End Point para Boletas
Request
JSON
{
"contribuyente":{
"token_contribuyente":"SBGV15GKOE3WPKSZTH24RU0MWTYTM9VM88VM3",
"id_usuario_vendedor":2,
"tipo_proceso":"prueba",
"tipo_envio":"inmediato"
},
"cliente":{
"tipo_docidentidad":1,
"numerodocumento":"42719520",
"nombre":"Razón social de tu cliente",
"email":"email_cliente@gmail.com",
"direccion":"",
"ubigeo":"",
"sexo":"",
"fecha_nac":"",
"celular":""
},
"cabecera_comprobante":{
"tipo_documento":"03",
"moneda":"PEN",
"idsucursal": 691,
"id_condicionpago":"",
"fecha_comprobante":"19/05/2026",
"nro_placa":"",
"nro_orden":"",
"guia_remision":"",
"descuento_monto":0,
"descuento_porcentaje":0,
"observacion":""
},
"detalle":[
{
"idproducto":0,
"codigo":"TV_CODIGOPROD",
"afecto_icbper":"no",
"id_tipoafectacionigv":10,
"descripcion":"Producto de Ejemplo",
"idunidadmedida":"NIU",
"precio_venta":5,
"cantidad":111
},
{
"idproducto":0,
"codigo":"TV_CODIGOPROD2",
"afecto_icbper":"no",
"id_tipoafectacionigv":20,
"descripcion":"Producto de Ejemplo",
"idunidadmedida":"NIU",
"precio_venta":78.56,
"cantidad":2.89
}
]
}Response
Respuesta JSON
{
"respuesta": "ok",
"save_doc": "ok",
"send_api": "ok",
"documento": {
"respuesta": "ok",
"id_contribuyente": 1,
"id_tipodoc_electronico": "01",
"serie_comprobante": "B001",
"numero_comprobante": 54,
"tipo_envio_sunat": "prueba",
"idusuario": 1
},
"titulo": "El Documento se ha Guardado Correctamente!",
"mensaje": "Se guardó y envió a SUNAT correctamente el documento: B001-54.",
"repuesta_api": "El Documento N°: B001-54, se guardó correctamente. <br /> Sin embargo no se logró enviar a SUNAT, nosotros recomendamos verificar el estado del documento!<br /><br /> ERROR: No se puede leer (parsear) el archivo XML - Detalle: http://xxx.xxx.xxx/ol-ti-itcpfegem-beta/billService: cvc-particle 2.1: in element {urn:oasis:names:specification:ubl:schema:xsd:Invoice-2}Invoice of type {urn:oasis:names:specification:ubl:schema:xsd:Invoice-2}InvoiceType, found <cbc:DueDate> (in namespace urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2), but next item should be {urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2}AccountingSupplierParty",
"url_whatsapp": "",
"url_whatsapp_api": "",
"url_whatsapp_web": "",
"respuesta_email": "202\nArray\n(\n [0] => HTTP/1.1 202 Accepted\n [1] => Date: Mon, 18 May 2026 22:24:08 GMT\n [2] => Content-Length: 0\n [3] => Connection: keep-alive\n [4] => Server: nginx\n [5] => X-Message-Id: -NWsv2NdQ1O3tsQKp_XW4w\n [6] => Access-Control-Allow-Origin: https://sendgrid.api-docs.io\n [7] => Access-Control-Allow-Methods: POST\n [8] => Access-Control-Allow-Headers: Authorization, Content-Type, On-behalf-of, x-sg-elas-acl\n [9] => Access-Control-Max-Age: 600\n [10] => X-No-CORS-Reason: https://sendgrid.com/docs/Classroom/Basics/API/cors.html\n [11] => Strict-Transport-Security: max-age=31536000; includeSubDomains\n [12] => Content-Security-Policy: frame-ancestors 'none'\n [13] => Cache-Control: no-cache\n [14] => X-Content-Type-Options: no-sniff\n [15] => Referrer-Policy: strict-origin-when-cross-origin\n [16] => \n [17] => \n)\n\nnull",
"cadena_a4": "FcFW1Ofd3pq56O6RlQOR2kotg7Vm0AF5vVPA",
"cadena_ticket": "FcFW1Ofd3pq56O6RlQOR2kotg7Vm0AF5vUad3iA12Q==",
"url_absoluta_a4": "https://emisor.pe/facturacionv9/printpdf/?file=FcFW1Ofd3pq56O6RlQOR2kotg7Vm0AF5vVPA",
"url_absoluta_ticket": "https://emisor.pe/facturacionv9/printpdf/?file=FcFW1Ofd3pq56O6RlQOR2kotg7Vm0AF5vUad3iA12Q%3D%3D",
"url_relativa_a4": "/facturacionv9/printpdf/?file=FcFW1Ofd3pq56O6RlQOR2kotg7Vm0AF5vVPA",
"url_relativa_ticket": "/facturacionv9/printpdf/?file=FcFW1Ofd3pq56O6RlQOR2kotg7Vm0AF5vUad3iA12Q%3D%3D",
"cadena_xml": "/1/01/B001/54/xml_cpe_zip",
"url_relativa_xml": "/facturacionv9/download/downloadcpe/1/01/B001/54/xml_cpe_zip",
"url_absoluta_xml": "https://emisor.pe/facturacionv9/download/downloadcpe/1/01/B001/54/xml_cpe_zip",
"cadena_xml_cdr": "/1/01/B001/B001/xml_cdr_zip",
"url_relativa_xml_cdr": "/facturacionv9/download/downloadcpe/1/01/B001/54/xml_cdr_zip",
"url_absoluta_xml_cdr": "https://emisor.pe/facturacionv9/download/downloadcpe/1/01/B001/54/xml_cdr_zip",
"estado_envio_sunat": "pendiente",
"hash_cpe": null,
"hash_cdr": null,
"cod_sunat": null
}
¡Importante sobre Serie y Correlativo!
Los comprobantes que se emiten no llevan en el request la serie ni el correlativo, ya que esto se configura y autogestiona automáticamente desde la sucursal del sistema.
Si tu sistema local necesita conocer qué número correlativo se asignará al comprobante antes de emitirlo (para evitar desfases de numeración en tu base de datos local), debes realizar una consulta previa.
Para ver el flujo de consulta, parámetros del request y ejemplos de respuesta, revisa la sección dedicada: Guía de Comprobar Correlativo 🔍.
Parámetros: contribuyente
| Parámetro | Tipo | Req. | Descripción |
|---|---|---|---|
| token_contribuyente | string | Sí | El token único del contribuyente asignado por eFacturando. |
| id_usuario_vendedor | integer | Sí | ID del usuario vendedor en el sistema. |
| tipo_proceso | string | Sí | Entorno de envío. pruebaproduccion |
| tipo_envio | string | Sí | Tipo de envío del comprobante. inmediatoprogramado |
Parámetros: cliente
| Parámetro | Tipo | Req. | Descripción |
|---|---|---|---|
| tipo_docidentidad | integer | Sí | Tipo de documento de identidad. 0 = Sin doc1 = DNI6 = RUC4 = CE |
| numerodocumento | string | Sí* | Número de RUC/DNI. Obligatorio si tipo_docidentidad ≠ 0. |
| nombre | string | Sí | Razón social o nombre completo del cliente. |
| string | No | Correo del cliente. Si se incluye, se envía el comprobante por email. | |
| direccion | string | No | Dirección fiscal del cliente. |
| ubigeo | string | No | Código de ubigeo INEI (6 dígitos). Ej: 150101 |
| sexo | string | No | Sexo del cliente. masculinofemenino |
| fecha_nac | string | No | Fecha de nacimiento en formato DD/MM/YYYY. |
| celular | string | No | Número de celular del cliente. |
Parámetros: cabecera_comprobante
| Parámetro | Tipo | Req. | Descripción |
|---|---|---|---|
| tipo_documento | string | Sí | Tipo de comprobante SUNAT. "01" = Factura"03" = Boleta |
| moneda | string | Sí | Código de moneda ISO 4217. PENUSD |
| idsucursal | integer | Sí | ID de la sucursal emisora configurada en tu cuenta. |
| id_condicionpago | string | No | ID de la condición de pago configurada en tu catálogo. |
| fecha_comprobante | string | Sí | Fecha de emisión en formato DD/MM/YYYY. |
| nro_placa | string | No | Número de placa vehicular (sector transporte). |
| nro_orden | string | No | Número de orden de compra asociada. |
| guia_remision | string | No | Número de guía de remisión relacionada. Ej: T001-0000123 |
| descuento_monto | decimal | No | Descuento global en monto. Ej: 50.00 |
| descuento_porcentaje | decimal | No | Descuento global en porcentaje. Ej: 10.00 |
| observacion | string | No | Observaciones libres que aparecerán en el PDF. |
Parámetros: detalle (array de ítems)
| Parámetro | Tipo | Req. | Descripción |
|---|---|---|---|
| idproducto | integer | Sí | ID interno del producto en tu catálogo (usar 0 para productos manuales). |
| codigo | string | Sí | Código interno del producto en tu catálogo. |
| afecto_icbper | string | Sí | ¿Aplica impuesto a la bolsa plástica ICBPER? sino |
| id_tipoafectacionigv | integer | Sí | Código SUNAT de afectación al IGV. 10 = Gravado20 = Exonerado30 = Inafecto40 = Exportación |
| descripcion | string | Sí | Descripción del bien o servicio. Máx. 250 caracteres. |
| idunidadmedida | string | Sí | Código de unidad de medida SUNAT. Principal: NIU (Unidad).NIU = UnidadZZ = ServicioKGM = KilogramoLTR = Litro |
| precio_venta | decimal | Sí | Precio de venta unitario del ítem con IGV incluido. |
| cantidad | decimal | Sí | Cantidad del ítem. Hasta 4 decimales. |