API voor pakbon-PDF's voor fulfilmentprocessen
Genereer pakbon-PDF's vanuit order-, zendings-, doos- en itemdata voor e-commerce-, 3PL-, OMS- en magazijnfulfilmentprocessen.
/api/v1/template-render Render pakbonnen vanuit zendings-, ontvanger-, item- en doosdata, zodat fulfilmentteams voor elke uitgaande order een consistent document kunnen printen of toevoegen.
Wanneer deze API past
- Uw OMS of WMS al orderregels, aantallen, ontvangerdata en zendingsidentificatoren bevat.
- U een PDF-pakbon nodig hebt voor magazijnprintstations of als bijlage in klantpakketten.
- U een goedgekeurde layout wilt hergebruiken over magazijnen, merken of verkoopkanalen.
- U mogelijk een barcode of QR-code nodig hebt voor orderopzoeking of retourinname.
Wat dit niet vervangt
- U porto wilt kopen, een zendingstarief wilt bepalen of een vervoerdersetiket wilt aanmaken.
- U magazijnvoorraadbeheer nodig hebt in plaats van documentrendering.
- U juridische factuur- of e-invoice-semantiek nodig hebt.
Welk endpoint aanroepen
/api/v1/template-render
Template Render is het standaardpad voor deze workflow.
/api/v1/pdf/render
Gebruik dit wanneer de workflow een verwant API-pad, templatecontract of capability lookup nodig heeft.
Minimale request
POST /api/v1/template-render - packing_list-template met een zending.
{
"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"
}
]
}
]
}
Wat gPdf afhandelt
- Template Render voor gepubliceerde pakbonlayouts.
- JSON Render voor maatwerkpakbonpagina's tijdens ontwerp of eenmalige processen.
- Tabellen, itemregels, adresblokken, optionele barcodes en PDF-output.
- Deterministische reprints wanneer dezelfde data en template worden gebruikt.
Wat uw systeem beheert
- Orderdata, itemaantallen, zendingsstatus, magazijnroutering en klantcommunicatie.
- Template-veldmapping, routering naar printstations en reprintbeleid.
- Elk vervoerders-, douane- of factuurdocument dat met het pakket moet meegaan.
Productiechecklist
- Test de langste SKU-, itemnaam- en adrescombinaties.
- Valideer cases met een item, meerdere dozen, backorders en deelzendingen.
- Gebruik Template Render nadat de pakbonlayout is goedgekeurd.
- Log template_id en X-Request-Id voor elke fulfilmentprintaanvraag.
- Houd het aanmaken van vervoerdersetiketten gescheiden van pakbonrendering.
Grenzen van de claim
- gPdf rendert de pakbon-PDF; het beheert geen voorraad of fulfilmentstatus.
- Een pakbon is niet automatisch een belastingfactuur of douanedocument.
- Aankoop van vervoerdersetiketten en tariefbepaling voor zendingen vallen buiten gPdf.
Pakbonnen passen bij het templatepad
Pakbonnen hebben meestal een stabiele structuur: afzender, ontvanger, zendingsnummer, itemregels en optionele notities. Daardoor is Template Render een sterke keuze zodra de layout is goedgekeurd.
JSON Render blijft belangrijk tijdens het ontwerp. Daarmee kan uw team
kolommen, spacing, barcodeplaatsing en pagina-overgangen afstemmen voordat het
stabiele template_id-contract wordt gepubliceerd.
FAQ
- Is een pakbon een apart gPdf-endpoint?
- Nee. Gebruik Template Render voor een goedgekeurde pakbontemplate of JSON Render wanneer uw systeem de layout direct beschrijft.
- Kunnen pakbonnen barcodes bevatten?
- Ja. gPdf kan barcode-elementen in de PDF renderen. Uw systeem beheert de gecodeerde order-, doos- of retourpayload.
- Maakt gPdf vervoerdersetiketten?
- Nee. Vervoerdersetiketten zijn een apart proces. gPdf rendert PDF's vanuit de data die uw vervoerder- of verzendsysteem levert.
- Kan een request meerdere pakbonnen renderen?
- Template Render accepteert een data-array voor meerdere items in een request, binnen de publieke API-limieten die voor dat endpoint zijn gedocumenteerd.