Notas de débito

Una nota de débito suma valores a una factura ya autorizada: intereses por mora, gastos de cobranza, una diferencia de precio a favor del vendedor. Es lo contrario de la nota de crédito. Tiene el mismo ciclo que una factura (pending → authorized/rejected).

curl https://api.chaski.ec/v1/debit-notes \
  -H "Authorization: Bearer $CHASKI_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: mora-octubre-88" \
  -d '{
    "invoice": "inv_01jbx3k9q2f8m4tn6vwz0yh5ce",
    "reasons": [
      { "description": "Intereses por mora, octubre", "amount": "12.35", "iva_rate": "15" },
      { "description": "Reposición de documento", "amount": "2.50", "iva_rate": "0" }
    ]
  }'

• El emisor, el punto de emisión y el comprador salen de la factura, que tiene que estar authorized. Sobre una factura anulada no se puede: 409 invoice_voided.
• Cada motivo lleva su valor sin IVA (amount, hasta 2 decimales) y su tarifa (iva_rate: 0, 5, 15, exempt o not_subject). El IVA se calcula por tarifa y la respuesta trae totals.subtotal, totals.taxes y totals.total.
• No hay tope: la nota suma a la factura, así que no le quita saldo a las notas de crédito.
• payments es opcional. Si lo envías, debe sumar el total (con una sola forma de pago, el monto se puede omitir).

Las notas de débito se consultan, descargan y reenvían igual que las facturas, en /v1/debit-notes. Para ver las de una factura: GET /v1/debit-notes?invoice=inv_…. Los webhooks son debit_note.authorized, debit_note.rejected y debit_note.failed. En producción, cada nota consume cuota igual que una factura.