API REST - Guía de Integración

End Point para Notas de Crédito

POST https://emisor.pe/facturacionv9/api/procesar_notacredito

Request

JSON

{
    "contribuyente":{
       "token_contribuyente":"SBGV15GKOE3WPKSZTH24RU0MWTYTM9VM88VM3",
       "id_usuario_vendedor":2,
       "tipo_proceso":"prueba",
       "tipo_envio":"inmediato"
    },
    "cabecera_comprobante":{
       "tipo_documento":"07",
       "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":1,
       "id_motivo_nota_credito":"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
       }
    ]
}

Response

Respuesta JSON

{
    "respuesta": "ok",
    "save_doc": "ok",
    "send_api": "error",
    "documento": {
        "respuesta": "ok",
        "id_contribuyente": 2,
        "id_tipodoc_electronico": "07",
        "serie_comprobante": "FC02",
        "numero_comprobante": 1,
        "tipo_envio_sunat": "prueba",
        "idusuario": 2
    },
    "titulo": "El Documento se ha Guardado Correctamente!",
    "mensaje": "Se guardó correctamente el documento: FC02-1<span class=\"text-danger\"> Sin embargo aún está \"PENDIENTE DE ENVÍO A SUNAT\".</span>",
    "repuesta_api": "El Documento N°: FC02-1, 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-complex-type 3: element {urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2}CreditedQuantity of type {urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2}CreditedQuantityType had undefined attribute unitCodeListID",
    "url_whatsapp": "",
    "url_whatsapp_api": "",
    "url_whatsapp_web": "",
    "cadena_a4": "FsFW1OHd3prK6O2RlQfZ2kYvhKVh0xx5oAY=",
    "cadena_ticket": "FsFW1OHd3prK6O2RlQfZ2kYvhKVh0xx5tVuX1i4k",
    "url_absoluta_a4": "https://emisor.pe/facturacionv9/printpdf/?file=FsFW1OHd3prK6O2RlQfZ2kYvhKVh0xx5oAY%3D",
    "url_absoluta_ticket": "https://emisor.pe/facturacionv9/printpdf/?file=FsFW1OHd3prK6O2RlQfZ2kYvhKVh0xx5tVuX1i4k",
    "url_relativa_a4": "/facturacionv9/printpdf/?file=FsFW1OHd3prK6O2RlQfZ2kYvhKVh0xx5oAY%3D",
    "url_relativa_ticket": "/facturacionv9/printpdf/?file=FsFW1OHd3prK6O2RlQfZ2kYvhKVh0xx5tVuX1i4k",
    "cadena_xml": "/2/07/FC02/1/xml_cpe_zip",
    "url_relativa_xml": "/facturacionv9/download/downloadcpe/2/07/FC02/1/xml_cpe_zip",
    "url_absoluta_xml": "https://emisor.pe/facturacionv9/download/downloadcpe/2/07/FC02/1/xml_cpe_zip",
    "cadena_xml_cdr": "/2/07/FC02/FC02/xml_cdr_zip",
    "url_relativa_xml_cdr": "/facturacionv9/download/downloadcpe/2/07/FC02/1/xml_cdr_zip",
    "url_absoluta_xml_cdr": "https://emisor.pe/facturacionv9/download/downloadcpe/2/07/FC02/1/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 🔍.

🚨

¡Requisito indispensable!

No es posible generar una Nota de Crédito 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 Crédito
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_credito	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.