API d'étiquettes palette pour workflows entrepôt et 3PL
Générez des PDF d'étiquettes palette pour workflows entrepôt, 3PL, retail et logistique avec SSCC, GS1-128, blocs texte et templates sûrs pour la réimpression.
/api/v1/pdf/render Générer des PDF d'étiquettes palette depuis des données WMS, ERP ou 3PL afin que les équipes entrepôt puissent identifier les palettes, scanner SSCC ou codes-barres GS1 et réimprimer la même étiquette pendant réception, expédition ou mouvements d'inventaire.
Quand utiliser cette API
- Votre WMS possède déjà l'ID palette, les données SKU ou GTIN, la quantité, le lot et la destination.
- Vous avez besoin d'une étiquette PDF avec SSCC, GS1-128 ou autres formats de codes-barres pris en charge.
- Vous voulez des réimpressions déterministes depuis le même payload source.
- Vous avez besoin que la mise en page devienne un contrat Template Render stable.
Ce qu'elle ne remplace pas
- Vous voulez que gPdf gère inventaire, palettisation ou tâches entrepôt.
- Vous avez besoin d'une certification GS1 plutôt que de rendu de codes-barres PDF.
- Vous avez besoin d'une sortie directe en commandes imprimante.
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/pdf/render - étiquette palette avec code-barres SSCC.
{
"pages": [
{
"size": "label_4_6_in",
"elements": [
{
"type": "text",
"x": 5,
"y": 7,
"content": "PALLET 12 / DOCK B",
"style": { "font_size": 13, "font_family": "NotoSans-Regular" }
},
{
"type": "barcode",
"format": "sscc-18",
"content": "000123456789012345",
"x": 5,
"y": 28,
"width": 92,
"height": 30,
"barcode_text": { "enabled": true, "position": "bottom" }
},
{
"type": "text",
"x": 5,
"y": 78,
"content": "GTIN 09506000134352\nQTY 48 CASES\nLOT L-2026-05",
"style": { "font_size": 10, "font_family": "NotoSans-Regular" }
}
]
}
]
}
Ce que gPdf prend en charge
- Pages PDF au format étiquette avec texte, cadres et éléments de code-barres.
- SSCC, GS1-128, Code 128, QR et autres formats de codes-barres pris en charge dans la sortie PDF.
- Binding de template pour mises en page d'étiquettes palette approuvées.
- Sortie déterministe pour réimpressions et preuves d'audit.
Ce que votre système garde
- Identité palette, données produit, données de lot, quantité, routage et règles entrepôt.
- Exactitude du payload de code-barres, chiffres de contrôle, tests scanner et validation du stock d'étiquettes.
- Routage des postes d'impression, autorisation de réimpression et état d'inventaire.
Checklist de production
- Valider le payload SSCC ou GS1 avant le rendu.
- Scanner les étiquettes avec les scanners de production aux postes de réception et d'expédition.
- Tester les données denses, noms produit longs et besoins multilingues d'entrepôt.
- Enregistrer template_id, ID palette source et request ID pour les réimpressions.
- Garder les transitions d'état entrepôt hors de l'API de rendu.
Limites de la promesse
- gPdf génère des PDF d'étiquettes palette ; il ne gère pas palettes ni inventaire entrepôt.
- gPdf n'est pas un organisme de certification GS1.
- L'acceptation scanner et la correction du processus entrepôt restent sous votre responsabilité.
Les étiquettes palette relient les données WMS à l’impression
Le workflow d’étiquette palette commence dans votre WMS ou ERP. Il décide quelles données de palette, produit, quantité, lot et route appartiennent à l’étiquette. gPdf transforme ces données en PDF que les postes d’impression entrepôt peuvent sortir et réimprimer.
Utilisez la page SSCC plus ciblée quand l’intention de recherche porte spécifiquement sur SSCC-18 ou l’étiquetage logistique GS1. Utilisez cette page pour le workflow plus large d’étiquette palette.
Choix de l’endpoint
L’appel par défaut utilise /api/v1/pdf/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 d’étiquettes palette 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
- gPdf peut-il générer des étiquettes palette SSCC ?
- gPdf peut générer des éléments de code-barres SSCC dans une sortie PDF. Votre système détient la valeur SSCC et la sémantique GS1.
- gPdf gère-t-il l'inventaire palette ?
- Non. Les systèmes WMS ou ERP détiennent l'état d'inventaire. gPdf génère le PDF d'étiquette.
- Les étiquettes palette peuvent-elles utiliser Template Render ?
- Oui. Template Render est généralement le chemin de production après approbation de la mise en page d'étiquette palette.
- gPdf certifie-t-il les étiquettes GS1 ?
- Non. gPdf génère des codes-barres PDF vectoriels. Certification, tests de scan et acceptation restent sous votre responsabilité.