Return label API สำหรับ reverse logistics ของ ecommerce
สร้าง PDF สำหรับ return label และ return instructions จากข้อมูล ecommerce หรือ support พร้อมหน้าขนาดฉลาก บาร์โค้ด และ reprint ผ่านเทมเพลต
/api/v1/pdf/render เรนเดอร์ return label PDFs หรือ return instruction sheets จากข้อมูล RMA, customer, item, destination และ barcode เพื่อให้ returns portal ส่งเอกสาร deterministic ให้ลูกค้าได้
ควรใช้ API นี้เมื่อใด
- ระบบของคุณสร้าง RMA และ return authorization แล้ว
- carrier หรือ returns system จัดเตรียม label payload หรือ tracking data แล้ว
- คุณต้องการ PDF label หรือ instruction sheet ที่ download, email หรือ reprint ได้
- คุณต้องการใช้ layout return label เดิมซ้ำผ่าน Template Render
สิ่งที่ไม่ได้ทดแทน
- คุณต้องการให้ gPdf อนุมัติ return, buy postage หรือสร้าง carrier shipment
- คุณต้องการ direct carrier API orchestration
- คุณต้องการ output เป็น printer command เช่น ZPL
ควรเรียก endpoint ใด
/api/v1/pdf/render
JSON Render คือ path หลักสำหรับเวิร์กโฟลว์นี้.
/api/v1/template-render
ใช้เมื่อเวิร์กโฟลว์ต้องการ API path ที่เกี่ยวข้อง สัญญาเทมเพลต หรือการค้นหา capability.
Minimal request
POST /api/v1/pdf/render - return label พร้อม RMA barcode
{
"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 จัดการอะไร
- การเรนเดอร์ PDF สำหรับ return labels ขนาดฉลากและ instruction pages
- barcode, text, address, RMA และ service blocks
- template binding สำหรับ return label หรือ instruction layouts ที่อนุมัติแล้ว
- output deterministic สำหรับ customer re-downloads และ support reprints
ระบบของคุณรับผิดชอบอะไร
- return eligibility, RMA state, carrier account, postage, tracking number และ customer messaging
- barcode payloads ที่ถูกต้อง destination address, item references และ return window rules
- email delivery, portal download และ support audit trail
Production checklist
- validate return payload กับ carrier หรือ returns provider ก่อนเรนเดอร์
- พิมพ์และสแกนฉลากบน stock เดียวกับที่ลูกค้าหรือ store จะใช้
- ใส่ X-Request-Id และจัดเก็บ trace RMA-to-PDF ใน support logs
- ทำ repeated downloads ให้ idempotent จากมุมมองลูกค้า
- แยก label rendering ออกจาก refund approval logic
ขอบเขตของ claim
- gPdf เรนเดอร์ return label PDFs แต่ไม่ได้ authorize returns หรือ buy postage
- carrier acceptance และ barcode payload correctness ยังเป็นของคุณ
- public API ส่งกลับ PDF ไม่ใช่ ZPL หรือ direct printer commands
Reverse logistics ต้องมี ownership ที่ชัดเจน
Return labels รวม customer experience กับ carrier rules เข้าด้วยกัน gPdf เป็นเจ้าของ PDF rendering ระบบ return ของคุณเป็นเจ้าของ eligibility, RMA state, tracking, carrier payloads และ customer communication
ทำ boundary นี้ให้เห็นชัดใน integration ตัดสินใจเรื่อง return ให้เสร็จก่อน แล้วจึงเรนเดอร์เอกสารจาก finalized data
FAQ
- gPdf สร้าง return shipment หรือไม่
- ไม่ carrier หรือ returns platform ของคุณสร้าง shipment และ payload ส่วน gPdf เรนเดอร์ข้อมูลนั้นเป็น PDF
- สร้าง return labels จาก templates ได้หรือไม่
- ได้ ใช้ Template Render เมื่อ return label หรือ instruction layout ได้รับอนุมัติแล้ว
- PDF ใส่ return instructions ได้หรือไม่
- ได้ render request เดียวกันสามารถสร้างหน้าฉลาก หน้า instructions หรือทั้งสองอย่างได้ตาม layout ของคุณ
- gPdf แทน carrier certification หรือไม่
- ไม่ carrier acceptance, scanner tests และ payload rules ยังเป็นความรับผิดชอบของคุณ