Émettre votre première facture d'essai
Votre logiciel crée une facture, la relit et la finalise en mode essai. Rien de ce que vous faites ici n'a de valeur fiscale.
À savoir. Une clé d'essai commence par eiv_test_. Elle ne produit jamais de numéro légal et ne voit jamais vos documents réels.
1. Récupérez votre clé et votre entreprise
Dans FakturBi, menu Développeurs › Clés API, créez une clé d'essai pour l'entreprise qui émettra les factures. Notez aussi son identifiant (issuerId).
export EINVOICING_API_BASE_URL='[URL_API]/v1/einvoicing' export EINVOICING_API_KEY='eiv_test_…' export EINVOICING_ISSUER_ID='…'
2. Créez un brouillon
L'en-tête Idempotency-Key rend la requête rejouable : si votre réseau coupe, renvoyez-la telle quelle, vous retrouverez le même brouillon.
curl -X POST "$EINVOICING_API_BASE_URL/invoices" \
-H "Authorization: Bearer $EINVOICING_API_KEY" \
-H "Idempotency-Key: commande-4582" \
-H "Content-Type: application/json" \
-d '{
"issuerId": "'"$EINVOICING_ISSUER_ID"'",
"currency": "XOF",
"recipient": { "name": "Client Exemple", "address": "Dakar", "country": "SN" },
"lines": [ { "description": "Prestation de service", "quantity": 1, "unitPrice": 25000 } ]
}'
La réponse contient le numéro d'essai du brouillon, par exemple TEST-2026-42A608117D, son statut DRAFT et l'identifiant de chaque ligne.
3. Prévisualisez, puis finalisez
L'aperçu renvoie un PDF marqué « Document de test — sans valeur fiscale ». La finalisation fige le document : une correction passera ensuite par un avoir.
curl "$EINVOICING_API_BASE_URL/invoices/TEST-2026-42A608117D/preview" \ -H "Authorization: Bearer $EINVOICING_API_KEY" -o apercu.pdf curl -X POST "$EINVOICING_API_BASE_URL/invoices/TEST-2026-42A608117D/finalize" \ -H "Authorization: Bearer $EINVOICING_API_KEY"
C'est fait. Votre facture d'essai est finalisée. Vous la retrouvez dans FakturBi, onglet Essai.