API PDF logistique pour des étiquettes, bons et documents entrepôt
Générez des PDF logistiques structurés tels qu'étiquettes, bons de préparation, lettres de voiture, manifestes et documents entrepôt depuis des données WMS, OMS et 3PL.
/api/v1/pdf/render Générer des documents logistiques opérationnels depuis des données structurées WMS, OMS, 3PL et fulfillment, tout en gardant transactions transporteur, routage d'expédition, état entrepôt et règles métier dans les systèmes appelants.
Quand utiliser cette API
- Vous avez besoin de PDF pour des étiquettes, bons de préparation, manifestes, lettres de voiture ou documents d'entrepôt.
- Vos systèmes logistiques connaissent déjà expédition, commande, inventaire, route et données transporteur.
- Vous avez besoin de réimpressions déterministes et de rendu API à haut volume.
- Vous voulez une page hub large qui oriente vers des workflows plus précis d'étiquettes et d'entrepôt.
Ce qu'elle ne remplace pas
- Vous voulez que gPdf calcule les tarifs d'expédition, achète l'affranchissement ou parle directement aux transporteurs.
- Vous avez besoin de fonctions WMS, OMS, TMS ou gestion d'inventaire.
- Vous avez besoin d'EDI natif, de dépôt douanier ou de workflows courtier fret hors génération PDF.
Quel endpoint appeler
/api/v1/pdf/render
JSON Render est le chemin par défaut pour ce workflow.
/api/v1/template-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 - document logistique répété depuis des données structurées.
{
"template_id": "packing_list",
"data": [
{
"order_number": "SO-8421",
"warehouse": "LAX-01",
"ship_to": "Example Retailer, 88 Harbor Rd, Long Beach, CA",
"items": [
{ "sku": "CASE-001", "description": "Widget case", "quantity": 4 },
{ "sku": "CASE-002", "description": "Replacement kit", "quantity": 1 }
]
}
]
}
Ce que gPdf prend en charge
- Rendu PDF pour documents logistiques structurés.
- Pages au format étiquette, documents A4/letter, codes-barres, tableaux, blocs adresse et métadonnées.
- Template Render pour mises en page de documents entrepôt et fulfillment approuvées.
- Sortie déterministe pour réimpressions et preuves d'audit.
Ce que votre système garde
- État d'expédition, service transporteur, règles de routage, état d'inventaire et éligibilité documentaire.
- Mapping des données métier depuis WMS, OMS, TMS, ERP ou systèmes 3PL.
- Routage d'impression, stockage, livraison, logique de retry et gestion des exceptions opérationnelles.
Checklist de production
- Décider quels documents utilisent directement JSON Render et lesquels utilisent des templates.
- Valider les cas de débordement de codes-barres, adresses et tableaux pour chaque type de document.
- Stocker les données source ou le PDF selon les exigences de réimpression et d'audit.
- Garder les appels API transporteur et les appels API de rendu comme étapes d'intégration séparées.
- Relier les pages plus ciblées pour des étiquettes d'expédition et étiquettes entrepôt au lieu de dupliquer leur contenu.
Limites de la promesse
- gPdf génère des PDF logistiques ; ce n'est ni un transporteur, ni un WMS, OMS, TMS ou fournisseur d'affranchissement.
- Tarification d'expédition, achat d'étiquette, état d'inventaire et opérations transporteur restent hors de gPdf.
- Cette page large doit lier vers des pages solution plus précises pour les intentions de workflow exactes.
Les documents logistiques forment un ensemble
La génération PDF logistique couvre plusieurs types de documents : étiquettes d’expédition, étiquettes entrepôt, bons de préparation, manifestes, lettres de voiture, tickets de picking et documents internes de passation. Cette page est l’entrée large. Les pages ciblées doivent porter l’intention exacte de recherche pour les étiquettes et workflows riches en codes-barres.
Pattern d’utilisation API
La plupart des documents logistiques utilisent JSON Render ou Template Render. JSON Render convient aux mises en page générées ou aux documents spéciaux. Template Render convient aux documents répétés où les équipes opérations attendent une mise en page stable et un petit ensemble de champs de données.
Garder les systèmes opérationnels comme autorité
Votre WMS, OMS, TMS, plateforme 3PL, ERP ou intégration transporteur reste la source de vérité pour l’état d’expédition et les règles métier. gPdf reçoit les données finales du document et produit la sortie PDF.
FAQ
- Cette page est-elle différente de la page étiquette d'expédition ?
- Oui. C'est la page large des documents logistiques. Les étiquettes d'expédition et d'entrepôt ont des pages plus ciblées avec des recommandations plus précises sur les étiquettes et codes-barres.
- gPdf appelle-t-il les transporteurs ?
- Non. Votre stack logistique gère APIs transporteur, affranchissement, tarification d'expédition et routage. gPdf génère des PDF depuis les données qu'il reçoit.
- Quel endpoint convient aux documents logistiques ?
- Utilisez JSON Render pour les mises en page spécifiques et Template Render pour les documents répétés approuvés, comme les bons de préparation ou les étiquettes entrepôt.
- Les pages logistiques peuvent-elles inclure des codes-barres ?
- Oui. gPdf génère des éléments de code-barres dans les PDF, mais votre système détient le payload encodé et la validation opérationnelle.