Vektör PDF etiketleri için GS1 barkod API'si
GS1-128, GS1 DataMatrix, GS1 QR, ITF-14 ve SSCC-18 etiket iş akışları dahil PDF'lerde vektör GS1 barkodları render edin.
/api/v1/pdf/render Ürün, depo veya perakende sisteminiz doğru uygulama tanımlayıcıları, kontrol basamakları ve tarayıcı kabulü için sorumlu kalırken GS1 barkod payload'larını vektör PDF etiketlerine veya belgelere render etmek.
Bu API ne zaman kullanılır
- Barkod modüllerinin PDF içinde yapıştırılmış bitmap görüntü yerine vektör içerik olarak çizilmesi gerekiyor.
- Sisteminiz doğru GS1 payload'una ve okunabilir yorum'a zaten sahip.
- Etiket veya belgelerde GS1-128, GS1 DataMatrix, GS1 QR, ITF-14 veya SSCC-18 iş akışları gerekiyor.
- Tekrarlanan barkod etiket yerleşimlerinı Template Render'a taşımak istiyorsunuz.
Neyin yerine geçmez
- gPdf'ten GS1 sertifikasyon veya product-veri semantiği doğrulama bekliyorsunuz.
- gPdf'in GS1 company prefix, GTIN, SSCC veya kontrol basamağı tahsis etmesini istiyorsunuz.
- Envanter veya product master data management gerekiyor.
Hangi endpoint çağrılır
/api/v1/pdf/render
JSON Render bu iş akışı için varsayılan yoldur.
/api/v1/template-render
İş akışı ilgili API yoluna, template sözleşmesine veya capability sorgusuna ihtiyaç duyduğunda kullanın.
Minimum request
POST /api/v1/pdf/render - GS1-128 tarzı PDF barkod elementi.
{
"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" }
}
]
}
]
}
gPdf neyi üstlenir
- PDF çıktısı içinde vektör barkod render işlemi.
- Metin, çizgi, ürün verisi ve etiket yapılarıyla barkod yerleşimi.
- Tekrarlanan ürün, palet, koli ve depo etiketleri için Template Render.
- Tarayıcı ve baskı testlerine uygun PDF çıktısı.
Sisteminiz neyi yönetir
- GS1 uygulama tanımlayıcıları, şirket önekleri, GTIN'ler, SSCC'ler ve kontrol basamakları.
- Doğru barkod verisi, ürün verisi, düzenleyici metin ve tarayıcı kabulü testleri.
- Baskı süreci, etiket stoğu, quiet zone'lar ve operasyonel QA.
Production kontrol listesi
- GS1 payload'unu önceki sistemde üretin ve test edilebilir tutun.
- Üretim yazıcı ve tarayıcılarla yazdırıp tarayın.
- Sessiz bölge, modül boyutu, okunabilir metin ve etiket stoğu doğrulayın.
- Etiket yerleşimi onaylandıktan sonra Template Render kullanın.
- gPdf'in barkodları render ettiğini ancak GS1 compliance sertifikasyonu yapmadığını belgeleyin.
İddia sınırları
- gPdf vektör PDF barkodları render eder; GS1 sertifikasyon kurumu değildir.
- GS1 veri semantiği ve kontrol basamakları çağıran sisteme aittir.
- Tarayıcı kabulü çağıran sistemin üretim environment'ında doğrulanmalıdır.
GS1 barkod render işlemi bir PDF render işlemi işidir
gPdf barkodu PDF içine çizmekten sorumludur. Bir GTIN, SSCC veya uygulama tanımlayıcısı dizisinin işiniz için geçerli olup olmadığına karar vermekten sorumlu değildir. Bu mantığı ERP, WMS, ürün bilgi sistemi veya GS1 araçları içinde tutun.
JSON Render veya Template Render kullanın
Kod etiketi veya belgeyi doğrudan yerleştiriyorsa JSON Render kullanın. Barkod tekrarlanan bir etiket yerleşimi içinde tek alan olduğunda Template Render kullanın. Her iki durumda da çağıran sistem encode edilmesi gereken payload’u gönderir.
Gerçek tarayıcılarla doğrulayın
Barkod başarısı, görüntünün monitörde doğru görünmesiyle değil tarayıcı kabulü ile ölçülür. Üretimde kullanılan aynı yazıcılar, tarayıcılar ve etiket stoğuyla basılı çıktıyı doğrulayın.
SSS
- gPdf GS1 etiketlerini sertifikalandırır mı?
- Hayır. gPdf PDF'lerde vektör barkod grafikleri render eder. GS1 payload doğruluğu, tarayıcı testleri ve sertifikasyon iş akışı ekibinize aittir.
- GS1 barkodları Template Render ile kullanılabilir mi?
- Evet. Yayınlanmış bir şablon barkod alanları içerebilir; çağıran sistemler tekrarlanan etiket yerleşimleri için yalnızca değişken veriyi gönderebilir.
- SSCC veya GTIN'i kim oluşturur?
- Tanımlayıcıları ürün, depo veya ERP sisteminiz oluşturur ve doğrular. gPdf payload'u alıp render eder.
- Neden vektör barkod kullanmalı?
- Vektör modüller raster scaling artifact'lerini önler ve etiket PDF'lerini yazıcı DPI ve zoom seviyelerinde daha keskin tutar.