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
AuthorizationrequisBearer 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
issuerIduuidEntreprise émettrice. Exigé par une clé rattachée à des entreprises ; il ne change plus ensuite.
currencytexterequisXOF, EUR, USD ou NGN.recipientobjetrequisClient facturé :
name (requis), address, country (2 lettres), taxId, email, phone.linesliste, 200 max.requisChaque ligne :
description, quantity, unitPrice.amountIncludesTaxbooléenVrai si vos prix sont TTC. FakturBi calcule alors la TVA et conserve exactement le total transmis.
invoiceDate, dueDatedateDate de facture et échéance, au format
AAAA-MM-JJ.sourceRefobjetRéférence dans votre système :
app, type, id. Une même référence ne crée jamais deux factures.Erreurs fréquentes
400Champ manquant ou invalide. Le message indique lequel.
FISC-ISSUER-REQUIREDVotre clé exige
issuerId.FISC-ENVIRONMENT-MISMATCHLe mode demandé ne correspond pas à la clé.