API de génération de devis PDF : automatiser ses documents commerciaux
Émettre un devis manuellement prend du temps : ouvrir un modèle, recopier les coordonnées du client, saisir les lignes, recalculer les totaux, exporter en PDF, puis recommencer pour le client suivant. Quand le volume augmente, cette tâche devient un goulot d'étranglement. Une API de génération de devis PDF supprime ce travail répétitif : votre application envoie les données, le service renvoie un devis propre et prêt à envoyer. Ce guide explique comment générer un devis PDF par API avec DocX, à partir d'un simple modèle, et comment enchaîner ensuite sur la facture et la signature.
Le besoin : automatiser la création des devis
Si vous envoyez quelques devis par mois, un traitement de texte suffit. Mais dès que votre activité se structure, vous voulez que le devis se génère tout seul à partir de votre logiciel, de votre formulaire web ou de votre outil d'automatisation. Les besoins typiques sont les suivants :
- Gagner du temps : plus de copier-coller, le document se construit à partir de vos données
- Zéro erreur de calcul : les totaux, remises et taux de TVA sont calculés en amont, pas à la main
- Un rendu homogène : tous vos devis suivent la même charte, avec votre logo et vos mentions
- L'intégration dans votre flux : le devis se crée dès qu'un client valide un panier ou remplit un formulaire
L'idée centrale est de séparer la mise en forme (le modèle, que vous contrôlez) des données (qui changent à chaque devis). C'est exactement le rôle d'une API de document commercial comme DocX.
Comment ça marche : un modèle Word + des données = un PDF
Le principe est simple. Vous créez une fois pour toutes un modèle de devis dans Word, en y plaçant des balises là où les valeurs doivent apparaître (nom du client, date, numéro, lignes, total). Vous chargez ce modèle dans DocX, qui vous renvoie un identifiant de modèle. Ensuite, à chaque devis, vous appelez l'API avec les données du moment, et DocX vous renvoie le PDF fusionné.
Le service DocX est disponible sur https://docx.layerone.fr et l'endpoint de génération est POST /render-document. Point important : cet endpoint attend les données au format formulaire (application/x-www-form-urlencoded), et non du JSON brut dans le corps de la requête. Trois champs sont utilisés :
- template_id : l'identifiant de votre modèle de devis chargé au préalable
- json_data : vos données, sous forme de chaîne de caractères JSON (les valeurs à insérer dans le modèle)
- output_filename : le nom du fichier généré, par exemple devis-2026-0042.pdf
L'authentification se fait par un en-tête X-API-Key contenant votre clé. Vous récupérez cette clé après inscription sur l'espace développeur.
Exemple d'appel avec curl
Voici un appel complet. Notez l'usage de --data-urlencode pour encoder correctement les champs, et le fait que les données métier sont passées comme une chaîne JSON dans json_data :
curl -X POST https://docx.layerone.fr/render-document \
-H "X-API-Key: votre_cle_api" \
--data-urlencode 'template_id=tpl_devis_standard' \
--data-urlencode 'json_data={"client":"Boulangerie Martin","numero":"2026-0042","date":"19/06/2026","lignes":[{"designation":"Prestation A","quantite":2,"prix_unitaire":150},{"designation":"Prestation B","quantite":1,"prix_unitaire":300}],"total_ht":600,"tva":120,"total_ttc":720}' \
--data-urlencode 'output_filename=devis-2026-0042.pdf'La requête renvoie le document généré. Vous remarquerez qu'il n'y a aucun en-tête Content-Type: application/json : les données voyagent dans le corps du formulaire, et le contenu métier (client, lignes, totaux) est sérialisé en JSON à l'intérieur du champ json_data. C'est ce format exact qu'il faut respecter pour que la génération fonctionne.
Cas d'usage : qui a besoin d'une API de devis ?
Une API de génération de devis sert bien plus de profils qu'on ne l'imagine. Voici les plus courants :
Les artisans et indépendants
Un artisan qui chiffre plusieurs chantiers par semaine veut un devis propre, daté, numéroté, avec ses mentions légales, sans repasser par Word à chaque fois. En branchant son logiciel de gestion sur l'API, le devis se crée d'un clic à partir de la fiche client.
Les agences et prestataires de services
Une agence qui répond à de nombreuses demandes a besoin de devis cohérents, à sa charte, générés à la volée par son outil interne. L'API garantit que chaque proposition commerciale a le même rendu professionnel, peu importe qui la prépare.
Les éditeurs de logiciels et plateformes SaaS
Un SaaS qui gère la relation client de ses utilisateurs peut leur offrir la génération de devis sans développer un moteur PDF maison. L'API DocX devient la brique « documents » de la plateforme : chaque utilisateur final reçoit un devis propre, et l'éditeur garde la main sur les modèles.
Du devis à la facture et à la signature
Un devis n'est qu'une étape. Une fois accepté, il devient une facture ; et avant d'être accepté, il gagne à être signé électroniquement. La même approche par API couvre tout le cycle :
- Devis : généré à partir de votre modèle, comme décrit plus haut
- Signature : envoyez le devis à la signature en ligne pour valider l'accord du client de façon opposable
- Facture : une fois le devis accepté, générez la facture sur le même principe, avec le même moteur, au format électronique conforme
En gardant un seul fournisseur pour le devis, la facture et la signature, vous évitez de jongler entre plusieurs services et vous obtenez un parcours cohérent du premier contact jusqu'au paiement.
Démarrer gratuitement
Vous pouvez tester l'API sans engagement. L'offre gratuite permet de générer 20 documents par mois, sans carte bancaire. C'est largement suffisant pour câbler votre premier modèle de devis, valider le rendu et brancher votre flux. L'inscription et la récupération de votre clé se font sur l'espace développeur : https://dev.layerone.fr.
Côté intégration, vous n'êtes pas obligé d'écrire du code bas niveau. DocX se connecte via de nombreux canaux : un paquet npm, un connecteur MCP, ainsi que Zapier, Make, n8n, Pipedream, Bubble, Adalo et une collection Postman pour tester l'API en quelques clics. Que vous soyez développeur ou utilisateur d'outils no-code, vous trouverez le bon point d'entrée.
Questions fréquentes
L'API de génération de devis est-elle gratuite ?
Oui pour commencer : l'offre gratuite permet de générer 20 documents par mois, sans carte bancaire. De quoi câbler votre premier modèle de devis et valider le rendu avant de passer à un plan supérieur.
Comment obtenir une clé API pour générer des devis ?
Vous vous inscrivez sur l'espace développeur https://dev.layerone.fr et vous récupérez votre clé API. Elle s'envoie dans l'en-tête X-API-Key de chaque appel à DocX, sur https://docx.layerone.fr.
Dans quel format envoyer les données du devis à l'API ?
L'endpoint render-document attend des données au format application/x-www-form-urlencoded, pas du JSON brut. Vous envoyez trois champs : template_id (le modèle de devis), json_data (les données du devis sérialisées en chaîne JSON) et output_filename (le nom du PDF généré).
Peut-on générer des devis sans savoir coder ?
Oui : DocX se connecte à des outils no-code comme Zapier, Make, n8n, Pipedream, Bubble et Adalo. Vous pouvez déclencher la création d'un devis depuis un formulaire ou un enregistrement CRM sans écrire de code.