API Factures

Listez, récupérez et importez des factures via l'API FactPilot.

Lister les factures

GET /api/v1/invoices

Paramètres de requête :

Paramètre	Type	Description
`dossier_id`	string	Identifiant du dossier (requis)
`status`	string	Filtre : `pending`, `validated`, `exported`
`date_from`	date	Date de début au format YYYY-MM-DD
`date_to`	date	Date de fin au format YYYY-MM-DD

Exemple de réponse :

{
  "data": [
    {
      "id": "inv_01HXK3P7QM2N4T8RVWZB",
      "montant_ht": 1250.00,
      "montant_tva": 250.00,
      "montant_ttc": 1500.00,
      "fournisseur": "SARL Dupont Fournitures",
      "siret": "12345678900012",
      "date_facture": "2024-03-15",
      "status": "validated"
    }
  ],
  "meta": { "total": 42, "page": 1, "per_page": 25 }
}

Récupérer une facture

GET /api/v1/invoices/{id}

Retourne le détail complet d'une facture, incluant les champs extraits par l'IA et le statut de traitement.

Importer une facture

POST /api/v1/invoices
Content-Type: multipart/form-data

Corps de la requête (multipart) :

Champ	Type	Description
`file`	file	Fichier PDF, JPG ou PNG (requis)
`dossier_id`	string	Identifiant du dossier (requis)

L'extraction IA démarre automatiquement après l'import. Consultez le statut via GET /api/v1/invoices/{id} — passera à validated une fois le traitement terminé.