Управляет ли gPdf складским inventory?

Нет. Ваша WMS или ERP владеет inventory state, locations, SKUs, lots и process rules. gPdf рендерит PDF-этикетку из финальных данных.

Можно ли использовать GS1 или SSCC barcodes в складских этикетках?

Да, gPdf может рендерить поддерживаемые barcode formats в PDF output. Ваша система отвечает за barcode payload и scanner acceptance.

Стоит ли повторяемые складские этикетки делать через templates?

Обычно да. Template Render дает print stations стабильный `template_id` и data contract после утверждения label layout.

Как должна работать перепечатка?

Храните source label data или generated PDF вместе со складской записью, затем рендерьте или извлекайте ту же этикетку по исходным operational IDs.

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

API складских этикеток для print workflows в WMS и ERP

Генерируйте PDF-этикетки для паллет, коробов, ячеек, inventory и складских операций из WMS или ERP data с детерминированной перепечаткой.

ОСНОВНАЯ API JSON Render

ENDPOINT /api/v1/pdf/render

СИСТЕМЫ WMS / ERP / warehouse print service / inventory workflow

Попробовать в Playground Читать документацию

Задача сценария

Рендерить складские этикетки из WMS или ERP data для паллет, коробов, ячеек, активов, локаций и inventory movements, оставляя inventory state, picking rules и warehouse operations в системе caller.

Когда использовать эту API

Нужны PDF-этикетки для паллет, коробов, ячеек, локаций, inventory или assets.
Ваша WMS или ERP уже владеет SKU, lot, location, SSCC и inventory data.
Нужна детерминированная перепечатка, когда этикетка повреждена или station повторяет job.
Утвержденные label layouts должны использоваться повторно через Template Render.

Что она не заменяет

Нужно, чтобы gPdf управлял inventory, распределял locations или выполнял warehouse workflows.
Нужны scanner app, print-station agent или label-routing system от gPdf.
Нужна GS1 certification вместо рендеринга штрихкодов.

Какой endpoint вызывать

ОСНОВНОЙ

/api/v1/pdf/render

JSON Render — путь по умолчанию для этого сценария.

ДОПОЛНИТЕЛЬНЫЙ 1

/api/v1/template-render

Используйте, когда сценарию нужен связанный API-путь, контракт шаблона или проверка возможностей.

Минимальный запрос

POST /api/v1/pdf/render - паллетная этикетка с данными SSCC barcode.

{
  "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-этикетки для warehouse print workflows.
Векторные штрихкоды, текст, рамки, label page sizes и template binding.
Детерминированный вывод для reprint и audit workflows.
JSON Render для custom layouts и Template Render для утвержденных label contracts.

Что контролирует ваша система

Inventory state, SKU data, lot/serial data, SSCC values и location semantics.
Printer routing, station setup, scanner validation и warehouse process rules.
Template selection, retries и хранение rendered PDFs или source data.

Production-чеклист

Проверьте размеры этикетки на реальном принтере и label stock.
Просканируйте каждый barcode format, который используется складским процессом.
Оставьте WMS/ERP authoritative source и отправляйте в gPdf только финальные label data.
Используйте Template Render для этикеток, которые печатают несколько систем или stations.
Логируйте source document IDs и request IDs для traceability при перепечатке.

Границы заявлений

gPdf рендерит PDF складских этикеток; он не управляет inventory или warehouse state.
Caller отвечает за смысл barcode payload и scanner acceptance.
Template Render стабилизирует label layouts, но не заменяет WMS rules.

Складские этикетки — это операционные записи

Складские этикетки идентифицируют паллеты, короба, ячейки, assets, inventory movements и locations. Они связаны с operational state в вашей WMS или ERP. gPdf должен получать финальные label data и рендерить их; он не должен определять inventory meaning или warehouse process state.

Template Render упрощает print stations

Для этикеток, которые используются на нескольких stations, опубликуйте утвержденный layout как template. Print services смогут отправлять template_id плюс WMS data вместо того, чтобы заново собирать координаты в каждом caller.

Детерминированная перепечатка

Склады перепечатывают этикетки. Поврежденная этикетка, застрявший принтер или station retry не должны создавать чуть другой документ. Привязывайте source label data к складской записи и используйте детерминированные render inputs для перепечатки.

FAQ

Управляет ли gPdf складским inventory?: Нет. Ваша WMS или ERP владеет inventory state, locations, SKUs, lots и process rules. gPdf рендерит PDF-этикетку из финальных данных.
Можно ли использовать GS1 или SSCC barcodes в складских этикетках?: Да, gPdf может рендерить поддерживаемые barcode formats в PDF output. Ваша система отвечает за barcode payload и scanner acceptance.
Стоит ли повторяемые складские этикетки делать через templates?: Обычно да. Template Render дает print stations стабильный `template_id` и data contract после утверждения label layout.
Как должна работать перепечатка?: Храните source label data или generated PDF вместе со складской записью, затем рендерьте или извлекайте ту же этикетку по исходным operational IDs.