FFakturBi Documentation

Corriger une facture par un avoir

Mise à jour : novembre 20265 min de lectureAPI v1

Une facture finalisée ne se modifie pas. Un avoir la corrige, en tout ou en partie, et reste lié à elle.

1. Créer le brouillon d'avoir

Indiquez la facture d'origine, le type (TOTAL ou PARTIAL) et le motif. Pour un avoir partiel, chaque ligne cite l'identifiant de la ligne d'origine (lineId, renvoyé à la lecture de la facture) et le montant hors taxe à retirer.

curl -X POST "$EINVOICING_API_BASE_URL/credit-notes" \
  -H "Authorization: Bearer $EINVOICING_API_KEY" \
  -H "Idempotency-Key: avoir-4582-1" \
  -H "Content-Type: application/json" \
  -d '{
    "originalInvoiceNumber": "TEST-2026-42A608117D",
    "kind": "PARTIAL",
    "reasonCode": "ERREUR_PRIX",
    "reasonText": "Remise oubliée",
    "lines": [ { "originalLineId": 1, "netAmount": 5000 } ]
  }'

2. Ce qui est contrôlé

SituationRéponse
Montant supérieur à ce qui reste à corrigerFISC-CREDIT-NOTE-EXCEEDS-REMAINING (409)
Facture déjà entièrement corrigéeFISC-CREDIT-NOTE-FULLY-CREDITED (409)
Facture encore en brouillonFISC-CREDIT-NOTE-ORIGINAL-NOT-FINALIZED

Le motif reasonCode s'écrit en majuscules, chiffres et _ (2 à 40 caractères).

3. Finaliser

POST /credit-notes/{numéro}/finalize attribue le numéro de l'avoir dans sa propre suite. Un avoir ne rembourse rien : le remboursement passe par votre moyen d'encaissement.

Cette page vous a-t-elle aidé ? Oui · Non