CYCLE COMPLET
Créez, émettez, encaissez et corrigez depuis votre code.
POST /api/v1/facturas crée un brouillon. Ensuite, sur la même facture, vous l’émettez, l’envoyez avec le PDF en pièce jointe, enregistrez un paiement total ou partiel, l’annulez ou générez un avoir. Chaque action déclenche son événement : votre système peut réagir par webhook.
- Brouillon d’abord : rien n’est transmis à l’administration tant que vous n’émettez pas
- Paiements partiels plafonnés au solde réel
- invoice.finalized, invoice.paid et invoice.voided en webhooks
POST /api/v1/facturas # brouillon
{ "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 # e-mail avec le PDF en pièce jointe
POST /api/v1/facturas/f3a8… { "action": "payment", "monto": 5000 }
← 200 saldo: 9875.00 # paiement partiel