Ir al contenido

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: el totals.total menos 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.

Ventana de terminal
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" }
]
}
}'

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