Logistics ও label

Fulfillment workflow-এর জন্য Packing slip PDF API

Ecommerce, 3PL, OMS এবং warehouse fulfillment workflow-এর জন্য order, shipment, carton ও item data থেকে packing slip PDF তৈরি করুন।

প্রাথমিক API Template Render
Endpoint /api/v1/template-render
System OMS / WMS / 3PL backend / Shopify app backend
যে কাজটি করতে হবে

Shipment, recipient, item এবং carton data থেকে packing slip render করুন, যাতে fulfillment team প্রতিটি outbound order-এর জন্য consistent document print বা attach করতে পারে।

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

  • আপনার OMS বা WMS-এ order item, quantity, recipient data এবং shipment identifier আগে থেকেই আছে।
  • Warehouse print station বা customer parcel insert-এর জন্য PDF packing slip দরকার।
  • Warehouse, brand বা sales channel জুড়ে এক approved layout reuse করতে চান।
  • Order lookup বা return intake-এর জন্য barcode বা QR code দরকার হতে পারে।

এটি কী replace করে না

  • Postage কিনতে, shipment rate করতে বা carrier label তৈরি করতে হবে।
  • Document rendering নয়, warehouse inventory management দরকার।
  • Legal invoice বা e-invoice semantics দরকার।

কোন endpoint call করবেন

প্রাথমিক

/api/v1/template-render

Template Render এই workflow-এর default path।

সহায়ক 1

/api/v1/pdf/render

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

নূন্যতম request

POST /api/v1/template-render - এক shipment-সহ packing_list template।

{
  "template_id": "packing_list",
  "data": [
    {
      "shipment": {
        "number": "PL-2026-1001",
        "date": "2026-05-29"
      },
      "shipper": {
        "name": "Acme Warehouse",
        "address": "1200 Logistics Pkwy"
      },
      "consignee": {
        "name": "Receiver Inc.",
        "address": "123 Main St"
      },
      "items": [
        {
          "item_no": "1",
          "description": "Replacement filter",
          "quantity": "2",
          "unit": "pcs",
          "gross_weight": "1.2 kg",
          "net_weight": "1.0 kg"
        }
      ]
    }
  ]
}

gPdf কী করে

  • Published packing slip layout-এর জন্য Template Render।
  • Design বা one-off workflow-তে custom packing slip page-এর জন্য JSON Render।
  • Table, item row, address block, optional barcode এবং PDF output।
  • একই data ও template ব্যবহার করলে deterministic reprint।

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

  • Order data, item quantity, shipment state, warehouse routing এবং customer messaging।
  • Template field mapping, print station routing এবং reprint policy।
  • Parcel-এর সাথে travel করা carrier, customs বা invoice document।

Production checklist

  1. সবচেয়ে long SKU, item name এবং address combination test করুন।
  2. One-item, multi-carton, backorder এবং partial shipment case validate করুন।
  3. Packing slip layout approved হলে Template Render ব্যবহার করুন।
  4. প্রতিটি fulfillment print request-এর জন্য template_id এবং X-Request-Id log করুন।
  5. Carrier label generation-কে packing slip rendering থেকে আলাদা রাখুন।

দাবির সীমা

  • gPdf packing slip PDF render করে; inventory বা fulfillment state manage করে না।
  • Packing slip নিজে থেকে tax invoice বা customs document হয়ে যায় না।
  • Carrier label purchase এবং shipment rating gPdf-এর বাইরে থাকে।

Packing slip template path-এ ভালো মানায়

Packing slip সাধারণত stable structure রাখে: shipper, recipient, shipment number, item row এবং optional note। Layout approved হওয়ার পরে এই কারণে Template Render ভালো fit।

Design চলাকালীন JSON Render এখনও গুরুত্বপূর্ণ। Stable template_id contract publish করার আগে column, spacing, barcode placement এবং page break tune করতে এটি team-কে সাহায্য করে।

FAQ

Packing slip কি আলাদা gPdf endpoint?
না। Approved packing slip template-এর জন্য Template Render ব্যবহার করুন, অথবা আপনার system layout সরাসরি বর্ণনা করলে JSON Render ব্যবহার করুন।
Packing slip-এ কি barcode রাখা যায়?
হ্যাঁ। gPdf PDF-এ barcode element render করতে পারে। Encoded order, carton বা return payload আপনার system own করে।
gPdf কি carrier label তৈরি করে?
না। Carrier label আলাদা workflow। আপনার carrier বা shipping system যে data দেয়, gPdf তা থেকে PDF render করে।
এক request-এ কি একাধিক packing slip render করা যায়?
Template Render public API limit-এর মধ্যে এক request-এ একাধিক item-এর data array গ্রহণ করে।