API per etichette di spedizione in PDF 4x6
Genera PDF di etichette di spedizione 4x6 pronti per la stampa da JSON d'ordine, con codici a barre vettoriali, formati pagina per etichette e ristampe di magazzino deterministiche.
/api/v1/pdf/render Renderizzare PDF in formato etichetta da dati di ordine, destinatario, servizio e tracciamento, così un backend di magazzino o ecommerce può stampare la stessa etichetta 4x6 in modo affidabile durante l'evasione ordine e ristamparla in modo deterministico quando serve.
Quando usare questa API
- Il vostro sistema ha già numero di tracciamento, destinazione, testo del servizio e contenuto del codice a barre.
- Vi serve output PDF per flussi di stampa con Zebra, SATO, Honeywell o altre stampanti termiche.
- Volete codici a barre vettoriali invece di immagini raster incollate in un PDF.
- Vi serve che lo stesso contenuto renderizzi la stessa etichetta per ristampe ed evidenze di audit.
Cosa non sostituisce
- Vi serve acquistare affrancatura, calcolare una tariffa di spedizione o creare un'etichetta del corriere tramite account del vettore.
- Vi serve un endpoint sostitutivo di ZPL. gPdf restituisce PDF, non linguaggio di comando stampante.
- Vi serve una certificazione del vettore da gPdf. Test scanner e accettazione del vettore restano vostri.
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 4x6 minima con codice a barre di tracciamento.
{
"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" }
}
]
}
]
}
Cosa gestisce gPdf
- Pagine PDF in formato etichetta, inclusi flussi 4x6 pollici.
- Rendering di codici a barre vettoriali per contenuti del vettore ed etichette di magazzino.
- Testo, blocchi indirizzo, marcature del servizio, linee, riquadri e associazione opzionale al template.
- Output PDF deterministico per ristampe di magazzino.
Cosa controlla il tuo sistema
- Account del vettore, acquisto affrancatura, selezione servizio e creazione del numero di tracciamento.
- Contenuti corretti dei codici a barre, testo leggibile, indirizzi e dati di routing.
- Configurazione stampanti, supporto etichetta, test di scansione e controlli di accettazione del vettore.
Checklist di produzione
- Stampate etichette di test sul modello reale di stampante e sul supporto etichetta reale.
- Verificate i tassi di lettura dei codici a barre al DPI e alla distanza scanner target.
- Conservate i dati sorgente della spedizione o il PDF restituito secondo i vostri criteri di ristampa.
- Usate Template Render dopo l'approvazione del layout etichetta e il riuso tra sistemi.
- Tenete la logica specifica del vettore fuori dalla richiesta di rendering.
Limiti della promessa
- gPdf renderizza il PDF dell'etichetta; non acquista affrancatura né parla direttamente con vettori o corrieri.
- gPdf non è un'autorità di certificazione per etichette dei vettori.
- L'API produce output PDF, non ZPL, EPL o un altro flusso di comandi per stampanti termiche.
Forma dell’API per etichette di spedizione
Le pagine di etichetta di spedizione non sono un endpoint separato del vettore. Chiamate JSON Render con una pagina in formato etichetta, blocchi di testo, linee, immagini opzionali ed elementi codice a barre. Per etichette ripetute, pubblicate il layout approvato come template e chiamate Template Render con i dati della spedizione.
Questo mantiene chiaro il confine di responsabilità. gPdf possiede rendering PDF e disegno dei codici a barre. Il vostro sistema possiede transazione con il vettore, stato della spedizione e semantica del contenuto.
JSON Render rispetto a Template Render
Usate JSON Render quando il sistema di evasione ordine genera l’intero layout o quando il team operations sta ancora regolando le coordinate. Usate Template Render quando il magazzino ha approvato un layout etichetta stabile e ogni sistema chiamante deve inviare gli stessi campi dati.
Entrambi i percorsi restituiscono output PDF. La differenza è se il sistema
chiamante descrive il layout a ogni richiesta o fa riferimento a un
template_id pubblicato.
I test di stampa contano
La qualità delle etichette termiche è fisica. Validate l’output su supporti etichetta, stampanti e scanner reali. Correttezza del contenuto del codice a barre, zone di quiete, intensità della stampante e regole specifiche del vettore sono responsabilità di produzione fuori dall’API di rendering.
FAQ
- gPdf crea etichette del corriere al posto mio?
- No. Il vostro corriere o sistema di spedizione crea la spedizione presso il vettore e il contenuto del codice a barre. gPdf renderizza quei dati in un'etichetta PDF.
- Posso usare Template Render per le etichette di spedizione?
- Sì. Usate JSON Render mentre progettate o testate l'etichetta, poi Template Render quando il layout è stabile e i sistemi chiamanti devono inviare solo dati.
- gPdf produce ZPL?
- No. Le API pubbliche di rendering producono PDF. Se il vostro percorso di stampa richiede ZPL, convertite o instradate il PDF fuori da gPdf.
- Cosa devo validare prima della produzione?
- Stampate su stampante e supporto etichetta reali, scansionate il codice a barre con scanner di produzione e confermate che testo e contenuti specifici del vettore arrivino dal vostro sistema di spedizione.