Factures

Créez, finalisez et suivez une facture électronique.

Créer une facture

POST /api/v1/invoices crée toujours un brouillon. Finalisez-le dans un second appel après vérification.

curl https://api.yaoka.fr/api/v1/invoices \
  -H "Authorization: Bearer $YAOKA_API_KEY" \
  -H "X-Yaoka-Organization-Id: $YAOKA_ORG_ID" \
  -H "Idempotency-Key: invoice-order-847-v1" \
  -H "Content-Type: application/json" \
  -d '{
    "customerId":"customer_...",
    "dueInDays":30,
    "paymentMethods":["transfer"],
    "lines":[{"label":"Licence août","quantity":1,"unitPrice":"49.00","unit":"piece","vatRate":"20.00"}]
  }'

Finaliser

POST /api/v1/invoices/{id}/finalize attribue un numéro légal, produit le PDF Factur-X et déclenche l’envoi vers Pennylane si la connexion est active. Une facture finalisée n’est plus modifiable sur ses montants : créez un avoir.

Lire et filtrer

GET /invoices/{id} récupère une facture.
GET /invoices?status=paid&customerId=... filtre la liste.
GET /invoices/{id}/pdf donne accès au document officiel.
GET /invoices/{id}/compliance expose son état de conformité et de transmission.

La liste accepte aussi invoiceType, fromDate, toDate, limit (1 à 100) et cursor. La création accepte uniquement finalize: false : la finalisation est volontairement une seconde opération explicite.

Erreurs Organisations