GS1 barcode API для векторных PDF labels
Рендерьте векторные GS1 barcodes в PDF, включая workflows для GS1-128, GS1 DataMatrix, GS1 QR, ITF-14 и SSCC-18 labels.
/api/v1/pdf/render Рендерить GS1 barcode payloads в векторные PDF labels или documents, пока ваша product, warehouse или retail system отвечает за корректные application identifiers, check digits и scanner acceptance.
Когда использовать эту API
- Нужны barcode modules, нарисованные как векторный PDF content, а не вставленные bitmap images.
- В вашей системе уже есть корректный GS1 payload и human-readable interpretation.
- Нужны workflows GS1-128, GS1 DataMatrix, GS1 QR, ITF-14 или SSCC-18 в labels или documents.
- Повторяемые barcode label layouts должны перейти в Template Render.
Что она не заменяет
- Нужна GS1 certification или validation product-data semantics от gPdf.
- Нужно, чтобы gPdf выделял GS1 company prefixes, GTINs, SSCCs или check digits.
- Нужно управление inventory или product master data.
Какой endpoint вызывать
/api/v1/pdf/render
JSON Render — путь по умолчанию для этого сценария.
/api/v1/template-render
Используйте, когда сценарию нужен связанный API-путь, контракт шаблона или проверка возможностей.
Минимальный запрос
POST /api/v1/pdf/render - PDF barcode element в стиле GS1-128.
{
"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" }
}
]
}
]
}
Что выполняет gPdf
- Векторный barcode rendering внутри PDF output.
- Barcode placement с текстом, линиями, product data и label structures.
- Template Render для повторяемых product, pallet, carton и warehouse labels.
- PDF output, пригодный для scanner и print tests.
Что контролирует ваша система
- GS1 application identifiers, company prefixes, GTINs, SSCCs и check digits.
- Correct barcode data, product data, regulatory text и scanner acceptance tests.
- Print process, label stock, quiet zones и operational QA.
Production-чеклист
- Генерируйте GS1 payload upstream и держите его testable.
- Печатайте и сканируйте на production printers и scanners.
- Проверяйте quiet zones, module size, human-readable text и label stock.
- Используйте Template Render после утверждения label layout.
- Задокументируйте, что gPdf рендерит штрихкоды, но не сертифицирует GS1 compliance.
Границы заявлений
- gPdf рендерит векторные PDF barcodes; он не является GS1 certification body.
- Caller отвечает за GS1 data semantics и check digits.
- Scanner acceptance нужно проверять в production environment caller.
GS1 barcode rendering — это PDF rendering job
gPdf отвечает за отрисовку штрихкода в PDF. Он не отвечает за то, валидны ли GTIN, SSCC или sequence application identifiers для вашего бизнеса. Держите эту логику в ERP, WMS, product-information system или GS1 tooling.
JSON Render или Template Render
Используйте JSON Render, когда code напрямую раскладывает label или document. Используйте Template Render, когда barcode — одно поле внутри повторяемого label layout. В обоих случаях caller отправляет payload, который нужно закодировать.
Проверяйте на реальных сканерах
Успех barcode измеряется scanner acceptance, а не тем, выглядит ли image правильно на мониторе. Проверяйте printed output с теми же printers, scanners и label stock, которые используются в production.
FAQ
- Сертифицирует ли gPdf GS1 labels?
- Нет. gPdf рендерит векторную barcode graphics в PDF. Ваша команда отвечает за GS1 payload correctness, scanner tests и любой certification workflow.
- Можно ли использовать GS1 barcodes с Template Render?
- Да. Published template может содержать barcode fields, а callers могут отправлять только variable data для повторяемых label layouts.
- Кто создает SSCC или GTIN?
- Ваша product, warehouse или ERP system создает и проверяет identifiers. gPdf получает payload и рендерит его.
- Зачем использовать векторные штрихкоды?
- Векторные modules избегают raster scaling artifacts и сохраняют label PDFs более четкими при разных printer DPI и zoom levels.