Tim Kencang.in
Satu QR untuk semua produk cukup untuk brosur, tetapi tidak untuk kemasan. Produsen ingin setiap SKU, bahkan setiap nomor seri, memiliki QR sendiri agar bisa mengarah ke halaman produk yang tepat, mengaktifkan garansi, atau memverifikasi keaslian. Membuat ribuan QR secara manual mustahil; lewat API, ini pekerjaan satu skrip.
Kenapa QR dinamis untuk kemasan
Kemasan dicetak sekali dan beredar bertahun-tahun. Dengan QR dinamis, tujuan tiap QR bisa diubah kapan saja: hari ini ke halaman produk, saat ada recall ke pengumuman resmi, saat promo ke halaman kupon. Setiap pindaian juga tercatat, sehingga Anda tahu produk mana yang dipindai, di kota mana, dan kapan.
Merancang skema alias
Sebelum membuat, tentukan pola alias yang deterministik, karena alias adalah kunci yang menghubungkan QR fisik dengan data Anda:
- Per SKU:
p-ab1234. Cukup untuk halaman produk dan promo. - Per nomor seri:
s-ab1234-000981. Diperlukan untuk garansi dan verifikasi keaslian. - Per batch produksi:
b-2026w31-ab1234. Kompromi antara keduanya untuk pelacakan distribusi.
Alias yang deterministik juga membuat skrip idempoten: jika dijalankan ulang, alias yang sudah ada akan ditolak API dan Anda tahu QR itu sudah dibuat. Aturan penulisan alias dibahas di artikel alias kustom.
Endpoint yang dipakai
POST /api/qr/add menerima type (link, text, vcard, wifi, dan lainnya), data berisi tujuan, name sebagai label internal, custom untuk alias link pendek di baliknya, serta opsi desain seperti warna, logo, bingkai, dan format keluaran (png, svg, pdf). Respons berisi ID QR, link pendek, dan URL file gambar. Parameter lengkap ada di dokumentasi developer.
Skrip batch
Beberapa catatan untuk skrip di atas:
- Jeda 1,1 detik menjaga di bawah 60 permintaan per menit (paket Pro). Paket Bisnis mengizinkan 300 per menit, sehingga jeda bisa diperkecil. Penjelasan lengkap di artikel rate limit dan penanganan error.
- Simpan hasil ke file secara bertahap, sehingga jika skrip berhenti di tengah, Anda bisa melanjutkan dari baris terakhir.
- Minta format SVG untuk cetak; vektor tetap tajam di ukuran label 1,5 cm maupun poster. Alasan teknisnya dijelaskan di artikel mendesain QR code dengan logo.
- Tambahkan desain seragam (warna brand, logo kecil) lewat parameter, agar semua QR konsisten tanpa pengeditan manual.
Alternatif tanpa kode
Jika jumlahnya ratusan, bukan ribuan, menu QR Massal di dasbor menerima file CSV berisi kolom nama, tujuan, dan alias, lalu menghasilkan arsip ZIP berisi semua gambar. Fitur ini tersedia di paket Pro ke atas (lihat harga).
Mengirim ke percetakan
- Percetakan umumnya menerima data variabel dalam bentuk folder SVG/PDF yang dinamai sesuai SKU atau nomor seri, ditambah CSV pemetaan. Pastikan nama file sama persis dengan alias.
- Sertakan sampel cetak untuk uji pindai sebelum produksi penuh. Standar ukuran dan quiet zone mengacu pada ISO/IEC 18004.
- Arahkan semua QR ke halaman "segera hadir" dulu; ubah tujuan massal lewat API saat produk mulai dijual.
Membaca data pindaian
Karena setiap QR memiliki alias sendiri, statistik dapat ditarik per produk lewat GET /api/url/{id} atau dilihat di dasbor. Kelompokkan QR ke dalam Kampanye per lini produk untuk melihat angka gabungan. Anda juga bisa mengirim pindaian secara real-time ke sistem gudang atau CRM melalui webhook, misalnya untuk mengaktifkan garansi otomatis saat konsumen memindai pertama kali.
Pertanyaan umum
Berapa lama membuat seribu QR lewat API?
Dengan paket Pro yang membatasi 60 permintaan per menit, sekitar 17 menit. Dengan paket Bisnis yang mengizinkan 300 permintaan per menit, sekitar 4 menit. Jalankan skrip di latar belakang dan simpan hasil secara bertahap.
Apakah semua QR massal bisa diubah tujuannya sekaligus?
Bisa. Karena setiap QR memiliki ID dan alias, skrip yang sama dapat memanggil endpoint pembaruan untuk mengganti tujuan secara massal, misalnya saat produk berpindah halaman atau saat kampanye baru dimulai.
Format file apa yang diterima percetakan untuk data variabel?
Umumnya folder berisi SVG atau PDF yang dinamai sesuai nomor seri, ditambah CSV pemetaan. Pastikan nama file sama persis dengan alias agar pencocokan tidak salah, dan sertakan sampel cetak untuk uji pindai.
Apakah pindaian per nomor seri bisa dipakai untuk verifikasi keaslian?
Bisa sebagai lapisan awal. Pindaian yang muncul dari banyak kota berbeda untuk satu nomor seri menandakan kemungkinan pemalsuan. Untuk verifikasi yang kuat, gabungkan dengan sistem aktivasi di sisi aplikasi Anda.
