Sipariş karşılama iş akışları için paketleme fişi PDF API'si
Sipariş ve sipariş karşılama verilerinden packing slip PDF'leri üretin; şablonlar satıcı, depo veya marka yerleşimlerini kararlı tutar.
/api/v1/template-render Sipariş, ürün, alıcı ve sipariş karşılama verisinden packing slip PDF'leri render ederek depo veya e-ticaret iş akışının aynı belgeyi güvenilir şekilde yazdırmasını veya yeniden üretmesini sağlamak.
Bu API ne zaman kullanılır
- Sipariş ve ürün verisi sisteminizde zaten var.
- Packing slip yerleşimi marka, depo veya satıcı bazında tekrar kullanılacak.
- Çağıran sistemlerin sayfa koordinatları yerine iş verisi göndermesini istiyorsunuz.
- İade etiketleri, faturalar veya gönderi etiketleriyle aynı belge hattını istiyorsunuz.
Neyin yerine geçmez
- gPdf'in OMS, WMS veya taşıyıcı entegrasyonu gibi davranmasını bekliyorsunuz.
- Serbest biçimli HTML-to-PDF dönüşümü gerekiyor.
- Legal e-invoice PDF/A-3b paketi gerekiyor. E-Invoice Render kullanın.
Hangi endpoint çağrılır
/api/v1/template-render
Template Render bu iş akışı için varsayılan yoldur.
/api/v1/pdf/render
İş akışı ilgili API yoluna, template sözleşmesine veya capability sorgusuna ihtiyaç duyduğunda kullanın.
Minimum request
POST /api/v1/template-render - packing slip template'i için sipariş verisi.
{
"template_id": "packing_list",
"data": [
{
"shipment": {
"number": "PL-2026-1001",
"date": "2026-05-29"
},
"shipper": {
"name": "Acme Warehouse",
"address": "1200 Logistics Pkwy"
},
"consignee": {
"name": "Receiver Inc.",
"address": "123 Main St"
},
"items": [
{
"item_no": "1",
"description": "Replacement filter",
"quantity": "2",
"unit": "pcs",
"gross_weight": "1.2 kg",
"net_weight": "1.0 kg"
}
]
}
]
}
gPdf neyi üstlenir
- Yayınlanmış şablon üzerinden packing slip PDF render işlemi.
- Ürün satırları, adres blokları, notlar, barkod/QR alanları ve sayfa yerleşimi.
- Template Render veri dizileri ve PDF yanıtı.
- JSON Render ile yerleşim prototipleme yolu.
Sisteminiz neyi yönetir
- Sipariş verisi, ürün miktarları, sipariş karşılama durumu ve alıcı ayrıntıları.
- Satıcı markalaması, iş kuralları, teslimat, depolama ve yeniden yazdırma yetkisi.
- Yazıcı kurulumu, depo iş akışı ve sonraki sistem doğrulaması.
Production kontrol listesi
- Uzun SKU'ları, ürün adlarını, miktarları ve not varyasyonlarını test edin.
- Şablon veri şemasını çağıran sistemlerle sözleşme olarak paylaşın.
- Kaynak sipariş ID'sini, template_id'yi ve request ID'yi loglayın.
- Yerleşim onaylandıktan sonra Template Render kullanın.
- Sipariş karşılama durumunu ve taşıyıcı mantığını render isteği dışında tutun.
İddia sınırları
- gPdf operasyonel PDF render eder; OMS, WMS veya pazaryeri connector değildir.
- Packing slip doğruluğu sipariş ve sipariş karşılama verinize bağlıdır.
- Template Render e-invoice paketleme yerine geçmez.
Packing slip’ler şablon yoluna uygundur
Packing slip yerleşimi genellikle onaylandıktan sonra tekrar tekrar kullanılır: logo, ürün tablosu, notlar, adres blokları ve depo talimatları sabit kalır. Bu nedenle Template Render, üretimde çoğu packing slip için temiz bir sözleşme sağlar.
Çağıran sistem yalnızca sipariş ve ürün verisi gönderir. Şablon belge yapısını sahiplenir, gPdf PDF’i render eder, sipariş karşılama durumu ve iş kuralları ise sizin sisteminizde kalır.
SSS
- Packing slip için Template Render ne zaman kullanılır?
- Yerleşim onaylandığında ve çağıran sistemler yalnızca sipariş verisi göndermeliyse Template Render kullanın.
- JSON Render ile başlayabilir miyim?
- Evet. Koordinatlar ve alanlar test edilirken JSON Render kullanabilir, ardından yerleşimi şablona taşıyabilirsiniz.
- gPdf sipariş karşılama durumunu bilir mi?
- Hayır. Fulfillment state ve iş kuralları sizin OMS/WMS sisteminizde kalır.
- Packing slip ile gönderi etiketi aynı endpoint mi?
- Her ikisi de public render API'lerini kullanabilir; endpoint seçimi yerleşimin kodda mı yoksa template'te mi olduğuna bağlıdır.