FFakturBi Référence API

Créer une facture

POST/v1/einvoicing/invoices

Crée un brouillon de facture pour une entreprise émettrice. Le brouillon reçoit un numéro provisoire, se modifie librement, puis se finalise. Droit requis : invoices:write.

En-têtes

Authorizationrequis
Bearer eiv_test_… ou clé réelle. Le mode de la clé décide du mode du document.
Idempotency-Keytexte, 200 max.
Rejouer la même requête avec la même clé renvoie le même brouillon, sans doublon. Recommandé.

Corps

issuerIduuid
Entreprise émettrice. Exigé par une clé rattachée à des entreprises ; il ne change plus ensuite.
currencytexterequis
XOF, EUR, USD ou NGN.
recipientobjetrequis
Client facturé : name (requis), address, country (2 lettres), taxId, email, phone.
linesliste, 200 max.requis
Chaque ligne : description, quantity, unitPrice.
amountIncludesTaxbooléen
Vrai si vos prix sont TTC. FakturBi calcule alors la TVA et conserve exactement le total transmis.
invoiceDate, dueDatedate
Date de facture et échéance, au format AAAA-MM-JJ.
sourceRefobjet
Référence dans votre système : app, type, id. Une même référence ne crée jamais deux factures.

Erreurs fréquentes

400
Champ manquant ou invalide. Le message indique lequel.
FISC-ISSUER-REQUIRED
Votre clé exige issuerId.
FISC-ENVIRONMENT-MISMATCH
Le mode demandé ne correspond pas à la clé.