GS1 Barcode API для векторних PDF-етикеток
Рендерте векторні GS1 штрихкоди в PDF, зокрема GS1-128, GS1 DataMatrix, GS1 QR, ITF-14 і процеси етикеток SSCC-18.
/api/v1/pdf/render Рендерити дані GS1-штрихкодів у векторні PDF-етикетки або документи, поки ваша товарна, складська система або система роздрібної торгівлі відповідає за правильні application identifiers, check digits і прийняття сканером.
Коли використовувати цю API
- Потрібно малювати модулі штрихкоду як векторний PDF-вміст, а не вставляти растрові зображення.
- У вашій системі вже є коректні GS1-дані й читабельна для людини інтерпретація.
- Потрібні процеси GS1-128, GS1 DataMatrix, GS1 QR, ITF-14 або SSCC-18 в етикетках чи документах.
- Потрібно перенести повторювані макети етикеток зі штрихкодами у Template Render.
Що вона не замінює
- Потрібна сертифікація GS1 або валідація семантики товарних даних від gPdf.
- Потрібно, щоб gPdf виділяв GS1 company prefixes, GTINs, SSCCs або check digits.
- Потрібне керування залишками або майстер-даними товарів.
Який шлях API викликати
/api/v1/pdf/render
JSON Render — типовий шлях для цього сценарію.
/api/v1/template-render
Використовуйте, коли сценарію потрібен пов’язаний API-шлях, контракт шаблону або перевірка можливостей.
Мінімальний запит
POST /api/v1/pdf/render - PDF-елемент штрихкоду у стилі 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
- Рендеринг векторних штрихкодів усередині PDF-виводу.
- Розміщення штрихкоду разом із текстом, лініями, даними товару і структурами етикетки.
- Template Render для повторюваних товарних, палетних, коробкових і складських етикеток.
- PDF-вивід, придатний для тестів сканування й друку.
Що контролює ваша система
- GS1 application identifiers, company prefixes, GTINs, SSCCs і check digits.
- Коректні дані штрихкоду, дані товару, регуляторний текст і тести прийняття сканером.
- Процес друку, матеріал етикеток, quiet zones і операційний QA.
Чеклист для робочого запуску
- Генеруйте GS1-дані вище за gPdf і тримайте їх тестованими.
- Друкуйте й скануйте на бойових принтерах і сканерах.
- Валідуйте quiet zones, розмір модуля, людинозчитуваний текст і матеріал етикетки.
- Використовуйте Template Render після затвердження макета етикетки.
- Задокументуйте, що gPdf рендерить штрихкоди, але не сертифікує відповідність GS1.
Межі заявлених можливостей
- gPdf рендерить векторні PDF-штрихкоди; він не є органом сертифікації GS1.
- Сервіс-викликач відповідає за семантику GS1-даних і check digits.
- Прийняття сканером потрібно валідувати в бойовому середовищі сервісу-викликача.
Рендеринг GS1-штрихкодів — це задача PDF-рендерингу
gPdf відповідає за малювання штрихкоду в PDF. Він не відповідає за рішення, чи GTIN, SSCC або послідовність application identifiers є валідними для вашого бізнесу. Тримайте цю логіку у вашому ERP, WMS, системі товарної інформації або GS1-інструментах.
Використовуйте JSON Render або Template Render
Використовуйте JSON Render, коли код напряму розкладає етикетку або документ. Використовуйте Template Render, коли штрихкод є одним полем у повторюваному макеті етикетки. В обох випадках сервіс-викликач надсилає дані, які потрібно закодувати.
Валідуйте реальними сканерами
Успішність штрихкоду вимірюється прийняттям сканером, а не тим, чи зображення добре виглядає на моніторі. Валідуйте надрукований вивід на тих самих принтерах, сканерах і матеріалі етикеток, які використовуються в бойовому середовищі.
FAQ
- Чи сертифікує gPdf GS1-етикетки?
- Ні. gPdf рендерить векторну графіку штрихкодів у PDF. Ваша команда відповідає за коректність GS1-даних, тести сканування й будь-який процес сертифікації.
- Чи можна використовувати GS1 штрихкоди з Template Render?
- Так. Опублікований шаблон може містити поля штрихкоду, а сервіси-викликачі можуть надсилати лише змінні дані для повторюваних макетів етикеток.
- Хто створює SSCC або GTIN?
- Ваша товарна, складська або ERP-система створює й валідує ідентифікатори. gPdf отримує дані й рендерить їх.
- Навіщо використовувати векторні штрихкоди?
- Векторні модулі уникають артефактів масштабування растру й зберігають PDF-етикетки чіткішими на різних DPI принтера та рівнях zoom.