API dla etykiet paletowych dla procesów magazynowych i 3PL
Generuj PDF etykiet paletowych dla magazynu, 3PL, handlu detalicznego i procesów logistycznych, z SSCC, GS1-128, blokami tekstu i szablonami bezpiecznymi dla reprintów.
/api/v1/pdf/render Renderować PDF etykiet paletowych z danych WMS, ERP albo 3PL, aby zespoły magazynowe mogły identyfikować palety, skanować kody SSCC albo GS1 i ponownie drukować tę samą etykietę podczas przyjęcia, wysyłki lub przesunięć zapasu.
Kiedy użyć tej API
- WMS ma już ID palety, dane SKU albo GTIN, ilość, partię i miejsce docelowe.
- Potrzebujesz etykiety PDF z SSCC, GS1-128 albo innym obsługiwanym formatem kodu kreskowego.
- Chcesz deterministycznych reprintów z tych samych danych źródłowych.
- Potrzebujesz, aby układ stał się stabilnym kontraktem Template Render.
Czego nie zastępuje
- Potrzebujesz, aby gPdf zarządzał zapasem, paletyzacją albo zadaniami magazynowymi.
- Potrzebujesz certyfikacji GS1 zamiast renderowania kodów kreskowych w PDF.
- Potrzebujesz bezpośredniego wyjścia w komendach drukarki.
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 paletowa z kodem kreskowym SSCC.
{
"pages": [
{
"size": "label_4_6_in",
"elements": [
{
"type": "text",
"x": 5,
"y": 7,
"content": "PALLET 12 / DOCK B",
"style": { "font_size": 13, "font_family": "NotoSans-Regular" }
},
{
"type": "barcode",
"format": "sscc-18",
"content": "000123456789012345",
"x": 5,
"y": 28,
"width": 92,
"height": 30,
"barcode_text": { "enabled": true, "position": "bottom" }
},
{
"type": "text",
"x": 5,
"y": 78,
"content": "GTIN 09506000134352\nQTY 48 CASES\nLOT L-2026-05",
"style": { "font_size": 10, "font_family": "NotoSans-Regular" }
}
]
}
]
}
Co obsługuje gPdf
- Strony PDF w formacie etykiety z tekstem, ramkami i elementami kodu kreskowego.
- SSCC, GS1-128, Code 128, QR i inne obsługiwane formaty kodów kreskowych w wyjściu PDF.
- Powiązanie z szablonem dla zatwierdzonych układów etykiet paletowych.
- Deterministyczne wyjście dla reprintów i dowodów audytowych.
Co kontroluje Twój system
- Tożsamość palety, dane produktu, dane partii, ilość, trasowanie i reguły magazynowe.
- Poprawność danych kodu kreskowego, cyfry kontrolne, testy skanerów i walidację materiału etykiet.
- Kierowanie do stanowisk druku, autoryzację reprintów i stan zapasów.
Checklist produkcyjny
- Zweryfikuj dane SSCC albo GS1 przed renderowaniem.
- Skanuj etykiety produkcyjnymi skanerami na stanowiskach przyjęcia i wysyłki.
- Przetestuj gęste dane, długie nazwy produktów i potrzeby wielu języków w magazynie.
- Rejestruj template_id, źródłowe ID palety i ID żądania dla reprintów.
- Trzymaj przejścia stanów magazynowych poza API renderowania.
Granice deklaracji
- gPdf renderuje PDF etykiet paletowych; nie zarządza paletami ani stanem magazynowym.
- gPdf nie jest jednostką certyfikującą GS1.
- Akceptacja skanera i poprawność procesu magazynowego pozostają po Twojej stronie.
Etykiety paletowe łączą dane WMS z wydrukiem
Proces etykiety paletowej zaczyna się w WMS albo ERP. To ten system decyduje, jakie dane palety, produktu, ilości, partii i trasy powinny znaleźć się na etykiecie. gPdf zamienia te dane w PDF, który stanowiska druku w magazynie mogą wydrukować i odtworzyć przy reprintach.
Użyj węższej strony SSCC, gdy intencja wyszukiwania dotyczy konkretnie SSCC-18 albo oznaczeń logistycznych GS1. Użyj tej strony dla szerszego procesu etykiet paletowych.
FAQ
- Czy gPdf może generować etykiety paletowe SSCC?
- gPdf może renderować elementy kodu kreskowego SSCC w wyjściu PDF. Twój system odpowiada za wartość SSCC i semantykę GS1.
- Czy gPdf zarządza stanem palet?
- Nie. Za stan zapasów odpowiada WMS albo ERP. gPdf renderuje PDF etykiety.
- Czy etykiety paletowe mogą używać Template Render?
- Tak. Template Render jest zwykle ścieżką produkcyjną po zatwierdzeniu układu etykiety paletowej.
- Czy gPdf certyfikuje etykiety GS1?
- Nie. gPdf renderuje wektorowe kody kreskowe w PDF. Certyfikacja, testy skanowania i akceptacja pozostają po Twojej stronie.