API kodów kreskowych GS1 dla wektorowych etykiet PDF
Renderuj wektorowe kody GS1 w PDF, w tym GS1-128, GS1 DataMatrix, GS1 QR, ITF-14 oraz procesy etykiet SSCC-18.
/api/v1/pdf/render Renderuj dane kodów GS1 jako wektorowe etykiety lub dokumenty PDF, podczas gdy system produktowy, magazynowy albo retail odpowiada za poprawne identyfikatory aplikacyjne, cyfry kontrolne i akceptację skanerów.
Kiedy użyć tej API
- Potrzebujesz modułów kodu kreskowego rysowanych jako wektorowa zawartość PDF, a nie wklejanych obrazów bitmapowych.
- Twój system ma już poprawne dane GS1 i ich czytelną dla człowieka interpretację.
- Potrzebujesz procesów GS1-128, GS1 DataMatrix, GS1 QR, ITF-14 albo SSCC-18 w etykietach lub dokumentach.
- Chcesz przenieść powtarzalne układy etykiet z kodami kreskowymi do Template Render.
Czego nie zastępuje
- Potrzebujesz certyfikacji GS1 albo walidacji semantyki danych produktowych przez gPdf.
- Potrzebujesz, aby gPdf przydzielał prefiksy firmowe GS1, GTIN, SSCC albo cyfry kontrolne.
- Potrzebujesz zarządzania zapasami albo danymi podstawowymi produktów.
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 - element kodu kreskowego PDF w stylu GS1-128.
{
"pages": [
{
"size": "label_4_6_in",
"elements": [
{
"type": "barcode",
"format": "gs1-128",
"content": "(00)012345678901234567",
"x": 8,
"y": 22,
"width": 86,
"height": 24,
"barcode_text": { "enabled": true, "position": "bottom" }
},
{
"type": "text",
"x": 8,
"y": 56,
"content": "SSCC pallet label",
"style": { "font_size": 10, "font_family": "NotoSans-Regular" }
}
]
}
]
}
Co obsługuje gPdf
- Wektorowe renderowanie kodów kreskowych wewnątrz wyjścia PDF.
- Umieszczanie kodu kreskowego razem z tekstem, liniami, danymi produktu i strukturami etykiet.
- Template Render dla powtarzalnych etykiet produktowych, paletowych, kartonowych i magazynowych.
- Wyjście PDF odpowiednie do testów skanowania i druku.
Co kontroluje Twój system
- Identyfikatory aplikacyjne GS1, prefiksy firmowe, GTIN, SSCC i cyfry kontrolne.
- Poprawne dane kodu kreskowego, dane produktu, tekst regulacyjny i testy akceptacji skanerów.
- Proces druku, materiał etykiety, marginesy ochronne i operacyjną kontrolę jakości.
Checklist produkcyjny
- Wygeneruj dane GS1 wcześniej i utrzymuj je w formie możliwej do testowania.
- Drukuj i skanuj na produkcyjnych drukarkach oraz skanerach.
- Sprawdź marginesy ochronne, rozmiar modułu, tekst czytelny dla człowieka i materiał etykiety.
- Użyj Template Render po zatwierdzeniu układu etykiety.
- Udokumentuj, że gPdf renderuje kody kreskowe, ale nie certyfikuje zgodności z GS1.
Granice deklaracji
- gPdf renderuje wektorowe kody kreskowe w PDF; nie jest jednostką certyfikującą GS1.
- System wywołujący odpowiada za semantykę danych GS1 i cyfry kontrolne.
- Akceptację skanerów trzeba zweryfikować w środowisku produkcyjnym systemu wywołującego.
Renderowanie kodów GS1 to zadanie renderowania PDF
gPdf odpowiada za narysowanie kodu kreskowego w PDF. Nie decyduje, czy GTIN, SSCC albo sekwencja identyfikatorów aplikacyjnych jest poprawna dla Twojej firmy. Zachowaj tę logikę w ERP, WMS, systemie informacji produktowej albo narzędziach GS1.
Użyj JSON Render albo Template Render
Użyj JSON Render, gdy kod bezpośrednio układa etykietę albo dokument. Użyj Template Render, gdy kod kreskowy jest jednym polem w powtarzalnym układzie etykiety. W obu przypadkach system wywołujący wysyła dane, które mają zostać zakodowane.
Weryfikuj na realnych skanerach
Skuteczność kodu kreskowego mierzy się akceptacją skanera, a nie tym, czy obraz wygląda poprawnie na monitorze. Zweryfikuj wydruk na tych samych drukarkach, skanerach i materiałach etykiet, które będą używane produkcyjnie.
FAQ
- Czy gPdf certyfikuje etykiety GS1?
- Nie. gPdf renderuje wektorową grafikę kodów kreskowych w PDF. Twój zespół odpowiada za poprawność danych GS1, testy skanerów i ewentualny proces certyfikacji.
- Czy kodów GS1 można używać z Template Render?
- Tak. Opublikowany szablon może zawierać pola kodów kreskowych, a systemy wywołujące mogą wysyłać tylko zmienne dane dla powtarzalnych układów etykiet.
- Kto tworzy SSCC albo GTIN?
- Twój system produktowy, magazynowy albo ERP tworzy i weryfikuje identyfikatory. gPdf otrzymuje dane do zakodowania i je renderuje.
- Dlaczego używać wektorowych kodów kreskowych?
- Moduły wektorowe unikają artefaktów skalowania rastra i utrzymują większą ostrość etykiet PDF przy różnych DPI drukarek oraz poziomach powiększenia.