API PDF de bon de préparation pour workflows de fulfillment
Générez des PDF de bons de préparation depuis les données commande, expédition, carton et articles pour les workflows ecommerce, 3PL, OMS et fulfillment entrepôt.
/api/v1/template-render Générer des bons de préparation depuis les données d'expédition, destinataire, articles et cartons afin que les équipes fulfillment puissent imprimer ou joindre un document cohérent à chaque commande sortante.
Quand utiliser cette API
- Votre OMS ou WMS possède déjà les articles commandés, quantités, données destinataire et identifiants d'expédition.
- Vous avez besoin d'un PDF de bon de préparation pour postes d'impression entrepôt ou inserts de colis client.
- Vous voulez une mise en page approuvée réutilisée entre entrepôts, marques ou canaux de vente.
- Vous pourriez avoir besoin d'un code-barres ou QR code pour la recherche de commande ou la réception retour.
Ce qu'elle ne remplace pas
- Vous devez acheter l'affranchissement, tarifer une expédition ou créer une étiquette transporteur.
- Vous avez besoin de gestion d'inventaire entrepôt plutôt que de rendu documentaire.
- Vous avez besoin de sémantique de facture légale ou de facture électronique.
Quel endpoint appeler
/api/v1/template-render
Template Render est le chemin par défaut pour ce workflow.
/api/v1/pdf/render
À utiliser si le workflow a besoin d'un chemin API lié, d'un contrat de modèle ou d'une recherche de capacités.
Requête minimale
POST /api/v1/template-render - template packing_list avec une expédition.
{
"template_id": "packing_list",
"data": [
{
"shipment": {
"number": "PL-2026-1001",
"date": "2026-05-29"
},
"shipper": {
"name": "Acme Warehouse",
"address": "1200 Logistics Pkwy"
},
"consignee": {
"name": "Receiver Inc.",
"address": "123 Main St"
},
"items": [
{
"item_no": "1",
"description": "Replacement filter",
"quantity": "2",
"unit": "pcs",
"gross_weight": "1.2 kg",
"net_weight": "1.0 kg"
}
]
}
]
}
Ce que gPdf prend en charge
- Template Render pour des mises en page de bons de préparation publiées.
- JSON Render pour pages de bon de préparation spécifiques pendant la conception ou les workflows ponctuels.
- Tableaux, lignes d'articles, blocs adresse, codes-barres optionnels et sortie PDF.
- Réimpressions déterministes quand les mêmes données et le même template sont utilisés.
Ce que votre système garde
- Données commande, quantités d'articles, état d'expédition, routage entrepôt et messages client.
- Mapping des champs de template, routage des postes d'impression et politique de réimpression.
- Tout document transporteur, douanier ou de facture qui doit accompagner le colis.
Checklist de production
- Tester les combinaisons les plus longues de SKU, noms d'articles et adresses.
- Valider les cas article unique, multi-cartons, reliquat et expédition partielle.
- Utiliser Template Render après approbation de la mise en page du bon de préparation.
- Journaliser template_id et X-Request-Id pour chaque demande d'impression fulfillment.
- Séparer la génération d'étiquette transporteur du rendu du bon de préparation.
Limites de la promesse
- gPdf génère le PDF de bon de préparation ; il ne gère pas inventaire ni état de fulfillment.
- Un bon de préparation n'est pas automatiquement une facture fiscale ou un document douanier.
- L'achat d'étiquette transporteur et la tarification d'expédition restent hors de gPdf.
Les bons de préparation correspondent bien au chemin template
Les bons de préparation ont généralement une structure stable : expéditeur, destinataire, numéro d’expédition, lignes d’articles et notes optionnelles. Cela rend Template Render très adapté après approbation de la mise en page.
JSON Render reste utile pendant la conception. Il permet à votre équipe d’ajuster
colonnes, espacements, placement des codes-barres et sauts de page avant de
publier le contrat template_id stable.
Choix de l’endpoint
L’appel par défaut utilise /api/v1/template-render. Utilisez JSON Render tant que le layout évolue ou que l’appelant décrit toute la page. Une fois le layout approuvé, publiez-le comme template et envoyez seulement les données métier via Template Render.
Réservez E-Invoice Render aux paquets Factur-X / ZUGFeRD PDF/A-3b avec XML EN 16931 CII embarqué. Les PDF opérationnels, étiquettes, reçus et rapports ordinaires ne doivent pas être traités comme un flux de facture électronique.
Validation avant production
Validez API PDF de bon de préparation avec des données réelles et les systèmes qui consommeront le PDF. Conservez les request IDs, les sorties rendues et les preuves d’acceptation pour le support, l’audit et les réimpressions. gPdf rend le PDF ; les règles métier, le routage externe, la fiscalité, les transporteurs et la conformité marketplace restent dans votre système.
FAQ
- Un bon de préparation est-il un endpoint gPdf séparé ?
- Non. Utilisez Template Render pour un template de bon de préparation approuvé ou JSON Render quand votre système décrit directement la mise en page.
- Les bons de préparation peuvent-ils inclure des codes-barres ?
- Oui. gPdf peut générer des éléments de code-barres dans le PDF. Votre système détient le payload encodé de commande, carton ou retour.
- gPdf crée-t-il des étiquettes transporteur ?
- Non. Les étiquettes transporteur relèvent d'un workflow séparé. gPdf génère des PDF depuis les données fournies par votre transporteur ou système d'expédition.
- Une requête peut-elle générer plusieurs bons de préparation ?
- Template Render accepte un tableau de données pour plusieurs items dans une requête, dans les limites publiques documentées pour cet endpoint.