API PDF dla listów pakowych w procesach realizacji zamówień
Generuj PDF listów pakowych z danych zamówienia, przesyłki, kartonu i pozycji dla ecommerce, 3PL, OMS oraz magazynowych procesów realizacji zamówień.
/api/v1/template-render Renderować listy pakowe z danych przesyłki, odbiorcy, pozycji i kartonu, aby zespoły realizacji zamówień mogły drukować albo dołączać spójny dokument do każdego zamówienia wychodzącego.
Kiedy użyć tej API
- OMS albo WMS ma już pozycje zamówienia, ilości, dane odbiorcy i identyfikatory przesyłki.
- Potrzebujesz listu pakowego PDF dla stanowisk druku w magazynie albo wkładki do paczki klienta.
- Chcesz używać jednego zatwierdzonego układu w magazynach, markach albo kanałach sprzedaży.
- Możesz potrzebować kodu kreskowego albo kodu QR do wyszukania zamówienia lub przyjęcia zwrotu.
Czego nie zastępuje
- Potrzebujesz kupić opłatę pocztową, wycenić przesyłkę albo utworzyć etykietę przewoźnika.
- Potrzebujesz zarządzania zapasem magazynowym zamiast renderowania dokumentów.
- Potrzebujesz semantyki faktury prawnej albo e-faktury.
Który endpoint wywołać
/api/v1/template-render
Template Render to domyślna ścieżka dla tego procesu.
/api/v1/pdf/render
Użyj, gdy proces wymaga powiązanej ścieżki API, kontraktu szablonu albo sprawdzenia capabilities.
Minimalny request
POST /api/v1/template-render - szablon packing_list z jedną przesyłką.
{
"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"
}
]
}
]
}
Co obsługuje gPdf
- Template Render dla opublikowanych układów listów pakowych.
- JSON Render dla własnych stron listu pakowego podczas projektowania albo procesów jednorazowych.
- Tabele, wiersze pozycji, bloki adresowe, opcjonalne kody kreskowe i wyjście PDF.
- Deterministyczne reprinty przy użyciu tych samych danych i tego samego szablonu.
Co kontroluje Twój system
- Dane zamówienia, ilości pozycji, stan przesyłki, trasowanie magazynowe i komunikaty dla klienta.
- Mapowanie pól szablonu, kierowanie wydruków do stanowisk druku i politykę reprintów.
- Każdy dokument przewoźnika, celny albo fakturowy, który musi podróżować z paczką.
Checklist produkcyjny
- Przetestuj najdłuższe kombinacje SKU, nazw pozycji i adresów.
- Zweryfikuj przypadki jednej pozycji, wielu kartonów, backorderów i częściowych wysyłek.
- Użyj Template Render po zatwierdzeniu układu listu pakowego.
- Loguj template_id i X-Request-Id dla każdego zadania druku w realizacji zamówień.
- Trzymaj generowanie etykiet przewoźnika osobno od renderowania listu pakowego.
Granice deklaracji
- gPdf renderuje PDF listu pakowego; nie zarządza stanem zapasów ani stanem realizacji zamówienia.
- List pakowy nie jest automatycznie fakturą podatkową ani dokumentem celnym.
- Zakup etykiety przewoźnika i wycena przesyłki pozostają poza gPdf.
Listy pakowe dobrze pasują do ścieżki szablonów
Listy pakowe zwykle mają stabilną strukturę: nadawca, odbiorca, numer przesyłki, wiersze pozycji i opcjonalne notatki. Dlatego Template Render dobrze sprawdza się po zatwierdzeniu układu.
JSON Render nadal jest przydatny podczas projektowania. Pozwala zespołowi
dopasować kolumny, odstępy, położenie kodu kreskowego i podziały stron przed
opublikowaniem stabilnego kontraktu template_id.
FAQ
- Czy list pakowy ma osobny endpoint gPdf?
- Nie. Użyj Template Render dla zatwierdzonego szablonu listu pakowego albo JSON Render, gdy system opisuje układ bezpośrednio.
- Czy listy pakowe mogą zawierać kody kreskowe?
- Tak. gPdf może renderować elementy kodów kreskowych w PDF. Twój system odpowiada za zakodowane dane zamówienia, kartonu albo zwrotu.
- Czy gPdf tworzy etykiety przewoźników?
- Nie. Etykiety przewoźników to osobny proces. gPdf renderuje PDF z danych dostarczonych przez system przewoźnika albo system wysyłkowy.
- Czy jedno zadanie może renderować wiele listów pakowych?
- Template Render przyjmuje tablicę data dla wielu elementów w jednym zadaniu, w granicach publicznych limitów API opisanych dla tego endpointu.