---
name: faktura-guia-factura-al-credito-con-cuotas
description: "Guía: factura al crédito con cuotas con la API de Faktura (facturación electrónica SUNAT, Perú). 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. Úsala cuando integres esta operación desde tu sistema."
---

# Skill: Guía: factura al crédito con cuotas — Faktura API

## Propósito

Le da a tu asistente el contexto para **guía: factura al crédito con cuotas** con la API de Faktura: 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.

Instalación en Claude Code: guarda este archivo como `.claude/skills/faktura-guia-factura-al-credito-con-cuotas/SKILL.md` en tu proyecto. Fuente: https://faktura-doc.cgallardo.me/guias/factura-al-credito/

## Autenticación y cabeceras

- `Authorization: Bearer <api key>`. En pruebas, una clave `sk_test_` (SUNAT beta, sin valor tributario); en producción, la `sk_live_`. El ambiente lo decide la clave.
- `Content-Type: application/json` en las peticiones con cuerpo.
- `Idempotency-Key` (recomendada al emitir): repetir la petición con la misma clave y el mismo cuerpo devuelve el mismo comprobante, sin duplicarlo.
- Errores: JSON `{ "reason": "<código>", "details": [...] }`. `401` clave inválida o vencida, `403` alcance insuficiente, `422` datos inválidos, `429` límite de 120 peticiones por minuto (respeta `Retry-After`), `500` solo con `traceId`.

## Reglas

- 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](https://faktura-doc.cgallardo.me/calculo-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

3 horas a USD 10.555 sin IGV → base 31.67 + IGV 5.70 = total **37.37**.

```bash
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:

```json
{
  "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

| `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. |

## Reglas generales de la API

- Montos en las respuestas como texto decimal (`"16.00"`); en las peticiones, número o texto.
- Fechas `YYYY-MM-DD` en hora de Perú (`America/Lima`); identificadores UUID.
- Un comprobante emitido responde `201` con `status: "pending"`: el número ya es tuyo. El resultado de SUNAT llega después (webhook o `GET /v1/documents/{id}`).
- Documentación completa: https://faktura-doc.cgallardo.me/ · Toda la API en una skill: https://faktura-doc.cgallardo.me/skills/faktura-api.md
