Guías por comprobante
Notas de crédito y de débito por API
Cómo emitir notas de crédito y de débito electrónicas por API: el comprobante que modifican, el tipo de nota, el tope de la nota de crédito y su envío a SUNAT.
Actualizado el
Una nota de crédito (tipo 07) baja el importe de un comprobante ya emitido: una devolución, un descuento o la anulación
de la operación. Una nota de débito (tipo 08) lo sube: intereses por mora o un aumento en el valor. Las dos van con el
mismo endpoint que la factura y la boleta.
- Endpoint:
POST /comprobantes· alcancecomprobantes.emitir. - Serie: una de notas del tipo que corresponde (las de una factura empiezan con F y las de una boleta con B). Revisa
las de tu local en
GET /establecimientos. - Llegan a SUNAT como su comprobante: la nota de una factura se envía directo y la de una boleta va en el resumen diario.
Nota de crédito: anulación de la operación
{
"serie_documento": "FC01",
"numero_documento": "#",
"fecha_de_emision": "2026-11-04",
"hora_de_emision": "16:40:00",
"codigo_tipo_documento": "07",
"codigo_tipo_moneda": "PEN",
"codigo_tipo_nota": "01",
"motivo_o_sustento_de_nota": "Anulación de la operación",
"documento_afectado": { "external_id": "9a0b1c2d-3e4f-4a5b-8c6d-7e8f9a0b1c2d" },
"datos_del_cliente_o_receptor": {
"codigo_tipo_documento_identidad": "6",
"numero_documento": "20601234567",
"apellidos_y_nombres_o_razon_social": "CONSTRUCTORA ANDINA S.A.C.",
"codigo_pais": "PE"
},
"totales": {
"total_operaciones_gravadas": 1000,
"total_igv": 180,
"total_impuestos": 180,
"total_valor": 1000,
"total_venta": 1180
},
"items": [{
"codigo_interno": "CEM-42",
"descripcion": "Cemento 42.5 kg",
"unidad_de_medida": "NIU",
"cantidad": 40,
"valor_unitario": 25,
"codigo_tipo_precio": "01",
"precio_unitario": 29.5,
"codigo_tipo_afectacion_igv": "10",
"total_base_igv": 1000,
"porcentaje_igv": 18,
"total_igv": 180,
"total_impuestos": 180,
"total_valor_item": 1000,
"total_item": 1180
}]
}
documento_afectadoacepta elexternal_iddel comprobante o su serie, número y tipo:{"serie_documento": "F001", "numero_documento": "120", "codigo_tipo_documento": "01"}. Si no existe, responde 422documento_afectado_no_existe.- La nota no lleva
codigo_tipo_operacionnipagos. - Para una devolución parcial, manda solo las líneas y cantidades que devuelves, con sus totales.
Tipos de nota más usados
| Nota | codigo_tipo_nota |
Para qué |
|---|---|---|
| Crédito | 01 |
Anulación de la operación |
| Crédito | 06 |
Devolución total |
| Crédito | 07 |
Devolución por ítem |
| Crédito | 13 |
Ajustes de montos o fechas de pago (cuotas de una venta a crédito) |
| Débito | 01 |
Intereses por mora |
| Débito | 02 |
Aumento en el valor |
Son los catálogos 09 (crédito) y 10 (débito) de SUNAT.
El tope de la nota de crédito
La suma de las notas de crédito de un comprobante no puede pasar de lo que queda de él. Si pasa, responde 422
nota_credito_excede con lo que aún se puede acreditar. Es la misma regla de la web.
Nota de crédito o anulación
Si el comprobante está aceptado y quieres dejarlo sin efecto, tienes dos caminos:
- Anularlo con
POST /comprobantes/{id}/anular: comunicación de baja (factura) o resumen de anulación (boleta). SUNAT pone plazos para la baja; si ya pasaron, usa la nota de crédito. Ver Anular. - Emitir una nota de crédito de tipo
01: el comprobante sigue aceptado y la nota lo compensa.
Si dudas, la nota de crédito es el camino que siempre está disponible.