Templates

Les templates définissent la structure HTML de vos documents. Utilisez des variables Handlebars{{variable}}pour les données dynamiques.

Templates système

RestifyDocs fournit des templates pré-faits conformes pour chaque pays. Utilisez-les directement ou créez vos propres templates personnalisés.

Créer depuis la console

Vous pouvez créer et éditer vos templates directement depuis la console développeur, sans écrire une seule ligne de code API. L'éditeur intégré offre :

Éditeur HTML avec numéros de ligne

Écrivez votre HTML directement dans l'éditeur. Les variables Handlebars {{variable}} sont détectées automatiquement.

Aperçu en temps réel

Le panneau de droite affiche un rendu live de votre template au format papier (A4, A5, Letter, Legal) avec zoom ajustable. Chaque modification du HTML est reflétée instantanément.

Valeurs par défaut des variables

Renseignez des valeurs par défaut pour chaque variable détectée. L'aperçu les utilise pour simuler un document réaliste, et elles serviront de fallback lors de la génération.

Configuration pays & type

Sélectionnez le pays cible et le type de document (Facture, Devis, Reçu, etc.). RestifyDocs validera automatiquement la conformité de votre template selon les normes fiscales du pays choisi.

Recommandé pour débuter

Si vous créez votre premier template, utilisez la console pour itérer rapidement sur le rendu avant de passer à l'API pour l'intégration dans votre workflow.

Créer via l'API

POST

/v1/templatesAPI Key

Créer un nouveau template HTML.

Body

Paramètre	Type	Description
`name`requis	`string`	Nom du template
`html`requis	`string`	Code HTML avec variables Handlebars
`type`optionnel	`string`	Type de document : invoice, quote, receipt, credit_note, freeDéfaut : `invoice`
`country`optionnel	`string`	Code pays ISO (CI, BJ, NE, TG, SN)
`paperSize`optionnel	`string`	Format : A4, A5, Letter, LegalDéfaut : `A4`
`defaultVars`optionnel	`object`	Valeurs par défaut pour les variables Handlebars

Réponse201 Created

JSON

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "Facture CI custom",
  "type": "invoice",
  "countryCode": "CI",
  "version": 1,
  "variables": ["entreprise", "nom_client", "total_ttc"],
  "compliance": {
    "status": "valid",
    "warnings": []
  },
  "createdAt": "2026-04-27T10:00:00.000Z"
}

Lister les templates

GET

/v1/templatesAPI Key

Récupérer la liste de tous les templates.

Query params

Paramètre	Type	Description
`country`optionnel	`string`	Filtrer par code pays (ex: CI)
`type`optionnel	`string`	Filtrer par type de document
`is_system`optionnel	`boolean`	Filtrer les templates système
`page`optionnel	`number`	Numéro de pageDéfaut : `1`
`per_page`optionnel	`number`	Éléments par page (max 100)Défaut : `20`

Réponse200 OK

JSON

{
  "data": [
    {
      "id": "a1b2c3d4-...",
      "name": "Facture CI",
      "type": "invoice",
      "countryCode": "CI",
      "version": 1,
      "isSystem": true,
      "complianceStatus": "valid",
      "createdAt": "2026-01-01T00:00:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "perPage": 20,
    "total": 7,
    "totalPages": 1
  }
}

Récupérer un template

GET

/v1/templates/:idAPI Key

Récupérer les détails complets d'un template, incluant le HTML et les variables.

Réponse200 OK

JSON

{
  "id": "a1b2c3d4-...",
  "orgId": "uuid",
  "name": "Facture CI custom",
  "html": "<h1>{{entreprise}}</h1>...",
  "variables": ["entreprise", "nom_client", "total_ttc"],
  "defaultVars": { "entreprise": "Acme Corp" },
  "countryCode": "CI",
  "type": "invoice",
  "paperSize": "A4",
  "version": 1,
  "isSystem": false
}

Modifier un template

PUT

/v1/templates/:idAPI Key

Mettre à jour un template custom. Les templates système ne sont pas modifiables.

Body

Paramètre	Type	Description
`name`optionnel	`string`	Nouveau nom
`html`optionnel	`string`	Nouveau code HTML
`paperSize`optionnel	`string`	Nouveau format papier
`defaultVars`optionnel	`object`	Nouvelles valeurs par défaut

Supprimer un template

DELETE

/v1/templates/:idAPI Key

Archiver un template custom. Les documents existants ne sont pas affectés.

Réponse204 No Content

JSON

// Pas de corps de réponse

Prochaine étape

Utilisez vos templates pour générer des documents PDF conformes.

Documents →