Packing slip PDF API untuk workflow fulfillment
Generate PDF packing slip dari data order, shipment, carton, dan item untuk workflow ecommerce, 3PL, OMS, dan fulfillment gudang.
/api/v1/template-render Merender packing slip dari data shipment, penerima, item, dan carton agar tim fulfillment dapat mencetak atau menyertakan dokumen yang konsisten untuk setiap outbound order.
Kapan memakai API ini
- OMS atau WMS Anda sudah memiliki item order, quantity, data penerima, dan identifier shipment.
- Anda membutuhkan PDF packing slip untuk print station gudang atau sisipan paket pelanggan.
- Anda menginginkan satu layout yang disetujui dan dipakai ulang lintas gudang, brand, atau channel penjualan.
- Anda mungkin membutuhkan barcode atau QR code untuk lookup order atau intake return.
Apa yang tidak digantikan
- Anda perlu membeli ongkir, menghitung tarif shipment, atau membuat label carrier.
- Anda membutuhkan inventory management gudang, bukan render dokumen.
- Anda membutuhkan semantik invoice legal atau e-invoice.
Endpoint yang dipanggil
/api/v1/template-render
Template Render adalah jalur default untuk workflow ini.
/api/v1/pdf/render
Gunakan saat workflow butuh jalur API terkait, kontrak template, atau capability lookup.
Request minimal
POST /api/v1/template-render - template packing_list dengan satu 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"
}
]
}
]
}
Yang ditangani gPdf
- Template Render untuk layout packing slip yang dipublikasikan.
- JSON Render untuk halaman packing slip kustom selama desain atau workflow sekali pakai.
- Tabel, baris item, blok alamat, barcode opsional, dan output PDF.
- Reprint deterministik ketika data dan template yang sama digunakan.
Yang dikelola sistem Anda
- Data order, quantity item, status shipment, routing gudang, dan pesan pelanggan.
- Mapping field template, routing print station, dan kebijakan reprint.
- Dokumen carrier, dokumen kepabeanan, atau invoice apa pun yang harus ikut dalam paket.
Checklist produksi
- Uji kombinasi SKU, nama item, dan alamat terpanjang.
- Validasi kasus satu item, multi-carton, backorder, dan partial shipment.
- Gunakan Template Render setelah layout packing slip disetujui.
- Log template_id dan X-Request-Id untuk setiap request cetak fulfillment.
- Pisahkan pembuatan label carrier dari render packing slip.
Batas klaim
- gPdf merender PDF packing slip; gPdf tidak mengelola inventory atau status fulfillment.
- Packing slip tidak otomatis menjadi dokumen pajak atau dokumen kepabeanan.
- Pembelian label carrier dan rating shipment tetap di luar gPdf.
Packing slip cocok dengan jalur template
Packing slip biasanya memiliki struktur stabil: shipper, penerima, nomor shipment, baris item, dan catatan opsional. Itu membuat Template Render sangat cocok setelah layout disetujui.
JSON Render tetap penting selama desain. Jalur ini memungkinkan tim Anda menyetel kolom, jarak, penempatan barcode, dan page break sebelum memublikasikan kontrak template_id yang stabil.
FAQ
- Apakah packing slip adalah endpoint gPdf terpisah?
- Tidak. Gunakan Template Render untuk template packing slip yang sudah disetujui atau JSON Render ketika sistem Anda menjelaskan layout secara langsung.
- Bisakah packing slip memuat barcode?
- Ya. gPdf dapat merender elemen barcode dalam PDF. Sistem Anda memiliki payload order, carton, atau return yang dikodekan.
- Apakah gPdf membuat label carrier?
- Tidak. Label carrier adalah workflow terpisah. gPdf merender PDF dari data yang diberikan carrier atau sistem pengiriman Anda.
- Bisakah satu request merender beberapa packing slip?
- Template Render menerima array data untuk beberapa item dalam satu request, dalam batas API publik yang terdokumentasi untuk endpoint tersebut.