Comment commencer à utiliser l'API ?

Créez une clé d'API dans « Réglages », « Clés d'API », envoyez-la dans l'en-tête « Authorization: Bearer … », puis appelez GET /v1/me pour vérifier la société et les permissions de la clé. La documentation interactive est sur /docs et le contrat OpenAPI sur /openapi.yaml, à l'adresse de l'API.

Les trois premiers pas

1. Une clé. Un propriétaire ou un administrateur la crée dans « Réglages », « Clés d'API », avec les seuls droits utiles.

2. Un premier appel.

   curl -H "Authorization: Bearer qiv_…" https://<adresse de l'API>/v1/me
   

   La réponse liste, dans tenants, l'unique société de la clé avec ses permissions.

3. Le contrat. Ouvrez /docs sur la même adresse pour la documentation, ou récupérez /openapi.yaml pour générer un client.

Le cycle d'une facture

1. POST /v1/invoices crée un brouillon, sans numéro.
2. POST /v1/invoices/{id}/issue l'émet : numéro légal attribué, facture immuable.
3. POST /v1/invoices/{id}/submit la dépose chez la plateforme agréée.
4. Une facture émise se corrige par un avoir : POST /v1/invoices/{id}/credit-notes.

Les formats électroniques (/einvoice, /facturx) ne se produisent qu'à partir d'une facture émise.

Pourquoi l'interface web n'a aucun privilège

L'interface de QInvoice passe par les mêmes routes et les mêmes permissions que votre intégration. Ce qu'elle sait faire, l'API le sait aussi.

Mis à jour le 30 septembre 2026.