FFakturBi Documentation

Émettre votre première facture d'essai

Mise à jour : novembre 20265 min de lectureAPI v1

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.

4. Et ensuite

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