CICLO COMPLETO
Crea, emite, cobra y corrige desde tu código.
POST /api/v1/facturas crea un borrador. Después, sobre la misma factura, emites, envías con el PDF adjunto, registras un pago total o parcial, anulas o generas una nota de crédito. Cada acción dispara su evento, así que tu sistema puede reaccionar por webhook.
- Borrador primero: nada llega a la autoridad hasta que emites
- Pagos parciales acotados al saldo real
- invoice.finalized, invoice.paid e invoice.voided como webhooks
POST /api/v1/facturas # borrador
{ "cliente_id": "9b41…", "items": [ … ] }
← 200 { "id": "f3a8d1c4-…" }
POST /api/v1/facturas/f3a8… { "action": "finalize" }
← 200 estado_fiscal: "issued" # invoice.finalized
POST /api/v1/facturas/f3a8… { "action": "send" }
← 200 # correo con el PDF adjunto
POST /api/v1/facturas/f3a8… { "action": "payment", "monto": 5000 }
← 200 saldo: 9875.00 # abono parcial