API dla etykiet SSCC w logistycznych PDF GS1
Renderuj etykiety z kodem kreskowym SSCC-18 jako PDF dla logistyki, palet, kartonów i procesów magazynowych, gdy Twój system odpowiada za poprawność payloadu GS1.
/api/v1/pdf/render Renderować etykiety z kodem kreskowym SSCC-18 jako wektorowe wyjście PDF dla palet, kartonów lub jednostek logistycznych po tym, jak Twój system nadał Serial Shipping Container Code i zweryfikował jego semantykę GS1.
Kiedy użyć tej API
- Twój system ma już wartość SSCC i wszystkie powiązane identyfikatory zastosowania.
- Potrzebujesz etykiety PDF ze skanowalnym kodem kreskowym SSCC i tekstem czytelnym dla człowieka.
- Potrzebujesz powtarzalnych układów etykiet SSCC dla magazynu albo stanowisk druku 3PL.
- Chcesz połączyć etykiety SSCC z szerszymi procesami etykiet paletowych lub magazynowych.
Czego nie zastępuje
- Potrzebujesz od gPdf nadania prefiksu GS1, utworzenia cyfry kontrolnej albo certyfikacji zgodności.
- Potrzebujesz zarządzania stanem zapasów lub przesyłki.
- Potrzebujesz zakupu etykiety przewoźnika albo wyceny wysyłki.
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 - kod kreskowy etykiety SSCC-18.
{
"pages": [
{
"size": "label_100_150",
"elements": [
{
"type": "text",
"x": 6,
"y": 8,
"content": "SSCC",
"style": { "font_size": 12, "font_family": "NotoSans-Regular" }
},
{
"type": "barcode",
"format": "sscc-18",
"content": "000123456789012345",
"x": 6,
"y": 28,
"width": 86,
"height": 30,
"barcode_text": { "enabled": true, "position": "bottom" }
}
]
}
]
}
Co obsługuje gPdf
- Wektorowe renderowanie kodów kreskowych SSCC wewnątrz stron PDF.
- Układ etykiety z tekstem, ramkami, tekstem kodu kreskowego i opcjonalnym powiązaniem z szablonem.
- Wyjście PDF do druku, przechowywania albo magazynowych reprintów.
- Wspólną kopertę błędu, gdy żądanie nie przejdzie walidacji.
Co kontroluje Twój system
- Prefiks firmy GS1, cyfrę rozszerzenia, referencję seryjną, cyfrę kontrolną i zakodowany payload.
- Reguły procesu magazynowego, akceptację skanerów i walidację materiału etykiet.
- Każdy proces EDI, ASN, przewoźnika albo partnera handlowego, który konsumuje SSCC.
Checklist produkcyjny
- Zweryfikuj wartość SSCC i cyfrę kontrolną przed wywołaniem gPdf.
- Zeskanuj wyjście produkcyjnymi skanerami i na produkcyjnym materiale etykiet.
- Udokumentuj, które zdarzenia magazynowe tworzą i ponownie drukują etykiety SSCC.
- Użyj Template Render dla zatwierdzonych układów etykiet SSCC.
- Trzymaj kontrole zgodności partnerów handlowych poza wywołaniem renderowania.
Granice deklaracji
- gPdf renderuje kod kreskowy SSCC jako PDF; nie nadaje ani nie certyfikuje wartości SSCC.
- Zgodność z GS1 i wymaganiami partnerów handlowych pozostaje Twoją odpowiedzialnością.
- Etykiety SSCC nie oznaczają utworzenia przesyłki przewoźnika.
Etykiety SSCC to precyzyjny proces kodu kreskowego
Etykiety SSCC są węższe niż ogólne etykiety paletowe. Najważniejsza jest sama wartość Serial Shipping Container Code. gPdf renderuje ten kod w PDF; Twój system odpowiada za nadanie kodu, reguły GS1 i wymagania partnerów handlowych.
FAQ
- Czy gPdf może utworzyć numer SSCC?
- Nie. Twój system tworzy i waliduje wartość SSCC. gPdf renderuje ją jako kod kreskowy w PDF.
- Którego formatu kodu kreskowego użyć?
- Podczas renderowania elementu kodu kreskowego SSCC użyj obsługiwanego aliasu SSCC, takiego jak sscc-18.
- Czy to może być szablon?
- Tak. Większość etykiet SSCC powinna przejść na Template Render po zatwierdzeniu układu i mapowania pól.
- Czy to certyfikuje zgodność z GS1?
- Nie. gPdf renderuje wektorowe wyjście kodu kreskowego. Zgodność i akceptacja skanerów są osobnymi odpowiedzialnościami.