Facture
Lister les factures
GET /v3/products/{productId}/invoices — rechercher et paginer les factures d'un produit.
GET /v3/products/{productId}/invoices?status=OPEN&limit=20
Authorization: Bearer <token>Renvoie les factures du produit, de la plus récente à la plus ancienne (createdAt décroissant).
Paramètres de query
Tous les paramètres sont optionnels ; tout paramètre inconnu est rejeté (400 INVALID_REQUEST).
| Paramètre | Type | Description |
|---|---|---|
status | enum | OPEN, PAID ou CANCELLED. |
partnerInvoiceReference | chaîne | Égalité stricte sur la référence partenaire. |
createdFrom | date | Borne basse incluse sur createdAt (ISO 8601 avec décalage). |
createdTo | date | Borne haute incluse sur createdAt (ISO 8601 avec décalage). |
limit | entier | Taille de page, de 1 à 100. Défaut : 20. |
cursor | chaîne | Valeur de nextCursor de la page précédente. |
Réponse 200
{
"items": [
{
"id": "0f8b7a3e-6c2d-4b1a-9e8f-5d4c3b2a1f0e",
"productId": "2f8a9d1e-1c4b-4f37-9a55-6c0a9d3f1b02",
"partnerInvoiceReference": "INV-2025-0001",
"status": "OPEN",
"amount": { "value": 2500, "currency": "EUR" },
"customer": { "externalId": "CUST-987" },
"createdAt": "2025-03-01T10:15:00.000Z",
"paidAt": null,
"cancelledAt": null,
"qrCode": {
"format": "datamatrix",
"content": "8d6c1f0e-1d0b-4f8e-9f5a-3c1e2b4d5a6f;5d41402abc4b2a76b9719d911017c592",
"expiresAt": "2025-03-01T11:15:00.000Z"
}
}
],
"nextCursor": "eyJpZCI6IjBmOGI3YTNlLTZjMmQtNGIxYS05ZThmLTVkNGMzYjJhMWYwZSJ9"
}Chaque élément a la même forme qu'une facture ; qrCode n'est présent que pour les
factures OPEN.
Pagination
Appelez l'endpoint sans cursor.
Si nextCursor est non nul, rappelez l'endpoint avec cursor=<nextCursor> et les mêmes
filtres.
Arrêtez-vous quand nextCursor vaut null : c'est la dernière page.
Le curseur est opaque : ne le construisez pas et ne l'interprétez pas. Un curseur mal formé
renvoie 400 INVALID_CURSOR.
Erreurs
| Statut | Code | Cause |
|---|---|---|
400 | INVALID_REQUEST | Paramètre invalide ou inconnu, limit hors bornes. |
400 | INVALID_CURSOR | Curseur illisible. |
400 | INVALID_DATE_RANGE | createdFrom postérieur à createdTo. |
401 | MISSING_PARTNER_ID | Identifiant partenaire absent. |
404 | PRODUCT_NOT_FOUND | Produit inexistant ou appartenant à un autre partenaire. |