DataMatrix Barcode API для векторного PDF-виводу
Рендерте DataMatrix і GS1 DataMatrix штрихкоди в PDF-етикетках і документах для товарних, медичних, роздрібних і складських процесів.
/api/v1/pdf/render Рендерити дані DataMatrix або GS1 DataMatrix як векторні елементи штрихкоду в товарних етикетках, складських етикетках або документах, поки ваша система відповідає за закодовані бізнес-дані.
Коли використовувати цю API
- Потрібен 2D DataMatrix штрихкод у PDF-документі або етикетці.
- Ваш застосунок уже знає закодований ідентифікатор, партію, серійний номер або дані товару.
- Потрібні повторювані макети DataMatrix-етикеток через Template Render.
- Потрібен векторний вивід штрихкоду замість растрових зображень, вбудованих у PDF.
Що вона не замінює
- Потрібна регуляторна сертифікація, затвердження маркування пристрою або сертифікація GS1 від gPdf.
- Потрібно, щоб gPdf генерував бізнес-ідентифікатори або перевіряв зовнішні реєстри.
- Потрібне керування парком сканерів.
Який шлях API викликати
/api/v1/pdf/render
JSON Render — типовий шлях для цього сценарію.
/api/v1/template-render
Використовуйте, коли сценарію потрібен пов’язаний API-шлях, контракт шаблону або перевірка можливостей.
Мінімальний запит
POST /api/v1/pdf/render - GS1 DataMatrix штрихкод на товарній етикетці.
{
"pages": [
{
"size": "label_100_100",
"elements": [
{
"type": "barcode",
"format": "gs1-datamatrix",
"content": "(01)09506000134352(10)LOT26A",
"x": 10,
"y": 14,
"width": 34,
"height": 34
},
{
"type": "text",
"x": 10,
"y": 56,
"content": "GTIN 09506000134352\nLOT LOT26A",
"style": { "font_size": 9, "font_family": "NotoSans-Regular" }
}
]
}
]
}
Що виконує gPdf
- Рендеринг векторних DataMatrix і GS1 DataMatrix штрихкодів у PDF.
- Макет етикетки або документа навколо штрихкоду.
- Прив’язку шаблону для повторюваних товарних або складських етикеток.
- Бінарний PDF-вивід для друку, архіву або завантаження.
Що контролює ваша система
- Вміст закодованих даних, application identifiers, серійні номери, партії й регуляторний текст.
- Тести сканування, валідацію розміру модулів, матеріал етикеток і критерії прийняття.
- Будь-який галузевий процес відповідності, який споживає штрихкод.
Чеклист для робочого запуску
- Перевіряйте синтаксис даних перед рендерингом.
- Друкуйте й скануйте у бойовому розмірі, DPI та матеріалі.
- Тестуйте довгі ідентифікатори й кілька мовних варіантів товару.
- Тримайте сертифікацію й регуляторний перегляд поза gPdf.
- Використовуйте Template Render для затверджених сімейств етикеток.
Межі заявлених можливостей
- gPdf рендерить DataMatrix штрихкоди; він не сертифікує регуляторну відповідність.
- Ваша система відповідає за семантику даних штрихкоду й прийняття сканером.
- Векторний рендеринг не замінює фізичну валідацію друку.
DataMatrix у PDF — це задача рендерингу
DataMatrix штрихкоди часто несуть товарні або логістичні ідентифікатори. Важлива межа — дані. gPdf рендерить векторний штрихкод зі значення, яке ви надсилаєте; ваша система вирішує, що це значення означає і чи відповідає воно зовнішнім вимогам.
FAQ
- Чи підтримує gPdf DataMatrix штрихкоди?
- Так. Публічна schema перелічує datamatrix і GS1 DataMatrix aliases форматів штрихкоду.
- Чи валідує gPdf регуляторний вміст?
- Ні. gPdf рендерить штрихкод. Ваша система відповідає за коректність даних і регуляторний перегляд.
- Чи можуть DataMatrix-етикетки використовувати Template Render?
- Так. Використовуйте Template Render, коли повторюваний макет етикетки має приймати лише бізнес-дані.
- Чи все одно потрібне тестування сканування?
- Так. Завжди валідуйте бойовими принтерами, матеріалами й сканерами.