Guía: factura al crédito con cuotas
SUNAT exige indicar en cada factura si se paga al contado o al crédito y, si es al crédito, el monto y el vencimiento de cada cuota.
- Solo facturas (
POST /v1/invoices). - De 1 a 60 cuotas.
- Cada cuota con monto mayor que cero y vencimiento posterior a la fecha de emisión.
- La suma de las cuotas debe ser exactamente el neto pendiente de pago (
net_payable: eltotals.totalmenos la detracción o la retención del IGV, si las hay).
Como la API calcula el total, conviene calcularlo antes con las mismas reglas (Cálculo de impuestos) o, si trabajas con precios sin IGV, sumar base más 18 % redondeado por línea.
Ejemplo: consultoría en dólares, a 2 cuotas
Sección titulada «Ejemplo: consultoría en dólares, a 2 cuotas»3 horas a USD 10.555 sin IGV → base 31.67 + IGV 5.70 = total 37.37.
curl -X POST https://faktura-test.cgallardo.me/v1/invoices \ -H "Authorization: Bearer $FAKTURA_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: erp-pedido-8842" \ -d '{ "series": "F001", "currency": "USD", "price_includes_tax": false, "customer": { "doc_type": "RUC", "doc_number": "20131312955", "name": "CLIENTE DE PRUEBA S.A.C." }, "items": [ { "description": "Consultoría", "quantity": 3, "unit_price": 10.555, "unit_code": "HUR" } ], "payment": { "type": "credito", "installments": [ { "amount": 20.00, "due_date": "2026-12-15" }, { "amount": 17.37, "due_date": "2027-01-15" } ] } }'use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('FAKTURA_KEY')) ->withHeaders(['Idempotency-Key' => 'erp-pedido-8842']) ->post('https://faktura-test.cgallardo.me/v1/invoices', [ 'series' => 'F001', 'currency' => 'USD', 'price_includes_tax' => false, 'customer' => [ 'doc_type' => 'RUC', 'doc_number' => '20131312955', 'name' => 'CLIENTE DE PRUEBA S.A.C.', ], 'items' => [ [ 'description' => 'Consultoría', 'quantity' => 3, 'unit_price' => 10.555, 'unit_code' => 'HUR', ], ], 'payment' => [ 'type' => 'credito', 'installments' => [ ['amount' => 20.00, 'due_date' => '2026-12-15'], ['amount' => 17.37, 'due_date' => '2027-01-15'], ], ], ]);
$data = $response->json();const response = await fetch('https://faktura-test.cgallardo.me/v1/invoices', { method: 'POST', headers: { Authorization: `Bearer ${process.env.FAKTURA_KEY}`, 'Content-Type': 'application/json', 'Idempotency-Key': 'erp-pedido-8842', }, body: JSON.stringify({ series: 'F001', currency: 'USD', price_includes_tax: false, customer: { doc_type: 'RUC', doc_number: '20131312955', name: 'CLIENTE DE PRUEBA S.A.C.', }, items: [ { description: 'Consultoría', quantity: 3, unit_price: 10.555, unit_code: 'HUR', }, ], payment: { type: 'credito', installments: [ { amount: 20.00, due_date: '2026-12-15' }, { amount: 17.37, due_date: '2027-01-15' }, ], }, }),});const data = await response.json();La respuesta incluye:
{ "totals": { "taxed": "31.67", "exempt": "0.00", "unaffected": "0.00", "free": "0.00", "igv": "5.70", "icbper": "0.00", "total_taxes": "5.70", "discounts": "0.00", "charges": "0.00", "total": "37.37" }, "amount_in_words": "SON TREINTA Y SIETE CON 37/100 DÓLARES AMERICANOS", "payment": { "type": "credito", "installments": [ { "amount": "20.00", "due_date": "2026-12-15" }, { "amount": "17.37", "due_date": "2027-01-15" } ] }}Errores frecuentes
Sección titulada «Errores frecuentes»reason |
Causa |
|---|---|
InstallmentsDoNotMatchTotal |
Las cuotas suman distinto del total (revisa los redondeos). |
InvalidInstallments |
Una cuota vence hoy o antes, tiene monto cero, o hay más de 60. |
ValidationFailed con payment.installments:RequiredIf |
Indicaste credito sin cuotas. |