GS1 barcode API untuk label PDF vektor
Render barcode GS1 vektor dalam PDF, termasuk workflow label GS1-128, GS1 DataMatrix, GS1 QR, ITF-14, dan SSCC-18.
/api/v1/pdf/render Merender payload barcode GS1 menjadi label atau dokumen PDF vektor, sementara sistem produk, gudang, atau retail Anda tetap bertanggung jawab atas application identifiers, check digit, dan penerimaan scanner yang benar.
Kapan memakai API ini
- Anda membutuhkan modul barcode digambar sebagai konten PDF vektor, bukan gambar bitmap yang ditempel.
- Sistem Anda sudah memiliki payload GS1 yang benar dan interpretasi human-readable.
- Anda membutuhkan workflow GS1-128, GS1 DataMatrix, GS1 QR, ITF-14, atau SSCC-18 di label atau dokumen.
- Anda ingin layout label barcode berulang dipindahkan ke Template Render.
Apa yang tidak digantikan
- Anda membutuhkan sertifikasi GS1 atau validasi semantik data produk dari gPdf.
- Anda membutuhkan gPdf mengalokasikan GS1 company prefix, GTIN, SSCC, atau check digit.
- Anda membutuhkan inventory atau product master data management.
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 - elemen barcode PDF bergaya GS1-128.
{
"pages": [
{
"size": "label_4_6_in",
"elements": [
{
"type": "barcode",
"format": "gs1-128",
"content": "(00)012345678901234567",
"x": 8,
"y": 22,
"width": 86,
"height": 24,
"barcode_text": { "enabled": true, "position": "bottom" }
},
{
"type": "text",
"x": 8,
"y": 56,
"content": "SSCC pallet label",
"style": { "font_size": 10, "font_family": "NotoSans-Regular" }
}
]
}
]
}
Yang ditangani gPdf
- Render barcode vektor di dalam output PDF.
- Penempatan barcode bersama teks, garis, data produk, dan struktur label.
- Template Render untuk label produk, pallet, carton, dan gudang yang berulang.
- Output PDF yang cocok untuk scanner dan print tests.
Yang dikelola sistem Anda
- GS1 application identifiers, company prefix, GTIN, SSCC, dan check digit.
- Data barcode yang benar, data produk, teks regulatori, dan scanner acceptance tests.
- Proses cetak, label stock, quiet zone, dan QA operasional.
Checklist produksi
- Generate payload GS1 upstream dan jaga agar dapat diuji.
- Cetak dan scan pada printer dan scanner production.
- Validasi quiet zone, ukuran modul, teks human-readable, dan label stock.
- Gunakan Template Render setelah layout label disetujui.
- Dokumentasikan bahwa gPdf merender barcode tetapi tidak mensertifikasi compliance GS1.
Batas klaim
- gPdf merender barcode PDF vektor; gPdf bukan badan sertifikasi GS1.
- Caller memiliki semantik data GS1 dan check digit.
- Penerimaan scanner harus divalidasi di lingkungan production caller.
Render barcode GS1 adalah pekerjaan render PDF
gPdf bertanggung jawab menggambar barcode ke dalam PDF. gPdf tidak bertanggung jawab memutuskan apakah GTIN, SSCC, atau urutan application identifier valid untuk bisnis Anda. Simpan logika itu di ERP, WMS, sistem informasi produk, atau tooling GS1 Anda.
Gunakan JSON Render atau Template Render
Gunakan JSON Render ketika kode menyusun label atau dokumen secara langsung. Gunakan Template Render ketika barcode adalah satu field di dalam layout label berulang. Pada kedua kasus, caller mengirim payload yang harus dikodekan.
Validasi dengan scanner sungguhan
Keberhasilan barcode diukur dari penerimaan scanner, bukan dari apakah gambar terlihat benar di monitor. Validasi output cetak dengan printer, scanner, dan label stock yang sama dengan production.
FAQ
- Apakah gPdf mensertifikasi label GS1?
- Tidak. gPdf merender grafik barcode vektor dalam PDF. Tim Anda memiliki kebenaran payload GS1, scan test, dan workflow sertifikasi apa pun.
- Bisakah barcode GS1 dipakai dengan Template Render?
- Ya. Template yang dipublikasikan dapat berisi field barcode, dan caller dapat mengirim hanya data variabel untuk layout label berulang.
- Siapa yang membuat SSCC atau GTIN?
- Sistem produk, gudang, atau ERP Anda membuat dan memvalidasi identifier. gPdf menerima payload dan merendernya.
- Mengapa memakai barcode vektor?
- Modul vektor menghindari artefak scaling raster dan menjaga PDF label lebih tajam pada berbagai DPI printer dan level zoom.