क्या gPdf return shipment create करता है?

नहीं. Carrier या returns platform shipment और payload create करता है. gPdf उस data को PDF में render करता है.

क्या return labels templates से generate हो सकते हैं?

हाँ. Return label या instruction layout approve होने के बाद Template Render use करें.

क्या PDF में return instructions शामिल हो सकते हैं?

हाँ. Same render request आपके layout के अनुसार label page, instruction page या दोनों create कर सकती है.

क्या gPdf carrier certification replace करता है?

नहीं. Carrier acceptance, scanner tests और payload rules आपकी responsibility रहते हैं.

Logistics और labels

Ecommerce reverse logistics के लिए Return label API

Ecommerce या support data से return label और return instruction PDFs generate करें, label-sized pages, barcodes और template reprints के साथ.

PRIMARY API JSON Render

ENDPOINT /api/v1/pdf/render

SYSTEMS ecommerce backend / returns portal / OMS / 3PL backend

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

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

RMA, customer, item, destination और barcode data से return label PDFs या return instruction sheets render करें, ताकि returns portal customer को deterministic document दे सके.

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

आपके system ने RMA और return authorization पहले से create कर लिया है.
Carrier या returns system ने label payload या tracking data पहले से supply कर दिया है.
Download, email या reprint होने वाला PDF label या instruction sheet चाहिए.
Same return label layout को Template Render से reuse करना है.

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

आपको gPdf से return approve कराना, postage खरीदना या carrier shipment create कराना है.
आपको direct carrier API orchestration चाहिए.
आपको ZPL जैसा printer command output चाहिए.

कौन सा 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 - RMA barcode वाला return label.

{
  "pages": [
    {
      "size": "label_4_6_in",
      "elements": [
        {
          "type": "text",
          "x": 5,
          "y": 8,
          "content": "RETURN TO",
          "style": { "font_size": 9, "font_family": "NotoSans-Regular" }
        },
        {
          "type": "text",
          "x": 5,
          "y": 18,
          "content": "Acme Returns\n500 Dock Door 4\nColumbus OH 43215",
          "style": { "font_size": 11, "font_family": "NotoSans-Regular" }
        },
        {
          "type": "barcode",
          "format": "code128",
          "content": "RMA-2026-77881",
          "x": 5,
          "y": 70,
          "width": 88,
          "height": 20,
          "barcode_text": { "enabled": true, "position": "bottom" }
        }
      ]
    }
  ]
}

gPdf क्या handle करता है

Label-sized return labels और instruction pages के लिए PDF rendering.
Barcode, text, address, RMA और service blocks.
Approved return label या instruction layouts के लिए template binding.
Customer re-downloads और support reprints के लिए deterministic output.

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

Return eligibility, RMA state, carrier account, postage, tracking number और customer messaging.
Correct barcode payloads, destination address, item references और return window rules.
Email delivery, portal download और support audit trail.

Production checklist

Rendering से पहले return payload को carrier या returns provider के साथ validate करें.
Labels को उसी stock पर print और scan करें जिसे customers या stores use करेंगे.
X-Request-Id include करें और RMA-to-PDF trace को support logs में store करें.
Repeated downloads को customer perspective से idempotent बनाएं.
Label rendering को refund approval logic से अलग रखें.

Claim boundaries

gPdf return label PDFs render करता है; returns authorize नहीं करता और postage नहीं खरीदता.
Carrier acceptance और barcode payload correctness आपकी जिम्मेदारी रहती है.
Public API PDF लौटाती है, ZPL या direct printer commands नहीं.

Reverse logistics को clear ownership चाहिए

Return labels customer experience और carrier rules को combine करते हैं. gPdf PDF rendering own करता है. आपका return system eligibility, RMA state, tracking, carrier payloads और customer communication own करता है.

Integration में यह boundary visible रखें. पहले return decision generate करें, फिर finalized data से document render करें.

FAQ

क्या gPdf return shipment create करता है?: नहीं. Carrier या returns platform shipment और payload create करता है. gPdf उस data को PDF में render करता है.
क्या return labels templates से generate हो सकते हैं?: हाँ. Return label या instruction layout approve होने के बाद Template Render use करें.
क्या PDF में return instructions शामिल हो सकते हैं?: हाँ. Same render request आपके layout के अनुसार label page, instruction page या दोनों create कर सकती है.
क्या gPdf carrier certification replace करता है?: नहीं. Carrier acceptance, scanner tests और payload rules आपकी responsibility रहते हैं.