Barcodes and retail
SSCC label API for GS1 logistics PDFs
Render SSCC-18 barcode labels in PDF for logistics, pallet, carton, and warehouse workflows while your system owns GS1 payload correctness.
PRIMARY API JSON Render
ENDPOINT
/api/v1/pdf/render SYSTEMS WMS / 3PL backend / retail logistics system / warehouse print service
Job to be done
Render SSCC-18 barcode labels as vector PDF output for pallet, carton, or logistics units after your system has assigned the serial shipping container code and verified its GS1 semantics.
When to use this API
- Your system already owns the SSCC value and any related application identifiers.
- You need a PDF label with a scannable SSCC barcode and human-readable text.
- You need repeated SSCC label layouts for warehouse or 3PL print stations.
- You want to connect SSCC labels to broader pallet or warehouse label workflows.
What it does not replace
- You need GS1 prefix issuance, check digit creation, or compliance certification from gPdf.
- You need inventory or shipment state management.
- You need carrier label purchase or rating.
Which endpoint to call
/api/v1/pdf/render
JSON Render is the default path for this workflow.
/api/v1/template-render
Use this when the workflow needs the related API path, template contract, or capabilities lookup.
Minimal request
POST /api/v1/pdf/render - SSCC-18 label barcode.
{
"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" }
}
]
}
]
}
What gPdf handles
- Vector SSCC barcode rendering inside PDF pages.
- Label layout with text, boxes, barcode text, and optional template binding.
- PDF output for print, storage, or warehouse reprint workflows.
- Shared error envelope when a request fails validation.
What your system owns
- GS1 company prefix, extension digit, serial reference, check digit, and encoded payload.
- Warehouse process rules, scanner acceptance, and label stock validation.
- Any EDI, ASN, carrier, or trading-partner workflow that consumes the SSCC.
Production checklist
- Validate the SSCC value and check digit before calling gPdf.
- Scan output with production scanners and label stock.
- Document which warehouse events create and reprint SSCC labels.
- Use Template Render for approved SSCC label layouts.
- Keep trading-partner compliance checks outside the render call.
Claim boundaries
- gPdf renders the SSCC barcode as PDF; it does not issue or certify SSCC values.
- GS1 and trading-partner compliance remain your responsibility.
- SSCC labels do not imply carrier shipment creation.
SSCC labels are a focused barcode workflow
SSCC labels are narrower than general pallet labels. The important fact is the serial shipping container code itself. gPdf renders the code in a PDF; your system owns code assignment, GS1 rules, and trading-partner requirements.
FAQ
- Can gPdf create an SSCC number?
- No. Your system creates and validates the SSCC value. gPdf renders it as a barcode in a PDF.
- Which barcode format should I use?
- Use the supported SSCC alias such as sscc-18 when rendering an SSCC barcode element.
- Can this be a template?
- Yes. Most SSCC labels should move to Template Render after the layout and field mapping are approved.
- Does this certify GS1 compliance?
- No. gPdf renders vector barcode output. Compliance and scanner acceptance are separate responsibilities.