API per etichette SSCC per PDF logistici GS1
Renderizza etichette con codice a barre SSCC-18 in PDF per processi logistici, pallet, colli e magazzino, mentre il vostro sistema possiede la correttezza del contenuto GS1.
/api/v1/pdf/render Renderizzare etichette con codice a barre SSCC-18 come output PDF vettoriale per pallet, colli o unità logistiche dopo che il vostro sistema ha assegnato il serial shipping container code e verificato la semantica GS1.
Quando usare questa API
- Il vostro sistema possiede già il valore SSCC e gli eventuali application identifier collegati.
- Vi serve un'etichetta PDF con codice a barre SSCC scansionabile e testo leggibile.
- Vi servono layout SSCC ripetuti per postazioni di stampa in magazzino o 3PL.
- Volete collegare le etichette SSCC a flussi di lavoro più ampi per etichette pallet o etichette di magazzino.
Cosa non sostituisce
- Vi serve da gPdf emissione del prefisso GS1, creazione del check digit o certificazione di compliance.
- Vi serve gestione dello stato inventario o spedizione.
- Vi serve acquisto o tariffazione di etichette del vettore.
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 - codice a barre etichetta SSCC-18.
{
"pages": [
{
"size": "label_100_150",
"elements": [
{
"type": "text",
"x": 6,
"y": 8,
"content": "SSCC",
"style": { "font_size": 12, "font_family": "NotoSans-Regular" }
},
{
"type": "barcode",
"format": "sscc-18",
"content": "000123456789012345",
"x": 6,
"y": 28,
"width": 86,
"height": 30,
"barcode_text": { "enabled": true, "position": "bottom" }
}
]
}
]
}
Cosa gestisce gPdf
- Rendering di codici a barre SSCC vettoriali dentro pagine PDF.
- Layout etichetta con testo, riquadri, testo del codice a barre e associazione opzionale al template.
- Output PDF per stampa, archiviazione o flussi di ristampa in magazzino.
- Struttura di errore condivisa quando una richiesta non supera la validazione.
Cosa controlla il tuo sistema
- Prefisso aziendale GS1, extension digit, serial reference, check digit e contenuto codificato.
- Regole operative di magazzino, accettazione scanner e validazione del supporto etichetta.
- Qualsiasi flusso EDI, ASN, con vettori o trading partner che consuma l'SSCC.
Checklist di produzione
- Validate valore SSCC e check digit prima di chiamare gPdf.
- Scansionate l'output con scanner di produzione e supporto etichetta reale.
- Documentate quali eventi di magazzino creano e ristampano etichette SSCC.
- Usate Template Render per layout di etichette SSCC approvati.
- Tenete i controlli di compliance dei trading partner fuori dalla chiamata di rendering.
Limiti della promessa
- gPdf renderizza il codice a barre SSCC come PDF; non emette né certifica valori SSCC.
- Compliance GS1 e dei trading partner restano vostra responsabilità.
- Le etichette SSCC non implicano creazione di spedizioni presso vettori.
Le etichette SSCC sono un flusso di lavoro mirato per codici a barre
Le etichette SSCC sono più specifiche delle etichette pallet generiche. Il dato centrale è il serial shipping container code. gPdf renderizza il codice in un PDF; il vostro sistema possiede assegnazione del codice, regole GS1 e requisiti dei partner commerciali.
FAQ
- gPdf può creare un numero SSCC?
- No. Il vostro sistema crea e valida il valore SSCC. gPdf lo renderizza come codice a barre in un PDF.
- Quale formato di codice a barre devo usare?
- Usate l'alias SSCC supportato, come sscc-18, quando renderizzate un elemento codice a barre SSCC.
- Può diventare un template?
- Sì. La maggior parte delle etichette SSCC dovrebbe passare a Template Render dopo l'approvazione di layout e mappatura dei campi.
- Questo certifica la compliance GS1?
- No. gPdf renderizza output con codici a barre vettoriali. Compliance e accettazione scanner sono responsabilità separate.