Clozo pour les développeurs
Une API HTTP avec un schéma publié
Émettez, transmettez et rapprochez vos factures depuis votre propre système. Le schéma est publié et consultable ; clés, webhooks et consommation se gèrent en libre-service dans votre espace de travail.
Ouvrir la référence de l'APILa référence est générée à partir du service en fonctionnement : elle ne peut pas décrire une version précédente.
Démarrage rapide
curl https://api.useclozo.com/b2b/v1/documents \
-X POST \
-H "Authorization: Bearer clz_live_<keyid>_<secret>" \
-H "Idempotency-Key: order-4471-v1" \
-H "Content-Type: application/json" \
-d '{
"issuer_id": "3f6c1b8e-2d4a-4e7b-9a15-6c0d2e8f7a41",
"customer": {
"name": "Kestrel Logistics GmbH",
"country": "DE",
"vat_number": "DE123456789"
},
"currency": "EUR",
"line_items": [
{
"description": "Consulting, October",
"quantity": "1",
"unit_amount": 395000,
"tax_rate": 0,
"tax_category": "AE"
}
]
}'HTTP/1.1 201 Created
{
"object": "document",
"id": "doc_5Hq2m8Zr4Kd9",
"issuer_id": "3f6c1b8e-2d4a-4e7b-9a15-6c0d2e8f7a41",
"issuer_country": "NL",
"currency": "EUR",
"subtotal": 395000,
"tax_total": 0,
"total": 395000,
"reverse_charge": true,
"status_bucket": "created",
"status_detail": "draft",
"invoice_number": ""
}
// ...Créez une clé d'API dans votre espace de travail, puis envoyez-la comme jeton Bearer. Les requêtes qui créent ou émettent des documents ou enregistrent des mouvements d'argent acceptent un Idempotency-Key : une nouvelle tentative ne crée jamais de doublon. issuer_id est l'UUID de l'une de vos entités juridiques.
Une règle à lire avant de commencer
L'organisation est déduite du credential, jamais d'un paramètre de requête. Une clé émise pour une organisation ne peut pas en adresser une autre — il n'y a pas d'identifiant d'organisation à transmettre, et aucun moyen d'élargir la portée en modifiant la requête. Les limites de débit sont renvoyées par des en-têtes X-RateLimit, en succès comme en 429.
Ce que couvre l'API
Tout ce qui figure ici est disponible aujourd'hui, sauf mention Accès anticipé.
Schéma publié et navigateur associé
Un schéma OpenAPI et une interface Swagger, servis par l'API elle-même. Générez votre client depuis le schéma au lieu de recopier les endpoints.
Clés d'API en libre-service, avec portées et rotation
Créez, faites tourner et révoquez vos clés dans votre espace de travail. La rotation délivre la nouvelle clé avant que l'ancienne cesse de fonctionner : un déploiement n'a pas besoin d'être simultané.
Webhooks signés, journal de livraison et rejeu
Enregistrez des endpoints, envoyez un événement d'exemple, consultez le journal de livraison et rejouez un événement ou toute la file des échecs. Une livraison manquée se rattrape sans avoir à nous solliciter.
Consommation lisible par vous
Ce que l'organisation a consommé, e-mail inclus, est un endpoint et non une question au support.
Exports filtrés
Extraits CSV et XLSX des mêmes données que vous pouvez lister via l'API.
Livraison de facture électronique via PeppolAccès anticipé. Accès anticipé : l'envoi et la réception via Peppol, KSeF et SdI sont en cours d'activation avec les clients en accès anticipé.
Livraison d'un document au participant Peppol du destinataire, avec l'état de livraison consultable via la même API. La page des pays indique où la facturation électronique est disponible.