API per PDF di distinte di imballaggio nei processi di evasione
Genera PDF di distinte di imballaggio da dati di ordine, spedizione, collo e articoli per ecommerce, 3PL, OMS e processi di evasione in magazzino.
/api/v1/template-render Renderizzare distinte di imballaggio da dati di spedizione, destinatario, articoli e colli, così i team di evasione ordine possono stampare o allegare un documento coerente per ogni ordine in uscita.
Quando usare questa API
- Il vostro OMS o WMS contiene già articoli dell'ordine, quantità, dati del destinatario e identificativi di spedizione.
- Vi serve una distinta di imballaggio in PDF per postazioni di stampa in magazzino o inserti nei pacchi cliente.
- Volete riusare un unico layout approvato tra magazzini, brand o canali di vendita.
- Potrebbe servirvi un codice a barre o un QR code per cercare l'ordine o gestire l'accettazione di un reso.
Cosa non sostituisce
- Vi serve acquistare affrancatura, calcolare una tariffa di spedizione o creare un'etichetta del corriere.
- Vi serve gestione dell'inventario di magazzino invece del rendering di documenti.
- Vi servono semantiche di fattura legale o fattura elettronica.
Quale endpoint chiamare
/api/v1/template-render
Template Render è il percorso predefinito per questo flusso.
/api/v1/pdf/render
Usalo quando il flusso richiede l'API collegata, un contratto di template o una verifica delle capacità.
Request minimo
POST /api/v1/template-render - template packing_list con una spedizione.
{
"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"
}
]
}
]
}
Cosa gestisce gPdf
- Template Render per layout di distinte di imballaggio pubblicati.
- JSON Render per pagine di distinta di imballaggio personalizzate durante la progettazione o per processi una tantum.
- Tabelle, righe articolo, blocchi indirizzo, codici a barre opzionali e output PDF.
- Ristampe deterministiche quando si usano gli stessi dati e lo stesso template.
Cosa controlla il tuo sistema
- Dati dell'ordine, quantità degli articoli, stato della spedizione, instradamento di magazzino e messaggi al cliente.
- Mappatura dei campi del template, instradamento verso le postazioni di stampa e criteri di ristampa.
- Qualsiasi documento del corriere, doganale o di fattura che debba viaggiare con il pacco.
Checklist di produzione
- Testate le combinazioni più lunghe di SKU, nome articolo e indirizzo.
- Validate i casi con un solo articolo, più colli, backorder e spedizioni parziali.
- Usate Template Render dopo l'approvazione del layout della distinta di imballaggio.
- Registrate template_id e X-Request-Id per ogni richiesta di stampa nel processo di evasione.
- Tenete la generazione dell'etichetta del corriere separata dal rendering della distinta di imballaggio.
Limiti della promessa
- gPdf renderizza il PDF della distinta di imballaggio; non gestisce inventario né stato di evasione.
- Una distinta di imballaggio non è automaticamente una fattura fiscale o un documento doganale.
- Acquisto di etichette del corriere e calcolo tariffario della spedizione restano fuori da gPdf.
Le distinte di imballaggio sono adatte al percorso template
Le distinte di imballaggio di solito hanno una struttura stabile: mittente, destinatario, numero di spedizione, righe articolo e note opzionali. Per questo Template Render è una scelta solida dopo l’approvazione del layout.
JSON Render resta utile durante la progettazione. Permette al team di regolare
colonne, spaziature, posizione dei codici a barre e interruzioni di pagina prima
di pubblicare il contratto stabile template_id.
FAQ
- La distinta di imballaggio usa un endpoint gPdf separato?
- No. Usate Template Render per un template di distinta di imballaggio approvato, oppure JSON Render quando il vostro sistema descrive direttamente il layout.
- Le distinte di imballaggio possono includere codici a barre?
- Sì. gPdf può renderizzare elementi codice a barre nel PDF. Il vostro sistema possiede il contenuto codificato per ordine, collo o accettazione reso.
- gPdf crea etichette del corriere?
- No. Le etichette del corriere sono un processo separato. gPdf renderizza PDF dai dati forniti dal vostro corriere o sistema di spedizione.
- Una richiesta può renderizzare più distinte di imballaggio?
- Template Render accetta un array `data` per più elementi in una sola richiesta, entro i limiti dell'API pubblica documentati per quell'endpoint.