API SSCC-этикеток для GS1 logistics PDFs
Рендерьте SSCC-18 barcode labels в PDF для logistics, pallet, carton и warehouse workflows, пока ваша система отвечает за корректность GS1 payload.
/api/v1/pdf/render Рендерить SSCC-18 barcode labels как векторный PDF output для паллет, коробов или logistics units после того, как ваша система назначила serial shipping container code и проверила его GS1 semantics.
Когда использовать эту API
- Ваша система уже владеет SSCC value и связанными application identifiers.
- Нужна PDF-этикетка со сканируемым SSCC barcode и человекочитаемым текстом.
- Нужны повторяемые SSCC label layouts для warehouse или 3PL print stations.
- Нужно связать SSCC labels с более широкими pallet или warehouse label workflows.
Что она не заменяет
- Нужно, чтобы gPdf выдавал GS1 prefix, создавал check digit или сертифицировал compliance.
- Нужно управление inventory или shipment state.
- Нужны carrier label purchase или rating.
Какой endpoint вызывать
/api/v1/pdf/render
JSON Render — путь по умолчанию для этого сценария.
/api/v1/template-render
Используйте, когда сценарию нужен связанный API-путь, контракт шаблона или проверка возможностей.
Минимальный запрос
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" }
}
]
}
]
}
Что выполняет gPdf
- Векторный рендеринг SSCC barcode внутри PDF pages.
- Layout этикетки с текстом, рамками, barcode text и опциональным template binding.
- PDF output для печати, хранения или warehouse reprint workflows.
- Единый error envelope, когда request не проходит validation.
Что контролирует ваша система
- GS1 company prefix, extension digit, serial reference, check digit и encoded payload.
- Warehouse process rules, scanner acceptance и label stock validation.
- Любой EDI, ASN, carrier или trading-partner workflow, который потребляет SSCC.
Production-чеклист
- Проверьте SSCC value и check digit перед вызовом gPdf.
- Сканируйте output production-сканерами и на реальном label stock.
- Задокументируйте, какие warehouse events создают и перепечатывают SSCC labels.
- Используйте Template Render для утвержденных SSCC label layouts.
- Держите trading-partner compliance checks вне render call.
Границы заявлений
- gPdf рендерит SSCC barcode как PDF; он не выдает и не сертифицирует SSCC values.
- GS1 и trading-partner compliance остаются вашей ответственностью.
- SSCC labels не означают создание carrier shipment.
SSCC labels — узкий barcode workflow
SSCC labels уже, чем общие паллетные этикетки. Главное здесь — сам serial shipping container code. gPdf рендерит code в PDF; ваша система отвечает за назначение code, правила GS1 и trading-partner requirements.
FAQ
- Может ли gPdf создать SSCC number?
- Нет. Ваша система создает и проверяет SSCC value. gPdf рендерит его как штрихкод в PDF.
- Какой barcode format использовать?
- Используйте поддерживаемый SSCC alias, например `sscc-18`, при рендеринге SSCC barcode element.
- Можно ли сделать это template?
- Да. Большинство SSCC labels стоит перенести в Template Render после утверждения layout и field mapping.
- Сертифицирует ли это GS1 compliance?
- Нет. gPdf рендерит векторный barcode output. Compliance и scanner acceptance — отдельные зоны ответственности.