Логістика та етикетки

API палетних етикеток для складських і 3PL-процесів

Генеруйте PDF палетних етикеток для складських, 3PL, роздрібних і логістичних процесів із SSCC, GS1-128, текстовими блоками й шаблонами, безпечними для передруку.

ОСНОВНА API JSON Render
ШЛЯХ API /api/v1/pdf/render
СИСТЕМИ WMS / 3PL-бекенд / сервіс експорту ERP / складський сервіс друку
Задача сценарію

Рендерити PDF палетних етикеток із даних WMS, ERP або 3PL, щоб складські команди могли ідентифікувати палети, сканувати SSCC або GS1 штрихкоди й передруковувати ту саму етикетку під час приймання, відвантаження або рухів запасів.

Коли використовувати цю API

  • Ваш WMS уже має ID палети, дані SKU або GTIN, кількість, lot і пункт призначення.
  • Потрібна PDF-етикетка з SSCC, GS1-128 або іншими підтримуваними форматами штрихкодів.
  • Потрібні детерміновані передруки з тих самих вихідних даних.
  • Потрібно, щоб макет став стабільним контрактом Template Render.

Що вона не замінює

  • Потрібно, щоб gPdf керував запасами, палетизацією або складськими задачами.
  • Потрібна сертифікація GS1 замість PDF-рендерингу штрихкодів.
  • Потрібен прямий вивід команд принтера.

Який шлях API викликати

ОСНОВНИЙ

/api/v1/pdf/render

JSON Render — типовий шлях для цього сценарію.

ДОДАТКОВИЙ 1

/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

  • PDF-сторінки розміру етикетки з текстом, рамками й елементами штрихкоду.
  • SSCC, GS1-128, Code 128, QR та інші підтримувані формати штрихкодів у PDF-виводі.
  • Прив’язку шаблону для затверджених макетів палетних етикеток.
  • Детермінований вивід для передруків і аудиторських доказів.

Що контролює ваша система

  • Ідентичність палети, дані товару, дані lot, кількість, маршрутизацію й складські правила.
  • Коректність даних штрихкоду, check digits, тести сканування й валідацію матеріалу етикеток.
  • Маршрутизацію станції друку, дозвіл на передрук і стан запасів.

Чеклист для робочого запуску

  1. Валідуйте дані SSCC або GS1 перед рендерингом.
  2. Скануйте етикетки бойовими сканерами на станціях приймання й відвантаження.
  3. Тестуйте щільні дані, довгі назви товарів і потреби кількох складських мов.
  4. Записуйте template_id, source pallet ID і request ID для передруків.
  5. Тримайте transitions складського стану поза render API.

Межі заявлених можливостей

  • gPdf рендерить PDF палетних етикеток; він не керує палетами або складськими запасами.
  • gPdf не є органом сертифікації GS1.
  • Прийняття сканерами й коректність складського процесу залишаються вашою відповідальністю.

Палетні етикетки з’єднують WMS-дані з друком

Процес палетної етикетки починається у вашому WMS або ERP. Він вирішує, які дані палети, товару, кількості, lot і маршруту мають бути на етикетці. gPdf перетворює ці дані на PDF, який складські станції друку можуть надрукувати й передрукувати.

Використовуйте вузькішу сторінку SSCC, коли пошуковий intent стосується саме SSCC-18 або GS1 logistics labeling. Ця сторінка призначена для ширшого процесу палетних етикеток.

FAQ

Чи може gPdf генерувати SSCC палетні етикетки?
gPdf може рендерити елементи штрихкоду SSCC у PDF-виводі. Ваша система відповідає за значення SSCC і GS1-семантику.
Чи керує gPdf запасами палет?
Ні. WMS або ERP-системи відповідають за стан запасів. gPdf рендерить PDF-етикетки.
Чи можуть палетні етикетки використовувати Template Render?
Так. Template Render зазвичай є бойовим шляхом після затвердження макета палетної етикетки.
Чи сертифікує gPdf GS1-етикетки?
Ні. gPdf рендерить векторні PDF-штрихкоди. Сертифікація, тести сканування й прийняття залишаються вашою відповідальністю.