Etiketler, fişler ve depo belgeleri için lojistik PDF API'si
Etiket, packing slip, teslimat notu ve depo belgelerini WMS, OMS veya 3PL backend verilerinden deterministik PDF çıktısı olarak üretin.
/api/v1/pdf/render Sipariş, gönderi, depo ve yönlendirme verilerinden etiket, packing slip, iade belgesi veya operasyonel PDF üretirken taşıyıcı işlemini ve sipariş karşılama durumunu kendi sisteminizde tutmak.
Bu API ne zaman kullanılır
- WMS, OMS veya 3PL backend'inizde lojistik verisi zaten var.
- PDF çıktısı aynı payload ile yeniden üretilebilir olmalı.
- Etiketler, fişler, notlar veya depo formları için tek render API istiyorsunuz.
- Koordinatları test ettikten sonra kararlı şablonlara geçmek istiyorsunuz.
Neyin yerine geçmez
- gPdf'in gönderi satın almasını, taşıyıcı fiyatı almasını veya takip numarası üretmesini bekliyorsunuz.
- ZPL/EPL komut akışı gerekiyor; public render API PDF döner.
- Taşıyıcı sertifikasyon 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 - lojistik belge için basit PDF sayfası.
{
"template_id": "packing_list",
"data": [
{
"order_number": "SO-8421",
"warehouse": "LAX-01",
"ship_to": "Example Retailer, 88 Harbor Rd, Long Beach, CA",
"items": [
{ "sku": "CASE-001", "description": "Widget case", "quantity": 4 },
{ "sku": "CASE-002", "description": "Replacement kit", "quantity": 1 }
]
}
]
}
gPdf neyi üstlenir
- Lojistik PDF çıktısı için JSON Render veya Template Render.
- Metin, barkod, tablo, çizgi, kutu, etiket boyutunda sayfalar ve metadata.
- Tekrarlanan depo ve sipariş karşılama yerleşimleri için şablonlar.
- Yeniden yazdırma ve denetim için deterministik PDF yanıtı.
Sisteminiz neyi yönetir
- Taşıyıcı hesabı, gönderi oluşturma, servis seçimi, takip numarası ve yönlendirme semantiği.
- Doğru barkod payload'ları, adresler, depo durumu ve iş kuralları.
- Yazıcı kurulumu, etiket stoğu, tarama testi ve operasyonel kabul.
Production kontrol listesi
- Gerçek yazıcılar, etiket stoğu ve tarayıcılarla test edin.
- Taşıyıcıya özgü metin ve payload'ların gönderi sisteminden geldiğini doğrulayın.
- Yeniden yazdırma politikası için kaynak veriyi veya dönen PDF'i saklayın.
- Onaylanan yerleşimleri Template Render'a taşıyın.
- Taşıyıcı mantığı render isteği dışında tutun.
İddia sınırları
- gPdf lojistik PDF'leri render eder; taşıyıcı, WMS veya OMS değildir.
- Gönderi durumu, yönlendirme ve operasyonel kabul çağıran sistemde kalır.
- PDF çıktısı ZPL, EPL veya başka yazıcı komut dili değildir.
Lojistik belgeler bir kümedir
Lojistik PDF’leri tek bir belge türünden ibaret değildir. Gönderi etiketleri, iade etiketleri, packing slip’ler, palet etiketleri ve depo formları aynı sorumluluk modelini paylaşır: sisteminiz operasyonel gerçeği bilir, gPdf PDF’i render eder.
API kullanım deseni
Yerleşim kod tarafından oluşturuluyorsa JSON Render kullanın. Onaylanmış, tekrarlanan belgeler için Template Render kullanın. Her iki durumda da takip, yönlendirme, servis ve barkod payload’u gPdf’e son render verisi olarak gelir.
Operasyonel sistemler authoritative kalır
gPdf gönderi satın almaz, taşıyıcı ile konuşmaz veya depo durumunu yönetmez. WMS, OMS, 3PL backend ve taşıyıcı entegrasyonu tek doğru kaynak olarak kalır.
SSS
- gPdf gönderi oluşturur mu?
- Hayır. Gönderi veya taşıyıcı sisteminiz gönderiyi ve payload'u oluşturur; gPdf veriyi PDF'e render eder.
- Lojistik belgelerde Template Render kullanılabilir mi?
- Evet. Yerleşim kararlıysa ve çağıran sistem yalnızca data göndermeliyse Template Render kullanın.
- gPdf ZPL döndürür mü?
- Hayır. Public render API'leri PDF döndürür. ZPL gerekiyorsa PDF'i gPdf dışında dönüştürün veya yönlendirin.
- Üretim öncesi ne doğrulanmalı?
- Çıktı gerçek yazıcı, etiket stoğu, tarayıcı ve sonraki lojistik sistemle test edilmelidir.