API voor 4x6 PDF-verzendlabels
Genereer printklare 4x6-verzendlabel-PDF's vanuit order-JSON met vectorbarcodes, labelformaten en deterministische magazijnreprints.
/api/v1/pdf/render Render PDF's op labelformaat vanuit order-, ontvanger-, service- en trackingdata, zodat een magazijn- of e-commercebackend hetzelfde 4x6-label betrouwbaar kan printen tijdens fulfilment en het indien nodig deterministisch opnieuw kan printen.
Wanneer deze API past
- Uw systeem al het trackingnummer, de bestemming, servicetekst en barcodepayload bevat.
- U PDF-output nodig hebt voor Zebra-, SATO-, Honeywell- of andere thermische printerworkflows.
- U vectormodules voor barcodes wilt in plaats van rasterbarcodeafbeeldingen die in een PDF zijn geplakt.
- U dezelfde payload nodig hebt om hetzelfde label te renderen voor reprints en auditbewijs.
Wat dit niet vervangt
- U porto wilt kopen, een zending wilt prijzen of een carrierlabel via een carrieraccount wilt aanmaken.
- U een ZPL-vervangend endpoint nodig hebt. gPdf retourneert PDF, geen printercommandotaal.
- U carriercertificering van gPdf nodig hebt. Scanner- en carrieracceptatietests blijven uw verantwoordelijkheid.
Welk endpoint aanroepen
/api/v1/pdf/render
JSON Render is het standaardpad voor deze workflow.
/api/v1/template-render
Gebruik dit wanneer de workflow een verwant API-pad, templatecontract of capability lookup nodig heeft.
Minimale request
POST /api/v1/pdf/render - minimaal 4x6-label met trackingbarcode.
{
"pages": [
{
"size": "label_4_6_in",
"elements": [
{
"type": "text",
"x": 4,
"y": 6,
"content": "SHIP TO",
"style": { "font_size": 8, "font_family": "NotoSans-Regular" }
},
{
"type": "text",
"x": 4,
"y": 13,
"content": "Acme Warehouse\n1200 Logistics Pkwy\nMemphis TN 38116",
"style": { "font_size": 11, "font_family": "NotoSans-Regular" }
},
{
"type": "barcode",
"format": "code128",
"content": "1Z999AA10123456784",
"x": 4,
"y": 62,
"width": 92,
"height": 22,
"barcode_text": { "enabled": true, "position": "bottom" }
}
]
}
]
}
Wat gPdf afhandelt
- PDF-pagina's op labelformaat, zoals 4x6 inch-workflows.
- Vectorbarcoderendering voor carrier- en magazijnlabelcontent.
- Tekst, adresblokken, servicemarkeringen, lijnen, kaders en optionele template-binding.
- Deterministische PDF-output voor magazijnreprints.
Wat uw systeem beheert
- Carrieraccount, portoaankoop, servicekeuze en het aanmaken van trackingnummers.
- Correcte barcodepayloads, leesbare tekst, adressen en routeringsdata.
- Printerconfiguratie, labelmateriaal, scantests en carrieracceptatiechecks.
Productiechecklist
- Print testlabels op het echte printermodel en het echte labelmateriaal.
- Verifieer barcodescanpercentages op de doel-DPI en scannerafstand.
- Bewaar brondata van de zending of de teruggegeven PDF volgens uw reprintbeleid.
- Gebruik Template Render zodra de labellayout is goedgekeurd en door meerdere systemen wordt hergebruikt.
- Houd carrierspecifieke logica buiten de renderrequest.
Grenzen van de claim
- gPdf rendert de label-PDF; het koopt geen porto en communiceert niet direct met carriers.
- gPdf is geen certificeringsinstantie voor carrierlabels.
- De API levert PDF-output, geen ZPL, EPL of andere commandostream voor thermische printers.
De vorm van de shipping label API
Verzendlabelpagina’s zijn geen apart carrierendpoint. U roept JSON Render aan met een pagina op labelformaat, tekstblokken, lijnen, optionele afbeeldingen en barcode-elementen. Voor herhaalde labels publiceert u de goedgekeurde layout als template en roept u Template Render aan met zendingsdata.
Zo blijft de eigendomsgrens duidelijk. gPdf beheert PDF-rendering en barcodetekening. Uw systeem beheert de carriertransactie, verzendstatus en payloadsemantiek.
JSON Render versus Template Render
Gebruik JSON Render wanneer uw fulfilmentsysteem de volledige layout genereert of wanneer het operationele team coördinaten nog afstemt. Gebruik Template Render wanneer het magazijn een stabiele labellayout heeft goedgekeurd en elke caller dezelfde datavelden moet sturen.
Beide paden retourneren PDF-output. Het verschil is of de caller bij elke
request de layout beschrijft of verwijst naar een gepubliceerd template_id.
Printtests blijven essentieel
Kwaliteit van thermische labels is fysiek. Valideer de output op echt labelmateriaal, echte printers en echte scanners. Correctheid van barcodepayloads, quiet zones, printerdonkerte en carrierspecifieke regels zijn productieverantwoordelijkheden buiten de rendering-API.
FAQ
- Maakt gPdf carrierlabels voor mij aan?
- Nee. Uw carrier- of verzendsysteem maakt de carrierzending en barcodepayload aan. gPdf rendert die data naar een PDF-label.
- Kan ik Template Render gebruiken voor verzendlabels?
- Ja. Gebruik JSON Render tijdens het ontwerpen of testen van het label, en gebruik daarna Template Render wanneer de layout stabiel is en callers alleen data moeten sturen.
- Levert gPdf ZPL-output?
- Nee. De publieke render-API's leveren PDF-output. Als uw printpad ZPL nodig heeft, converteer of routeer de PDF buiten gPdf.
- Wat moet ik valideren voor productie?
- Print op de echte printer en het echte labelmateriaal, scan de barcode met productiescanners en bevestig dat carrierspecifieke tekst en payloads uit uw verzendsysteem komen.