API per packing slip PDF nei sistemi di produzione
Genera packing slip PDF da dati backend strutturati, senza browser, con confini chiari tra il PDF renderizzato da gPdf e le regole del tuo sistema.
/api/v1/template-render Generare packing slip PDF 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 packing slip PDF 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/template-render
Template Render è il percorso predefinito per questo workflow.
/api/v1/pdf/render
Usalo quando il workflow richiede l’API collegata, un contratto di template o una verifica delle capacità.
Request minimo
/api/v1/template-render - packing slip PDF
{
"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
- Rendering PDF di packing slip PDF 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 packing slip PDF, 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 PDF operativi; non è un connettore marketplace ufficiale né un OMS.
- Il tuo sistema mantiene ordini, fulfillment, chiamate marketplace e regole cliente.
Forma dell’API
API per packing slip PDF è 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/template-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 packing slip PDF 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 packing slip PDF 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.