FFakturBi Documentation

Rejouer une requête sans créer de doublon

Mise à jour : novembre 20264 min de lectureAPI v1

Un réseau coupe, un serveur redémarre. Avec une clé d'idempotence, vous renvoyez la même requête sans jamais créer deux factures.

1. La clé d'idempotence

Ajoutez l'en-tête Idempotency-Key (200 caractères au plus) à la création d'une facture, d'un avoir et à la finalisation. Choisissez une valeur liée à votre opération, par exemple le numéro de commande.

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 @facture.json

2. Ce qui se passe au rejeu

Vous renvoyezFakturBi répond
La même clé et le même contenuLe même résultat que la première fois, sans nouveau document
La même clé avec un autre contenuFISC-IDEMPOTENCY-CONFLICT (409) : rien n'est créé

3. Votre référence

Le champ sourceRef (app, type, id) désigne l'objet dans votre système. Une même référence ne crée jamais deux factures ; un contenu différent répond FISC-SOURCE-REFERENCE-CONFLICT (409).

4. Quand réessayer

Réessayez avec la même clé après une coupure réseau ou une réponse 5xx, en espaçant les essais (1 s, 2 s, 4 s…). Ne réessayez pas une réponse 4xx : corrigez d'abord la requête.

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