Depo ve 3PL iş akışları için palet etiketi API'si
WMS veya 3PL verilerinden palet etiketi PDF'leri üretin; SSCC, yönlendirme metni ve depo yeniden yazdırma gereksinimlerini render katmanında sabit tutun.
/api/v1/pdf/render WMS veya 3PL sisteminiz palet, SSCC, rota ve yük verisini belirledikten sonra bu veriyi yazdırılabilir ve deterministik palet etiketi PDF'lerine render etmek.
Bu API ne zaman kullanılır
- Sisteminiz palet tanımlayıcı, SSCC veya yönlendirme veriye zaten sahip.
- Depo yazdırma istasyonları için PDF etiket çıktısı gerekiyor.
- Yeniden yazdırmanın aynı payload ile aynı etiketi üretmesi gerekiyor.
- Onaylanan palet etiketi yerleşiminu Template Render'a taşımak istiyorsunuz.
Neyin yerine geçmez
- gPdf'in SSCC üretmesini, GS1 semantics doğrulamasını veya taşıyıcı kabulü sertifikası vermesini bekliyorsunuz.
- Yazıcı komut dili çıktı gerekiyor; public API PDF döndürür.
- WMS, inventory veya gönderi durumu 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 - palet etiketi için label-sized PDF.
{
"pages": [
{
"size": "label_4_6_in",
"elements": [
{
"type": "text",
"x": 5,
"y": 7,
"content": "PALLET 12 / DOCK B",
"style": { "font_size": 13, "font_family": "NotoSans-Regular" }
},
{
"type": "barcode",
"format": "sscc-18",
"content": "000123456789012345",
"x": 5,
"y": 28,
"width": 92,
"height": 30,
"barcode_text": { "enabled": true, "position": "bottom" }
},
{
"type": "text",
"x": 5,
"y": 78,
"content": "GTIN 09506000134352\nQTY 48 CASES\nLOT L-2026-05",
"style": { "font_size": 10, "font_family": "NotoSans-Regular" }
}
]
}
]
}
gPdf neyi üstlenir
- Palet etiketi için label-sized PDF render işlemi.
- Vektör barkodlar, text blocks, yönlendirme marks ve boxes.
- Tekrarlanan yerleşimler için Template Render.
- Yeniden yazdırma ve denetim için deterministik PDF yanıtı.
Sisteminiz neyi yönetir
- Palet data, SSCC/GS1 payload, yönlendirme, depo durumu ve iş kuralları.
- Yazıcı setup, etiket stoğu, tarayıcı testi ve kabul kriterleri.
- Depolama, yeniden yazdırma yetkisi ve operational denetim.
Production kontrol listesi
- SSCC veya barkod payload'unu önceki sistemde doğrulayın.
- Üretim yazıcı, tarayıcı ve etiket stoğu ile test edin.
- Sessiz bölge, modül boyutu ve okunabilir metin doğrulayın.
- Yeniden yazdırma için template_id, kaynak palet ID'si ve request ID'yi saklayın.
- Onaylanmış yerleşimi Template Render'a taşıyın.
İddia sınırları
- gPdf palet etiketi PDF'ini render eder; SSCC veya GS1 veri semantiği üretmez.
- Taşıyıcı veya depo kabul testleri çağıran sisteme aittir.
- PDF çıktısı yazıcı komut akışı değildir.
Palet etiketleri WMS verisini print çıktı’a bağlar
Palet etiketi, WMS veya 3PL sisteminizdeki operasyonel verinin fiziksel çıktısıdır. gPdf tanımlayıcı, yönlendirme veya depo durumu üretmez; bu verileri PDF etiket yerleşimina render eder.
SSCC, barkod payload ve okunabilir metin’i önceki sistemde doğrulayın. Üretim başarısı gerçek yazıcılar, tarayıcılar ve etiket stoğu ile ölçülür.
SSS
- gPdf SSCC oluşturur mu?
- Hayır. SSCC veya diğer GS1 tanımlayıcıları sizin sisteminiz oluşturur ve doğrular; gPdf payload'u render eder.
- Palet etiketlerinde Template Render kullanılabilir mi?
- Evet. Yerleşim onaylandıktan sonra Template Render kullanmak yazdırma istasyonları için daha kararlı bir sözleşme sağlar.
- PDF yerine ZPL döner mi?
- Hayır. Public render API'leri PDF döndürür. ZPL gerekiyorsa PDF'i gPdf dışında dönüştürün veya yazdırma hattınızda yönlendirin.
- Üretim öncesi ne test edilmeli?
- Gerçek yazıcı, etiket stoğu, tarayıcı ve depo sürecinizle test edin.