E-ticaret tersine lojistik için iade etiketi API'si
E-ticaret tersine lojistik için iade etiketi PDF'leri render edin; taşıyıcı hesabı, RMA mantığı ve takip payload'u sisteminizde kalır.
/api/v1/pdf/render Return yetkilendirme, alıcı, servis ve takip verisi sisteminizde belirlendikten sonra aynı iade etiketi PDF'ini sipariş karşılama ve yeniden yazdırma için deterministik olarak render etmek.
Bu API ne zaman kullanılır
- Sisteminiz RMA, alıcı, servis ve barkod payload'a zaten sahip.
- Müşteriye veya depoya PDF iade etiketi sunmanız gerekiyor.
- Aynı iade payload'u aynı etiketi üretmeli.
- Approved yerleşimi Template Render'a taşımak istiyorsunuz.
Neyin yerine geçmez
- gPdf'in taşıma ücreti satın almasını, taşıyıcı gönderi oluşturmasını veya iadeler portal olmasını bekliyorsunuz.
- ZPL/EPL command stream gerekiyor; public API PDF döndürür.
- Taşıyıcı sertifikasyon veya RMA iş kuralları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 - iade etiketi PDF'i.
{
"pages": [
{
"size": "label_4_6_in",
"elements": [
{
"type": "text",
"x": 5,
"y": 8,
"content": "RETURN TO",
"style": { "font_size": 9, "font_family": "NotoSans-Regular" }
},
{
"type": "text",
"x": 5,
"y": 18,
"content": "Acme Returns\n500 Dock Door 4\nColumbus OH 43215",
"style": { "font_size": 11, "font_family": "NotoSans-Regular" }
},
{
"type": "barcode",
"format": "code128",
"content": "RMA-2026-77881",
"x": 5,
"y": 70,
"width": 88,
"height": 20,
"barcode_text": { "enabled": true, "position": "bottom" }
}
]
}
]
}
gPdf neyi üstlenir
- İade etiketi için label-sized PDF render işlemi.
- Barkod, address block, yönlendirme metni ve optional şablon bağlama.
- JSON Render veya Template Render üzerinden deterministic PDF çıktısı.
- İndirme, e-posta veya depo yazdırma iş akışları için PDF yanıtı.
Sisteminiz neyi yönetir
- RMA mantığı, taşıyıcı hesabı, taşıma ücreti, servis seçimi ve takip payload'u.
- Müşteri yetkilendirmesi, iade politikası, depolama ve yeniden yazdırma erişimi.
- Yazıcı setup, tarama testi ve taşıyıcı kabulü.
Production kontrol listesi
- Taşıyıcıya özgü text ve payload'ları gönderi/iade sistemi'dan alın.
- Gerçek yazıcı, etiket stoğu ve tarayıcı ile test edin.
- Return yetkilendirme ve expiry mantığı gPdf dışında tutun.
- Dönen PDF'i veya kaynak iade verisini yeniden yazdırma politikasına göre saklayın.
- Kararlı yerleşim için Template Render kullanın.
İddia sınırları
- gPdf iade etiketi PDF'ini render eder; iade gönderi veya taşıma ücreti oluşturmaz.
- RMA, taşıyıcı kabulü ve iade politikası çağıran sistemde kalır.
- Public render API PDF döndürür, yazıcı komut akışı değil.
Tersine lojistik açık sorumluluk ister
İade etiketi, taşıyıcı işlemi ve iade politikası tarafından belirlenen verilerin fiziksel çıktısıdır. gPdf RMA durumu, taşıma ücreti veya taşıyıcı kabulü üretmez; son payload’u PDF’e render eder.
Bu sınırı korumak müşteri self-servis akışlarında önemlidir. İade portal veya OMS iadeyi yönetir, gPdf deterministic PDF label üretir.
SSS
- gPdf taşıyıcı iade label oluşturur mu?
- Hayır. Taşıyıcı veya gönderi sistemi iade gönderi ve barkod payload'u oluşturur; gPdf bunu PDF etikete render eder.
- İade etiketleri Template Render kullanabilir mi?
- Evet. Yerleşim kararlı olduğunda Template Render çağıran sistemlerin yalnızca iade verisi göndermesini sağlar.
- gPdf ZPL çıktı verir mi?
- Hayır. Public API PDF çıktısı verir. ZPL gerekiyorsa gPdf dışında dönüştürün veya yönlendirin.
- Üretim öncesi ne doğrulanmalı?
- Gerçek yazıcı, etiket stoğu, tarayıcı ve taşıyıcıya özgü payload ile test edin.