API per etichette di magazzino nei flussi di stampa WMS ed ERP
Genera PDF di etichette per pallet, colli, ubicazioni, inventario e operazioni di magazzino da dati WMS o ERP, con ristampe deterministiche.
/api/v1/pdf/render Renderizzare etichette di magazzino da dati WMS o ERP per pallet, cartoni, contenitori, asset, ubicazioni e movimenti di inventario, mantenendo stato inventariale, regole di prelievo e operazioni di magazzino nel sistema chiamante.
Quando usare questa API
- Vi servono etichette PDF per pallet, cartoni, contenitori, ubicazioni, inventario o asset.
- Il vostro WMS o ERP possiede già dati SKU, lotto, ubicazione, SSCC e inventario.
- Vi servono ristampe deterministiche quando un'etichetta è danneggiata o una postazione ritenta una stampa.
- Volete riusare layout di etichette approvati tramite Template Render.
Cosa non sostituisce
- Vi serve che gPdf gestisca inventario, assegni ubicazioni o esegua processi di magazzino.
- Vi serve da gPdf un'app scanner, un agente per postazioni di stampa o un sistema di instradamento etichette.
- Vi serve certificazione GS1 invece del rendering di codici a barre.
Quale endpoint chiamare
/api/v1/pdf/render
JSON Render è il percorso predefinito per questo flusso.
/api/v1/template-render
Usalo quando il flusso richiede l'API collegata, un contratto di template o una verifica delle capacità.
Request minimo
POST /api/v1/pdf/render - etichetta pallet con dati codice a barre SSCC.
{
"pages": [
{
"size": "label_4_6_in",
"elements": [
{
"type": "text",
"x": 6,
"y": 8,
"content": "PALLET LAX-01-2026-00042",
"style": { "font_size": 12, "font_family": "NotoSans-Regular" }
},
{
"type": "barcode",
"format": "sscc-18",
"content": "012345678901234567",
"x": 6,
"y": 30,
"width": 88,
"height": 26,
"barcode_text": { "enabled": true, "position": "bottom" }
},
{
"type": "text",
"x": 6,
"y": 70,
"content": "SKU: CASE-001\nQTY: 48\nLOCATION: A-14-02",
"style": { "font_size": 10, "font_family": "NotoSans-Regular" }
}
]
}
]
}
Cosa gestisce gPdf
- Etichette PDF per flussi di stampa di magazzino.
- Codici a barre vettoriali, testo, riquadri, formati pagina per etichette e associazione al template.
- Output deterministico per ristampa e audit.
- JSON Render per layout personalizzati e Template Render per contratti di etichetta approvati.
Cosa controlla il tuo sistema
- Stato dell'inventario, dati SKU, dati di lotto/seriale, valori SSCC e semantica delle ubicazioni.
- Instradamento stampanti, configurazione postazioni, validazione scanner e regole del processo di magazzino.
- Selezione del template, ritentativi e conservazione dei PDF renderizzati o dei dati sorgente.
Checklist di produzione
- Validate le dimensioni dell'etichetta rispetto alla stampante reale e al supporto etichetta.
- Scansionate ogni formato di codice a barre usato dal processo di magazzino.
- Mantenete autorevole lo stato WMS/ERP e inviate a gPdf solo i dati finali dell'etichetta.
- Usate Template Render per etichette stampate da più sistemi o postazioni.
- Registrate ID dei documenti sorgente e request ID per la tracciabilità delle ristampe.
Limiti della promessa
- gPdf renderizza PDF di etichette di magazzino; non gestisce inventario né stato di magazzino.
- Il sistema chiamante possiede la semantica del contenuto dei codici a barre e l'accettazione scanner.
- Template Render può stabilizzare i layout delle etichette, ma non sostituisce le regole WMS.
Le etichette di magazzino sono record operativi
Le etichette di magazzino identificano pallet, colli, contenitori, asset, movimenti di inventario e ubicazioni. Sono legate allo stato operativo nel vostro WMS o ERP. gPdf dovrebbe ricevere i dati finali dell’etichetta e renderizzarli; non dovrebbe decidere il significato dell’inventario o lo stato del processo di magazzino.
Template Render semplifica le postazioni di stampa
Per le etichette usate da più postazioni, pubblicate il layout approvato come
template. I servizi di stampa possono quindi inviare template_id più dati WMS
invece di ricostruire le coordinate in ogni sistema chiamante.
Ristampe deterministiche
Nei magazzini le etichette vengono ristampate. Un’etichetta danneggiata, una stampante inceppata o un ritentativo della postazione non dovrebbero creare un documento leggermente diverso. Tenete i dati sorgente dell’etichetta collegati al record di magazzino e usate input di rendering deterministici per le ristampe.
FAQ
- gPdf gestisce l'inventario di magazzino?
- No. Il vostro WMS o ERP possiede stato inventariale, ubicazioni, SKU, lotti e regole di processo. gPdf renderizza il PDF dell'etichetta dai dati finali.
- Le etichette di magazzino possono usare codici a barre GS1 o SSCC?
- Sì, gPdf può renderizzare nel PDF i formati di codice a barre supportati. Il vostro sistema possiede il contenuto codificato e l'accettazione scanner.
- Le etichette di magazzino ripetute dovrebbero usare template?
- Di solito sì. Template Render fornisce alle postazioni di stampa un template_id stabile e un contratto dati dopo l'approvazione del layout dell'etichetta.
- Come dovrebbero funzionare le ristampe?
- Salvate i dati sorgente dell'etichetta o il PDF generato insieme al record di magazzino, poi renderizzate o recuperate la stessa etichetta usando gli ID operativi originali.