Issue debit note
Service to issue electronic debit notes. Debit notes increase the value of a previously issued document (e.g., interests, penalties, additional charges).
Important usage rules
tipoIntegracion:OFFLINE→ your own ERP handles the correlative (series/number).ERP→ tefacturo handles the correlative.numero(indatosDocumento): it cannot be duplicated. If the number was already used, map/track the correlative so it is not resent.fechaEmision: an electronic document (CPE) can be declared with at most 3 days of backdating.- Replace the fixed example RUC with the issuer RUC used in the URL and token; all three must match.
- Response 200 values such as series, number, hash, signature, and identifier are illustrative; the API generates their actual values for each request.
https://jarvis.tefacturo.pe/notadebito-api/invoice2u/integracion/nota-debito/{ruc}Service to issue electronic debit notes. Replace {ruc} with the issuer RUC. The debit note must reference a previously issued document.
Headers
| Header | Value | Description |
|---|---|---|
| Authorization | Bearer {token} | Authentication token obtained from the login endpoint. |
| Content-Type | application/json | Content type for the request body. |
Request Body
Al igual que la nota de crédito, la nota de débito incluye un objeto comprobanteAjustado que referencia al documento original. El detalle indica el monto adicional a cobrar.
Adjusted document (Original document)
El objeto comprobanteAjustado identifica el comprobante al que se aplica el cargo adicional:
| Campo | Tipo | Requerido | Description |
|---|---|---|---|
| serie | string | Sí | Original document series |
| numero | number | Sí | Número del comprobante original |
| tipoComprobante | string | Sí | Tipo: "01" para Factura, "03" para Boleta |
| tipoDocumento | string | Sí | FACTURA o BOLETA, coherente con tipoComprobante |
| fechaEmision | string | Sí | Fecha de emisión del documento original (YYYY-MM-DD) |
Debit note reasons
El campo motivo define la razón del cargo adicional:
| Value | Description |
|---|---|
| AUMENTO_EN_EL_VALOR | Se incrementa el valor del comprobante original por servicios o costos adicionales. |
| INTERESES_POR_MORA | Cobro de intereses por pago tardío o morosidad. |
| PENALIDADES | Cobro de penalidades contractuales. |
Successful Response (200)
La respuesta confirma que la nota de débito fue emitida y vinculada al comprobante original, retornando firma, hash, identificador, serie, número, total, observación y tipo_documento.
Error Handling
| Code | Status | Description |
|---|---|---|
| 400 | Bad Request | Errores de validación. Verifique que el comprobante ajustado exista y sea correcto. |
| 401 | Unauthorized | Invalid or expired authentication token. |
| 403 | Forbidden | You do not have permission to issue debit notes with the provided RUC. |
| 404 | Not Found | El RUC o comprobante original no fue encontrado. |
| 500 | Internal Server Error | Internal server error. Try again or contact support. |