Professional Documents
Culture Documents
Apot I Dev 08 018 Struktura Danych Pamieci Chronionej W Drukarkach
Apot I Dev 08 018 Struktura Danych Pamieci Chronionej W Drukarkach
Spis treści
Drzewo plików pamięci chronionej:.....................................................................................................4
Zawartość podkatalogów katalogu DOC:.............................................................................................5
Podpisy plików:....................................................................................................................................5
Identyfikatory urządzeń:.......................................................................................................................7
Nagłówek rekordu:...............................................................................................................................7
Typy rekordów:....................................................................................................................................7
Dostępne typy rekordów dokumentów:...........................................................................................7
Dostępne typy rekordów zdarzeń:...................................................................................................9
Typ zdarzenia – wartość rekordu ‘0x80’.......................................................................................10
Wartości stawek PTU po zmianie – wartość rekordu ‘0x81’........................................................11
Data i czas po zmianie – wartość rekordu ‘0x82’..........................................................................11
Waluta po zmianie – wartość rekordu ‘0x83’................................................................................11
Zmiana konfiguracji serwera – wartość rekordu ‘0x84’................................................................11
Suma kontrolna po zmianie firmware’u – wartość rekordu ‘0x85’...............................................11
Tryb serwisowy – wartość rekordu ‘0x86’....................................................................................11
Oznaczenie pamięci chronionej – wartość rekordu ‘0x87’............................................................11
Id serwisanta – wartość rekordu ‘0x88’.........................................................................................11
Źródło aktualizacji oprogramowania – wartość rekordu ‘0x89’....................................................12
Wartość klucza publicznego – wartość rekordu ‘0x8A’................................................................12
Punkt sprzedaży – wartość rekordu ‘0x8B’...................................................................................12
Zmiana harmonogramu połączeń z repozytorium – wartość rekordu ‘0x8C’...............................13
Zmiana drukowania QRCode – wartość rekordu ‘0x8D’..............................................................14
Klucz publiczny (dane) – wartość rekordu ‘0x8E’........................................................................14
Dane Dokumentów:............................................................................................................................15
Dane linii – wartość ‘0x0A’ (0x0Ah)............................................................................................15
Dane stopki – wartość ‘A’ (0x41h)................................................................................................15
Tekst nagłówka – wartość ‘T’ (0x54h)..........................................................................................16
Dane nagłówka dokumentu – wartość ‘D’ (0x44h).......................................................................16
Dane separatora teksów – wartość ‘S’ (0x53h).............................................................................16
Dane sprzedaży – wartość ‘a’ (0x61h)...........................................................................................17
Dane kodu kreskowego – wartość ‘b’ (0x62h)..............................................................................17
Struktura kodów kreskowych – dane rekordu ‘b’ (0x62h).......................................................18
0x01h – AZTEC:.......................................................................................................................18
0x02h – QR CODE:..................................................................................................................18
0x03h – PDF 417:.....................................................................................................................18
0x04h – DATA MATRIX:........................................................................................................19
0x05h – EAN 128:....................................................................................................................19
0x06h – EAN 13.......................................................................................................................20
Dane linii opakowań – wartość ‘c’ (0x63h)...................................................................................20
Sekcja z wartościami – wartość ‘d’ (0x64h)..................................................................................20
Sekcja – wartość ‘e’ (0x65h).........................................................................................................20
Skrót do grafiki – wartość ‘i’ (0x69h)...........................................................................................20
Dane form płatności – wartość ‘j’ (0x6Ah)...................................................................................21
Dane reszty form płatności – wartość ‘k’ (0x6Bh)........................................................................21
Linie informacyjne w stopce – wartość ‘l’ (0x6Ch)......................................................................22
Skrót SHA – wartość ‘m’ (0x6Dh)................................................................................................22
1/42
DKO 27.07.2021 oznaczenie dokumentu: POT–I–DEV–08 wersja: 018
2/42
DKO 27.07.2021 oznaczenie dokumentu: POT–I–DEV–08 wersja: 018
3/42
DKO 27.07.2021 oznaczenie dokumentu: POT–I–DEV–08 wersja: 018
Uwaga: Kolejność bajtów dla wszystkich wartości liczbowych jest ustalona na BigEndian.
4/42
DKO 27.07.2021 oznaczenie dokumentu: POT–I–DEV–08 wersja: 018
Podpisy plików:
• Plik medium.SIG jest to podpis pliku medium.dat. SHA-1 jest generowane wyłącznie na
podstawie zawartości pliku medium.dat.
• KEY.SIG – plik zawierający podpis SHA-1 pliku .DER.
Skrót SHA1 generowany jest z konkatenacji:
◦ zawartości pliku .DER
◦ char[14] – numeru unikatowego urządzenia.
◦ unsigned long – numeru pamięci chronionej
• Plik xxxxxxxx.SIG jest to podpis pliku xxxxxxxx.BIN. Jest to podpis RSA512 ze skrótu
SHA1. Podpis pliku xxxxxxxx.BIN (rekord 0x20h) może zostać zapisany na końcu pliku
(ostatnie 64 bajty). W takim przypadku plik xxxxxxxx.SIG nie jest generowany.
Skrót SHA1 generowany jest z konkatenacji:
◦ zawartości pliku .BIN bez zawartości ostatniego rekordu 0x20 (podpis dokumentu)
łącznie z jego nagłówkiem (czyli tylko bez ostatnich 64 bajtów).
◦ char[14] – numeru unikatowego urządzenia.
◦ unsigned long – numeru pliku .BIN
• Plik xxxxxxxx.BIN jest wewnętrznie podpisywany. Pod koniec każdego pliku BIN znajduje
się rekord z podpisem RSA. Jest to podpis RSA2048 z skrótu SHA256. Podpis ten jest
generowany na podstawie danych znajdujących się od początku pliku xxxxxxxx.BIN, do
miejsca wystąpienia rekordu podpisu (oznaczenie rekordu 0x74h).
Klucz publiczny do danego pliku BIN należy pobrać:
◦ na podstawie rekordu fiskalizacji(*) z pamięci fiskalnej.
◦ w przypadku wymiany kluczy na podstawie wpisu o wymianie kluczy w pamięci
chronionej (oznaczenie rekordu 0x8A, typ klucza 0x01h – ENC) lub w pamięci fiskalnej.
(*) W rekordzie fiskalizacji znajduje się wartość (4 bajty) offsetu certyfikatu, i na jego podstawie
należy odczytać certyfikat z pliku zawierającego wszystkie certyfikaty urządzenia.
Pliki skrótów z rozszerzeniem SIG lub rekordy typu 0x20 służą do weryfikacji pliku - wykrycia
prostych przekłamań. Sprawdzenie podpisów w pliku BIN zapewnia uwierzytelnienie pliku.
5/42
DKO 27.07.2021 oznaczenie dokumentu: POT–I–DEV–08 wersja: 018
6/42
DKO 27.07.2021 oznaczenie dokumentu: POT–I–DEV–08 wersja: 018
Identyfikatory urządzeń:
Identyfikator Typ urządzenia
0x00000066 Thermal HD Online 1.01
0x00000067 Thermal XL2 Online 1.01
0x00000068 Temo Online 1.01
0x00000069 Trio Online 1.01
0x0000006A Pospay Online 1.01
Nagłówek rekordu:
Rekordy rozpoczynają się następującymi danymi:
Typ Nazwa Opis
unsigned short ZAREZERWOWANE Dane zarezerwowane
unsigned short Rec.type Typ rekordu
unsigned short Rec.size Rozmiar rekordu (w hex)
Typy rekordów:
7/42
DKO 27.07.2021 oznaczenie dokumentu: POT–I–DEV–08 wersja: 018
8/42
DKO 27.07.2021 oznaczenie dokumentu: POT–I–DEV–08 wersja: 018
ł – numer faktury
´ – nazwa faktury
µ – sekcja przed towarami faktury
0x8F – znacznik wymiany/wysłania certyfikatów
9/42
DKO 27.07.2021 oznaczenie dokumentu: POT–I–DEV–08 wersja: 018
Dane Zdarzeń:
Typ zdarzenia – wartość rekordu ‘0x80’
Ilość bajtów Typ Opis
1 byte Typy zdarzeń:
0x00 – rekord raportu dobowego
0x01 – rekord fiskalizacji
0x02 – rekord zerowania RAM
0x03 – rekord zmiany stawek PTU
0x04 – rekord przejścia w stan tylko
do odczytu
0x05 – rekord zmiany waluty
0x06 – konfiguracja przekazu danych
0x07 – adres podatnika
0x08 – aktualizacja programu
0x09 – nieudana aktualizacja programu
0x0A – tryb serwisowy
0x0B – wymiana pamięci chronionej
0x0C – kasowanie algorytmu
weryfikującego
0x0D – źródło aktualizacji programu
pracy
0x0E – zmiana daty i czasu
0x0F – wymiana klucza publicznego kasy
0x10 – przegląd techniczny
0x11 – błąd weryfikacji pam.
chronionej
0x12 – awaria zasilania
0x13 – utrata ciągłości nr dokumentów
0x14 – błąd weryfikacji danych
0x15 – zapełnienie pam. chronionej
0x16 – zapełnienie pam. fiskalnej
0x17 – odłączenie mech. drukującego
0x18 – odłączenie wyświet. nabywcy
0x19 – brak przekazu klucza
publicznego
0x1A – zarezerwowane
0x64 – rekord qrcode
0x67 – rekord zmiany harmonogramu połączeń
4 unsigned long Data i czas wystąpienia zdarzenia (w sekundach od
01.01.2000)
10/42
DKO 27.07.2021 oznaczenie dokumentu: POT–I–DEV–08 wersja: 018
11/42
DKO 27.07.2021 oznaczenie dokumentu: POT–I–DEV–08 wersja: 018
12/42
DKO 27.07.2021 oznaczenie dokumentu: POT–I–DEV–08 wersja: 018
13/42
DKO 27.07.2021 oznaczenie dokumentu: POT–I–DEV–08 wersja: 018
14/42
DKO 27.07.2021 oznaczenie dokumentu: POT–I–DEV–08 wersja: 018
Dane Dokumentów:
Dane linii – wartość ‘0x0A’ (0x0Ah)
Zawiera znaki składające się na linie wydruku np.: RAPORT RESETOWANIA
Maksymalna długość linii wynosi 121 bajtów – gdzie długość linii jest dostosowywana do zawartości.
15/42
DKO 27.07.2021 oznaczenie dokumentu: POT–I–DEV–08 wersja: 018
16/42
DKO 27.07.2021 oznaczenie dokumentu: POT–I–DEV–08 wersja: 018
17/42
DKO 27.07.2021 oznaczenie dokumentu: POT–I–DEV–08 wersja: 018
0x01h – AZTEC:
Ilość bajtów Typ Opis
1 byte PixelsPerModule - długość boku (w pikselach)
pojedynczego punktu kodu
Wartość minimalna: 2
1 byte EccLevel
Dopuszczalne wartości:
0 – (10%) najmniejszy poziom korekcji,
1 – (23%)
2 – (36%)
3 – (50%) największy poziom korekcji - największa
liczba dodatkowych danych
1 byte Mode - przełącznik pomiędzy trybami wprowadzanych
danych
0 – tryb Ascii
1 - tryb Hex.
0x02h – QR CODE:
Ilość bajtów Typ Opis
1 byte PixelsPerModule - długość boku (w pikselach)
pojedynczego punktu kodu
Wartość minimalna: 2
1 byte EccLevel
Dopuszczalne wartości:
0 – (L 7%) najmniejszy poziom korekcji
1 – (M 15%)
2 – (Q 25%)
3 – (H 30%) największy poziom korekcji -
największa liczba dodatkowych danych
1 byte Mode - przełącznik pomiędzy trybami wprowadzanych
danych
0 – tryb Ascii
1 - tryb Hex.
18/42
DKO 27.07.2021 oznaczenie dokumentu: POT–I–DEV–08 wersja: 018
19/42
DKO 27.07.2021 oznaczenie dokumentu: POT–I–DEV–08 wersja: 018
0x06h – EAN 13
Brak dodatkowych danych.
20/42
DKO 27.07.2021 oznaczenie dokumentu: POT–I–DEV–08 wersja: 018
21/42
DKO 27.07.2021 oznaczenie dokumentu: POT–I–DEV–08 wersja: 018
22/42
DKO 27.07.2021 oznaczenie dokumentu: POT–I–DEV–08 wersja: 018
23/42
DKO 27.07.2021 oznaczenie dokumentu: POT–I–DEV–08 wersja: 018
24/42
DKO 27.07.2021 oznaczenie dokumentu: POT–I–DEV–08 wersja: 018
25/42
DKO 27.07.2021 oznaczenie dokumentu: POT–I–DEV–08 wersja: 018
26/42
DKO 27.07.2021 oznaczenie dokumentu: POT–I–DEV–08 wersja: 018
Dokładny opis linii nagłówka znajduje się w specyfikacji protokołu kas - polecenie
[HEADERSET].
27/42
DKO 27.07.2021 oznaczenie dokumentu: POT–I–DEV–08 wersja: 018
28/42
DKO 27.07.2021 oznaczenie dokumentu: POT–I–DEV–08 wersja: 018
29/42
DKO 27.07.2021 oznaczenie dokumentu: POT–I–DEV–08 wersja: 018
1 byte Typ:
00h – Narzut
01h – Rabat
1 byte Rabat/narzut procentowy:
00h – Nie
01h – Tak
6 tBcdVal Wartość rabatu/narzutu do udzielenia
6 tBcdVal Wartość pozycji przed udzieleniem rabatu/narzutu
6 tBcdVal Wartość udzielonego rabatu/narzutu
1 byte Identyfikator stawki PTU:
00h – A
01h – B
02h – C
03h – D
04h – E
05h – F
06h – G
25 char Nazwa rabatu/narzutu
4 unsigned long Szerokość (ilość znaków w linii)
2 tBcdVal Wartość stawki PTU
1 byte Typ rabatu/narzutu:
00h – Podstawowy
01h – Do podsumy
02h - Informacyjny
6 tBcdVal Wartość netto
6 tBcdVal Wartość podatku
6 tBcdVal Wartość po udzieleniu rabatu/narzutu
6 tBcdVal Wartość brutto
30/42
DKO 27.07.2021 oznaczenie dokumentu: POT–I–DEV–08 wersja: 018
31/42
DKO 27.07.2021 oznaczenie dokumentu: POT–I–DEV–08 wersja: 018
32/42
DKO 27.07.2021 oznaczenie dokumentu: POT–I–DEV–08 wersja: 018
36 – Kwota
37 – Promocja
38 – Info
39 – Do faktury
40 – Ad.
41 – napis predefiniowany z uwzględnieniem
znaków formatujących
42 – napis predefiniowany z małą czcionką
113 char Tekst linii dodatkowej
1 byte Podwójna szerokość:
00h – Nie
01h – Tak
1 byte Podwójna wysokość:
00h – Nie
01h – Tak
1 unsigned char Typ szerokości:
00h – szer.80mm/56znaków
01h – szer.57mm/40znaków
02h – szer.80mm/40znaków
33/42
DKO 27.07.2021 oznaczenie dokumentu: POT–I–DEV–08 wersja: 018
34/42
DKO 27.07.2021 oznaczenie dokumentu: POT–I–DEV–08 wersja: 018
35/42
DKO 27.07.2021 oznaczenie dokumentu: POT–I–DEV–08 wersja: 018
36/42
DKO 27.07.2021 oznaczenie dokumentu: POT–I–DEV–08 wersja: 018
37/42
DKO 27.07.2021 oznaczenie dokumentu: POT–I–DEV–08 wersja: 018
38/42
DKO 27.07.2021 oznaczenie dokumentu: POT–I–DEV–08 wersja: 018
39/42
DKO 27.07.2021 oznaczenie dokumentu: POT–I–DEV–08 wersja: 018
40/42
DKO 27.07.2021 oznaczenie dokumentu: POT–I–DEV–08 wersja: 018
41/42
DKO 27.07.2021 oznaczenie dokumentu: POT–I–DEV–08 wersja: 018
42/42