Puis-je rejouer une requête sans risquer de doublon ?
Il n'y a pas d'en-tête Idempotency-Key générique. En revanche, les opérations qui comptent le sont par nature : un dépôt rejoué rend le dépôt existant, un devis transformé une seconde fois rend la même facture, et une facture ne s'émet qu'une fois. Une création (POST /v1/invoices) rejouée crée un second brouillon.
| Opération | Rejouée après une coupure |
|---|---|
POST /v1/invoices/{id}/submit (dépôt) |
Rend le dépôt existant, sans en créer un second. |
POST /v1/quotes/{id}/invoice (devis en facture) |
Rend la facture déjà créée (200). |
POST /v1/invoices/{id}/issue (émission) |
Une facture déjà émise ne peut pas l'être deux fois : refus 409 invoice_already_issued. |
POST /v1/invoices (brouillon) |
Crée un second brouillon. |
Après une coupure sur une création
Relisez la liste (GET /v1/invoices, les plus récentes d'abord) avant de
recréer. Un brouillon en trop n'a pas de numéro : il se supprime sans laisser
de trou dans la série.
Pourquoi ces opérations-là
Une facture déposée deux fois serait déclarée deux fois ; un devis facturé deux fois ferait payer deux fois la même commande ; un numéro attribué deux fois casserait la série légale. Un brouillon, lui, n'engage rien.
Mis à jour le 30 septembre 2026.