HAYES EXPERT.dokumentacja integracyjna
1. Metadane systemowe (główny obiekt)
Są to techniczne pola bazy danych oraz identyfikatory paczki danych.
- • IDHA Hayes Expert ID
- • ID: Unikalny numer ID transakcji w ramach systemu aplikacyjnego (469).
- • TYP: Typ rekordu/transakcji (2 – najczęściej oznacza standardową sprzedaż detaliczną).
- • DATI: Data i godzina zakończenia/zapisania całej transakcji w formacie YYYYMMDDHHMMSS (2025-03-06 14:19:28).
- • STATION_NR: Numer identyfikacyjny stacji paliw (4101).
- • SHF: Numer zmiany (Shift), podczas której doszło do sprzedaży (69).
- • ACC_REP_NR: Numer raportu rozliczeniowego/dobowego (Accounting Report Number) – (87).
- • OPID: Identyfikator operatora lub kasjera logującego transakcję (LART).
- • REF: Zewnętrzny numer referencyjny całego dokumentu (0113120151).
- • SEQ: Numer sekwencyjny nadany przez system kasowy lub automatykę stacji (0113120010316).
- • SAFTDATI: Data i godzina wygenerowania danych dla celów raportowania audytowego / SAF-T (w Polsce to odpowiednik struktury JPK) – 2025-03-06 14:19:28.
- • uniq: Unikalny hash tekstowy transakcji służący do szybkiej weryfikacji i unikania duplikatów (oUMUyOO8e).
- • created: Znacznik czasu (Timestamp UNIX w milisekundach) utworzenia tego dokumentu w bazie (1741269679720, co odpowiada 6 marca 2025).
- • fileName: Nazwa oryginalnego pliku źródłowego, z którego system zaimportował te dane (23200113.TRXU).
- • status: Aktualny status przetwarzania transakcji w systemie (register – zarejestrowana).
- • updatedAt: Dokładna data i czas ostatniej modyfikacji tego wpisu w bazie danych w formacie ISO (2025-03-10 06:29:11.983 UTC).
2. Sekcja ITEMS -> Produkt 1 (Szczegóły tankowania)
Ta sekcja opisuje to, co faktycznie wydarzyło się przy dystrybutorze.
Dane handlowe i lokalizacja dystrybutora:
- • MERCH_ID: Identyfikator punktu handlowego / stanowiska (A).
- • MERCH_NAME: Nazwa podmiotu / właściciela stacji (Petrodis Sp. z o.o.).
- • MERCH_RECEIPT_SEQ_NR: Numer sekwencyjny paragonu powiązanego z tym towarem (410100018738).
- • PMP: Numer fizycznego dystrybutora (Pump), z którego tankowano (4).
- • PUMP_MODE: Tryb pracy dystrybutora (1,1,2 – określa parametry elektroniki dystrybutora, np. tryb samoobsługowy lub automatyczny).
- • NOZZLE: Numer pistoletu / nalewaka na dystrybutorze (1).
Daty i czas operacji:
- • NDATI: Data i godzina odłożenia pistoletu / zakończenia nalewania (2025-03-06 14:18:47).
- • START_DATE: Dokładna data i godzina podniesienia pistoletu / rozpoczęcia nalewania (2025-03-06 14:16:11). Tankowanie trwało 2 minuty i 36 sekund.
Wolumen i Ceny:
- • PRI: Cena jednostkowa paliwa za litr (5.99 zł).
- • BASEPRI: Cena bazowa paliwa przed ewentualnymi rabatami (5.99 zł).
- • QTY: Ilość wydanego paliwa (51.05 litra).
- • QTYUNIT: Jednostka miary ilości (2 – w standardach IFSF kod 2 oznacza litry).
- • GAMT: Brutto / Łączna kwota do zapłaty (Gross Amount) – (305.79 zł).
- • AMT: Ostateczna kwota po rabatach (Amount) – (305.79 zł).
- • UGAMT / UAMT: Niesformatowane kwoty surowe (Unformatted Gross/Amount) używane do obliczeń wewnętrznych systemu (305.79 zł).
- • NQUA_CHANGEABLE: Stan licznika dystrybutora (totalizatora) po zakończeniu tankowania (86680.60 litrów).
Informacje o produkcie i podatkach:
- • PLU: Kod towaru w bazie (Price Look-Up) – (5).
- • NAM: Nazwa handlowa zatankowanego paliwa (PB95 E10 – Benzyna 95-oktanowa z zawartością do 10% bio komponentów).
- • GRP: Grupa towarowa, do której przypisane jest paliwo (59).
- • CRD: Kod waluty (227 – w niektórych systemach oznacza PLN lub wewnętrzny kod rozliczeniowy).
- • ART_MERCH_ID: Identyfikator powiązania artykułu ze stoiskiem (A).
- • PRC: Stawka podatku VAT w procentach (23.00%).
- • VAMT: Kwota podatku VAT z tego tankowania (VAT Amount) – (57.18 zł).
- • EXC: Kwota netto bez podatku VAT (Excluded) – (248.61 zł).
- • INC: Kwota brutto z podatkiem VAT (Included) – (305.79 zł).
Dane transakcji kartowej przy dystrybutorze (Płatność tankautomatu):
Te pola powtarzają się w sekcji głównej pod krótszymi nazwami – oznaczają, że klient płacił kartą bezpośrednio przy dystrybutorze lub aplikacją.
- • CPPAN: Zmaskowany numer karty płatniczej użytej do transakcji (535233******8125 – karta MasterCard).
- • CPCERT: Kod certyfikatu / numer transakcji z terminala (25122112C70034EB).
- • CPHOSTREF: Numer referencyjny nadany przez bank/centrum autoryzacyjne (030614757248).
- • CPPINA: Flagowy status wprowadzenia kodu PIN (1 – PIN poprawny / wprowadzony).
- • CPREPL: Tryb odpowiedzi serwera (Reply) – (2).
- • CPHOSTTYPE: Typ systemu autoryzacyjnego hosta (12).
- • CPHOSTBOOKPER: Okres księgowania na hoście bankowym (113).
- • CPAUTH: Kod autoryzacji transakcji bankowej z terminala (001138).
- • CPCAIC: Identyfikator terminala płatniczego (TID) lub akceptanta (048214101).
- • CPONLINERC: Kod odpowiedzi online (Response Code) – 000 oznacza pełny sukces transakcji finansowej.
- • CPSTAN: Numer śledzenia transakcji (STAN - System Trace Audit Number) na terminalu (019511).
Metoda płatności wewnątrz pozycji (MOP):
- • MOP / MOP_ADDX: Metoda płatności (Method of Payment) – 4 (standardowy kod dla kart płatniczych / kredytowych).
- • ROP: Sposób realizacji zamówienia (1).
- • PM: Kod wewnętrzny metody płatności (703).
- • PA: Kwota opłacona tą metodą (305.79 zł).
- • TRKMED: Typ nośnika danych karty (2 – np. odczyt z chipu/EMV).
3. Dane Autoryzacji Płatności (Główny blok na dole)
Są to ostatecznie potwierdzone dane finansowe dla całej transakcji (odpowiedniki pól z dopiskiem CP z wyższej sekcji, wyciągnięte na poziom główny dla łatwiejszego raportowania):
- • LCUR: Kod lokalnej waluty (24).
- • PAN: Zmaskowany numer karty (535233******8125).
- • HOSTTYPE: Identyfikator hosta rozliczeniowego (12).
- • HOSTBOOKPER: Okres księgowania operacji (113).
- • AUTH: Kod autoryzacji bankowej (001138).
- • CERT: Unikalny identyfikator certyfikatu płatności (25122112C70034EB).
- • HOSTREF: Referencja systemowa hosta finansowego (030614757248).
- • CAIC: Kod identyfikacyjny terminala (048214101).
- • ONLINERC: Kod powrotny z banku (000 = Transakcja zaakceptowana).
- • STAN: Numer audytowy transakcji finansowej (019511).
- • PINA: Status PIN (1).
- • REPL: Status powtórzenia/odpowiedzi (2).
- • SLSTOT: Suma całej sprzedaży (Sales Total) – (305.79 zł).