Formato real de API

Ejemplos JSON

Explora los ejemplos como un catálogo de requests reales. Cada caso conserva la estructura verdadera del payload y puede abrirse en la misma página para comparar escenarios sin cambiar de vista.

Casos

Manual/API

Derivados

Cómo está organizada esta página

Cada acordeón principal agrupa una familia de documentos. Dentro, usa las tabs pequeñas para cambiar de caso sin perder la vista del JSON a todo el ancho. Usa Catálogos para reemplazar valores de prueba por códigos permitidos.

Factura5 Boleta2 Nota de Crédito3 Nota de Débito1 Resumen de Baja1 Consultas1 Guías2

Factura

Todos los casos de factura agrupados en un solo bloque con tabs internas.

5 casos

Manual baseFactura

Factura electrónica

Ejemplo base de Factura con la estructura real close2u / datosDocumento / detalleDocumento que hoy usa la documentación.

Se tomó el ejemplo del manual de comprobantes y se normalizó a JSON válido, manteniendo la misma forma del payload.

Ver endpoint Factura

Factura · JSON de solicitud

{
  "close2u": {
    "tipoIntegracion": "OFFLINE",
    "tipoPlantilla": "01",
    "tipoRegistro": "PRECIOS_SIN_IGV"
  },
  "datosDocumento": {
    "serie": "FFA6",
    "numero": 1,
    "moneda": "PEN",
    "fechaEmision": "2025-04-16",
    "horaEmision": null,
    "formaPago": "CONTADO",
    "medioPago": "DEPOSITO_CUENTA",
    "condicionPago": "CONTADO",
    "ordencompra": null,
    "glosa": "observaciones"
  },
  "detalleDocumento": [
    {
      "codigoProducto": "ABC123",
      "descripcion": "PRODUCTO GRAVADO A",
      "tipoAfectacion": "GRAVADO_OPERACION_ONEROSA",
      "unidadMedida": "UNIDAD_BIENES",
      "cantidad": "1",
      "valorVentaUnitarioItem": 100
    },
    {
      "codigoProducto": "ABC124",
      "descripcion": "PRODUCTO GRAVADO B",
      "tipoAfectacion": "GRAVADO_OPERACION_ONEROSA",
      "unidadMedida": "UNIDAD_BIENES",
      "cantidad": "1",
      "valorVentaUnitarioItem": 200
    }
  ],
  "emisor": {
    "correo": "pruebasintegraciontest@gmail.com",
    "nombreComercial": "ALFA PLUS SAC",
    "nombreLegal": "ALFA PLUS S.A.C.",
    "numeroDocumentoIdentidad": "20133795724",
    "tipoDocumentoIdentidad": "RUC"
  },
  "informacionAdicional": {
    "tipoOperacion": "VENTA_INTERNA",
    "coVendedor": "AARROYO"
  },
  "receptor": {
    "correo": "pruebatest@gmail.com",
    "correoCopia": "andreatest768@gmail.com",
    "domicilioFiscal": {
      "direccion": "AV. PTE PIEDRA NRO. 386 - PRO - LIMA LIMA PUENTE PIEDRA",
      "ubigeo": "150101"
    },
    "nombreComercial": "AIR SERVICE PUCALLPA TOURS",
    "nombreLegal": "AIR SERVICE PUCALLPA TOURS E.I.R.L.",
    "numeroDocumentoIdentidad": "20393663988",
    "tipoDocumentoIdentidad": "RUC"
  }
}

Boleta

Boleta base y variaciones especificas de boleta.

2 casos

Manual baseBoleta

Boleta de venta

Caso base de Boleta con el mismo esquema del endpoint actual y datos consistentes con el manual.

La estructura del tab anterior fue reemplazada por el formato completo que ya se documenta para Boleta.

Ver endpoint Boleta

Boleta · JSON de solicitud

{
  "close2u": {
    "tipoIntegracion": "OFFLINE",
    "tipoPlantilla": "01",
    "tipoRegistro": "PRECIOS_SIN_IGV"
  },
  "datosDocumento": {
    "serie": "BBV5",
    "numero": 4,
    "moneda": "PEN",
    "fechaEmision": "2025-04-16",
    "horaEmision": null,
    "formaPago": "CONTADO",
    "medioPago": "EFECTIVO",
    "condicionPago": "CONTADO",
    "ordencompra": null,
    "glosa": null
  },
  "detalleDocumento": [
    {
      "codigoProducto": "ABC123",
      "descripcion": "PRODUCTO GRAVADO A",
      "tipoAfectacion": "GRAVADO_OPERACION_ONEROSA",
      "unidadMedida": "UNIDAD_BIENES",
      "cantidad": "1",
      "valorVentaUnitarioItem": 100
    },
    {
      "codigoProducto": "ABC124",
      "descripcion": "PRODUCTO GRAVADO B",
      "tipoAfectacion": "GRAVADO_OPERACION_ONEROSA",
      "unidadMedida": "UNIDAD_BIENES",
      "cantidad": "1",
      "valorVentaUnitarioItem": 200
    }
  ],
  "emisor": {
    "correo": "pruebasintegraciontest@gmail.com",
    "nombreComercial": "ALFA PLUS SAC",
    "nombreLegal": "ALFA PLUS S.A.C.",
    "numeroDocumentoIdentidad": "20133795724",
    "tipoDocumentoIdentidad": "RUC"
  },
  "informacionAdicional": {
    "tipoOperacion": "VENTA_INTERNA",
    "coVendedor": "AARROYO"
  },
  "receptor": {
    "correo": "pruebatest@gmail.com",
    "correoCopia": "andreatest768@gmail.com",
    "domicilioFiscal": {
      "departamento": null,
      "direccion": "AV. PTE PIEDRA NRO. 386 - PRO - LIMA LIMA PUENTE PIEDRA",
      "ubigeo": "150101"
    },
    "nombreComercial": "AIR SERVICE PUCALLPA TOURS",
    "nombreLegal": "AIR SERVICE PUCALLPA TOURS E.I.R.L.",
    "numeroDocumentoIdentidad": "20393663988",
    "tipoDocumentoIdentidad": "RUC"
  }
}

Nota de Crédito

Casos de nota de crédito, incluida la variante sobre boleta.

3 casos

Formato APINota de Crédito

Nota de crédito

Ejemplo corregido con la estructura real del endpoint: comprobanteAjustado + datosDocumento + detalleDocumento.

Se dejó el formato que hoy usa la documentación del endpoint para que el ejemplo sea útil al copiarlo.

Ver endpoint Nota de Crédito

Nota de Crédito · JSON de solicitud

{
  "anticipos": [],
  "close2u": {
    "tipoIntegracion": "OFFLINE",
    "tipoPlantilla": "01",
    "tipoRegistro": "PRECIOS_SIN_IGV"
  },
  "comprobanteAjustado": {
    "serie": "FFA5",
    "numero": 1,
    "tipoComprobante": "01",
    "fechaEmision": "2025-04-16"
  },
  "datosDocumento": {
    "serie": "FFC5",
    "numero": 6,
    "moneda": "PEN",
    "fechaEmision": "2025-04-17",
    "horaEmision": "01:13:07",
    "motivo": "ANULACION_OPERACION",
    "glosa": "Anulacion"
  },
  "detalleDocumento": [
    {
      "codigoProducto": "ABC123",
      "descripcion": "PRODUCTO GRAVADO A",
      "tipoAfectacion": "GRAVADO_OPERACION_ONEROSA",
      "unidadMedida": "UNIDAD_BIENES",
      "cantidad": 1,
      "valorVentaUnitarioItem": 50
    }
  ],
  "emisor": {
    "correo": "pruebasintegraciontest@gmail.com",
    "nombreComercial": "ALFA PLUS SAC",
    "nombreLegal": "ALFA PLUS S.A.C.",
    "numeroDocumentoIdentidad": "20133795724",
    "tipoDocumentoIdentidad": "RUC"
  },
  "informacionAdicional": {
    "tipoOperacion": null,
    "coVendedor": "AARROYO"
  },
  "receptor": {
    "correo": "pruebatest@gmail.com",
    "correoCopia": "andreatest768@gmail.com",
    "domicilioFiscal": {
      "departamento": null,
      "direccion": "AV. PTE PIEDRA NRO. 386 - PRO - LIMA LIMA PUENTE PIEDRA",
      "ubigeo": "150101"
    },
    "nombreComercial": "AIR SERVICE PUCALLPA TOURS",
    "nombreLegal": "AIR SERVICE PUCALLPA TOURS E.I.R.L.",
    "numeroDocumentoIdentidad": "20393663988",
    "tipoDocumentoIdentidad": "RUC"
  }
}

Nota de Débito

Caso de nota de débito para cargos adicionales.

1 casos

Formato APINota de Débito

Nota de débito

Ejemplo corregido con el formato actual del endpoint para cargos adicionales sobre un comprobante previo.

Ver endpoint Nota de Débito

Nota de Débito · JSON de solicitud

{
  "anticipos": [],
  "close2u": {
    "tipoIntegracion": "OFFLINE",
    "tipoPlantilla": "01",
    "tipoRegistro": "PRECIOS_SIN_IGV"
  },
  "comprobanteAjustado": {
    "serie": "FFA5",
    "numero": 10,
    "tipoComprobante": "01",
    "fechaEmision": "2025-04-16"
  },
  "datosDocumento": {
    "serie": "FFD1",
    "numero": 2,
    "moneda": "PEN",
    "fechaEmision": "2025-04-17",
    "horaEmision": "01:13:07",
    "motivo": "AUMENTO_EN_EL_VALOR",
    "glosa": "Aumento en el valor"
  },
  "detalleDocumento": [
    {
      "codigoProducto": "ABC123",
      "descripcion": "PRODUCTO GRAVADO A",
      "tipoAfectacion": "GRAVADO_OPERACION_ONEROSA",
      "unidadMedida": "UNIDAD_BIENES",
      "cantidad": 1,
      "valorVentaUnitarioItem": 20
    }
  ],
  "emisor": {
    "correo": "pruebasintegracion1@gmail.com",
    "nombreComercial": "ALFA PLUS SAC",
    "nombreLegal": "ALFA PLUS S.A.C.",
    "numeroDocumentoIdentidad": "20133795724",
    "tipoDocumentoIdentidad": "RUC"
  },
  "informacionAdicional": {
    "tipoOperacion": null,
    "coVendedor": "AARROYO"
  },
  "receptor": {
    "correo": "pruebatest@gmail.com",
    "correoCopia": "andreatest768@gmail.com",
    "domicilioFiscal": {
      "departamento": null,
      "direccion": "AV. PTE PIEDRA NRO. 386 - PRO - LIMA LIMA PUENTE PIEDRA",
      "ubigeo": "150101"
    },
    "nombreComercial": "AIR SERVICE PUCALLPA TOURS",
    "nombreLegal": "AIR SERVICE PUCALLPA TOURS E.I.R.L.",
    "numeroDocumentoIdentidad": "20393663988",
    "tipoDocumentoIdentidad": "RUC"
  }
}

Resumen de Baja

Payload para anular comprobantes ya emitidos.

1 casos

Formato APIResumen de Baja

Resumen de baja

Payload completo para anular comprobantes usando el arreglo resumenBajaItemList.

En este caso se conserva la forma documentada del endpoint actual, agregando fechas para que el JSON sea listo para copiar.

Ver endpoint Resumen de Baja

Resumen de Baja · JSON de solicitud

{
  "close2u": {
    "tipoIntegracion": "OFFLINE"
  },
  "emisor": {
    "correo": "pruebasintegracion1@gmail.com",
    "nombreComercial": "ALFA PLUS SAC",
    "nombreLegal": "ALFA PLUS S.A.C.",
    "numeroDocumentoIdentidad": "20133795724",
    "tipoDocumentoIdentidad": "RUC"
  },
  "fechaGeneracion": "2025-04-17",
  "fechaDocumentoBaja": "2025-04-16",
  "resumenBajaItemList": [
    {
      "serie": "FFA2",
      "numero": 1,
      "tipoComprobante": "01",
      "motivo": "Error en el documento emitido"
    }
  ]
}

Consultas

Consulta de PDF, XML y estados con el mismo body.

1 casos

Manual baseConsulta PDF/XML/Estados

Consulta de PDF, XML y estados

El mismo body sirve para consultar PDF, XML y el estado del comprobante. Lo único que cambia es el endpoint.

La página anterior mezclaba request y response en un mismo bloque. Aquí queda solo el JSON que realmente se envía.

Endpoint Consultar PDF Endpoint Consultar XML Endpoint Consultar Estados

Consulta PDF/XML/Estados · JSON de solicitud

{
  "emisor": 20123456789,
  "numero": 1,
  "serie": "FFA2",
  "tipoComprobante": "01"
}

Guías

Guía remitente y guía transportista dentro del mismo bloque.

2 casos

Manual baseGuía Remitente

Guía de remisión remitente

Ejemplo completo alineado con la estructura actual del endpoint de guía remitente.

Ver endpoint Guía Remitente

Guía Remitente · JSON de solicitud

{
  "close2u": {
    "tipoIntegracion": "OFFLINE",
    "tipoPlantilla": "01"
  },
  "datosDocumento": {
    "serie": "T001",
    "numero": 1,
    "fechaEmision": "2025-04-16",
    "horaEmision": null,
    "glosa": "Traslado de mercaderia a sucursal"
  },
  "motivoTraslado": "VENTA",
  "modalidadTransporte": "TRANSPORTE_PRIVADO",
  "fechaInicioTraslado": "2025-04-17",
  "pesoBrutoTotal": 50.5,
  "unidadPeso": "KGM",
  "numeroBultos": 5,
  "puntoLlegada": {
    "ubigeo": "150101",
    "direccion": "AV. DESTINO NRO. 456 - LIMA"
  },
  "puntoPartida": {
    "ubigeo": "150132",
    "direccion": "AV. ORIGEN NRO. 123 - SAN JUAN DE LURIGANCHO"
  },
  "remitente": {
    "correo": "empresa@gmail.com",
    "nombreComercial": "MI EMPRESA SAC",
    "nombreLegal": "MI EMPRESA S.A.C.",
    "numeroDocumentoIdentidad": "20123456789",
    "tipoDocumentoIdentidad": "RUC"
  },
  "destinatario": {
    "correo": "cliente@gmail.com",
    "nombreComercial": "CLIENTE EMPRESA",
    "nombreLegal": "CLIENTE EMPRESA E.I.R.L.",
    "numeroDocumentoIdentidad": "20987654321",
    "tipoDocumentoIdentidad": "RUC"
  },
  "conductor": {
    "nombreCompleto": "CARLOS RODRIGUEZ GARCIA",
    "numeroDocumentoIdentidad": "12345678",
    "tipoDocumentoIdentidad": "DNI",
    "licenciaConducir": "Q12345678"
  },
  "vehiculo": {
    "placa": "ABC-123"
  },
  "detalleDocumento": [
    {
      "codigoProducto": "PROD001",
      "descripcion": "PRODUCTO A - LOTE 2025",
      "unidadMedida": "UNIDAD_BIENES",
      "cantidad": "10"
    },
    {
      "codigoProducto": "PROD002",
      "descripcion": "PRODUCTO B - LOTE 2025",
      "unidadMedida": "KILOGRAMO",
      "cantidad": "40.5"
    }
  ]
}