tefacturo
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

15

Manual/API

14

Derivados

1

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.

Reglas de uso importantes

  • tipoIntegracion: OFFLINE → tu propio ERP se encarga del correlativo (serie/número). ERP → tefacturo se encarga del correlativo.
  • numero (en datosDocumento): no puede estar duplicado. Si el número ya fue utilizado, mapea/controla el correlativo para no reenviarlo.
  • fechaEmision: un comprobante (CPE) se puede declarar con un máximo de 3 días de anterioridad.
  • Reemplaza el RUC fijo del ejemplo por el RUC emisor usado en la URL y el token; los tres deben coincidir.
  • Los valores de la respuesta 200, como serie, número, hash, firma e identificador, son ilustrativos; el API genera sus valores reales en cada solicitud.
Factura4Boleta3Nota de Crédito3Nota de Débito1Resumen de Baja1Consultas1Guías2
Factura

Factura

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

4 casos
JSON actualizadoFactura gravada

Factura gravada

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

Factura y factura gravada usan el mismo payload en estos ejemplos, por eso este caso queda como tab inicial.

Ver endpoint Factura
Factura gravada · 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
    }
  ],
  "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

Boleta gravada y variaciones especificas de boleta.

3 casos
Manual baseBoleta gravada

Boleta gravada

Caso de boleta gravada 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 gravada · 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
    }
  ],
  "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": "cliente.final@gmail.com",
    "correoCopia": null,
    "domicilioFiscal": {
      "direccion": "JR. LOS OLIVOS 456 - LIMA",
      "ubigeo": "150101"
    },
    "nombreComercial": "JUAN PEREZ",
    "nombreLegal": "JUAN PEREZ GARCIA",
    "numeroDocumentoIdentidad": "12345678",
    "tipoDocumentoIdentidad": "DOC_NACIONAL_DE_IDENTIDAD"
  }
}
Nota de Crédito

Nota de Crédito

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

3 casos
Formato APINota de Crédito sobre Factura

Nota de Crédito sobre Factura

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

Usa un comprobante ya emitido del mismo emisor y receptor. El importe de la nota no puede superar el importe del comprobante referenciado.

Ver endpoint Nota de Crédito
Nota de Crédito sobre Factura · JSON de solicitud
{
  "close2u": {
    "tipoIntegracion": "OFFLINE",
    "tipoPlantilla": "01",
    "tipoRegistro": "PRECIOS_SIN_IGV"
  },
  "comprobanteAjustado": {
    "serie": "FFA5",
    "numero": 1,
    "tipoComprobante": "01",
    "tipoDocumento": "FACTURA",
    "fechaEmision": "2025-04-16"
  },
  "datosDocumento": {
    "serie": "FFC5",
    "numero": 6,
    "moneda": "PEN",
    "fechaEmision": "2025-04-17",
    "horaEmision": "01:13:07",
    "motivo": "ANULACION_OPERACION",
    "glosa": "Anulación"
  },
  "detalleDocumento": [
    {
      "codigoProducto": "ABC123",
      "descripcion": "PRODUCTO GRAVADO A",
      "tipoAfectacion": "GRAVADO_OPERACION_ONEROSA",
      "unidadMedida": "UNIDAD_BIENES",
      "cantidad": 1,
      "valorVentaUnitarioItem": 100
    }
  ],
  "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"
  },
  "motivo": "ANULACION_OPERACION",
  "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

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.

Referencia un comprobante ya emitido del mismo emisor y receptor; conserva los datos e importes relacionados con el documento original.

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",
    "tipoDocumento": "FACTURA",
    "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": "VENTA_INTERNA",
    "coVendedor": "AARROYO"
  },
  "motivo": "AUMENTO_EN_EL_VALOR",
  "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

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.

La serie, número y tipo son ilustrativos: reemplázalos por un comprobante emitido del mismo emisor. El resumen de baja usa esa referencia para anularlo.

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

Consultas

Solicitud JSON y respuesta JSON con el XML en base64 dentro de xmlFirma.

1 casos
Manual baseConsultar XML

Consulta del XML de un comprobante

Solicitud oficial para recuperar el XML de un comprobante previamente emitido.

La serie, número y tipo son ilustrativos y deben corresponder a un comprobante emitido previamente. La consulta no consume esa referencia; la respuesta 200 contiene el base64 dentro de xmlFirma.

Endpoint Consultar XML
Consultar XML · JSON de solicitud
{
  "emisor": 20133795724,
  "numero": 1,
  "serie": "FFA2",
  "tipoComprobante": "01"
}
Respuesta 200 · JSON
{
  "serieNumero": "FFA2-1",
  "xmlFirma": "UEsDBBQACAgIAEWOJlkAAAAAAAAAAAAAAAZAAAAMTAyNTYyMjgyMzMtMDEtRkZBMl8xLlhNT...",
  "hashCode": null
}
Guías

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.

La guía usa OFFLINE: envía datosDocumento.numero porque tu ERP controla el correlativo.

Ver endpoint Guía Remitente
Guía Remitente · JSON de solicitud
{
  "close2u": {
    "tipoIntegracion": "OFFLINE",
    "tipoPlantilla": "01"
  },
  "datosDocumento": {
    "serie": "T001",
    "numero": 400,
    "fechaEmision": "2025-04-16",
    "codigoAlmacen": "AL1",
    "glosa": "Traslado de mercadería a sucursal"
  },
  "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"
  },
  "datosEnvio": {
    "motivoTraslado": "VENTA",
    "indicadorVehiculosConductoresTransportista": "False",
    "indicadorTrasladoVehiculosM1oL": "False",
    "indicadorTrasladoTotalDAM": "False",
    "modalidadTraslado": "PRIVADO",
    "descripcionTraslado": "Traslado de mercadería a sucursal",
    "transbordoProgramado": "False",
    "retornoVehiculoContenedoresVacios": "False",
    "retornoVehiculoVacio": "False",
    "unidadMedida": "KILOS",
    "pesoBruto": "50.5",
    "numeroBultos": 5,
    "numeroPallet": "5",
    "fechaTraslado": "2025-04-16",
    "fechaEntrega": "2025-04-16",
    "puntoPartida": {
      "ubigeo": "150132",
      "direccion": "AV. ORIGEN NRO. 123 - SAN JUAN DE LURIGANCHO"
    },
    "puntoLlegada": {
      "ubigeo": "150101",
      "direccion": "AV. DESTINO NRO. 456 - LIMA"
    }
  },
  "vehiculos": [
    {
      "placa": "ABC-123",
      "conductor": {
        "nombreLegal": "CARLOS RODRIGUEZ GARCIA",
        "numeroDocumentoIdentidad": "12345678",
        "tipoDocumentoIdentidad": "DOC_NACIONAL_DE_IDENTIDAD"
      },
      "liscenciaConducir": "Q12345678"
    }
  ],
  "detalleGuia": [
    {
      "numeroOrden": 1,
      "codigoProducto": "PROD001",
      "descripcion": "PRODUCTO A - LOTE 2025",
      "unidadMedida": "UNIDAD_BIENES",
      "unidadNombre": "UNIDAD_BIENES",
      "cantidad": 10
    },
    {
      "numeroOrden": 2,
      "codigoProducto": "PROD002",
      "descripcion": "PRODUCTO B - LOTE 2025",
      "unidadMedida": "KILOGRAMO",
      "unidadNombre": "KILOGRAMO",
      "cantidad": 40.5
    }
  ]
}