API per etichette pallet nei sistemi di produzione
Genera etichette pallet da dati backend strutturati, senza browser, con confini chiari tra il PDF renderizzato da gPdf e le regole del tuo sistema.
/api/v1/pdf/render Generare etichette pallet come PDF riproducibile da dati strutturati. Il tuo sistema mantiene la logica di business; gPdf gestisce il rendering PDF.
Quando usare questa API
- Il tuo backend possiede già i dati per etichette pallet e deve ottenere una risposta PDF stabile.
- Vuoi evitare Chromium o HTML-to-PDF per documenti operativi.
- Ti serve output ripetibile per ristampe, audit o batch.
Cosa non sostituisce
- Hai bisogno che gPdf acquisti spedizioni, liquidi imposte, crei ordini esterni o agisca da sistema fiscale.
- Vuoi sostituire validazione dati, logica di business o integrazioni marketplace.
Quale endpoint chiamare
/api/v1/pdf/render
JSON Render è il percorso predefinito per questo workflow.
/api/v1/template-render
Usalo quando il workflow richiede l’API collegata, un contratto di template o una verifica delle capacità.
Request minimo
/api/v1/pdf/render - etichette pallet
{
"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" }
}
]
}
]
}
Cosa gestisce gPdf
- Rendering PDF di etichette pallet da request strutturate.
- Testi, tabelle, linee, codici a barre, pagine, metadati e opzioni di output secondo il request.
- Output deterministico per retry, ristampe e audit.
Cosa controlla il tuo sistema
- Dati corretti per etichette pallet, regole di business e stato operativo.
- Autenticazione, persistenza, integrazioni esterne e validazione con i destinatari.
Checklist di produzione
- Testa con dati reali e con i sistemi che riceveranno il PDF.
- Salva request ID ed evidenze per supporto, audit e ristampa.
- Trasforma il layout approvato in template quando più sistemi devono riusarlo.
Limiti della promessa
- gPdf renderizza il PDF dell’etichetta; non acquista spedizioni, non crea shipment e non certifica i carrier.
- Il tuo sistema mantiene payload, stampanti, supporti etichetta, routing e test di scansione.
Forma dell’API
API per etichette pallet è un workflow di produzione basato sulle API pubbliche di gPdf. Il request descrive dati, layout, settings e parti PDF da renderizzare. gPdf renderizza il PDF; il tuo sistema mantiene la semantica dell’evento di business.
Scelta dell’endpoint
Per questo workflow, l’endpoint predefinito è /api/v1/pdf/render. Usa Template Render quando il layout è approvato e riutilizzato tra sistemi. Usa E-Invoice Render solo quando serve packaging Factur-X / ZUGFeRD PDF/A-3b con EN 16931 CII XML incorporato.
Validazione prima della produzione
Valida etichette pallet con dati reali e con i sistemi che lo consumeranno. Conserva request ID, output renderizzato ed evidenze di validazione per supporto, audit e ristampa.
FAQ
- È un endpoint separato?
- API per etichette pallet collega il workflow a una API pubblica di gPdf. La pagina indica quale percorso chiamare e cosa deve contenere il request.
- Posso usare template?
- Sì. Usa JSON Render mentre il layout cambia; usa Template Render quando il layout è approvato e i caller inviano solo dati di business.
- Cosa validare prima della produzione?
- Valida con dati reali e con stampanti, scanner, validatori, contabilità o marketplace del workflow.