Avoirs

Corrigez légalement une facture finalisée avec un avoir.

POST /api/v1/invoices/{invoiceId}/credit-note · droit invoices:write

Omettez amountTtc pour annuler la totalité. Indiquez un montant TTC positif pour un avoir partiel ; YAOKA produit automatiquement le document avec des montants négatifs.

curl https://api.yaoka.fr/api/v1/invoices/invoice_123/credit-note \
  -H "Authorization: Bearer $YAOKA_API_KEY" \
  -H "X-Yaoka-Organization-Id: $YAOKA_ORG_ID" \
  -H "Idempotency-Key: credit-invoice-123-v1" \
  -H "Content-Type: application/json" \
  -d '{"reason":"Remise commerciale après facturation","amountTtc":"24.00"}'

L’avoir reçoit son propre numéro légal et son propre PDF, conserve fromInvoiceId, puis est transmis à Pennylane. La somme des avoirs ne peut pas dépasser le TTC de la facture d’origine.

reason est obligatoire (2 à 500 caractères). amountTtc est une chaîne décimale positive facultative. L’avoir est finalisé immédiatement : il n’existe pas de brouillon d’avoir via cette opération.

Disponibilité des fonctions Clients