3 API3.5
Annuler avant la transmission
Arrêter une facture avant sa transmission.
- Dans le bac à sable
En termes simples
Cet appel arrête une facture qui n’a pas encore atteint le canal ; au-delà, la correction passe par un avoir.
POST /invoices/{id}/cancel arrête une facture que le canal n’a pas encore reçue. Il fonctionne tant que la facture est received, validated ou queued et qu’aucun envoi n’est en cours. Au-delà, l’annulation relève d’un document commercial : émettez un avoir.
L’appel nécessite une clé dotée de la portée submit et un en-tête Idempotency-Key (de 8 à 100 caractères). La requête n’a pas de corps.
Annulée à temps
La facture passe à cancelled, et sa tâche en file d’attente est abandonnée.
curl -X POST "https://api-sandbox-eu.eurinvoice.com/invoices/inv_ae4d9834bf251353532fe5ee/cancel" \
-H "Authorization: Bearer <your-api-key>" \
-H "Idempotency-Key: cancel-2026-0001"import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Example {
public static void main(String[] args) throws Exception {
HttpRequest request = HttpRequest.newBuilder(URI.create("https://api-sandbox-eu.eurinvoice.com/invoices/inv_ae4d9834bf251353532fe5ee/cancel"))
.header("Authorization", "Bearer <your-api-key>")
.header("Idempotency-Key", "cancel-2026-0001")
.POST(HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}const response = await fetch('https://api-sandbox-eu.eurinvoice.com/invoices/inv_ae4d9834bf251353532fe5ee/cancel', {
method: 'POST',
headers: {
Authorization: 'Bearer <your-api-key>',
'Idempotency-Key': 'cancel-2026-0001',
},
});
console.log(response.status);
console.log(await response.text());{
"invoice_ref": "FRESH-mux3dlqm-0",
"environment": "sandbox",
"document_sha256": "b341c81da6fe297787829a8c26fd4b25106b5b34e67482d38c1039651bbfed65",
"route": "DE-XRECHNUNG",
"updated_at": "2026-10-06T19:49:10.992Z",
"client": "acme-srl",
"created_at": "2026-10-06T19:49:10.816Z",
"id": "inv_ae4d9834bf251353532fe5ee",
"state": "cancelled",
"invoice_number": "FRESH-mux3dlqm-0"
}Trop tard
Une fois que le canal a reçu la facture, ou qu’un envoi est en cours, la réponse est 409.
curl -X POST "https://api-sandbox-eu.eurinvoice.com/invoices/inv_936a93e38de84e7b0a1d7681/cancel" \
-H "Authorization: Bearer <your-api-key>" \
-H "Idempotency-Key: cancel-2026-0002"import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Example {
public static void main(String[] args) throws Exception {
HttpRequest request = HttpRequest.newBuilder(URI.create("https://api-sandbox-eu.eurinvoice.com/invoices/inv_936a93e38de84e7b0a1d7681/cancel"))
.header("Authorization", "Bearer <your-api-key>")
.header("Idempotency-Key", "cancel-2026-0002")
.POST(HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}const response = await fetch('https://api-sandbox-eu.eurinvoice.com/invoices/inv_936a93e38de84e7b0a1d7681/cancel', {
method: 'POST',
headers: {
Authorization: 'Bearer <your-api-key>',
'Idempotency-Key': 'cancel-2026-0002',
},
});
console.log(response.status);
console.log(await response.text());{
"type": "https://eurinvoice.com/problems/already-submitted",
"title": "Already submitted to the route; issue a credit note instead",
"status": 409
}Réponses
| Statut | Signification |
|---|---|
200 | Annulée. Le corps est la facture. |
400 | L’en-tête Idempotency-Key est absent ou ne compte pas de 8 à 100 caractères. |
401 | Aucune clé, ou une clé inconnue. |
403 | La clé n’a pas la portée submit. |
404 | Cette facture n’existe pas pour ce client. |
409 | Déjà transmise (already-submitted), ou un envoi est en cours (send-in-progress). Émettez un avoir, ou attendez le résultat. Pour une facture dead_letter, la clé d’un client reçoit dead-letter : c’est à nous de trancher. |
429 | Trop de requêtes pour la clé. Attendez Retry-After secondes. |
Annuler une facture déjà annulée renvoie 200 avec la même facture : un nouvel essai après une réponse perdue est donc sans risque. Une facture en file d’attente est prise en charge en quelques secondes : la fenêtre d’annulation est donc courte. Si un envoi a été tenté et que sa réponse s’est perdue, la facture est en submitting et l’annulation répond send-in-progress, car le canal peut l’avoir reçue.