Production sistemleri için packing slip PDF’leri API
packing slip PDF’leri çıktısını yapılandırılmış backend verilerinden tarayıcı olmadan üretin; gPdf PDF rendering’i üstlenir, iş kuralları sisteminizde kalır.
/api/v1/template-render packing slip PDF’leri çıktısını yapılandırılmış veriden tekrarlanabilir PDF olarak üretmek. gPdf PDF’i render eder; veri anlamı ve süreç durumu sisteminizde kalır.
Bu API ne zaman kullanılır
- Backend’inizde packing slip PDF’leri verisi zaten var ve kararlı bir PDF yanıtı gerekiyor.
- Operasyon belgesi için Chromium veya HTML-to-PDF kullanmak istemiyorsunuz.
- Reprint, audit veya batch için tekrarlanabilir çıktı gerekiyor.
Neyin yerine geçmez
- gPdf kargo satın almaz, vergi beyan etmez, dış sipariş oluşturmaz ve mali sistem değildir.
- Veri doğrulama, iş kuralları veya marketplace entegrasyonlarının yerine geçmez.
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
/api/v1/template-render - packing slip PDF’leri
{
"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
- Yapılandırılmış request üzerinden packing slip PDF’leri için PDF rendering.
- Request’e göre metin, tablo, çizgi, barkod, sayfa, metadata ve çıktı ayarları.
- Retry, reprint ve audit için deterministik çıktı.
Sisteminiz neyi yönetir
- packing slip PDF’leri için doğru veri, iş kuralları ve operasyon durumu.
- Kimlik doğrulama, kalıcı kayıt, dış workflow ve alıcı sistem doğrulamaları.
Production checklist
- Gerçek veri ve PDF’i tüketecek sistemlerle test edin.
- Support, audit ve reprint için request ID ve doğrulama kanıtlarını saklayın.
- Onaylı layout birden fazla sistemde kullanılacaksa template’e taşıyın.
İddia sınırları
- gPdf operasyonel PDF render eder; resmi marketplace connector veya OMS değildir.
- Siparişler, fulfillment, marketplace API çağrıları ve müşteri kuralları sisteminizdedir.
API şekli
packing slip PDF’leri API, gPdf public API’leri üzerinde çalışan bir production workflow’dur. Request veriyi, layout’u, settings’i ve render edilecek PDF parçalarını açıkça tarif eder. gPdf PDF’i üretir; iş olayının semantiği sisteminizde kalır.
Endpoint seçimi
Bu workflow için varsayılan endpoint /api/v1/template-render. Layout onaylandıktan sonra Template Render kullanın. E-Invoice Render yalnızca EN 16931 CII XML gömülü Factur-X / ZUGFeRD PDF/A-3b paketleme gerektiğinde kullanılır.
Production öncesi doğrulama
packing slip PDF’leri çıktısını gerçek veriyle ve downstream sistemlerle doğrulayın. Support, audit ve reprint için request ID, render edilen çıktı ve doğrulama kanıtlarını saklayın.
FAQ
- Bu ayrı bir endpoint mi?
- packing slip PDF’leri API, workflow’u gPdf’in public API’lerinden birine bağlar. Sayfa hangi path’in çağrılacağını ve request’in neyi taşıyacağını açıklar.
- Templates kullanabilir miyim?
- Evet. Layout değişirken JSON Render, layout onaylandıktan ve callers yalnızca iş verisi gönderdikten sonra Template Render kullanın.
- Production öncesi neyi doğrulamalıyım?
- Gerçek veriyle ve workflow’daki yazıcı, scanner, validator, muhasebe sistemi veya marketplace ile doğrulayın.