Factures

Créez, émettez et envoyez des factures, ou consultez votre historique via l'API.

Toutes les routes requièrent l'en-tête Authorization: Bearer em_live_…

GET/invoicesLister les factures

Retourne la liste paginée des factures de l'entreprise active.

Paramètres de requête

Paramètre	Type	Requis	Description
page	`integer`	Optionnel	Numéro de page (défaut : 1)
limit	`integer`	Optionnel	Résultats par page, max 100 (défaut : 20)
status	`string`	Optionnel	Filtrer par statut : draft, issued, sent, paid, overdue…
clientId	`uuid`	Optionnel	Filtrer par identifiant de client
search	`string`	Optionnel	Recherche textuelle (numéro, nom client)
from	`date`	Optionnel	Date d'émission min (ISO 8601)
to	`date`	Optionnel	Date d'émission max (ISO 8601)

Exemple

curl "https://api.emetia.fr/api/invoices?status=sent&limit=10" \
  -H "Authorization: Bearer em_live_VOTRE_CLE"

Réponse

{
  "data": [ { "id": "…", "invoiceNumber": "2024-001", … } ],
  "total": 42,
  "page": 1,
  "limit": 10,
  "totalPages": 5
}

GET/invoices/:idObtenir une facture

Retourne le détail complet d'une facture, y compris ses lignes, le client et l'entreprise émettrice.

curl "https://api.emetia.fr/api/invoices/INV_UUID" \
  -H "Authorization: Bearer em_live_VOTRE_CLE"

POST/invoicesCréer une facture

Crée une facture au statut brouillon (draft). Utilisez /issue pour l'émettre.

Corps de la requête

Paramètre	Type	Requis	Description
clientId	`uuid`	Requis	Identifiant du client destinataire
issueDate	`date`	Requis	Date d'émission (ISO 8601, ex. 2024-07-01)
dueDate	`date`	Requis	Date d'échéance
lines	`array`	Requis	Lignes de facturation (voir ci-dessous)
serviceDate	`date`	Optionnel	Date de prestation
taxRate	`number`	Optionnel	Taux de TVA global (ex. 20)
currency	`string`	Optionnel	Devise ISO 4217 (défaut : EUR)
description	`string`	Optionnel	Description générale
notes	`string`	Optionnel	Notes visibles sur la facture
format	`string`	Optionnel	pdf ou facturx (défaut : pdf)

Structure d'une ligne (`lines[]`)

Paramètre	Type	Requis	Description
description	`string`	Requis	Libellé de la ligne
quantity	`number`	Requis	Quantité
unitPrice	`integer`	Requis	Prix unitaire HT en centimes (ex. 10000 = 100 €)
taxRate	`number`	Requis	Taux de TVA de la ligne (ex. 20)
unit	`string`	Optionnel	Unité (h, j, pièce…)
lineNumber	`integer`	Optionnel	Ordre d'affichage

Exemple

curl -X POST "https://api.emetia.fr/api/invoices" \
  -H "Authorization: Bearer em_live_VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{
    "clientId": "CLIENT_UUID",
    "issueDate": "2024-07-01",
    "dueDate":   "2024-07-31",
    "lines": [
      {
        "description": "Développement web — juillet 2024",
        "quantity":    1,
        "unitPrice":   250000,
        "taxRate":     20,
        "unit":        "forfait"
      }
    ]
  }'

POST/invoices/:id/issueÉmettre une facture

Passe la facture du statut draft à issued. Attribue un numéro de facture définitif.

curl -X POST "https://api.emetia.fr/api/invoices/INV_UUID/issue" \
  -H "Authorization: Bearer em_live_VOTRE_CLE"

POST/invoices/:id/sendEnvoyer une facture

Envoie la facture au client par email (PDF en pièce jointe). La facture doit être au statut issued.

curl -X POST "https://api.emetia.fr/api/invoices/INV_UUID/send" \
  -H "Authorization: Bearer em_live_VOTRE_CLE"

POST/invoices/:id/payMarquer comme payée

Enregistre un paiement total ou partiel.

Paramètre	Type	Requis	Description
amount	`integer`	Optionnel	Montant payé en centimes. Si omis, marque la totalité comme payée.

curl -X POST "https://api.emetia.fr/api/invoices/INV_UUID/pay" \
  -H "Authorization: Bearer em_live_VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{ "amount": 12050 }'

GET/invoices/:id/pdfTélécharger le PDF

Retourne le PDF de la facture en binaire (application/pdf).

curl "https://api.emetia.fr/api/invoices/INV_UUID/pdf" \
  -H "Authorization: Bearer em_live_VOTRE_CLE" \
  --output facture.pdf

Statuts d'une facture

Statut	Description
`draft`	Brouillon — en cours de préparation
`issued`	Émise — numéro attribué, prête à être envoyée
`sent`	Envoyée par email au client
`viewed`	Le client a ouvert le lien de visualisation
`accepted`	Acceptée par le client
`paid`	Payée intégralement
`partial_paid`	Paiement partiel reçu
`overdue`	Dépassement de l'échéance
`cancelled`	Annulée
`rejected`	Rejetée par le client

Factures

Paramètres de requête

Exemple

Réponse

Corps de la requête

Structure d'une ligne (lines[])

Exemple

Statuts d'une facture

Structure d'une ligne (`lines[]`)