क्या gPdf मेरे लिए carrier labels create करता है?

नहीं. Carrier या shipping system carrier shipment और barcode payload create करता है. gPdf उस data को PDF label में render करता है.

क्या shipping labels के लिए Template Render use कर सकता हूँ?

हाँ. Label design या testing के दौरान JSON Render use करें, फिर layout stable हो जाए और callers को सिर्फ data भेजना चाहिए तो Template Render use करें.

क्या gPdf ZPL output देता है?

नहीं. Public render APIs PDF output देती हैं. अगर print path को ZPL चाहिए, तो PDF को gPdf से बाहर convert या route करें.

Production से पहले क्या validate करना चाहिए?

Real printer और label stock पर print करें, production scanners से barcode scan करें, और carrier-specific text तथा payloads आपके shipping system से आ रहे हैं यह confirm करें.

Logistics और labels

4x6 PDF labels के लिए Shipping label API

Order JSON से print-ready 4x6 shipping label PDFs generate करें, vector barcodes, label page sizes और deterministic warehouse reprints के साथ.

PRIMARY API JSON Render

ENDPOINT /api/v1/pdf/render

SYSTEMS WMS / OMS / 3PL backend / shipping backend

Playground में आज़माएँ Docs पढ़ें

काम जो पूरा करना है

Order, recipient, service और tracking data से label-sized PDFs render करें, ताकि warehouse या ecommerce backend fulfillment के दौरान वही 4x6 label reliably print कर सके और जरूरत पर deterministic reprint कर सके.

यह API कब इस्तेमाल करें

आपके system के पास tracking number, destination, service text और barcode payload पहले से है.
Zebra, SATO, Honeywell या अन्य thermal-printer workflows के लिए PDF output चाहिए.
PDF में raster barcode images paste करने के बजाय vector barcode modules चाहिए.
Reprints और audit evidence के लिए same payload से same label render होना चाहिए.

यह क्या replace नहीं करता

आपको postage खरीदना, shipment rate करना या carrier account से carrier label create करना है.
आपको ZPL replacement endpoint चाहिए. gPdf PDF लौटाता है, printer command language नहीं.
आपको gPdf से carrier certification चाहिए. Scanner और carrier acceptance testing आपकी जिम्मेदारी रहती है.

कौन सा endpoint call करें

PRIMARY

/api/v1/pdf/render

JSON Render इस workflow का default path है।

SECONDARY 1

/api/v1/template-render

जब workflow को related API path, template contract या capabilities lookup चाहिए, तब इसका उपयोग करें।

Minimal 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 क्या handle करता है

4x6 inch workflows जैसे label-sized PDF pages.
Carrier और warehouse label content के लिए vector barcode rendering.
Text, address blocks, service marks, lines, boxes और optional template binding.
Warehouse reprints के लिए deterministic PDF output.

आपका system क्या संभालता है

Carrier account, postage purchase, service selection और tracking number creation.
Correct barcode payloads, human-readable text, addresses और routing data.
Printer setup, label stock, scan testing और carrier acceptance checks.

Production checklist

Real printer model और label stock पर test labels print करें.
Target DPI और scanner distance पर barcode scan rates verify करें.
अपनी reprint policy के अनुसार source shipment data या returned PDF store करें.
Label layout approve हो जाए और systems में reuse हो, तब Template Render use करें.
Carrier-specific logic को rendering request से बाहर रखें.

Claim boundaries

gPdf label PDF render करता है; यह postage नहीं खरीदता और carriers से direct बात नहीं करता.
gPdf carrier-label certification authority नहीं है.
API PDF output है, ZPL, EPL या thermal-printer command stream नहीं.

Shipping label API shape

Shipping label pages separate carrier endpoint नहीं हैं. आप label-sized page, text blocks, lines, optional images और barcode elements के साथ JSON Render call करते हैं. Repeated labels के लिए approved layout को template के रूप में publish करें और shipment data के साथ Template Render call करें.

Ownership इससे clear रहता है. gPdf PDF rendering और barcode drawing own करता है. आपका system carrier transaction, shipment state और payload semantics own करता है.

JSON Render versus Template Render

जब fulfillment system full layout generate करता है या operations team coordinates tune कर रही होती है, तब JSON Render use करें. जब warehouse ने stable label layout approve कर दिया हो और हर caller को same data fields भेजने हों, तब Template Render use करें.

दोनों paths PDF output लौटाते हैं. फर्क यह है कि caller हर request में layout describe करता है या published template_id reference करता है.

Print testing matters

Thermal label quality physical है. Output को real label stock, real printers और real scanners पर validate करें. Barcode payload correctness, quiet zones, printer darkness और carrier-specific rules rendering API से बाहर production responsibilities हैं.

FAQ

क्या gPdf मेरे लिए carrier labels create करता है?: नहीं. Carrier या shipping system carrier shipment और barcode payload create करता है. gPdf उस data को PDF label में render करता है.
क्या shipping labels के लिए Template Render use कर सकता हूँ?: हाँ. Label design या testing के दौरान JSON Render use करें, फिर layout stable हो जाए और callers को सिर्फ data भेजना चाहिए तो Template Render use करें.
क्या gPdf ZPL output देता है?: नहीं. Public render APIs PDF output देती हैं. अगर print path को ZPL चाहिए, तो PDF को gPdf से बाहर convert या route करें.
Production से पहले क्या validate करना चाहिए?: Real printer और label stock पर print करें, production scanners से barcode scan करें, और carrier-specific text तथा payloads आपके shipping system से आ रहे हैं यह confirm करें.