GS1 barcode API for vector PDF labels
Render vector GS1 barcodes in PDFs, including GS1-128, GS1 DataMatrix, GS1 QR, ITF-14, and SSCC-18 label workflows.
/api/v1/pdf/render Render GS1 barcode payloads into vector PDF labels or documents while your product, warehouse, or retail system remains responsible for correct application identifiers, check digits, and scanner acceptance.
When to use this API
- You need barcode modules drawn as vector PDF content rather than pasted bitmap images.
- Your system already has the correct GS1 payload and human-readable interpretation.
- You need GS1-128, GS1 DataMatrix, GS1 QR, ITF-14, or SSCC-18 workflows in labels or documents.
- You want repeated barcode label layouts to move into Template Render.
What it does not replace
- You need GS1 certification or validation of product-data semantics from gPdf.
- You need gPdf to allocate GS1 company prefixes, GTINs, SSCCs, or check digits.
- You need inventory or product master data management.
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 - GS1-128 style PDF barcode element.
{
"pages": [
{
"size": "label_4_6_in",
"elements": [
{
"type": "barcode",
"format": "gs1-128",
"content": "(00)012345678901234567",
"x": 8,
"y": 22,
"width": 86,
"height": 24,
"barcode_text": { "enabled": true, "position": "bottom" }
},
{
"type": "text",
"x": 8,
"y": 56,
"content": "SSCC pallet label",
"style": { "font_size": 10, "font_family": "NotoSans-Regular" }
}
]
}
]
}
What gPdf handles
- Vector barcode rendering inside PDF output.
- Barcode placement with text, lines, product data, and label structures.
- Template Render for repeated product, pallet, carton, and warehouse labels.
- PDF output suitable for scanner and print tests.
What your system owns
- GS1 application identifiers, company prefixes, GTINs, SSCCs, and check digits.
- Correct barcode data, product data, regulatory text, and scanner acceptance tests.
- Print process, label stock, quiet zones, and operational QA.
Production checklist
- Generate the GS1 payload upstream and keep it testable.
- Print and scan on production printers and scanners.
- Validate quiet zones, module size, human-readable text, and label stock.
- Use Template Render once the label layout is approved.
- Document that gPdf renders barcodes but does not certify GS1 compliance.
Claim boundaries
- gPdf renders vector PDF barcodes; it is not a GS1 certification body.
- The caller owns GS1 data semantics and check digits.
- Scanner acceptance must be validated in the caller's production environment.
GS1 barcode rendering is a PDF rendering job
gPdf is responsible for drawing the barcode into the PDF. It is not responsible for deciding whether a GTIN, SSCC, or application-identifier sequence is valid for your business. Keep that logic in your ERP, WMS, product-information system, or GS1 tooling.
Use JSON Render or Template Render
Use JSON Render when code lays out the label or document directly. Use Template Render when the barcode is one field inside a repeated label layout. In both cases, the caller sends the payload that should be encoded.
Validate with real scanners
Barcode success is measured by scanner acceptance, not by whether an image looks correct on a monitor. Validate printed output with the same printers, scanners, and label stock used in production.
FAQ
- Does gPdf certify GS1 labels?
- No. gPdf renders vector barcode graphics in PDFs. Your team owns GS1 payload correctness, scanner tests, and any certification workflow.
- Can GS1 barcodes be used with Template Render?
- Yes. A published template can contain barcode fields, and callers can send only the variable data for repeated label layouts.
- Who creates the SSCC or GTIN?
- Your product, warehouse, or ERP system creates and validates identifiers. gPdf receives the payload and renders it.
- Why use vector barcodes?
- Vector modules avoid raster scaling artifacts and keep label PDFs sharper across printer DPI and zoom levels.