SSCC Label API для GS1-логістичних PDF
Рендерте SSCC-18 етикетки зі штрихкодами у PDF для логістичних, палетних, коробкових і складських процесів, поки ваша система відповідає за коректність GS1-даних.
/api/v1/pdf/render Рендерити SSCC-18 етикетки зі штрихкодами як векторний PDF-вивід для палет, коробів або логістичних одиниць після того, як ваша система призначила serial shipping container code і перевірила його GS1-семантику.
Коли використовувати цю API
- Ваша система вже відповідає за значення SSCC і будь-які пов’язані application identifiers.
- Потрібна PDF-етикетка зі сканованим SSCC-штрихкодом і читабельним текстом.
- Потрібні повторювані макети SSCC-етикеток для складських або 3PL-станцій друку.
- Потрібно пов’язати SSCC-етикетки із ширшими процесами палетних або складських етикеток.
Що вона не замінює
- Потрібна видача GS1 prefix, створення check digit або сертифікація відповідності від gPdf.
- Потрібне керування залишками або станом відправлення.
- Потрібна купівля етикетки перевізника або рейтингування.
Який шлях API викликати
/api/v1/pdf/render
JSON Render — типовий шлях для цього сценарію.
/api/v1/template-render
Використовуйте, коли сценарію потрібен пов’язаний API-шлях, контракт шаблону або перевірка можливостей.
Мінімальний запит
POST /api/v1/pdf/render - штрихкод етикетки SSCC-18.
{
"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-штрихкоду всередині PDF-сторінок.
- Макет етикетки з текстом, рамками, текстом штрихкоду й необов’язковою прив’язкою шаблону.
- PDF-вивід для друку, зберігання або складських процесів передруку.
- Спільний конверт помилок, коли запит не проходить validation.
Що контролює ваша система
- GS1 company prefix, extension digit, serial reference, check digit і закодовані дані.
- Складські процесні правила, прийняття сканером і валідацію матеріалу етикеток.
- Будь-який EDI, ASN, процес перевізника або торгового партнера, який споживає SSCC.
Чеклист для робочого запуску
- Валідуйте значення SSCC і check digit перед викликом gPdf.
- Скануйте вивід бойовими сканерами й на бойовому матеріалі етикеток.
- Задокументуйте, які складські події створюють і передруковують SSCC-етикетки.
- Використовуйте Template Render для затверджених макетів SSCC-етикеток.
- Тримайте перевірки відповідності trading partner поза викликом рендерингу.
Межі заявлених можливостей
- gPdf рендерить SSCC-штрихкод як PDF; він не видає й не сертифікує значення SSCC.
- Відповідність GS1 і вимогам trading partner залишається вашою відповідальністю.
- SSCC-етикетки не означають створення відправлення перевізника.
SSCC-етикетки — це сфокусований процес штрихкоду
SSCC-етикетки вужчі за загальні палетні етикетки. Важливий факт — сам serial shipping container code. gPdf рендерить код у PDF; ваша система відповідає за призначення коду, правила GS1 і вимоги trading partners.
FAQ
- Чи може gPdf створити SSCC number?
- Ні. Ваша система створює й валідує значення SSCC. gPdf рендерить його як штрихкод у PDF.
- Який barcode format використовувати?
- Використовуйте підтримуваний SSCC alias, наприклад sscc-18, під час рендерингу елемента SSCC-штрихкоду.
- Чи може це бути шаблоном?
- Так. Більшість SSCC-етикеток варто переносити на Template Render після затвердження макета й мапінгу полів.
- Чи це сертифікує GS1 compliance?
- Ні. gPdf рендерить векторний вивід штрихкоду. Відповідність і прийняття сканером — окремі відповідальності.