gPdf কি আমার জন্য carrier label তৈরি করে?

না। আপনার carrier বা shipping system carrier shipment এবং barcode payload তৈরি করে। gPdf সেই data-কে PDF label-এ render করে।

Shipping label-এর জন্য কি Template Render ব্যবহার করা যায়?

হ্যাঁ। Label design বা test করার সময় JSON Render ব্যবহার করুন, তারপর layout stable হলে এবং caller-দের শুধু data পাঠানো উচিত হলে Template Render ব্যবহার করুন।

gPdf কি ZPL output দেয়?

না। Public render API-গুলো PDF output দেয়। আপনার print path-এর ZPL দরকার হলে gPdf-এর বাইরে PDF convert বা route করুন।

Production-এর আগে কী validate করব?

Real printer ও label stock-এ print করুন, production scanner দিয়ে barcode scan করুন, এবং carrier-specific text ও payload আপনার shipping system থেকে এসেছে কি না confirm করুন।

Logistics ও label

4x6 PDF label-এর জন্য শিপিং লেবেল API

Order JSON থেকে vector barcode, label page size এবং deterministic warehouse reprint-সহ print-ready 4x6 shipping label PDF তৈরি করুন।

প্রাথমিক API JSON Render

Endpoint /api/v1/pdf/render

System WMS / OMS / 3PL backend / shipping backend

Playground-এ পরীক্ষা করুন Docs পড়ুন

যে কাজটি করতে হবে

Order, recipient, service ও tracking data থেকে label-sized PDF render করুন, যাতে warehouse বা ecommerce backend fulfillment-এর সময় একই 4x6 label নির্ভরযোগ্যভাবে print করতে পারে এবং দরকার হলে deterministic reprint করতে পারে।

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

আপনার system-এ tracking number, destination, service text এবং barcode payload আগে থেকেই আছে।
Zebra, SATO, Honeywell বা অন্যান্য thermal-printer workflow-এর জন্য PDF output দরকার।
PDF-এ raster barcode image paste না করে vector barcode module চান।
Reprint ও audit evidence-এর জন্য একই payload থেকে একই label render হওয়া দরকার।

এটি কী replace করে না

Carrier account দিয়ে postage কিনতে, shipment rate করতে বা carrier label তৈরি করতে হবে।
ZPL replacement endpoint দরকার। gPdf PDF return করে, printer command language নয়।
gPdf থেকে carrier certification দরকার। Scanner ও carrier acceptance testing আপনার দায়িত্ব।

কোন 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 - tracking barcode-সহ minimal 4x6 label।

{
  "pages": [
    {
      "size": "label_4_6_in",
      "elements": [
        {
          "type": "text",
          "x": 4,
          "y": 6,
          "content": "SHIP TO",
          "style": { "font_size": 8, "font_family": "NotoSans-Regular" }
        },
        {
          "type": "text",
          "x": 4,
          "y": 13,
          "content": "Acme Warehouse\n1200 Logistics Pkwy\nMemphis TN 38116",
          "style": { "font_size": 11, "font_family": "NotoSans-Regular" }
        },
        {
          "type": "barcode",
          "format": "code128",
          "content": "1Z999AA10123456784",
          "x": 4,
          "y": 62,
          "width": 92,
          "height": 22,
          "barcode_text": { "enabled": true, "position": "bottom" }
        }
      ]
    }
  ]
}

gPdf কী করে

4x6 inch workflow-এর মতো label-sized PDF page।
Carrier ও warehouse label content-এর জন্য vector barcode rendering।
Text, address block, service mark, line, box এবং optional template binding।
Warehouse reprint-এর জন্য deterministic PDF output।

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

Carrier account, postage purchase, service selection এবং tracking number creation।
সঠিক barcode payload, human-readable text, address এবং routing data।
Printer setup, label stock, scan testing এবং carrier acceptance check।

Production checklist

Real printer model এবং label stock-এ test label print করুন।
Target DPI ও scanner distance-এ barcode scan rate verify করুন।
আপনার reprint policy অনুযায়ী source shipment data বা returned PDF store করুন।
Label layout approved হয়ে একাধিক system-এ reuse হলে Template Render ব্যবহার করুন।
Carrier-specific logic rendering request-এর বাইরে রাখুন।

দাবির সীমা

gPdf label PDF render করে; postage কেনে না বা carrier-এর সাথে সরাসরি কথা বলে না।
gPdf carrier-label certification authority নয়।
API PDF output দেয়, ZPL, EPL বা অন্য thermal-printer command stream নয়।

Shipping label API shape

Shipping label page আলাদা carrier endpoint নয়। আপনি label-sized page, text block, line, optional image এবং barcode element-সহ JSON Render call করেন। Repeated label-এর জন্য approved layout template হিসেবে publish করুন এবং shipment data দিয়ে Template Render call করুন।

এতে ownership পরিষ্কার থাকে। gPdf PDF rendering ও barcode drawing own করে। আপনার system carrier transaction, shipment state এবং payload semantics own করে।

JSON Render বনাম Template Render

Fulfillment system যদি পুরো layout generate করে, অথবা operations team যদি এখনও coordinate tune করে, JSON Render ব্যবহার করুন। Warehouse stable label layout approve করে ফেললে এবং প্রতিটি caller-এর একই data field পাঠানো উচিত হলে Template Render ব্যবহার করুন।

দুই path-ই PDF output return করে। পার্থক্য হলো caller প্রতিটি request-এ layout বর্ণনা করবে, নাকি published template_id reference করবে।

Print testing গুরুত্বপূর্ণ

Thermal label quality একটি physical বিষয়। Real label stock, real printer এবং real scanner-এ output validate করুন। Barcode payload correctness, quiet zone, printer darkness এবং carrier-specific rule rendering API-এর বাইরে production responsibility।

FAQ

gPdf কি আমার জন্য carrier label তৈরি করে?: না। আপনার carrier বা shipping system carrier shipment এবং barcode payload তৈরি করে। gPdf সেই data-কে PDF label-এ render করে।
Shipping label-এর জন্য কি Template Render ব্যবহার করা যায়?: হ্যাঁ। Label design বা test করার সময় JSON Render ব্যবহার করুন, তারপর layout stable হলে এবং caller-দের শুধু data পাঠানো উচিত হলে Template Render ব্যবহার করুন।
gPdf কি ZPL output দেয়?: না। Public render API-গুলো PDF output দেয়। আপনার print path-এর ZPL দরকার হলে gPdf-এর বাইরে PDF convert বা route করুন।
Production-এর আগে কী validate করব?: Real printer ও label stock-এ print করুন, production scanner দিয়ে barcode scan করুন, এবং carrier-specific text ও payload আপনার shipping system থেকে এসেছে কি না confirm করুন।