WMS ve ERP yazdırma iş akışları için depo etiketi API'si
WMS ve ERP yazdırma iş akışları için depo etiketi PDF'leri üretin; tanımlayıcı, yönlendirme, tarayıcı kabulü ve yeniden yazdırma politikası sisteminizde kalır.
/api/v1/pdf/render WMS veya ERP sisteminiz item, location, yönlendirme veya stok payload'u'unu belirledikten sonra yazdırma istasyonları için deterministik depo etiketi PDF'leri render etmek.
Bu API ne zaman kullanılır
- Sisteminiz item, location, yönlendirme veya inventory veriye zaten sahip.
- Depo yazdırma istasyonları için PDF çıktısı gerekiyor.
- Yeniden yazdırmalar aynı kaynak veri ile aynı etiketi üretmeli.
- Onaylı yerleşimleri Template Render ile sabitlemek istiyorsunuz.
Neyin yerine geçmez
- gPdf'in WMS, stok sistemi veya tarayıcı fleet manager olmasını bekliyorsunuz.
- Yazıcı komut dili çıktı gerekiyor; public API PDF döndürür.
- Operasyonel kabul veya depo süreci doğrulamasını gPdf'ten bekliyorsunuz.
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 - depo etiketi PDF'i.
{
"pages": [
{
"size": "label_4_6_in",
"elements": [
{
"type": "text",
"x": 6,
"y": 8,
"content": "PALLET LAX-01-2026-00042",
"style": { "font_size": 12, "font_family": "NotoSans-Regular" }
},
{
"type": "barcode",
"format": "sscc-18",
"content": "012345678901234567",
"x": 6,
"y": 30,
"width": 88,
"height": 26,
"barcode_text": { "enabled": true, "position": "bottom" }
},
{
"type": "text",
"x": 6,
"y": 70,
"content": "SKU: CASE-001\nQTY: 48\nLOCATION: A-14-02",
"style": { "font_size": 10, "font_family": "NotoSans-Regular" }
}
]
}
]
}
gPdf neyi üstlenir
- Depo etiketi için label-sized PDF render işlemi.
- Metin, barkod, QR code, lines, boxes ve şablon bağlama.
- Yazdırma istasyonu iş akışları için Template Render.
- Yeniden yazdırma ve denetim için deterministic PDF çıktısı.
Sisteminiz neyi yönetir
- Depo tanımlayıcıları, öğe/konum verisi, yönlendirme, stok durumu ve iş kuralları.
- Yazıcı setup, etiket stoğu, tarama testi ve operasyonel kabul.
- Depolama, erişim kontrolü ve yeniden yazdırma yetkisi.
Production kontrol listesi
- Gerçek yazıcı, etiket stoğu ve tarayıcı ile test edin.
- Tanımlayıcı payload'larını önceki sistemde doğrulayın.
- Yeniden yazdırma için kaynak veri veya dönen PDF saklayın.
- template_id ve request ID'yi operasyon kaydı ile loglayın.
- Onaylı yerleşimler için Template Render kullanın.
İddia sınırları
- gPdf depo etiketi PDF'ini render eder; WMS veya stok sistemi değildir.
- Depo verisi semantiği ve tarayıcı kabulü çağıran sisteme aittir.
- PDF çıktısı yazıcı komut akışı değildir.
Depo etiketleri operasyonel kayıtlardır
Depo etiketi, WMS veya ERP sisteminizdeki operasyonel durumun fiziksel temsilidir. gPdf bu durumu belirlemez; item, location, yönlendirme veya stok payload’u’unu PDF yerleşim’a render eder.
Template Render yazdırma istasyonları sade tutar
Yazdırma istasyonlarının koordinat düzeyinde JSON üretmesi gerekmez. Onaylanmış yerleşimi şablona taşıyın, station veya backend yalnızca data göndersin.
Yeniden yazdırma determinism
Yeniden yazdırma için kaynak veriyi, template_id’yi ve request ID’yi saklayın. Aynı iş payload’u aynı etiket PDF’ini üretmelidir.
SSS
- gPdf WMS yerine geçer mi?
- Hayır. WMS veya ERP depo verisini belirler; gPdf bunu PDF etikete render eder.
- Depo etiketlerinde Template Render kullanılmalı mı?
- Kararlı yazdırma istasyonu yerleşimleri için evet. Çağıran sistem yalnızca öğe/konum verisi gönderir.
- gPdf barkod payload'u doğrular mı?
- Hayır. Payload correctness ve tarayıcı kabulü sizin sisteminizdedir.
- Yeniden yazdırma nasıl güvenli tutulur?
- Kaynak veri, template_id ve request ID saklayın; aynı payload aynı çıktıyı üretmelidir.