Invoxy

Quickstart

Ce guide te fait émettre une facture en mode test en 5 minutes, sans aucun paiement réel ni transmission au PPF.

1. Créer un compte et récupérer ta clé de test

Crée un compte sur app.invoxy.fr. Dans Settings → API Keys, copie ta clé de test :

sk_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Toutes les clés sk_test_* opèrent dans un environnement totalement isolé. Aucune facture émise en mode test n'arrive à la DGFiP — c'est un invariant produit.

2. Émettre une facture happy path

curl -X POST https://api.invoxy.fr/v1/invoices \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{
    "recipient_siren": "000000018",
    "total_excl_tax_cents": 100000,
    "total_incl_tax_cents": 120000,
    "currency": "EUR",
    "lines": [
      {
        "description": "Prestation de conseil",
        "quantity": 1,
        "unit_price_cents": 100000,
        "vat_rate": 20
      }
    ]
  }'

Réponse attendue (201 Created) :

{
  "id": "inv_01HXYZ...",
  "mode": "test",
  "status": "submitted",
  "recipient_siren": "000000018",
  "total_incl_tax_cents": 120000,
  "currency": "EUR",
  "pdf_url": "https://files.invoxy.fr/test/inv_01HXYZ.pdf?...",
  "created_at": "2026-05-06T09:30:00Z"
}

Le SIREN destinataire 000000018 est un SIREN magique réservé sandbox — il déclenche le scénario annuaire.happy (lookup réussit, PDP destinataire accepte).

3. Tester un cas d'erreur

Pour simuler un rejet métier du PDP destinataire, utilise le SIREN 000000117 :

curl -X POST https://api.invoxy.fr/v1/invoices \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{
    "recipient_siren": "000000117",
    "total_excl_tax_cents": 50000,
    "total_incl_tax_cents": 60000,
    "currency": "EUR",
    "lines": [{"description": "Test", "quantity": 1, "unit_price_cents": 50000, "vat_rate": 20}]
  }'

La facture est créée puis passe en statut rejected avec le motif TVA_INVALID. Le webhook invoice.rejected est envoyé à ton endpoint si tu en as configuré un.

4. Voir tous les scénarios disponibles

23 SIREN magiques couvrent toutes les branches de code possibles : annuaire, routage PDP, cycle de vie, e-reporting, erreurs émetteur. Voir la liste complète sur SIREN magiques.

Pour aller plus loin