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.
¿Nota de crédito o anulación?
Sección titulada «¿Nota de crédito o anulación?»| 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 |
Devolver parte de una factura
Sección titulada «Devolver parte de una factura»El cliente devuelve los dos libros. La nota de crédito lleva solo los ítems devueltos, con su precio.
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" } ] }'use Illuminate\Support\Facades\Http;
$response = Http::withToken('sk_test_...') ->withHeaders(['Idempotency-Key' => 'erp-devolucion-0001']) ->post('https://faktura-test.cgallardo.me/v1/credit-notes', [ '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', ], ], ]);
$data = $response->json();const response = await fetch('https://faktura-test.cgallardo.me/v1/credit-notes', { method: 'POST', headers: { Authorization: 'Bearer sk_test_...', 'Content-Type': 'application/json', 'Idempotency-Key': 'erp-devolucion-0001', }, body: JSON.stringify({ 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', }, ], }),});const data = await response.json();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" }}Descuento después de emitir
Sección titulada «Descuento después de emitir»Un descuento por pronto pago de S/ 11.80 (IGV incluido) sobre la factura.
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 } ] }'use Illuminate\Support\Facades\Http;
$response = Http::withToken('sk_test_...') ->withHeaders(['Idempotency-Key' => 'erp-descuento-0001']) ->post('https://faktura-test.cgallardo.me/v1/credit-notes', [ '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, ], ], ]);
$data = $response->json();const response = await fetch('https://faktura-test.cgallardo.me/v1/credit-notes', { method: 'POST', headers: { Authorization: 'Bearer sk_test_...', 'Content-Type': 'application/json', 'Idempotency-Key': 'erp-descuento-0001', }, body: JSON.stringify({ 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, }, ], }),});const data = await response.json();{ "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" }}Nota de crédito a una boleta
Sección titulada «Nota de crédito a una boleta»Las notas de una boleta usan una serie que empieza con B (BC01). Aquí el cliente devuelve uno de los dos cafés.
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 } ] }'use Illuminate\Support\Facades\Http;
$response = Http::withToken('sk_test_...') ->withHeaders(['Idempotency-Key' => 'pos-0042-devolucion-01']) ->post('https://faktura-test.cgallardo.me/v1/credit-notes', [ 'affected_document_id' => '<id-de-la-boleta>', 'series' => 'BC01', 'reason_code' => '07', 'items' => [ [ 'description' => 'Cafe americano', 'quantity' => 1, 'unit_price' => 8.00, ], ], ]);
$data = $response->json();const response = await fetch('https://faktura-test.cgallardo.me/v1/credit-notes', { method: 'POST', headers: { Authorization: 'Bearer sk_test_...', 'Content-Type': 'application/json', 'Idempotency-Key': 'pos-0042-devolucion-01', }, body: JSON.stringify({ affected_document_id: '<id-de-la-boleta>', series: 'BC01', reason_code: '07', items: [{ description: 'Cafe americano', quantity: 1, unit_price: 8.00 }], }),});const data = await response.json();{ "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" }}Nota de débito por penalidad
Sección titulada «Nota de débito por penalidad»La nota de débito aumenta el monto del comprobante. Sus items son obligatorios.
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 } ] }'use Illuminate\Support\Facades\Http;
$response = Http::withToken('sk_test_...') ->withHeaders(['Idempotency-Key' => 'erp-penalidad-0001']) ->post('https://faktura-test.cgallardo.me/v1/debit-notes', [ '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, ], ], ]);
$data = $response->json();const response = await fetch('https://faktura-test.cgallardo.me/v1/debit-notes', { method: 'POST', headers: { Authorization: 'Bearer sk_test_...', 'Content-Type': 'application/json', 'Idempotency-Key': 'erp-penalidad-0001', }, body: JSON.stringify({ 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, }, ], }),});const data = await response.json();{ "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" }}Anular una boleta
Sección titulada «Anular una boleta»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.
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" }'use Illuminate\Support\Facades\Http;
$response = Http::withToken('sk_test_...') ->post('https://faktura-test.cgallardo.me/v1/documents/<id-de-la-boleta>/void', ['reason' => 'Venta duplicada']);
$data = $response->json();const response = await fetch('https://faktura-test.cgallardo.me/v1/documents/<id-de-la-boleta>/void', { method: 'POST', headers: { Authorization: 'Bearer sk_test_...', 'Content-Type': 'application/json', }, body: JSON.stringify({ reason: 'Venta duplicada' }),});const data = await response.json();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).