Packing slip PDF API สำหรับ fulfillment workflows
สร้าง packing slip PDF จากข้อมูล order, shipment, carton และ item สำหรับ ecommerce, 3PL, OMS และ warehouse fulfillment workflows
/api/v1/template-render เรนเดอร์ packing slips จากข้อมูล shipment, recipient, item และ carton เพื่อให้ทีม fulfillment พิมพ์หรือแนบเอกสารที่สม่ำเสมอสำหรับ outbound order แต่ละรายการ
ควรใช้ API นี้เมื่อใด
- OMS หรือ WMS ของคุณมี order items, quantities, recipient data และ shipment identifiers อยู่แล้ว
- คุณต้องการ PDF packing slip สำหรับ warehouse print station หรือเอกสารแนบในพัสดุลูกค้า
- คุณต้องการ layout ที่อนุมัติแล้วหนึ่งชุดและใช้ซ้ำข้าม warehouses, brands หรือ sales channels
- คุณอาจต้องมี barcode หรือ QR code สำหรับ order lookup หรือ return intake
สิ่งที่ไม่ได้ทดแทน
- คุณต้องการ buy postage, rate shipment หรือสร้าง carrier label
- คุณต้องการ warehouse inventory management แทน document rendering
- คุณต้องการ legal invoice หรือ e-invoice semantics
ควรเรียก endpoint ใด
/api/v1/template-render
Template Render คือ path หลักสำหรับเวิร์กโฟลว์นี้.
/api/v1/pdf/render
ใช้เมื่อเวิร์กโฟลว์ต้องการ API path ที่เกี่ยวข้อง สัญญาเทมเพลต หรือการค้นหา capability.
Minimal request
POST /api/v1/template-render - เทมเพลต packing_list พร้อม shipment หนึ่งรายการ
{
"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 จัดการอะไร
- Template Render สำหรับ packing slip layouts ที่ publish แล้ว
- JSON Render สำหรับหน้า packing slip แบบ custom ระหว่าง design หรือ one-off workflows
- tables, item rows, address blocks, optional barcodes และ PDF output
- deterministic reprints เมื่อใช้ข้อมูลและเทมเพลตเดิม
ระบบของคุณรับผิดชอบอะไร
- order data, item quantities, shipment state, warehouse routing และ customer messaging
- template field mapping, print station routing และ reprint policy
- carrier, customs หรือ invoice document ใด ๆ ที่ต้องเดินทางไปพร้อมพัสดุ
Production checklist
- ทดสอบ SKU, item name และ address combinations ที่ยาวที่สุด
- validate case แบบ one-item, multi-carton, backorder และ partial shipment
- ใช้ Template Render หลังจาก layout packing slip ได้รับอนุมัติแล้ว
- log template_id และ X-Request-Id สำหรับ fulfillment print request แต่ละรายการ
- แยก carrier label generation ออกจาก packing slip rendering
ขอบเขตของ claim
- gPdf เรนเดอร์ packing slip PDF แต่ไม่จัดการ inventory หรือ fulfillment state
- packing slip ไม่ได้เป็น tax invoice หรือ customs document โดยอัตโนมัติ
- carrier label purchase และ shipment rating อยู่นอก gPdf
Packing slips เหมาะกับเส้นทาง template
Packing slips มักมีโครงสร้างที่เสถียร: shipper, recipient, shipment number, item rows และ optional notes จึงเหมาะกับ Template Render หลังจาก layout ได้รับอนุมัติ
JSON Render ยังสำคัญในช่วง design เพราะช่วยให้ทีมของคุณปรับ columns, spacing, barcode placement และ page breaks ก่อน publish contract template_id ที่เสถียร
FAQ
- packing slip เป็น gPdf endpoint แยกหรือไม่
- ไม่ ใช้ Template Render สำหรับเทมเพลต packing slip ที่อนุมัติแล้ว หรือ JSON Render เมื่อระบบของคุณอธิบาย layout โดยตรง
- packing slips ใส่บาร์โค้ดได้หรือไม่
- ได้ gPdf เรนเดอร์ barcode elements ใน PDF ระบบของคุณเป็นเจ้าของ order, carton หรือ return payload ที่ encode
- gPdf สร้าง carrier labels หรือไม่
- ไม่ carrier labels เป็น workflow แยก gPdf เรนเดอร์ PDF จากข้อมูลที่ carrier หรือ shipping system ของคุณให้มา
- request เดียวเรนเดอร์ packing slips หลายรายการได้หรือไม่
- Template Render รับ data array สำหรับหลายรายการใน request เดียวได้ ภายใน public API limits ที่ documented สำหรับ endpoint นั้น