Obsługa kodów QR i 3D
Wstęp
⚠️Uwaga: Opcja rozpoznawania dostępna jest dla pakietów eTeczki eFOB Professional i Enterprise.
W celu łatwej i skutecznej identyfikacji poszczególnych plików Dokumentów na platformie eFOB wykorzystywane są następujące mechanizmy rozpoznawania dodatkowych kodów wizualnych:
- Kody QR (pełne) – poszerzone dane wg poniższej specyfikacji – dostępne do generacji w systemach zewnętrznych
- Kody QR (podstawowe) – zawierające wyłącznie informację o typie dokumentu; dostępne do pobrania w systemie eFOB w formie pojedynczego kodu lub zestawu kodów do wydruku (naklejki) z poziomu menu (Typy dokumentów – generator kodów QR – eFOB eTeczka, dodatkowy opis ‘Nazwa krótka dokumentu‘)
- Kody 3D – generowane automatycznie przez mechanizm tworzenia dokumentów w eFOB; ich użycie i lokalizacja są konfigurowane w ustawieniach wzorów dokumentów.
Rozpoznawanie kodów QR i 3D w modułach eFOB
Rozpoznawanie kodów QR i 3D następuje, gdy włączona jest opcja przetwórz automatycznie dostępna w prawym rogu ekranu:
Rozpoznawanie kodów QR i 3D dostępne jest w następujących modułach -> funkcjonalnościach:
- Dokumenty -> Prześlij dokument
- Dokumenty -> Prześlij pliki
- Sprawy -> Prześlij pliki (dostępne jeśli co najmniej jeden typ dokumentu ma opcję generacji z systemu eFOB)
- Moje sprawy -> UWAGA: kody QR i 3D nie są aktualnie obsługiwane
Uwaga: Funkcja wieloskan obsługuje aktualnie wyłącznie kody 3D.
Specyfikacja techniczna kodów 3D
Kody 3D są generowane na każdej stronie dokumentu i są odczytywane autorskim rozwiązaniem AI wbudowanym w eFOB.
Kody zawierają następujące dane (wg identyfikatorów eFOB):
- ID pracownika (max. 400 tys. ) lub kandydata (max. 600 tys.)
- ID typu dokumentu (max. 4000)
- Nr wersji wzorca dokumentu (max. 127)
- Data dokumentu (powyżej 1970-01-01)
- Strona dokumentu (max. 200)
Uwaga: Kody 3D aktualnie nie zawierają rozpoznawania identyfikatora pracodawcy ani firmy – te opcje dostępne są w opcji kodów QR (pełnych).
Specyfikacja techniczna kodów QR (podstawowych)
Funkcjonalność podstawowych kodów QR zawierających sam typ dokumentu jest przydatna przy masowym wydruku pustych dokumentów, które są wypełniane odręcznie przez pracowników.
Nazwa krótka jest polem ustawienia Typu dokumentu o długości do 32 znaków. Jest ona wykorzystywana m.in. do generacji kodów QR. Powinny być one umieszczane na pierwszej stronie dokumentu celem automatycznej identyfikacji samego typu dokumentu.
Specyfikacja techniczna kodów QR (pełnych)
Zastosowane kody QR oparte są na kodowaniu Base36. Zastosowany standard umożliwia zakodowanie wielu istotnych informacji w zwartej i czytelnej postaci, przy zachowaniu niewielkiego stopnia złożoności samego kodu.
Specyfikacja została zaprojektowana w sposób otwarty, dzięki czemu kody QR (Kod QR – Wikipedia, wolna encyklopedia) mogą być generowane w systemach zewnętrznych (np. ERP), z zachowaniem pełnej zgodności i poprawnej interpretacji danych.
Kody QR (pełne) zawierają najbogatszy zestaw danych, jednak wymagają wygospodarowania na dokumencie odpowiedniej przestrzeni, by mogły być poprawnie rozpoznawane, mimo ew. zniekształceń powodowanych przez drukarkę/skaner.
Rekomendowane są następujące ustawienia generacji kodów QR:
- Umieszczenie kodu QR w prawym górnym rogu, minimum 15mm od krawędzi strony,
- Wielkość kodu 30mm x 30mm,
- Kod korekcji 2-Q (25%), łączna długość ciągu 28 -> rozmiar 25×25, quiet zone 4 moduły.
Kody zawierają 28 znaków, dzielących się na sekcje zgodnie z poniższą tabelą:
| Sekcja | Ilość znaków w Base36 | Zakres (w liczbach dziesiętnych) | Opis |
| Header | 2 | 0 – 1 296 | Nagłówek protokołu. Zawiera wersję schematu QR (obecnie zawsze M1) |
| T (tenant_id) | 4 | 0 – 1 679 615 | Identyfikator tenanta |
| E (employer_id) | 3 | 0 – 46 655 | Identyfikator pracodawcy |
| DT (doc_type) | 3 | 0 – 46 655 | Typ dokumentu |
| DD (date_days) | 4 | 0 – 1 679 615 | Liczba dni od 1970-01-01 |
| X1 (external_id_1) | 4 | 0 – 1 679 615 | Identyfikator pracownika z zewnętrznego systemu |
| X2 (external_id_2) | 4 | 0 – 1 679 615 | Inny identyfikator pracownika z zewnętrznego systemu |
| C (CRC16) | 4 | 0 – 1 679 615 | CRC16 (CCITT-FALSE) liczone z wszystkich wcześniejszych znaków kodu, zakodowane w Base36 lub ZZZZ jeśli brak możliwości wyliczenia. Pełni funkcję liczby sprawdzającej poprawność danych |
Informacje nt. tych informacji można otrzymać z poniższych źródeł w eFOB:
- Nagłówek (Header) – obecnie stała wartość M1.
- Identyfikator tenanta (T) – w module Administracja należy przejść do Danych firmy, a w nich znaleźć Kod firmy (QR).
- Typ dokumentu (DT) – w module Administracja należy przejść do Typów dokumentów, wybrać konkretny typ, a w nim Kod typu (QR).
- Data (DD) – konieczna do policzenia liczba dni od 1970-01-01.
Przykład kodu QR (pełnego)
Uzupełniając dane z kolejnych sekcji, możemy otrzymać przykładowo kod: M1YZUV001C5R0FR3001F2N9C0RS2. Ciąg znaków przełoży się na poniższy kod QR, do tworzenia którego można wykorzystać przykładowo: Generator kodów QR – Twórz bezpłatne kody QR (w trybie ‘tekst’).
Udostępnij artykuł w Social Mediach