API pour remplir un modèle Word automatiquement

Vous avez un modèle Word (.docx) — un contrat, une attestation, une fiche de paie, un devis — et vous voulez le remplir avec des données différentes des dizaines de fois par jour, sans ouvrir Word une seule fois ? C'est exactement ce que permet une API de publipostage. Vous déposez votre modèle une fois, vous envoyez vos données, et vous récupérez un document fini en PDF ou en DOCX. Ce guide explique comment automatiser le remplissage de modèle Word par API avec l'API DocX de Layerone.

Le besoin : du publipostage automatisé, sans Word ni macro

Le publipostage (ou « mailmerge » en anglais) consiste à fusionner un modèle de document avec une liste de données pour produire un document personnalisé pour chaque entrée. Historiquement, on le faisait dans Word avec une source Excel, à la main, écran par écran. Cette méthode atteint vite ses limites :

• Pas d'automatisation : il faut un humain devant l'ordinateur à chaque génération
• Macros fragiles : les macros VBA cassent à chaque mise à jour, et ne tournent pas sur un serveur
• Pas de PDF propre : exporter en PDF reste une étape manuelle de plus
• Aucune intégration : impossible de brancher votre logiciel métier ou votre CRM dessus

Une API de fusion de document Word résout tout ça : votre application appelle l'API, et le document sort prêt à l'emploi, en quelques secondes, sans intervention humaine et sans dépendance à Microsoft Word.

Comment ça marche : 3 étapes

Le principe est volontairement simple. Pour générer un document depuis un modèle, vous suivez trois étapes :

L'intérêt de cette approche est qu'elle sépare le fond de la forme. Vos données vivent dans votre application ou votre base ; la mise en page reste dans votre modèle Word, modifiable par n'importe qui sans toucher au code. Le jour où vous changez la police, le logo ou l'ordre des paragraphes, vous remplacez le modèle et tous les documents suivants suivent automatiquement le nouveau format, sans redéploiement ni modification de votre application.

1. Déposer un modèle .docx : votre document Word contient des champs (des « balises ») aux endroits à remplir, par exemple le nom du client, la date, le montant.
2. Envoyer les données : votre application envoie à l'API les valeurs à insérer dans chaque champ, sous forme de données structurées.
3. Recevoir le document fini : l'API renvoie le document généré, en PDF prêt à imprimer ou à envoyer, ou en DOCX si vous voulez encore le retoucher.

Tout passe par l'API DocX, accessible sur https://docx.layerone.fr. L'authentification se fait avec une clé envoyée dans l'en-tête X-API-Key de chaque requête : pas de configuration compliquée, pas de session à maintenir.

Gérer ses modèles versionnés

Vos modèles ne sont pas figés : un contrat évolue, un en-tête change, une mention légale est ajoutée. L'API DocX intègre une gestion des modèles complète depuis l'espace /client/templates, où vous pouvez :

• Uploader un nouveau modèle .docx et récupérer son identifiant
• Lister tous vos modèles existants pour les retrouver facilement
• Gérer les versions d'un même modèle, pour suivre les évolutions sans perdre l'historique

Chaque modèle a un identifiant stable (template_id). Quand vous mettez un modèle à jour, vous gardez la traçabilité : vous savez quelle version a servi à générer chaque document, ce qui est précieux pour les documents juridiques et contractuels.

Exemple concret : l'appel POST /render-document

Voici comment remplir un modèle Word par API en pratique. Le rendu se fait via l'appel POST /render-document. Point important : cet endpoint attend des données au format application/x-www-form-urlencoded, et non du JSON. Vous envoyez trois informations : l'identifiant du modèle (template_id), les données à insérer (json_data) et le nom du fichier de sortie (output_filename).

curl -X POST https://docx.layerone.fr/render-document \
  -H "X-API-Key: votre_cle_api" \
  --data-urlencode "template_id=tpl_contrat_2026" \
  --data-urlencode 'json_data={"nom_client":"Dupont SARL","date":"19/06/2026","montant":"1 250,00 €"}' \
  --data-urlencode "output_filename=contrat-dupont.pdf" \
  --output contrat-dupont.pdf

En quelques secondes, vous récupérez contrat-dupont.pdf, modèle rempli et prêt à être envoyé. Si vos documents doivent être conformes à la facturation électronique, l'endpoint frère POST /render-facturx génère directement un PDF Factur-X (PDF + données structurées de facture intégrées), selon la même logique.

Cas d'usage : RH, juridique, commercial

Le publipostage par API se branche sur n'importe quel processus métier qui produit des documents répétitifs :

• Ressources humaines : contrats de travail, avenants, attestations employeur, fiches de paie, courriers d'embauche — générés automatiquement depuis votre logiciel RH.
• Juridique : contrats commerciaux, mandats, conditions générales personnalisées, mises en demeure — avec la traçabilité de version pour chaque document émis.
• Commercial : devis, propositions commerciales, bons de commande, factures — déclenchés directement depuis votre CRM dès qu'une opportunité est validée.

Dans chacun de ces cas, l'humain ne touche plus au document : il valide les données en amont, et le document sort seul, identique à chaque fois, sans risque d'erreur de copier-coller. C'est aussi un gain de conformité : un modèle validé une fois garantit que chaque document généré contient les bonnes mentions, le bon en-tête et la bonne version, quel que soit le collaborateur ou le système qui déclenche la génération.

S'intégrer à vos outils existants

L'API DocX se branche partout, que vous codiez ou non. Des connecteurs prêts à l'emploi sont disponibles pour npm, MCP, Zapier, Make, n8n, Pipedream, Bubble, Adalo et Postman. Vous pouvez ainsi déclencher la génération d'un document Word rempli depuis un formulaire, un tableur, un nouvel enregistrement CRM ou un workflow no-code, sans écrire une seule ligne de code.

Combien ça coûte pour démarrer ?

L'API est gratuite pour commencer : le plan d'essai inclut 20 documents par mois, largement suffisant pour tester votre cas d'usage de bout en bout. Vous pouvez explorer l'API, lire la documentation technique et récupérer votre clé sur l'espace développeur https://dev.layerone.fr. Quand votre volume augmente, vous passez à un plan adapté, sans avoir à changer votre code.

Pourquoi automatiser dès maintenant

Chaque document rempli à la main, c'est du temps perdu et un risque d'erreur. En passant à une API pour générer un document depuis un modèle, vous transformez une tâche répétitive en un appel automatique, fiable et identique à chaque exécution. Vos équipes se concentrent sur le contenu, pas sur la mise en page. Commencez gratuitement, déposez votre premier modèle, et générez votre premier document en quelques minutes.

Questions fréquentes

Remplir un modèle Word par API, est-ce gratuit ?

Oui pour démarrer : le plan d'essai de DocX inclut 20 documents par mois, sans carte bancaire. C'est largement suffisant pour tester le remplissage de vos modèles Word de bout en bout.

Comment obtenir une clé API pour remplir mes modèles Word ?

Vous récupérez votre clé sur l'espace développeur https://dev.layerone.fr après inscription. Elle s'envoie dans l'en-tête X-API-Key de chaque requête vers https://docx.layerone.fr.

Dans quel format envoyer les données pour remplir le modèle ?

L'endpoint render-document attend des données au format application/x-www-form-urlencoded, et non du JSON. Vous transmettez trois champs : template_id (l'identifiant du modèle .docx), json_data (les valeurs à insérer, sérialisées en chaîne JSON) et output_filename (le nom du fichier de sortie).

Faut-il Microsoft Word installé pour remplir un modèle ?

Non : la fusion se fait côté serveur par l'API DocX, sans Word ni macro VBA. Vous déposez votre modèle .docx une fois, puis votre application envoie les données et reçoit le document fini en PDF ou en DOCX.

Articles connexes