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

API логистических PDF для labels, slips и складских документов

Генерируйте структурированные логистические PDF: этикетки, packing slips, waybills, manifests и складские документы из WMS, OMS и 3PL data.

ОСНОВНАЯ API JSON Render
ENDPOINT /api/v1/pdf/render
СИСТЕМЫ WMS / OMS / 3PL backend / carrier operations
Задача сценария

Рендерить операционные логистические документы из структурированных WMS, OMS, 3PL и fulfillment data, оставляя carrier transactions, shipment routing, warehouse state и business rules в системах caller.

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

  • Нужны PDF для labels, packing slips, manifests, waybills или warehouse paperwork.
  • Ваши logistics systems уже знают shipment, order, inventory, route и carrier data.
  • Нужны детерминированные перепечатки и high-volume API rendering.
  • Нужна широкая hub page, которая ведет пользователей к более узким label и warehouse workflows.

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

  • Нужно, чтобы gPdf рассчитывал shipment rating, покупал postage или напрямую обращался к carriers.
  • Нужны WMS, OMS, TMS или inventory-management features.
  • Нужны native EDI, customs filing или freight-broker workflows вне PDF generation.

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

ОСНОВНОЙ

/api/v1/pdf/render

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

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

/api/v1/template-render

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

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

POST /api/v1/template-render - повторяемый logistics document из structured data.

{
  "template_id": "packing_list",
  "data": [
    {
      "order_number": "SO-8421",
      "warehouse": "LAX-01",
      "ship_to": "Example Retailer, 88 Harbor Rd, Long Beach, CA",
      "items": [
        { "sku": "CASE-001", "description": "Widget case", "quantity": 4 },
        { "sku": "CASE-002", "description": "Replacement kit", "quantity": 1 }
      ]
    }
  ]
}

Что выполняет gPdf

  • PDF-рендеринг структурированных логистических документов.
  • Label-size страницы, A4/letter documents, barcodes, tables, address blocks и metadata.
  • Template Render для утвержденных warehouse и fulfillment document layouts.
  • Детерминированный output для reprints и audit records.

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

  • Shipment state, carrier service, routing rules, inventory state и document eligibility.
  • Business data mapping из WMS, OMS, TMS, ERP или 3PL systems.
  • Printer routing, storage, delivery, retry logic и operational exception handling.

Production-чеклист

  1. Решите, какие documents идут через direct JSON Render, а какие через templates.
  2. Проверьте barcode, address и table overflow cases для каждого document type.
  3. Храните source data или PDF согласно требованиям reprint и audit.
  4. Держите carrier API calls и render API calls отдельными integration steps.
  5. Ссылайтесь на более узкие страницы shipping labels и warehouse labels, а не дублируйте их содержание.

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

  • gPdf генерирует logistics PDFs; он не является carrier, WMS, OMS, TMS или postage provider.
  • Shipment rating, label purchase, inventory state и carrier operations остаются вне gPdf.
  • Эта широкая страница должна вести на более узкие solution pages для точного workflow intent.

Logistics documents — это кластер

Генерация logistics PDFs покрывает несколько типов документов: shipping labels, warehouse labels, packing slips, manifests, waybills, pick tickets и internal handoff documents. Эта страница — широкий вход. Узкие страницы должны отвечать за точный search intent по labels и barcode-heavy workflows.

Паттерн использования API

Большинство logistics documents используют JSON Render или Template Render. JSON Render подходит для generated layouts или специальных документов. Template Render подходит для повторяемых документов, где operations teams ожидают стабильный layout и небольшой набор data fields.

Операционные системы остаются authoritative

Ваша WMS, OMS, TMS, 3PL platform, ERP или carrier integration остается source of truth для shipment state и business rules. gPdf получает финальные document data и производит PDF output.

FAQ

Эта страница отличается от страницы shipping labels?
Да. Это широкая страница логистических документов. У shipping labels и warehouse labels есть более узкие страницы с конкретными рекомендациями по labels и barcode-heavy workflows.
Вызывает ли gPdf carriers?
Нет. Ваш logistics stack обрабатывает carrier APIs, postage, shipment rating и routing. gPdf рендерит PDF из полученных данных.
Какой endpoint подходит для logistics documents?
Используйте JSON Render для custom layouts и Template Render для утвержденных повторяемых documents, например packing slips или warehouse labels.
Можно ли включать barcodes в logistics pages?
Да. gPdf рендерит barcode elements в PDF, но ваша система отвечает за encoded payload и operational validation.