QRbug
Giriş yapBaşla
Blog
Rehberler ve Eğitimler

Toplu QR Kod Oluşturucu: 1000+ QR Kod Hatasız Nasıl Oluşturulur

CSV'den QR kodları ne zaman ve nasıl toplu oluşturulur. Ölçekte hata yönetimi, isimlendirme kuralları, baskıya hazır çıktı ve 1.000 kodu aştığınızda dinamik vs statik kararı.

Mert YıldızYazar: Mert Yıldız··8 dk okuma
Toplu QR Kod Oluşturucu: 1000+ QR Kod Hatasız Nasıl Oluşturulur

Hızlı Cevap

Bir toplu QR kod oluşturucu, CSV veya elektronik tablo girdisinden tek bir partide 100, 1.000 veya 10.000+ QR kod üretir. Girdideki her satır kendi hedef URL'si, opsiyonel etiketi ve opsiyonel metadata'sıyla bir QR koda dönüşür. Çıktı, SVG/PNG dosyalarının indirilebilir bir arşividir (ZIP) artı her dosyayı kaynak satırına eşleyen bir manifest CSV.

Toplu üretim, ekiplerin serileştirilmiş kod basması gerektiğinde ihtiyaç duyduğu şeydir — ürün birimi başına bir, masa başına bir, stand başına bir, bilet başına bir. Bunu manuel yapmak yaklaşık 20 koddan sonra çöker; programatik yapmak 1.000 kod için 30 saniye sürer.

Bu rehber toplu QR kod oluşturucuların nasıl çalıştığını, çoğunun kabul ettiği dört girdi formatını, ölçekte hata yönetimini ve 1.000 kodu aştığınızda ekipleri ısıran spesifik gotcha'ları (URL çakışması, isimlendirme çatışmaları, hata düzeltme varsayılanları) açıklar.

Toplu üretime ne zaman ihtiyacınız var

Tek tek üretimi aştığınızı söyleyen üç sinyal:

1. Serileştirilmiş ürün kodları. Her birim benzersiz bir QR alır (garanti kaydı, sahteciliğe karşı, parti izleme).

2. Masa veya stand başına kodlar. 200 masalı bir restoran veya 500 standlı bir fuar konum başına bir koda ihtiyaç duyar — her biri analitik için benzersiz bir URL'ye işaret eder.

3. Bilet veya katılımcı başına kodlar. Her konferans yaka kartı veya etkinlik biletinin bir vCard veya check-in URL'si vardır.

20 kodun üzerinde, manuel üretim yavaş ve hataya açıktır. 100'ün üzerinde, savunulamaz. Toplu oluşturucular bunu CSV-tabanlı partilerle çözer.

Bir toplu QR kod oluşturucu nasıl çalışır

Standart akış:

  1. Kod başına bir satır içeren bir CSV yükleyin. Sütunlar genellikle şunları içerir: hedef URL, dosya adı (slug), opsiyonel etiket, opsiyonel kategori.
  2. Bir şablon seçin — renk, nokta şekli, logo, hata düzeltme. Partideki her koda uygulanır.
  3. Çıktı formatını seçin — SVG (vektör, baskı için önerilir), PNG (raster, sabit boyut) veya PDF (baskıya hazır).
  4. Üretin — sunucu CSV'yi işler, her satırı kodlayıcıdan geçirir, çıktıları bir ZIP'e paketler.
  5. İndirin — ZIP, satır başına bir dosya artı her dosya adını kaynak URL'ye eşleyen bir manifest.csv içerir.

Dinamik toplu QR'lar için akış şunu ekler: üretilen her kısa URL yönlendirme veritabanında kaydedilir ve yönlendirme hedefi CSV satırındaki URL'dir. Satır başına bir kısa URL elde edersiniz, hepsi sonradan düzenlenebilir.

Girdi format beklentileri

Çoğu toplu oluşturucu en az şu sütunları içeren bir CSV kabul eder:

slug,destinationUrl,label
table-001,https://example.com/menu/table-1,Table 1
table-002,https://example.com/menu/table-2,Table 2
table-003,https://example.com/menu/table-3,Table 3

Yaygın opsiyonel sütunlar:

  • tags — virgülle ayrılmış liste, sonra filtreleme/analitik için kullanılır.
  • logoUrl — kod başına logo override (nadir — genellikle tüm parti için bir logo).
  • color — ön plan için hex kod.
  • metadata — keyfi ekstra alanların JSON bloğu.

Bazı oluşturucular CSV'ye ek olarak Excel (.xlsx) ve JSON girdileri kabul eder. CSV en güvenli seçim — her yerde çalışır ve gizli formatlamaya sahip değildir.

Statik vs dinamik toplu kodlar

Tek-kod üretimiyle aynı takas, ölçekle büyütülmüş.

Statik toplu kodlar: Her QR hedef URL'sini doğrudan kodlar. Ücretsiz veya düşük maliyetli (sunucu altyapısı için değil, kodlayıcı için ödüyorsunuz). Takas: sıfır analitik, sıfır düzenleme.

Dinamik toplu kodlar: Her QR benzersiz bir kısa yönlendirme URL'si kodlar; hedef düzenlenebilir. Abonelik tabanlı (fiyat kod sayısıyla ölçeklenir). Kod başına analitik veya kodları emekliye ayırma yeteneği isteyeceğiniz herhangi bir kampanya için değer.

1.000 kod için maliyet örneği:

ModKurulum maliyetiYıllık maliyetDüzenlenebilir?Analitik?
Statik (açık kaynak kütüphane)$0$0
Statik (ücretli oluşturucu)$0$0–$50 tek seferlik
Dinamik (ücretli oluşturucu)Kurulum seviyesi$200–$500/yıl

1.000 ürün birimi kodu için (izleme gerekmez), statik uygundur. 1.000 fuar standı kodu için (stand başına tarama verisi gerekir), dinamik tekrarlanan maliyete değer.

Ölçekte hata yönetimi

1.000 kod ürettiğinizde, ~5–15 tanesinin bir sorunu olacaktır. Yaygın sorunlar:

1. Çift slug'lar. Aynı slug'lı iki satır → ikinci birinciyi üzerine yazar. Toplu oluşturucular yüklemeyi reddetmeli ve çift satır numaralarını yüzeye çıkarmalı.

2. Uzunluk bütçesini aşan URL'ler. 500 karakterlik bir hedef URL, güvenilir taranmak için fazla yoğun bir kod üretir. Toplu oluşturucular kodlanan URL'nin ~150 karakteri aştığı satırlarda uyarmalı.

3. Slug'larda geçersiz karakterler. Slug'lar dosya adı olur; /, \, ?, <, > gibi karakterler dosya sistemlerini bozar. Toplu oluşturucular temizlemeli veya reddetmeli.

4. Boş satırlar. Boş bir satır boş string kodlayan bir QR üretir. Her zaman reddedin.

5. URL formatlama hataları. htps:// typo, eksik scheme. Toplu oluşturucular URL formatını doğrulamalı ve bozuk satırları reddetmeli.

İyi bir toplu oluşturucu işlemden önce dry-run önizleme sunar — satır sayısını gösterir, uyarıları listeler, CSV'yi düzeltip yeniden yüklemenize izin verir. Kötü olanı yüklediğiniz her şeyi işler ve sessizce bozuk kodlar üretir.

İsimlendirme ve organizasyon

1.000+ kod için dosya organizasyonu önemlidir. Önerilen desen:

qr-batch-2026-05/
├── manifest.csv             # Her kodu kaynak satırına eşler
├── codes/
│   ├── table-001.svg
│   ├── table-002.svg
│   └── ...
└── README.md                # Üretim parametreleri, parti ID, tarih

manifest.csv kritik — gelecekteki sizin (veya bir halefin) hangi basılı kodun nereye gittiğini bulmasına izin verir.

Dosya adları deterministik ve anlamlı olmalı: table-001.svg, booth-A14.svg, product-sn-12345.svg. Baskı süreciniz onları yeniden etiketlemediği sürece otomatik üretilen UUID'lerden kaçının.

Baskıya hazır çıktı

100 kodun üzerindeki baskılar için, çıktı format gereksinimleri spesifikleşir:

  • PNG değil SVG, çünkü yazıcı pikselleşmeden ölçekler.
  • Kesim payı boyuta göre kesiyorsanız — en az 2 mm padding.
  • Crop mark'lar sayfaya basıyorsanız — çoğu oluşturucu bunu destekler.
  • CMYK renk profili ticari baskıya gidiyorsa, dijital baskı için RGB.
  • Gömülü fontlar herhangi bir metin etiketinde — yoksa yazıcının font ikamesi düzeni bozabilir.

Yerel baskı destekli (CMYK + crop mark + payı) toplu oluşturucular nadirdir. Çoğu, sayfa montajı için bir düzen aracına (InDesign, Affinity Publisher, Figma) içe aktardığınız ham SVG'ler üretir. Üretim sonrası baskı hazırlık adımı için planlayın.

Programatik üretim (geliştirici yolu)

Mühendislik kapasiteniz varsa, açık kaynak qr-code-styling kütüphanesi toplu üretimi doğrudan yönetir:

import QRCodeStyling from 'qr-code-styling'
import { writeFileSync } from 'node:fs'
import { parse } from 'csv-parse/sync'

const csv = parse(readFileSync('input.csv'), { columns: true })

for (const row of csv) {
  const qr = new QRCodeStyling({
    width: 600,
    height: 600,
    type: 'svg',
    data: row.destinationUrl,
    qrOptions: { errorCorrectionLevel: 'H' },
    dotsOptions: { color: '#1d4ed8', type: 'rounded' },
    cornersSquareOptions: { color: '#1d4ed8', type: 'extra-rounded' },
    backgroundOptions: { color: '#ffffff' },
  })
  const svg = await qr.getRawData('svg')
  writeFileSync(`out/${row.slug}.svg`, svg)
}

1.000 kod için bu döngü 30–60 saniyede tamamlanır. 100.000+ için, Promise.all() ile 100'lük chunk'lar olarak paralelleştirin.

Self-hosting abonelik maliyetini kurtarır ama yalnızca statik kodlar üretir — qr-code-styling tek başına dinamik yönlendirme sunucusunu vermez. Ölçekte dinamik için yönlendirme sunucusunu da çalıştırmanız gerekir.

Toplu dinamik kodlar: yönlendirme veritabanı tarafı

1.000 dinamik kod ürettiğinizde, sağlayıcının yönlendirme veritabanında 1.000 satır oluşturuyorsunuz. Her biri kısa bir URL alır (örn. qrb.gg/abc) ve her tarama sağlayıcının altyapısı üzerinden loglanır.

1.000+ kod planına kayıt olmadan önce doğrulanacaklar:

  • Kod başına analitik, yalnızca parti seviyesinde değil. Hangi spesifik kodun hangi taramaları getirdiğini bilmeniz gerekir.
  • Toplu işlemler için API: 1.000 hedefi tek tek düzenlemek pratik değil. API veya CSV yeniden-yükleme yoluyla toplu güncelleme zorunlu.
  • Kod arşivleme/emeklilik — kodlar artık kullanılmadığında, geçmiş tarama verisini kaybetmeden devre dışı bırakmanız gerekir.
  • Özel domain desteği — 1.000+ kodda, yönlendirme kısa URL'leri bir marka yüzeyine dönüşür. qrb.gg/abc testler için uygun; links.yourbrand.com/abc production'ın istediğidir.

Yaygın tuzaklar

Küçük partide test etmeden üretmek. 1.000'e taahhüt etmeden önce her zaman 5–10 test satırını tüm pipeline'dan geçirin (üret → bas → tara).

Baskı boyutu değişen ürünler için aynı QR tasarımını kullanmak. 5×5 cm sticker için optimize edilmiş bir kod, 1×1 cm ambalaja küçültüldüğünde taranmaz. Her baskı boyutunu test edin.

Slug'ları kullanıcıya açık olarak değerlendirmek. qrb.gg/table-001-pleasing-mountain-goat müşteriye gözüküyorsa, bu iyi değil. Slug'lar makine-dostu iç tanımlayıcılar olmalı.

Manifest'i yedeklemeyi unutmak. Baskı işi bittiğinde, hangi kodun nereye gittiğini bilmenin tek yolu manifest.csv'dir. Onu kaybedin ve partinin izlenebilirliğini kaybedin.

Ürün kodları için H'de hata düzeltme yapmamak. Ürün ambalajı katlanır, çizilir ve havaya maruz kalır. Fiziksel ürün kodları için her zaman Seviye H hata düzeltme kullanın.

Statik yeterken dinamik kodları partilerle üretmek. Hedef URL asla değişmiyorsa (örn. bir ürün kılavuzu linki), statik için bir kez ödeyin ve dinamik aboneliği atlayın.

Toplu üretim kullanılmayacak durumlar

Toplunun aşırı olduğu üç durum:

1. Küçük baskılar (20 koddan az). UI'da manuel üretim, CSV ve içe aktarma süreci kurmaktan daha hızlıdır.

2. Çok farklı tasarımlı kodlar. Her kodun benzersiz bir rengi, logosu veya düzeni gerekiyorsa, toplu üretimin "tek şablon" modeli yardımcı olmaz. Manuel üretin.

3. Aynı URL'ye işaret eden kodlar. 1.000 kod tümü aynı URL'ye işaret ediyorsa, 1.000 koda ihtiyacınız yok — 1.000 kez basılmış bir koda ihtiyacınız var. Toplu üretim gereksiz yere 1.000 farklı kısa URL oluşturur.

Toplu üretim için fiyat seviyeleri

Kod sayısıKullanımFiyat seviyesi
1–25Küçük işletmeÜcretsiz veya $6/ay
25–100Restoran zinciri (masa başına)$19/ay
100–1.000Orta ölçekli ürün hattı$49/ay
1.000–10.000Kurumsal serileştirme$79–$199/ay
10.000+Üretim / tedarik zinciriAPI kurumsal

10.000 kodun üzerinde, neredeyse hiç kimse self-serve plan sunmaz — özel fiyatlandırmalı API kurumsal bölgesindesiniz.

SSS

Bir toplu QR kod oluşturucu için maksimum parti boyutu nedir?

Sağlayıcıya göre değişir. Çoğu tarayıcı tabanlı toplu araç yükleme başına 1.000–5.000 kodda sınırlanır. Sunucu tarafı veya API tabanlı oluşturucular tek partide 100.000+ idare eder ama kurulum gerektirir. Açık kaynak qr-code-styling kütüphanesi sınırsızdır (hesaplamayı siz sağlarsınız).

10.000 QR kodu ücretsiz üretebilir miyim?

Evet — qr-code-styling (npm) veya qrcode (npm/Python) kullanarak bir CSV girdisi ve scriptle. Kodlar statik olur (URL'ler gömülü). 10.000 dinamik kod için ücretli plan gerekir çünkü sağlayıcı yönlendirme sunucusunu çalıştırır.

1.000 QR kodu üretmek ne kadar sürer?

Ücretli toplu araçta: kodlayıcı için 10–30 saniye, artı paketleme süresi (ZIP için 1–2 dk). qr-code-styling ile programatik: logo gömmeye bağlı olarak 30–90 saniye. CSV'nin ağ yüklemesi 5–15 saniye ekler.

Toplu partideki her kod farklı içeriğe sahip olabilir mi?

Evet — anlamı bu. CSV'deki her satır kendi hedef URL'siyle bir koda dönüşür. Görsel şablon (renkler, logo, nokta şekli) genellikle parti boyunca paylaşılır.

Toplu üretim sonrasında kodları tek tek düzenleyebilir miyim?

Dinamik kodlar için: evet, herhangi bir spesifik kısa kodun hedef URL'sini UI veya API yoluyla güncelleyin. Statik kodlar için: hayır — yeniden üretmeniz gerekir.

CSV hangi formatta olmalı?

UTF-8 kodlanmış, virgülle ayrılmış, başlık satırlı. Gerekli sütunlar: en az slug (dosya adı) ve destinationUrl. Opsiyonel: label, tags, metadata. Excel'de kaydedilen CSV'ler ABD-dışı locale'lerde bazen noktalı virgül kullanır — dışa aktarımın virgül kullandığını doğrulayın.

Toplu QR kodlar tek kodlardan daha hataya açık mı?

Kod başına, hayır — kodlayıcı özdeştir. Hatalar girdi verisinden gelir: kötü URL'ler, çift slug'lar, formatlama sorunları. Her zaman işlemden önce dry-run doğrulama paslı çalıştırın.


Toplu üretim, 30 saniyelik iş ile 30 saatlik iş arasındaki farktır. 100+ kod üretiyorsanız bunu partide yapın — manuel zamanınıza vergi.

Kod başına analitikli toplu dinamik kodlar için, QRbug Pro seviyede CSV içe aktarımını destekler. Statik toplu için, qr-code-styling ile açık kaynak yolu ücretsiz ve yetenekli.

İlgili yazılar

QRbug'ı ücretsiz dene

Sınırsız statik QR kod — kayıt olmadan oluştur.