Ir al contenido

Ejemplos de notas y anulaciones

Recetas listas para copiar cuando necesites corregir o anular un comprobante que SUNAT ya aceptó. Usan como referencia la factura F001-1 del ejemplo de facturas (una laptop de S/ 118.00 y dos libros exonerados de S/ 5.50) y la boleta B001-1 del ejemplo de boletas. Reemplaza <id-de-la-factura> o <id-de-la-boleta> por el id que te devolvió la API al emitirlas.

Las reglas de cada motivo están en Emitir una nota de crédito, Emitir una nota de débito y Anular un comprobante.

Situación Qué usar
El comprobante tiene un error y no debió existir Anulación (comunicación de baja o resumen diario), o nota de crédito motivo 01
El cliente devuelve parte de lo comprado Nota de crédito motivo 07 (devolución por ítem)
Das un descuento después de emitir Nota de crédito motivo 04 (descuento global)
Cobras intereses o una penalidad Nota de débito

El cliente devuelve los dos libros. La nota de crédito lleva solo los ítems devueltos, con su precio.

Ventana de terminal
curl -X POST https://faktura-test.cgallardo.me/v1/credit-notes \
-H "Authorization: Bearer sk_test_..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: erp-devolucion-0001" \
-d '{
"affected_document_id": "<id-de-la-factura>",
"series": "FC01",
"reason_code": "07",
"reason_description": "Devolución de 2 libros",
"items": [ { "description": "Libro", "quantity": 2, "unit_price": 5.5, "igv_type": "exonerado" } ]
}'

Los libros son exonerados, así que la nota no lleva IGV:

{
"totals": {
"taxed": "0.00", "exempt": "11.00", "unaffected": "0.00", "free": "0.00",
"igv": "0.00", "icbper": "0.00", "total_taxes": "0.00", "discounts": "0.00", "charges": "0.00", "total": "11.00"
}
}

Un descuento por pronto pago de S/ 11.80 (IGV incluido) sobre la factura.

Ventana de terminal
curl -X POST https://faktura-test.cgallardo.me/v1/credit-notes \
-H "Authorization: Bearer sk_test_..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: erp-descuento-0001" \
-d '{
"affected_document_id": "<id-de-la-factura>",
"series": "FC01",
"reason_code": "04",
"reason_description": "Descuento por pronto pago",
"items": [ { "description": "Descuento por pronto pago", "quantity": 1, "unit_price": 11.80 } ]
}'
{
"totals": {
"taxed": "10.00", "exempt": "0.00", "unaffected": "0.00", "free": "0.00",
"igv": "1.80", "icbper": "0.00", "total_taxes": "1.80", "discounts": "0.00", "charges": "0.00", "total": "11.80"
}
}

Las notas de una boleta usan una serie que empieza con B (BC01). Aquí el cliente devuelve uno de los dos cafés.

Ventana de terminal
curl -X POST https://faktura-test.cgallardo.me/v1/credit-notes \
-H "Authorization: Bearer sk_test_..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: pos-0042-devolucion-01" \
-d '{
"affected_document_id": "<id-de-la-boleta>",
"series": "BC01",
"reason_code": "07",
"items": [ { "description": "Cafe americano", "quantity": 1, "unit_price": 8.00 } ]
}'
{
"totals": {
"taxed": "6.78", "exempt": "0.00", "unaffected": "0.00", "free": "0.00",
"igv": "1.22", "icbper": "0.00", "total_taxes": "1.22", "discounts": "0.00", "charges": "0.00", "total": "8.00"
}
}

La nota de débito aumenta el monto del comprobante. Sus items son obligatorios.

Ventana de terminal
curl -X POST https://faktura-test.cgallardo.me/v1/debit-notes \
-H "Authorization: Bearer sk_test_..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: erp-penalidad-0001" \
-d '{
"affected_document_id": "<id-de-la-factura>",
"series": "FD01",
"reason_code": "03",
"reason_description": "Penalidad por entrega tardía",
"items": [ { "description": "Penalidad por entrega tardía", "quantity": 1, "unit_price": 59 } ]
}'
{
"totals": {
"taxed": "50.00", "exempt": "0.00", "unaffected": "0.00", "free": "0.00",
"igv": "9.00", "icbper": "0.00", "total_taxes": "9.00", "discounts": "0.00", "charges": "0.00", "total": "59.00"
}
}

La anulación de una boleta viaja en un resumen diario (RC). SUNAT responde con un ticket que Faktura consulta sola. El estado de la baja se ve en el bloque void del comprobante.

Ventana de terminal
curl -X POST https://faktura-test.cgallardo.me/v1/documents/<id-de-la-boleta>/void \
-H "Authorization: Bearer sk_test_..." \
-H "Content-Type: application/json" \
-d '{ "reason": "Venta duplicada" }'

Una factura se anula igual, con su propio id: Faktura envía una comunicación de baja (RA) en lugar del resumen (Anular un comprobante).