API dla etykiet zwrotnych w odwrotnej logistyce ecommerce
Generuj PDF etykiet zwrotnych i instrukcji zwrotu z danych ecommerce albo obsługi klienta, z formatem etykiety, kodami kreskowymi i reprintami z szablonu.
/api/v1/pdf/render Renderować PDF etykiet zwrotnych albo arkuszy instrukcji zwrotu z danych RMA, klienta, pozycji, miejsca docelowego i kodu kreskowego, aby portal zwrotów mógł udostępnić klientowi deterministyczny dokument.
Kiedy użyć tej API
- Twój system utworzył już RMA i autoryzację zwrotu.
- Przewoźnik albo system zwrotów dostarczył już dane etykiety lub dane śledzenia.
- Potrzebujesz etykiety PDF albo arkusza instrukcji, który można pobrać, wysłać e-mailem albo wydrukować ponownie.
- Chcesz ponownie używać tego samego układu etykiety zwrotnej przez Template Render.
Czego nie zastępuje
- Potrzebujesz, aby gPdf zatwierdzał zwrot, kupował opłatę pocztową albo tworzył przesyłkę przewoźnika.
- Potrzebujesz bezpośredniej orkiestracji API przewoźnika.
- Potrzebujesz wyjścia w komendach drukarki, takich jak ZPL.
Który endpoint wywołać
/api/v1/pdf/render
JSON Render to domyślna ścieżka dla tego procesu.
/api/v1/template-render
Użyj, gdy proces wymaga powiązanej ścieżki API, kontraktu szablonu albo sprawdzenia capabilities.
Minimalny request
POST /api/v1/pdf/render - etykieta zwrotna z kodem kreskowym RMA.
{
"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" }
}
]
}
]
}
Co obsługuje gPdf
- Renderowanie PDF dla etykiet zwrotnych w formacie etykiety oraz stron z instrukcjami.
- Kody kreskowe, tekst, adresy, bloki RMA i bloki usługi.
- Powiązanie z szablonem dla zatwierdzonych układów etykiet zwrotnych albo instrukcji.
- Deterministyczne wyjście dla ponownego pobrania przez klienta i reprintów przez obsługę.
Co kontroluje Twój system
- Uprawnienie do zwrotu, stan RMA, konto przewoźnika, opłatę pocztową, numer śledzenia i komunikację z klientem.
- Poprawne dane kodu kreskowego, adres docelowy, odniesienia do pozycji i reguły okna zwrotu.
- Dostarczenie e-maila, pobieranie w portalu i ślad audytowy obsługi.
Checklist produkcyjny
- Zweryfikuj dane zwrotu u przewoźnika albo dostawcy systemu zwrotów przed renderowaniem.
- Wydrukuj i przeskanuj etykiety na tym samym materiale, którego będą używać klienci albo sklepy.
- Dodaj X-Request-Id i przechowuj ślad RMA-do-PDF w logach obsługi.
- Zadbaj, aby wielokrotne pobrania były idempotentne z perspektywy klienta.
- Oddziel renderowanie etykiety od logiki zatwierdzania zwrotu pieniędzy.
Granice deklaracji
- gPdf renderuje PDF etykiet zwrotnych; nie autoryzuje zwrotów ani nie kupuje opłaty pocztowej.
- Akceptacja przez przewoźnika i poprawność danych kodu kreskowego pozostają po Twojej stronie.
- Publiczne API zwraca PDF, nie ZPL ani bezpośrednie komendy drukarki.
Odwrotna logistyka wymaga jasnej odpowiedzialności
Etykiety zwrotne łączą doświadczenie klienta z regułami przewoźnika. gPdf odpowiada za renderowanie PDF. Twój system zwrotów odpowiada za uprawnienie do zwrotu, stan RMA, śledzenie, dane przewoźnika i komunikację z klientem.
Utrzymaj tę granicę w integracji. Najpierw podejmij decyzję o zwrocie, a potem wyrenderuj dokument z finalnych danych.
FAQ
- Czy gPdf tworzy przesyłkę zwrotną?
- Nie. Przewoźnik albo platforma zwrotów tworzy przesyłkę i dane etykiety. gPdf renderuje te dane jako PDF.
- Czy etykiety zwrotne można generować z szablonów?
- Tak. Użyj Template Render po zatwierdzeniu układu etykiety zwrotnej albo instrukcji.
- Czy PDF może zawierać instrukcje zwrotu?
- Tak. To samo żądanie renderowania może utworzyć stronę etykiety, stronę instrukcji albo oba elementy, zależnie od układu.
- Czy gPdf zastępuje certyfikację przewoźnika?
- Nie. Akceptacja przez przewoźnika, testy skanerów i reguły danych pozostają Twoją odpowiedzialnością.