API паллетных этикеток для warehouse и 3PL workflows
Генерируйте PDF паллетных этикеток для warehouse, 3PL, retail и logistics workflows: с SSCC, GS1-128, текстовыми блоками и reprint-safe templates.
/api/v1/pdf/render Рендерить PDF паллетных этикеток из WMS, ERP или 3PL data, чтобы складские команды могли идентифицировать паллеты, сканировать SSCC или GS1 barcodes и перепечатывать ту же этикетку при receiving, shipping или inventory moves.
Когда использовать эту API
- Ваша WMS уже содержит pallet ID, SKU или GTIN data, quantity, lot и destination.
- Нужна PDF-этикетка с SSCC, GS1-128 или другим поддерживаемым barcode format.
- Нужна детерминированная перепечатка из того же source payload.
- Layout должен стать стабильным контрактом Template Render.
Что она не заменяет
- Нужно, чтобы gPdf управлял inventory, palletization или warehouse tasks.
- Нужна GS1 certification вместо PDF barcode rendering.
- Нужен direct printer command output.
Какой endpoint вызывать
/api/v1/pdf/render
JSON Render — путь по умолчанию для этого сценария.
/api/v1/template-render
Используйте, когда сценарию нужен связанный API-путь, контракт шаблона или проверка возможностей.
Минимальный запрос
POST /api/v1/pdf/render - паллетная этикетка со штрихкодом SSCC.
{
"pages": [
{
"size": "label_4_6_in",
"elements": [
{
"type": "text",
"x": 5,
"y": 7,
"content": "PALLET 12 / DOCK B",
"style": { "font_size": 13, "font_family": "NotoSans-Regular" }
},
{
"type": "barcode",
"format": "sscc-18",
"content": "000123456789012345",
"x": 5,
"y": 28,
"width": 92,
"height": 30,
"barcode_text": { "enabled": true, "position": "bottom" }
},
{
"type": "text",
"x": 5,
"y": 78,
"content": "GTIN 09506000134352\nQTY 48 CASES\nLOT L-2026-05",
"style": { "font_size": 10, "font_family": "NotoSans-Regular" }
}
]
}
]
}
Что выполняет gPdf
- Label-size PDF-страницы с текстом, рамками и barcode elements.
- SSCC, GS1-128, Code 128, QR и другие поддерживаемые barcode formats в PDF output.
- Template binding для утвержденных pallet label layouts.
- Детерминированный output для reprints и audit evidence.
Что контролирует ваша система
- Pallet identity, product data, lot data, quantity, routing и warehouse rules.
- Корректность barcode payload, check digits, scanner tests и label stock validation.
- Print station routing, reprint authorization и inventory state.
Production-чеклист
- Проверьте SSCC или GS1 payload перед рендерингом.
- Сканируйте этикетки production-сканерами на receiving и shipping stations.
- Проверьте dense data, длинные product names и потребность в нескольких языках склада.
- Записывайте `template_id`, source pallet ID и request ID для перепечатки.
- Держите warehouse state transitions вне render API.
Границы заявлений
- gPdf рендерит PDF паллетных этикеток; он не управляет паллетами или warehouse inventory.
- gPdf не является GS1 certification body.
- Scanner acceptance и корректность warehouse process остаются на вашей стороне.
Паллетные этикетки соединяют WMS data и печать
Workflow паллетной этикетки начинается в вашей WMS или ERP. Она решает, какие данные pallet, product, quantity, lot и route должны попасть на этикетку. gPdf превращает эти данные в PDF, который warehouse print stations могут вывести на печать и перепечатать.
Используйте более узкую страницу SSCC, когда search intent касается конкретно SSCC-18 или GS1 logistics labeling. Эту страницу используйте для более широкого pallet label workflow.
FAQ
- Может ли gPdf генерировать SSCC pallet labels?
- gPdf может рендерить SSCC barcode elements в PDF output. Ваша система отвечает за SSCC value и GS1 semantics.
- Управляет ли gPdf pallet inventory?
- Нет. WMS или ERP systems владеют inventory state. gPdf рендерит PDF-этикетку.
- Можно ли использовать Template Render для паллетных этикеток?
- Да. Template Render обычно является production path после утверждения pallet label layout.
- Сертифицирует ли gPdf GS1 labels?
- Нет. gPdf рендерит векторные PDF-штрихкоды. Certification, scan tests и acceptance остаются вашей ответственностью.