Emitir Nota de Crédito

Servicio para emitir notas de crédito electrónicas. Las notas de crédito se emiten para anular, corregir o realizar descuentos sobre comprobantes previamente emitidos (facturas o boletas).

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.

Las notas de crédito deben referenciar un comprobante emitido del mismo emisor y receptor. Mantén consistentes los datos del documento original y no emitas una nota por un importe mayor al comprobante referenciado. Para AJUSTES_MONTOS_FECHA_PAGO, la factura referenciada debe ser una venta a crédito con cuotas.

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

Servicio para emitir notas de crédito electrónicas. Reemplaza {ruc} con el RUC del emisor. La nota de crédito 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

La nota de crédito incluye un objeto comprobanteAjustado que referencia al documento original. Usa las tabs del panel derecho para cambiar entre la nota de crédito sobre factura, la nota de crédito sobre boleta y el motivo de ajuste de fecha de pago de la página de Ejemplos JSON.

Los ejemplos completos están en el panel derecho para copiar rápidamente.

Comprobante Ajustado (Documento Original)

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	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 Crédito

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

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

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

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 los campos sean correctos.
401	Unauthorized	Token de autenticación inválido o expirado.
403	Forbidden	No tiene permisos para emitir notas de crédito con el RUC indicado.
404	Not Found	El RUC o el comprobante original no está registrado en el sistema.
500	Internal Server Error	Error interno del servidor. Intente nuevamente o contacte soporte.

Endpoints Relacionados

PUTEmitir Factura PUTEmitir Nota de Débito PUTConsultar Estados PUTResumen de Baja

EJEMPLOS

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