CICLO COMPLETO
Crie, emita, receba e corrija pelo seu código.
POST /api/v1/facturas cria um rascunho. Depois, sobre a mesma fatura, você emite, envia com o PDF anexado, registra um pagamento total ou parcial, cancela ou gera uma nota de crédito. Cada ação dispara seu evento, então seu sistema pode reagir por webhook.
- Rascunho primeiro: nada chega à autoridade até você emitir
- Pagamentos parciais limitados ao saldo real
- invoice.finalized, invoice.paid e invoice.voided como webhooks
POST /api/v1/facturas # rascunho
{ "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 com o PDF anexado
POST /api/v1/facturas/f3a8… { "action": "payment", "monto": 5000 }
← 200 saldo: 9875.00 # pagamento parcial