4x6 PDF etiketler için gönderi etiketi API'si
Sipariş JSON'undan vektör barkodlar, etiket sayfa boyutları ve deterministik depo yeniden yazdırmalarıyla yazdırmaya hazır 4x6 gönderi etiketi PDF'leri oluşturun.
/api/v1/pdf/render Depo veya e-ticaret backend'inin sipariş karşılama sırasında aynı 4x6 etiketi güvenilir şekilde yazdırabilmesi ve gerektiğinde deterministik olarak yeniden yazdırabilmesi için sipariş, alıcı, servis ve takip verisinden etiket boyutunda PDF'ler render etmek.
Bu API ne zaman kullanılır
- Sisteminizde takip numarası, hedef adres, servis metni ve barkod payload'u zaten var.
- Zebra, SATO, Honeywell veya diğer termal yazıcı iş akışları için PDF çıktısı gerekiyor.
- PDF içine yapıştırılmış raster barkod görüntüleri yerine vektör barkod modülleri istiyorsunuz.
- Aynı payload'un yeniden yazdırma ve denetim kanıtı için aynı etiketi render etmesi gerekiyor.
Neyin yerine geçmez
- Taşıma ücreti satın almak, gönderi ücreti almak veya taşıyıcı hesabı üzerinden taşıyıcı etiketi oluşturmak istiyorsunuz.
- ZPL replacement endpoint gerekiyor. gPdf PDF döndürür, yazıcı komut dili değil.
- gPdf'ten taşıyıcı sertifikasyonu bekliyorsunuz. Tarayıcı ve taşıyıcı kabulü testleri sizde kalır.
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 - takip barkodu içeren minimal 4x6 etiket.
{
"pages": [
{
"size": "label_4_6_in",
"elements": [
{
"type": "text",
"x": 4,
"y": 6,
"content": "SHIP TO",
"style": { "font_size": 8, "font_family": "NotoSans-Regular" }
},
{
"type": "text",
"x": 4,
"y": 13,
"content": "Acme Warehouse\n1200 Logistics Pkwy\nMemphis TN 38116",
"style": { "font_size": 11, "font_family": "NotoSans-Regular" }
},
{
"type": "barcode",
"format": "code128",
"content": "1Z999AA10123456784",
"x": 4,
"y": 62,
"width": 92,
"height": 22,
"barcode_text": { "enabled": true, "position": "bottom" }
}
]
}
]
}
gPdf neyi üstlenir
- 4x6 inç iş akışları için etiket boyutunda PDF sayfaları.
- Taşıyıcı ve depo etiketi içeriği için vektör barkod render işlemi.
- Metin, adres blokları, servis işaretleri, çizgiler, kutular ve isteğe bağlı şablon bağlama.
- Depo yeniden yazdırmaları için deterministik PDF çıktısı.
Sisteminiz neyi yönetir
- Taşıyıcı hesabı, taşıma ücreti satın alma, servis seçimi ve takip numarası oluşturma.
- Doğru barkod payload'ları, okunabilir metin, adresler ve yönlendirme verisi.
- Yazıcı kurulumu, etiket stoğu, tarama testi ve taşıyıcı kabul kontrolleri.
Production kontrol listesi
- Test etiketlerini gerçek yazıcı modelinde ve etiket stoğu üzerinde yazdırın.
- Hedef DPI ve tarayıcı mesafesinde barkod tarama oranlarını doğrulayın.
- Kaynak gönderi verisini veya dönen PDF'i yeniden yazdırma politikanıza göre saklayın.
- Etiket yerleşimi onaylanıp sistemler arasında tekrar kullanılınca Template Render kullanın.
- Taşıyıcıya özgü mantığı render isteği dışında tutun.
İddia sınırları
- gPdf etiket PDF'ini render eder; taşıma ücreti satın almaz veya taşıyıcılarla doğrudan konuşmaz.
- gPdf taşıyıcı etiketi sertifikasyon otoritesi değildir.
- API PDF çıktısı verir; ZPL, EPL veya başka termal yazıcı komut akışı değildir.
Gönderi etiketi API şekli
Gönderi etiketi sayfaları ayrı bir taşıyıcı endpoint değildir. JSON Render’ı etiket boyutunda sayfa, metin blokları, çizgiler, isteğe bağlı görseller ve barkod elementleriyle çağırırsınız. Tekrarlanan etiketlerde onaylanmış yerleşimi şablon olarak yayınlayıp gönderi verisi ile Template Render çağırın.
Bu sorumluluk sınırını açık tutar. gPdf PDF render işlemi ve barkod çizimini sahiplenir. Sisteminiz taşıyıcı işlemi, gönderi durumu ve payload semantiğini sahiplenir.
JSON Render ve Template Render
Sipariş karşılama sisteminiz tüm yerleşimi üretiyorsa veya operasyon ekibi hâlâ koordinatları ayarlıyorsa JSON Render kullanın. Depo ekibi kararlı etiket yerleşimini onayladıktan ve her çağıran sistem aynı veri alanlarını göndermesi gerektiğinde Template Render kullanın.
Her iki yol da PDF çıktısı döndürür. Fark, çağıran sistemin her istekte yerleşimi tarif etmesi veya yayınlanmış template_id referanslamasıdır.
Baskı testi önemlidir
Termal etiket kalitesi fizikseldir. Çıktıyı gerçek etiket stoğu, gerçek yazıcılar ve gerçek tarayıcılar ile doğrulayın. Barkod payload doğruluğu, sessiz bölgeler, yazıcı koyuluğu ve taşıyıcıya özgü kurallar render API’si dışında kalan üretim sorumluluklarıdır.
SSS
- gPdf benim için taşıyıcı etiketi oluşturur mu?
- Hayır. Taşıyıcı veya gönderi sistemi taşıyıcı gönderisini ve barkod payload'unu oluşturur. gPdf bu veriyi PDF etikete render eder.
- Gönderi etiketlerinde Template Render kullanabilir miyim?
- Evet. Etiketi tasarlarken veya test ederken JSON Render kullanın; yerleşim kararlı olduğunda ve çağıran sistemler yalnızca veri göndermeliyse Template Render kullanın.
- gPdf ZPL çıktı verir mi?
- Hayır. Public render API'leri PDF çıktısı verir. Yazdırma hattı ZPL istiyorsa PDF'i gPdf dışında dönüştürün veya yönlendirin.
- Üretim öncesi ne doğrulanmalı?
- Gerçek yazıcı ve etiket stoğu üzerinde yazdırın, barkodu üretim tarayıcılarıyla tarayın ve taşıyıcıya özgü metin ile payload'ların gönderi sisteminden geldiğini doğrulayın.