API PDF de bon de préparation pour flux de fulfillment
Générez des PDF de bons de préparation depuis les données commande, expédition, carton et articles pour les flux 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 flux.
/api/v1/pdf/render
À utiliser si le flux 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 flux 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.
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 flux 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.