L'API de VoxFactura
Branche ton logiciel, ton tableur ou ton assistant sur tes factures et tes dépenses. Une clé, des droits que tu choisis, et tout ce que tu as facturé se récupère sans ressaisie.
À quoi elle sert
Lire
- Factures et avoirs, avec leur PDF Factur-X
- Dépenses et justificatifs
- Encaissements
- Journaux des ventes et des achats, récapitulatif de TVA, FEC
- Clients et chantiers
Écrire
- Créer un devis brouillon
- Marquer une facture payée
- Créer une dépense
- Rapprocher une dépense d'une opération bancaire
Rien ne part chez un client depuis l'API : l'envoi d'une facture, d'un devis ou d'une relance reste un geste à toi, dans VoxFactura.
Démarrer
Crée une clé
Dans ta console, page Clés API, coche ce que la clé a le droit de lire et d'écrire. Elle n'est affichée qu'une fois. Tu la révoques quand tu veux.
Clé cabinet
L'expert-comptable crée une clé cabinet depuis son espace cabinet, page API. Elle lit en lecture seule les dossiers des clients qui lui ont donné accès, un dossier par appel. Espace experts-comptables.
Serveur MCP
Le paquet voxfactura-mcp branche ton assistant sur tes données avec la même clé. Il prépare des brouillons, il n'envoie rien à un client.
Adresse de base
La clé se passe dans l'en-tête Authorization. L'ancienne adresse, https://voxfacture-production.up.railway.app/api/v1/pub, reste valable.
curl -H "Authorization: Bearer vf_live_ta_cle" \
"https://api.voxfactura.com/api/v1/pub/invoices?unpaid_only=true"Serveur MCP
À installer sur ton ordinateur, puis à déclarer dans ton assistant avec ta clé.
pip install voxfactura-mcp
# ou, sans installer : uvx voxfactura-mcp
VOXFACTURA_API_KEY=vf_live_ta_cle voxfactura-mcpLimites
600 appels par heure et par compte. Au-delà, l'API répond 429 avec un en-tête Retry-After. Pour une synchronisation, le filtre modifie_depuis ne renvoie que ce qui a changé. Les listes se paginent avec limit et offset.
Référence complète
Chaque route, ses paramètres, ses réponses et les droits qu'elle demande.
Chargement de la référence de l'API…