Logistics ও label

WMS ও ERP print workflow-এর জন্য Warehouse label API

WMS বা ERP data থেকে pallet, case, bin, inventory এবং warehouse-operation label PDF তৈরি করুন, deterministic reprint-সহ।

প্রাথমিক API JSON Render
Endpoint /api/v1/pdf/render
System WMS / ERP / warehouse print service / inventory workflow
যে কাজটি করতে হবে

Pallet, carton, bin, asset, location এবং inventory movement-এর জন্য WMS বা ERP data থেকে warehouse label render করুন; inventory state, picking rule এবং warehouse operation caller-এর system-এ থাকে।

কখন এই API ব্যবহার করবেন

  • Pallet, carton, bin, location, inventory বা asset label PDF হিসেবে দরকার।
  • আপনার WMS বা ERP আগে থেকেই SKU, lot, location, SSCC এবং inventory data own করে।
  • Label damaged হলে বা station job retry করলে deterministic reprint দরকার।
  • Approved label layout Template Render দিয়ে reuse করতে চান।

এটি কী replace করে না

  • Inventory manage করা, location allocate করা বা warehouse workflow চালানোর কাজ gPdf-কে দিতে চান।
  • gPdf থেকে scanner app, print-station agent বা label-routing system দরকার।
  • Barcode rendering নয়, GS1 certification দরকার।

কোন endpoint call করবেন

প্রাথমিক

/api/v1/pdf/render

JSON Render এই workflow-এর default path।

সহায়ক 1

/api/v1/template-render

Workflow-তে related API path, template contract অথবা capabilities lookup দরকার হলে ব্যবহার করুন।

নূন্যতম request

POST /api/v1/pdf/render - SSCC barcode data-সহ pallet label।

{
  "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 কী করে

  • Warehouse print workflow-এর জন্য PDF label।
  • Vector barcode, text, box, label page size এবং template binding।
  • Reprint ও audit workflow-এর জন্য deterministic output।
  • Custom layout-এর জন্য JSON Render এবং approved label contract-এর জন্য Template Render।

আপনার system-এর দায়িত্ব

  • Inventory state, SKU data, lot/serial data, SSCC value এবং location semantics।
  • Printer routing, station setup, scanner validation এবং warehouse process rule।
  • Template selection, retry এবং rendered PDF বা source data storage।

Production checklist

  1. Actual printer এবং label stock-এর against label dimension validate করুন।
  2. Warehouse process-এ ব্যবহৃত প্রতিটি barcode format scan করুন।
  3. WMS/ERP state authoritative রাখুন এবং gPdf-এ শুধু final label data পাঠান।
  4. একাধিক system বা station যে label print করে, তার জন্য Template Render ব্যবহার করুন।
  5. Reprint traceability-এর জন্য source document ID এবং request ID log করুন।

দাবির সীমা

  • gPdf warehouse label PDF render করে; inventory বা warehouse state manage করে না।
  • Barcode payload semantics এবং scanner acceptance caller own করে।
  • Template Render label layout stabilize করতে পারে, কিন্তু WMS rule replace করে না।

Warehouse label operational record

Warehouse label pallet, case, bin, asset, inventory movement এবং location identify করে। এগুলো আপনার WMS বা ERP-এর operational state-এর সাথে tied। gPdf-এর চাই final label data পাওয়া এবং সেটি render করা; inventory meaning বা warehouse process state সিদ্ধান্ত নেওয়া তার কাজ নয়।

Template Render print station সহজ রাখে

একাধিক station-এ ব্যবহৃত label-এর জন্য approved layout template হিসেবে publish করুন। Print service তখন প্রতিটি caller-এ coordinate rebuild না করে template_id plus WMS data পাঠাতে পারে।

Reprint determinism

Warehouse label reprint করে। Damaged label, jammed printer বা station retry slightly different document তৈরি করা উচিত নয়। Reprint-এর জন্য source label data warehouse record-এর সাথে tied রাখুন এবং deterministic render input ব্যবহার করুন।

FAQ

gPdf কি warehouse inventory manage করে?
না। Inventory state, location, SKU, lot এবং process rule আপনার WMS বা ERP own করে। gPdf final data থেকে label PDF render করে।
Warehouse label কি GS1 বা SSCC barcode ব্যবহার করতে পারে?
হ্যাঁ, gPdf PDF output-এ supported barcode format render করতে পারে। Barcode payload এবং scanner acceptance আপনার system own করে।
Repeated warehouse label কি template ব্যবহার করা উচিত?
সাধারণত হ্যাঁ। Label layout approved হওয়ার পরে Template Render print station-কে stable template_id এবং data contract দেয়।
Reprint কীভাবে কাজ করা উচিত?
Source label data বা generated PDF আপনার warehouse record-এর সাথে store করুন, তারপর original operational ID ব্যবহার করে একই label render বা retrieve করুন।