Emitir Nota de Débito

Servicio para emitir notas de débito electrónicas. Las notas de débito se emiten para incrementar el valor de un comprobante previamente emitido, por ejemplo por intereses, penalidades o cargos adicionales.

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.

La nota de débito debe referenciar un comprobante previamente emitido por el mismo emisor y receptor. Mantén consistente la identidad referenciada y los importes relacionados con el documento original.

PUThttps://jarvis.tefacturo.pe/notadebito-api/invoice2u/integracion/nota-debito/{ruc}

Servicio para emitir notas de débito electrónicas. Reemplaza {ruc} con el RUC del emisor. La nota de débito debe hacer referencia a un comprobante previamente emitido.

Headers

Header	Valor	Descripción
Authorization	Bearer {token}	Token de autenticación obtenido del endpoint de login
Content-Type	application/json	Tipo de contenido del cuerpo de la solicitud

Cuerpo de la Solicitud

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.

El ejemplo completo está en el panel derecho para copiar rápidamente.

Comprobante Ajustado (Documento Original)

El objeto comprobanteAjustado identifica el comprobante al que se aplica el cargo adicional:

Campo	Tipo	Requerido	Descripción
serie	string	Sí	Serie del comprobante original
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)

Motivos de Nota de Débito

El campo motivo define la razón del cargo adicional:

Valor	Descripción
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.

Respuesta Exitosa (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.

Revisa el panel derecho para ver y copiar la respuesta de ejemplo.

Manejo de Errores

Código	Estado	Descripción
400	Bad Request	Errores de validación. Verifique que el comprobante ajustado exista y sea correcto.
401	Unauthorized	Token de autenticación inválido o expirado.
403	Forbidden	No tiene permisos para emitir notas de débito con el RUC indicado.
404	Not Found	El RUC o comprobante original no fue encontrado.
500	Internal Server Error	Error interno del servidor. Intente nuevamente o contacte soporte.

Endpoints Relacionados

PUTEmitir Factura PUTEmitir Nota de Crédito PUTConsultar Estados PUTConsultar PDF

EJEMPLOS

Request Body

{
  "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"
  }
}

Response 200

{
  "codigobBarras": null,
  "firma": "[B@3ab9248d",
  "hash": "SOdd8M/qDqz5UZ+yZ1IhU8gU0HQ=",
  "identificador": "4913758366312771640",
  "numero": 30,
  "serie": "FFD1",
  "total": 23.6,
  "observacion": null,
  "tipo_documento": "Nota de Débito"
}