API складських етикеток для друкарських процесів WMS і ERP
Генеруйте PDF палетних, коробкових, коміркових, інвентарних і складських операційних етикеток із даних WMS або ERP з детермінованими передруками.
/api/v1/pdf/render Рендерити складські етикетки з даних WMS або ERP для палет, коробів, комірок, активів, локацій і рухів запасів, залишаючи стан запасів, правила picking і складські операції у системі-викликачу.
Коли використовувати цю API
- Потрібні PDF-етикетки для палет, коробів, bins, locations, запасів або assets.
- Ваш WMS або ERP уже відповідає за SKU, lot, location, SSCC і дані запасів.
- Потрібні детерміновані передруки, коли етикетку пошкоджено або станція повторює задачу.
- Потрібно повторно використовувати затверджені макети етикеток через Template Render.
Що вона не замінює
- Потрібно, щоб gPdf керував запасами, виділяв locations або запускав складські процеси.
- Потрібен scanner app, print-station agent або label-routing system від gPdf.
- Потрібна сертифікація GS1 замість рендерингу штрихкодів.
Який шлях API викликати
/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": 6,
"y": 8,
"content": "PALLET LAX-01-2026-00042",
"style": { "font_size": 12, "font_family": "NotoSans-Regular" }
},
{
"type": "barcode",
"format": "sscc-18",
"content": "012345678901234567",
"x": 6,
"y": 30,
"width": 88,
"height": 26,
"barcode_text": { "enabled": true, "position": "bottom" }
},
{
"type": "text",
"x": 6,
"y": 70,
"content": "SKU: CASE-001\nQTY: 48\nLOCATION: A-14-02",
"style": { "font_size": 10, "font_family": "NotoSans-Regular" }
}
]
}
]
}
Що виконує gPdf
- PDF-етикетки для складських друкарських процесів.
- Векторні штрихкоди, текст, рамки, розміри сторінок етикеток і прив’язку шаблону.
- Детермінований вивід для передруків і аудиторських процесів.
- JSON Render для власних макетів і Template Render для затверджених контрактів етикеток.
Що контролює ваша система
- Стан запасів, дані SKU, дані lot/serial, значення SSCC і семантику location.
- Маршрутизацію принтера, налаштування станції, валідацію сканера й складські процесні правила.
- Вибір шаблону, retry і зберігання відрендерених PDF або вихідних даних.
Чеклист для робочого запуску
- Валідуйте розміри етикетки на фактичному принтері й матеріалі етикеток.
- Скануйте кожен формат штрихкоду, який використовується складським процесом.
- Залишайте стан WMS/ERP авторитетним і надсилайте в gPdf лише фінальні дані етикетки.
- Використовуйте Template Render для етикеток, які друкують кілька систем або станцій.
- Логуйте ID джерельних документів і request IDs для трасування передруків.
Межі заявлених можливостей
- gPdf рендерить PDF складських етикеток; він не керує запасами або станом складу.
- Сервіс-викликач відповідає за семантику даних штрихкоду й прийняття сканером.
- Template Render може стабілізувати макети етикеток, але не замінює правила WMS.
Складські етикетки — це операційні записи
Складські етикетки ідентифікують палети, короби, bins, assets, рухи запасів і locations. Вони прив’язані до операційного стану у вашому WMS або ERP. gPdf має отримувати фінальні дані етикетки й рендерити їх; він не має вирішувати значення запасів або стан складського процесу.
Template Render спрощує станції друку
Для етикеток, які використовуються на кількох станціях, опублікуйте
затверджений макет як шаблон. Сервіси друку тоді можуть надсилати template_id
плюс дані WMS замість повторного складання координат у кожному сервісі-викликачу.
Детермінованість передруку
Склади передруковують етикетки. Пошкоджена етикетка, застряглий принтер або повторна спроба станції не мають створювати трохи інший документ. Тримайте вихідні дані етикетки прив’язаними до складського запису й використовуйте детерміновані render inputs для передруків.
FAQ
- Чи керує gPdf складськими запасами?
- Ні. Ваш WMS або ERP відповідає за стан запасів, locations, SKUs, lots і процесні правила. gPdf рендерить PDF-етикетки з фінальних даних.
- Чи можуть складські етикетки використовувати GS1 або SSCC штрихкоди?
- Так, gPdf може рендерити підтримувані формати штрихкодів у PDF-виводі. Ваша система відповідає за дані штрихкоду й прийняття сканером.
- Чи варто повторюваним складським етикеткам використовувати шаблони?
- Зазвичай так. Template Render дає станціям друку стабільний template_id і контракт даних після затвердження макета етикетки.
- Як мають працювати передруки?
- Зберігайте вихідні дані етикетки або згенерований PDF разом зі складським записом, а потім рендерте або діставайте ту саму етикетку за початковими операційними ID.