API & MCP Oradevis

Connectez vos devis et factures Factur-X à votre logiciel de comptabilité (Pennylane, Sage, EBP) ou à votre assistant IA. API REST lecture seule, clés révocables, données hébergées en France.

1. Authentification

Créez une clé dans Dashboard → API & intégrations(plan PRO). La clé complète n'est affichée qu'une fois — nous n'en stockons qu'un hash SHA-256. Passez-la sur chaque requête :

curl https://oradevis.com/api/v1/me \
  -H "Authorization: Bearer orv_live_votre_cle"

Limite : 120 requêtes/minute par clé. Scopes : read:quotes, read:invoices, read:clients (lecture seule).

2. Endpoints

GET/api/v1/meIdentité du compte — test de connexion

GET/api/v1/quotesDevis (filtres status, from, to — pagination cursor)

GET/api/v1/quotes/{id}Détail d'un devis : lignes, client, factures liées

GET/api/v1/invoicesFactures normalisées compta : finales, acomptes, situations, soldes

GET/api/v1/invoices/{id}/pdfPDF Factur-X (XML EN 16931 embarqué) — import direct compta

GET/api/v1/clientsClients (recherche, pagination cursor)

3. Export compta : Pennylane, Sage, EBP

Les factures Oradevis sont au format Factur-X (PDF/A-3 avec XML EN 16931 embarqué) : Pennylane, Sage et la plupart des outils comptables les importent directement, sans ressaisie. Workflow type — récupérer les factures du mois et leurs PDF :

# Factures de mai 2026
curl "https://oradevis.com/api/v1/invoices?from=2026-05-01&to=2026-05-31" \
  -H "Authorization: Bearer orv_live_votre_cle"

# Télécharger un PDF Factur-X
curl -OJ "https://oradevis.com/api/v1/invoices/INVOICE_ID/pdf" \
  -H "Authorization: Bearer orv_live_votre_cle"

Importez ensuite les PDF dans Pennylane (« Importer des factures ») ou Sage : les montants HT/TVA/TTC, dates et tiers sont lus depuis le XML embarqué.

4. Serveur MCP (Claude, assistants IA)

Le serveur MCP officiel expose vos données à Claude Desktop / Claude Code en lecture seule : « liste mes factures du trimestre », « télécharge les PDF pour mon comptable », « quels devis n'ont pas été signés ? ». Configuration Claude Desktop :

{
  "mcpServers": {
    "oradevis": {
      "command": "node",
      "args": ["/chemin/vers/mcp-server/index.mjs"],
      "env": { "ORADEVIS_API_KEY": "orv_live_votre_cle" }
    }
  }
}

5. Sécurité

API lecture seule : aucune écriture possible de l'extérieur.
Clés hashées (SHA-256), affichées une seule fois, comparaison en temps constant.
Révocation immédiate depuis le dashboard, 5 clés actives maximum.
Rate-limit par clé, traçabilité du dernier usage.
Données hébergées en France, accès limité à votre seul compte.

Prêt à connecter votre compta ?

Créez votre clé API dans le dashboard (plan PRO) et branchez Pennylane, Sage ou Claude en 5 minutes.

Démarrer gratuitement →

Mentions légales Confidentialité CGV