Amazon FBA Label API สำหรับ backend ของ seller และคลังสินค้า
เรนเดอร์ PDF ฉลากสินค้า กล่อง และ shipment แบบ Amazon FBA จากข้อมูล seller หรือคลังสินค้า พร้อมบาร์โค้ดเวกเตอร์และ output จากเทมเพลต
/api/v1/pdf/render เรนเดอร์ PDF ฉลากสินค้า กล่อง หรือ shipment สำหรับเวิร์กโฟลว์เตรียม Amazon FBA หลังจากระบบ seller, prep service หรือคลังสินค้าของคุณกำหนด identifier, barcode payload และกฎฉลากที่ถูกต้องแล้ว
ควรใช้ API นี้เมื่อใด
- ระบบของคุณมีข้อมูล FNSKU, carton, shipment หรือฉลากจาก prep service อยู่แล้ว
- คุณต้องการฉลากบาร์โค้ดเวกเตอร์เป็น PDF สำหรับจุดพิมพ์ของ seller หรือคลังสินค้า
- คุณต้องการให้ layout ฉลากที่ใช้ซ้ำกลายเป็นสัญญา Template Render
- คุณต้องการ reprint ที่กำหนดผลลัพธ์ได้ซ้ำเดิมสำหรับงาน prep, audit หรือ exception handling
สิ่งที่ไม่ได้ทดแทน
- คุณต้องการ official Amazon integration, app หรือ SP-API connector จาก gPdf
- คุณต้องการให้ Amazon certify ฉลากผ่าน gPdf
- คุณต้องการจัดการ inventory, listing หรือ shipment plan
ควรเรียก endpoint ใด
/api/v1/pdf/render
JSON Render คือ path หลักสำหรับเวิร์กโฟลว์นี้.
/api/v1/template-render
ใช้เมื่อเวิร์กโฟลว์ต้องการ API path ที่เกี่ยวข้อง สัญญาเทมเพลต หรือการค้นหา capability.
Minimal request
POST /api/v1/pdf/render - ฉลากสินค้าพร้อม barcode payload แบบ FNSKU
{
"pages": [
{
"width": 70,
"height": 35,
"elements": [
{
"type": "text",
"x": 4,
"y": 4,
"content": "FNSKU X00ABC1234",
"style": { "font_size": 8, "font_family": "NotoSans-Regular" }
},
{
"type": "barcode",
"format": "code128",
"content": "X00ABC1234",
"x": 4,
"y": 12,
"width": 60,
"height": 12,
"barcode_text": { "enabled": true, "position": "bottom" }
},
{
"type": "text",
"x": 4,
"y": 29,
"content": "SKU: ACME-FILTER-01",
"style": { "font_size": 6, "font_family": "NotoSans-Regular" }
}
]
}
]
}
gPdf จัดการอะไร
- เรนเดอร์ PDF ขนาดฉลากจาก payload ของ JSON Render
- บาร์โค้ดเวกเตอร์ ข้อความ บล็อก SKU กล่อง และการผูกกับเทมเพลต
- output ฉลากที่ใช้ซ้ำผ่าน Template Render
- PDF response สำหรับ print station, seller tool หรือ workflow คลังสินค้า
ระบบของคุณรับผิดชอบอะไร
- การเชื่อมต่อบัญชี Amazon, การเรียก SP-API, ข้อมูล shipment plan, ค่า FNSKU และกฎ marketplace
- barcode payload ที่ถูกต้อง ขนาดฉลาก ข้อมูลสินค้า และการยอมรับจากการสแกน
- UX ของ seller, เวิร์กโฟลว์ prep, storage และสิทธิ์ในการ reprint
Production checklist
- ยืนยัน marketplace ที่ใช้งานและข้อกำหนด fulfillment ก่อนเรนเดอร์
- ตรวจสอบ barcode payload และคุณภาพการพิมพ์จริงบน stock ฉลาก production
- เก็บการเชื่อมต่อ Amazon และการจัดการ credential ไว้นอก gPdf
- จัดเก็บข้อมูลต้นทางของฉลากเพื่อให้ reprint ได้ deterministic
- ย้าย layout ที่อนุมัติแล้วไปใช้ Template Render สำหรับ integration กับ print station
ขอบเขตของ claim
- gPdf ไม่ใช่ official Amazon app หรือ SP-API connector
- gPdf เรนเดอร์ PDF; กฎด้าน Amazon compliance และ seller workflow ยังเป็นของคุณ
- อย่าถือว่าการเรนเดอร์ PDF คือการรับรองฉลากจาก Amazon
ฉลาก FBA คือฉลาก PDF ที่ขับเคลื่อนด้วยข้อมูล
เวิร์กโฟลว์เตรียม Amazon FBA มักต้องใช้ฉลากสินค้า กล่อง หรือ shipment ปัญหาด้านการเรนเดอร์นั้นตรงไปตรงมา: ระบบของคุณส่ง identifier และกฎฉลากมาให้ แล้ว gPdf เรนเดอร์เป็น PDF
แยกการเชื่อมต่อ marketplace ออกจากการเรนเดอร์ ดึงหรือคำนวณ identifier ที่ถูกต้องในระบบ seller หรือคลังสินค้าของคุณ แล้วค่อยเรียก gPdf ด้วย payload ฉลากขั้นสุดท้าย
FAQ
- gPdf เป็น official Amazon FBA app หรือไม่
- ไม่ใช่ backend ของ seller, prep service หรือคลังสินค้าสามารถเรียก gPdf ได้ แต่ gPdf ไม่อ้างว่าเป็น official Amazon app หรือ SP-API integration
- gPdf เรนเดอร์ฉลาก FNSKU ได้หรือไม่
- gPdf สามารถเรนเดอร์ฉลาก PDF ที่มีองค์ประกอบบาร์โค้ดได้ ระบบของคุณเป็นเจ้าของค่า FNSKU, กฎฉลาก และ workflow ของ Amazon
- ฉลาก FBA ควรใช้เทมเพลตหรือไม่
- ใช้ JSON Render ระหว่างทดสอบพิกัด และใช้ Template Render หลังจากดีไซน์ฉลากและ field contract ได้รับอนุมัติแล้ว
- gPdf certify ฉลากให้ Amazon หรือไม่
- ไม่ คุณภาพการพิมพ์ การยอมรับจากการสแกน และ compliance ของ marketplace ยังเป็นความรับผิดชอบของคุณ