End Point para Notas de Débito
{
"contribuyente":{
"token_contribuyente":"SBGV15GKOE3WPKSZTH24RU0MWTYTM9VM88VM3",
"id_usuario_vendedor":2,
"tipo_proceso":"prueba",
"tipo_envio":"inmediato"
},
"cabecera_comprobante":{
"tipo_documento":"08",
"moneda":"PEN",
"idsucursal":691,
"id_condicionpago":"",
"fecha_comprobante":"19/05/2026",
"nro_placa":"",
"nro_orden":"",
"guia_remision":"",
"descuento_monto":0,
"descuento_porcentaje":0,
"observacion":"",
"doc_modifica_id_tipodoc_electronico":"01",
"doc_modifica_serie_comprobante":"F002",
"doc_modifica_numero_comprobante":14,
"id_motivo_nota_debito":"01"
},
"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
}
]
}{
"respuesta": "ok",
"save_doc": "ok",
"send_api": "ok",
"documento": {
"respuesta": "ok",
"id_contribuyente": 1,
"id_tipodoc_electronico": "01",
"serie_comprobante": "FD01",
"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: FD01-54.",
"repuesta_api": "El Documento N°: FD01-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/FD01/54/xml_cpe_zip",
"url_relativa_xml": "/facturacionv9/download/downloadcpe/1/01/FD01/54/xml_cpe_zip",
"url_absoluta_xml": "https://emisor.pe/facturacionv9/download/downloadcpe/1/01/FD01/54/xml_cpe_zip",
"cadena_xml_cdr": "/1/01/FD01/FD01/xml_cdr_zip",
"url_relativa_xml_cdr": "/facturacionv9/download/downloadcpe/1/01/FD01/54/xml_cdr_zip",
"url_absoluta_xml_cdr": "https://emisor.pe/facturacionv9/download/downloadcpe/1/01/FD01/54/xml_cdr_zip",
"estado_envio_sunat": "pendiente",
"hash_cpe": null,
"hash_cdr": null,
"cod_sunat": null
}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 🔍.
No es posible generar una Nota de Débito para modificar un comprobante si este no existe previamente en la base de datos del sistema eFacturando. El comprobante original (Factura o Boleta) debe haber sido registrado o emitido en nuestra plataforma antes de intentar modificarlo.
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: cabecera_comprobante
| Parámetro | Tipo | Req. | Descripción |
|---|---|---|---|
| tipo_documento | string | Sí | Tipo de comprobante SUNAT. "07" = Nota de Débito |
| 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. |
| doc_modifica_id_tipodoc_electronico | string | Sí | Tipo de documento que se va a modificar. "01" = Factura"03" = Boleta |
| doc_modifica_serie_comprobante | string | Sí | Serie del documento a modificar (Ej: F001, B001). |
| doc_modifica_numero_comprobante | integer | Sí | Correlativo del documento a modificar. |
| id_motivo_nota_debito | string | Sí | Código del motivo de la nota de crédito según catálogo SUNAT. |
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. |