API dla etykiet magazynowych dla procesów druku WMS i ERP
Generuj PDF etykiet palet, kartonów, miejsc składowania, zapasów i operacji magazynowych z danych WMS albo ERP, z deterministycznymi reprintami.
/api/v1/pdf/render Renderować etykiety magazynowe z danych WMS albo ERP dla palet, kartonów, miejsc składowania, zasobów, lokalizacji i ruchów zapasu, przy zachowaniu stanu zapasów, reguł kompletacji i operacji magazynowych w systemie wywołującym.
Kiedy użyć tej API
- Potrzebujesz etykiet palet, kartonów, pojemników, lokalizacji, zapasów albo zasobów jako PDF.
- WMS albo ERP odpowiada już za SKU, partię, lokalizację, SSCC i dane zapasu.
- Potrzebujesz deterministycznych reprintów, gdy etykieta jest uszkodzona albo stanowisko ponawia zadanie.
- Chcesz ponownie używać zatwierdzonych układów etykiet przez Template Render.
Czego nie zastępuje
- Potrzebujesz, aby gPdf zarządzał zapasem, przydzielał lokalizacje albo prowadził procesy magazynowe.
- Potrzebujesz od gPdf aplikacji skanera, agenta stanowiska druku albo systemu kierowania etykiet.
- Potrzebujesz certyfikacji GS1 zamiast renderowania kodów kreskowych.
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 palety z danymi kodu kreskowego SSCC.
{
"pages": [
{
"size": "label_4_6_in",
"elements": [
{
"type": "text",
"x": 6,
"y": 8,
"content": "PALLET LAX-01-2026-00042",
"style": { "font_size": 12, "font_family": "NotoSans-Regular" }
},
{
"type": "barcode",
"format": "sscc-18",
"content": "012345678901234567",
"x": 6,
"y": 30,
"width": 88,
"height": 26,
"barcode_text": { "enabled": true, "position": "bottom" }
},
{
"type": "text",
"x": 6,
"y": 70,
"content": "SKU: CASE-001\nQTY: 48\nLOCATION: A-14-02",
"style": { "font_size": 10, "font_family": "NotoSans-Regular" }
}
]
}
]
}
Co obsługuje gPdf
- Etykiety PDF dla magazynowych procesów druku.
- Wektorowe kody kreskowe, tekst, ramki, rozmiary stron etykiet i powiązanie z szablonem.
- Deterministyczne wyjście dla reprintów i zapisów audytowych.
- JSON Render dla własnych układów oraz Template Render dla zatwierdzonych kontraktów etykiet.
Co kontroluje Twój system
- Stan zapasów, dane SKU, dane partii i numerów seryjnych, wartości SSCC oraz semantykę lokalizacji.
- Kierowanie wydruków do drukarek, konfigurację stanowisk, walidację skanerem i reguły procesów magazynowych.
- Wybór szablonu, ponowienia i przechowywanie wyrenderowanych PDF albo danych źródłowych.
Checklist produkcyjny
- Zweryfikuj wymiary etykiet na rzeczywistej drukarce i docelowym materiale etykiet.
- Przeskanuj każdy format kodu kreskowego używany w procesie magazynowym.
- Trzymaj stan WMS/ERP jako źródło odniesienia i wysyłaj do gPdf wyłącznie finalne dane etykiety.
- Użyj Template Render dla etykiet drukowanych przez wiele systemów albo stanowisk.
- Loguj ID dokumentów źródłowych i ID zadań dla śledzenia reprintów.
Granice deklaracji
- gPdf renderuje PDF etykiet magazynowych; nie zarządza zapasem ani stanem magazynu.
- System wywołujący odpowiada za semantykę zakodowanej wartości i akceptację skanera.
- Template Render może stabilizować układy etykiet, ale nie zastępuje reguł WMS.
Etykiety magazynowe są rekordami operacyjnymi
Etykiety magazynowe identyfikują palety, kartony, pojemniki, zasoby, ruchy zapasów i lokalizacje. Są powiązane ze stanem operacyjnym w WMS albo ERP. gPdf powinien otrzymać finalne dane etykiety i je wyrenderować; nie powinien decydować o znaczeniu zapasu ani stanie procesu magazynowego.
Template Render upraszcza stanowiska druku
Dla etykiet używanych na wielu stanowiskach opublikuj zatwierdzony układ jako
szablon. Usługi druku mogą wtedy wysyłać template_id plus dane WMS, zamiast
odtwarzać współrzędne w każdym systemie wywołującym.
Determinizm reprintów
Magazyny drukują etykiety ponownie. Uszkodzona etykieta, zacięta drukarka albo ponowienie zadania przez stanowisko nie powinny tworzyć nieco innego dokumentu. Trzymaj dane źródłowe etykiety przy rekordzie magazynowym i używaj deterministycznych danych renderowania dla reprintów.
FAQ
- Czy gPdf zarządza stanem magazynowym?
- Nie. WMS albo ERP odpowiada za stan zapasów, lokalizacje, SKU, partie i reguły procesu. gPdf renderuje PDF etykiety z finalnych danych.
- Czy etykiety magazynowe mogą używać kodów GS1 albo SSCC?
- Tak. gPdf może renderować obsługiwane formaty kodów kreskowych w wyjściu PDF. Twój system odpowiada za zakodowane dane i akceptację skanera.
- Czy powtarzalne etykiety magazynowe powinny używać szablonów?
- Zwykle tak. Template Render daje stanowiskom druku stabilny template_id i kontrakt danych po zatwierdzeniu układu etykiety.
- Jak powinny działać reprinty?
- Przechowuj dane źródłowe etykiety albo wygenerowany PDF przy rekordzie magazynowym, a potem renderuj albo pobieraj tę samą etykietę z użyciem oryginalnych ID operacyjnych.