Issue credit note

Service to issue electronic credit notes. Credit notes are used to cancel, correct, or discount previously issued documents (invoices or receipts).

Important usage rules

tipoIntegracion: OFFLINE → your own ERP handles the correlative (series/number). ERP → tefacturo handles the correlative.
numero (in datosDocumento): 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.

Credit notes must reference an issued document from the same issuer and receiver. Keep the original document data consistent and do not issue a credit note for an amount greater than the referenced document. For AJUSTES_MONTOS_FECHA_PAGO, the referenced invoice must be a credit sale with installments.

PUThttps://jarvis.tefacturo.pe/notacredito-api/invoice2u/integracion/nota-credito/{ruc}

Service to issue electronic credit notes. Replace {ruc} with the issuer RUC. The credit 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

The credit note includes a comprobanteAjustado object that references the original document. Use the tabs in the right panel to switch between the invoice-based case, the receipt-based case, and the payment date adjustment reason shown on the JSON examples page.

The full examples are in the right panel for quick copy.

Adjusted document (Original document)

El objeto comprobanteAjustado identifica el comprobante original al que se aplica la nota de crédito. Es obligatorio para vincular la nota con el documento que se está corrigiendo.

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)

Credit note reasons

El campo motivo a nivel raíz define la razón de la emisión de la nota de crédito:

Value	Description
ANULACION_OPERACION	Anulación total de la operación. Se emite por el monto completo del documento original.
ANULACION_ERROR_RUC	Anulación por error en el RUC del receptor.
CORRECCION_DESCRIPCION	Corrección en la descripción de los items.
DESCUENTO_GLOBAL	Descuento global aplicado al documento.
DESCUENTO_ITEM	Descuento aplicado a items específicos.
DEVOLUCION_TOTAL	Devolución total de los bienes.
DEVOLUCION_ITEM	Devolución parcial de bienes específicos.

Successful Response (200)

La respuesta confirma que la nota de crédito fue emitida correctamente y retorna los datos generados del documento: firma, hash, identificador, serie, número, total, observación y tipo_documento.

Check the right panel to view and copy the sample response.

Error Handling

Code	Status	Description
400	Bad Request	Errores de validación. Verifique que el comprobante ajustado exista y los campos sean correctos.
401	Unauthorized	Invalid or expired authentication token.
403	Forbidden	You do not have permission to issue credit notes with the provided RUC.
404	Not Found	El RUC o el comprobante original no está registrado en el sistema.
500	Internal Server Error	Internal server error. Try again or contact support.

Related Endpoints

PUTIssue invoice PUTIssue debit note PUTCheck status PUTVoided summary

EXAMPLES

Request Body

{
  "close2u": {
    "tipoIntegracion": "OFFLINE",
    "tipoPlantilla": "01",
    "tipoRegistro": "PRECIOS_SIN_IGV"
  },
  "comprobanteAjustado": {
    "serie": "FFA5",
    "numero": 1,
    "tipoComprobante": "01",
    "tipoDocumento": "FACTURA",
    "fechaEmision": "2025-04-16"
  },
  "datosDocumento": {
    "serie": "FFC5",
    "numero": 6,
    "moneda": "PEN",
    "fechaEmision": "2025-04-17",
    "horaEmision": "01:13:07",
    "motivo": "ANULACION_OPERACION",
    "glosa": "Anulación"
  },
  "detalleDocumento": [
    {
      "codigoProducto": "ABC123",
      "descripcion": "PRODUCTO GRAVADO A",
      "tipoAfectacion": "GRAVADO_OPERACION_ONEROSA",
      "unidadMedida": "UNIDAD_BIENES",
      "cantidad": 1,
      "valorVentaUnitarioItem": 100
    }
  ],
  "emisor": {
    "correo": "pruebasintegraciontest@gmail.com",
    "nombreComercial": "ALFA PLUS SAC",
    "nombreLegal": "ALFA PLUS S.A.C.",
    "numeroDocumentoIdentidad": "20133795724",
    "tipoDocumentoIdentidad": "RUC"
  },
  "informacionAdicional": {
    "tipoOperacion": "VENTA_INTERNA",
    "coVendedor": "AARROYO"
  },
  "motivo": "ANULACION_OPERACION",
  "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@73d7d969",
  "hash": "km2/ZJucEhyENrEw7bq3Eh51Wug=",
  "identificador": "3543542569192206391",
  "numero": 113,
  "serie": "FFC1",
  "total": 0,
  "observacion": "",
  "tipo_documento": "Nota de Crédito"
}