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.

Connecter votre logiciel de comptabilité

En connectant Oradevis à votre logiciel de comptabilité (ou à celui de votre expert-comptable), vos factures arrivent toutes seules dans la compta : plus de ressaisie, plus de PDF à transférer par email. La mise en place prend environ 5 minutes et ne demande aucune compétence technique — suivez le guide.

Prérequis

Un compte Oradevis plan PRO : la création de clés API est réservée aux abonnés PRO.

Sécurité

Votre clé est comme un mot de passe : ne la partagez jamais en dehors de votre logiciel. Vous pouvez la révoquer à tout moment depuis le dashboard.

Limites

API en lecture seule(aucune modification possible de l'extérieur), 120 requêtes par minute et par clé.

Créez votre clé API dans le dashboard

Connectez-vous à Oradevis puis ouvrez Dashboard → API & intégrations comptables. C'est la page qui gère vos clés : vous y créez, consultez et révoquez chaque accès.

Page « API & intégrations comptables » du dashboard Oradevis : formulaire « Créer une clé API » avec champ de nom et bouton orange « Créer la clé », section « Vos clés » encore vide

Donnez un nom parlant à la clé — le nom de votre logiciel ou de votre comptable (ex : « Pennylane », « Cabinet Martin ») — puis cliquez sur Créer la clé.

Formulaire de création rempli avec le nom « Pennylane », prêt à être validé avec le bouton « Créer la clé »

La clé s'affiche une seule fois : copiez-la immédiatement et collez-la dans votre logiciel (étape 2). Si vous la perdez, pas de panique — révoquez-la et créez-en une nouvelle.

Encadré vert « Clé créée — copiez-la maintenant, elle ne sera plus jamais affichée » avec la clé masquée et le bouton « Copier » ; la clé « Pennylane » apparaît dans la liste « Vos clés » avec son bouton « Révoquer »

Configurez votre logiciel

Dans votre logiciel de comptabilité (ou auprès de votre comptable / intégrateur), renseignez deux informations :

URL de base : https://oradevis.com/api/v1
En-tête d'authentification : Authorization: Bearer votre_clé

Pour vérifier que la connexion fonctionne, puis récupérer les factures du mois et leurs PDF Factur-X :

# 1. Tester la connexion (répond avec votre email et votre société)
curl https://oradevis.com/api/v1/me \
  -H "Authorization: Bearer orv_live_votre_cle"

# 2. Factures de juin 2026 (montants HT/TVA/TTC, client, n° de facture)
curl "https://oradevis.com/api/v1/invoices?from=2026-06-01&to=2026-06-30" \
  -H "Authorization: Bearer orv_live_votre_cle"

# 3. Télécharger le PDF Factur-X d'une facture (champ "pdfUrl" de la liste)
curl -OJ "https://oradevis.com/api/v1/invoices/INVOICE_ID/pdf" \
  -H "Authorization: Bearer orv_live_votre_cle"

Ce que votre logiciel récupère

Toutes vos factures, normalisées pour la compta : finales, acomptes, situations et soldes, avec montants HT / TVA / TTC, dates, numéros et client (SIRET inclus).
Les PDF Factur-X conformes EN 16931 : le XML comptable est embarqué dans chaque PDF — Pennylane, Sage, EBP et la plupart des outils les importent sans ressaisie.
Vos devis et vos clients, pour le suivi et les rapprochements.

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