Warehouse label API untuk workflow cetak WMS dan ERP
Generate PDF label pallet, case, bin, inventory, dan operasi gudang dari data WMS atau ERP dengan reprint deterministik.
/api/v1/pdf/render Merender label gudang dari data WMS atau ERP untuk pallet, carton, bin, asset, lokasi, dan pergerakan inventory, sambil menjaga status inventory, aturan picking, dan operasi gudang tetap di sistem caller.
Kapan memakai API ini
- Anda membutuhkan label pallet, carton, bin, lokasi, inventory, atau asset sebagai PDF.
- WMS atau ERP Anda sudah memiliki data SKU, lot, lokasi, SSCC, dan inventory.
- Anda membutuhkan reprint deterministik saat label rusak atau station mengulang job.
- Anda ingin layout label yang disetujui dipakai ulang melalui Template Render.
Apa yang tidak digantikan
- Anda membutuhkan gPdf mengelola inventory, mengalokasikan lokasi, atau menjalankan workflow gudang.
- Anda membutuhkan scanner app, print-station agent, atau sistem routing label dari gPdf.
- Anda membutuhkan sertifikasi GS1, bukan render barcode.
Endpoint yang dipanggil
/api/v1/pdf/render
JSON Render adalah jalur default untuk workflow ini.
/api/v1/template-render
Gunakan saat workflow butuh jalur API terkait, kontrak template, atau capability lookup.
Request minimal
POST /api/v1/pdf/render - label pallet dengan data barcode SSCC.
{
"pages": [
{
"size": "label_4_6_in",
"elements": [
{
"type": "text",
"x": 6,
"y": 8,
"content": "PALLET LAX-01-2026-00042",
"style": { "font_size": 12, "font_family": "NotoSans-Regular" }
},
{
"type": "barcode",
"format": "sscc-18",
"content": "012345678901234567",
"x": 6,
"y": 30,
"width": 88,
"height": 26,
"barcode_text": { "enabled": true, "position": "bottom" }
},
{
"type": "text",
"x": 6,
"y": 70,
"content": "SKU: CASE-001\nQTY: 48\nLOCATION: A-14-02",
"style": { "font_size": 10, "font_family": "NotoSans-Regular" }
}
]
}
]
}
Yang ditangani gPdf
- Label PDF untuk workflow cetak gudang.
- Barcode vektor, teks, kotak, ukuran halaman label, dan binding template.
- Output deterministik untuk workflow reprint dan audit.
- JSON Render untuk layout kustom dan Template Render untuk kontrak label yang disetujui.
Yang dikelola sistem Anda
- Status inventory, data SKU, data lot/serial, nilai SSCC, dan semantik lokasi.
- Routing printer, setup station, validasi scanner, dan aturan proses gudang.
- Pemilihan template, retry, dan penyimpanan PDF yang dirender atau source data.
Checklist produksi
- Validasi dimensi label terhadap printer dan label stock yang sebenarnya.
- Scan setiap format barcode yang dipakai proses gudang.
- Jaga status WMS/ERP sebagai otoritas dan kirim hanya data label final ke gPdf.
- Gunakan Template Render untuk label yang dicetak beberapa sistem atau station.
- Log ID dokumen sumber dan request ID untuk traceability reprint.
Batas klaim
- gPdf merender PDF label gudang; gPdf tidak mengelola inventory atau status gudang.
- Caller memiliki semantik payload barcode dan penerimaan scanner.
- Template Render dapat menstabilkan layout label, tetapi tidak menggantikan aturan WMS.
Label gudang adalah record operasional
Label gudang mengidentifikasi pallet, case, bin, asset, pergerakan inventory, dan lokasi. Label ini terkait dengan status operasional di WMS atau ERP Anda. gPdf sebaiknya menerima data label final dan merendernya; gPdf tidak seharusnya memutuskan makna inventory atau status proses gudang.
Template Render membuat print station lebih sederhana
Untuk label yang dipakai di beberapa station, publikasikan layout yang disetujui sebagai template. Layanan cetak kemudian dapat mengirim template_id plus data WMS, bukan membangun ulang koordinat di setiap caller.
Determinisme reprint
Gudang mencetak ulang label. Label rusak, printer macet, atau retry station tidak boleh membuat dokumen yang sedikit berbeda. Jaga source label data tetap terkait dengan record gudang dan gunakan input render deterministik untuk reprint.
FAQ
- Apakah gPdf mengelola inventory gudang?
- Tidak. WMS atau ERP Anda memiliki status inventory, lokasi, SKU, lot, dan aturan proses. gPdf merender PDF label dari data final.
- Bisakah label gudang memakai barcode GS1 atau SSCC?
- Ya, gPdf dapat merender format barcode yang didukung dalam output PDF. Sistem Anda memiliki payload barcode dan penerimaan scanner.
- Sebaiknya label gudang berulang memakai template?
- Biasanya ya. Template Render memberi print station template_id dan kontrak data yang stabil setelah layout label disetujui.
- Bagaimana sebaiknya reprint bekerja?
- Simpan source label data atau PDF yang digenerate bersama record gudang Anda, lalu render atau ambil label yang sama memakai ID operasional asli.