API Reference
Factures
Consultation, telechargement PDF et suivi de paiement.
Les endpoints factures sont sous /api/v1/invoices.
Endpoints
| Methode | Path | Description |
|---|---|---|
| GET | /invoices | Liste des factures |
| GET | /invoices/{id} | Detail d'une facture |
| GET | /invoices/{id}/download-pdf | Telecharger la facture en PDF |
| GET | /invoices/{id}/payment-status | Statut de paiement |
| GET | /invoices/by-order/{number} | Factures liees a une commande |
| POST | /invoices/sync | Declencher la synchronisation |
Source des donnees
Les factures proviennent de Cegid et sont synchronisees dans PostgreSQL (tables invoices et invoice_items). La synchronisation peut etre declenchee manuellement via /invoices/sync ou automatiquement via les scripts de sync.
Les factures PDF sont stockees dans MinIO S3 sous le prefixe invoices/{customer_id}/. Le telecharger via l'endpoint /download-pdf qui renvoie le fichier directement.
Liaison commande-facture
La table invoice_order_links fait le lien entre les factures et les commandes d'origine. Cela permet d'afficher les factures associees a une commande dans l'interface.