Factures client

Récupération de la liste des factures

GET /api/v1/invoice/

Paramètres de requête

Nom	Type	Description	Obligatoire
invoice_number	string	Numéro de facture	Non
accounting_date_lt	string	Date comptable inférieure ou égale (format YYYY-MM-DD)	Non
accounting_date_gt	string	Date comptable supérieure ou égale (format YYYY-MM-DD)	Non
cursor	string	Curseur pour la pagination	Non
page_size	integer	Nombre d'éléments par page (défaut: 20)	Non

Réponse

Nom	Type	Description
page_size	integer	Nombre d'éléments par page
count	integer	Nombre total d'éléments
next_page	string	URL de la page suivante
previous_page	string	URL de la page précédente
results	array	Liste des factures

Détail d'une facture

Nom	Type	Description
invoice_number	string	Numéro de la facture
customer_name	string	Nom du client
billing_site_ref	string	Référence du site de facturation
billing_site_name	string	Nom du site de facturation
invoice_type	integer	Type de facture
invoice_type_label	string	Libellé du type de facture
accounting_date	string	Date comptable
payment_deadline	string	Date limite de paiement

Exemple

{
  "page_size": 20,
  "count": 150,
  "next_page": "http://api.example.com/api/v1/invoice/?cursor=2&page_size=20",
  "previous_page": null,
  "results": [
    {
      "invoice_number": "FACTTSO25100246",
      "customer_name": "CLIENT EXAMPLE SA",
      "billing_site_ref": "SITE001",
      "billing_site_name": "Site Principal",
      "invoice_type": 1,
      "invoice_type_label": "Facture Standard",
      "accounting_date": "2025-10-27",
      "payment_deadline": "2025-11-26"
    }
  ]
}

Téléchargement d'une facture

GET /api/v1/invoice/{invoice_number}/download/

Paramètres de la requête

Nom	Type	Description	Obligatoire
invoice_number	string	Numéro de la facture	Oui

Réponse

Le contenu du fichier PDF de la facture au format binaire.

En-têtes de réponse

En-tête	Valeur
Content-Type	application/pdf
Content-Disposition	attachment; filename={invoice_number}.pdf

Gestion des erreurs

Code HTTP	Description
200	Succès
401	Utilisateur non authentifié
403	Permission refusée
404	Facture non trouvée
500	Erreur interne du serveur