Czym jest plik DEX? Przewodnik dla operatorów automatów sprzedających

Plik DEX to zapis audytowy, który automat sprzedający wytwarza o sobie: ile sprzedaży zrealizował, ile pieniędzy przyjął, co sprzedała każda pozycja i po jakiej cenie oraz jakie błędy zarejestrował. Format to DEX/UCS, z danymi zapisanymi zgodnie ze standardem EVA-DTS. Gdy umiesz go odczytać, nie musisz już ręcznie liczyć automatu, żeby wiedzieć, co się działo od ostatniej wizyty.

Skąd wzięła się nazwa

DEX oznacza Direct Exchange, a UCS for Uniform Communication Standard. The pair was borrowed from the grocery industry in the early 1990s, when the National Automatic Merchandising Association needed a way for route drivers to pull a machine's figures without opening a mechanical counter. The data inside the file follows EVA-DTS, czyli European Vending Association Data Transfer Standard, dlatego zobaczysz obie nazwy używane wymiennie dla tego samego. Ludzie mówią zamiennie „plik DEX”, „odczyt DEX”, „audyt DEX” i „plik EVA-DTS”.

Prawie każdy automat ze snackami, napojami i jedzeniem zbudowany w ciągu ostatnich dwudziestu pięciu lat potrafi wygenerować taki plik. Starsze automaty udostępniają go przez port DEX na płycie sterownika; nowsze automaty oraz większość czytników kart i urządzeń telemetrycznych tworzą ten sam plik i wysyłają go przez sieć komórkową.

Co zawiera plik DEX

Otwórz go w edytorze tekstu, a zobaczysz zwykły plik tekstowy, jeden rekord w wierszu; każdy rekord to kod, po którym następują pola oddzielone gwiazdkami. Koperta zaczyna się od DXS i kończy się DXE, a właściwa zawartość znajduje się pomiędzy nimi ST oraz SE Krótki wygląda tak:

DXS*1234567890*VA*V0/6*1
ST*001*0001
ID1*VMC12345678*MODEL-X*1234
ID4*2*USD
VA1*1842750*31204*49800*842
CA2*1250300*21855*31200*521
PA1*10*125
PA2*412*51500*8*1000
PA1*12*150
PA2*96*14400*2*300
EA1*EGS*20261014*0812
G85*A1F0
SE*12*0001
DXE*1*1

Typy rekordów ważne dla operatora:

Liczniki interwałowe i skumulowane

Większość rekordów zliczających zawiera dwa zestawy liczb: wartość od inicjalizacji maszyny oraz wartość od ostatniego resetu. Odczyt zwykle zeruje liczniki interwałowe, więc pola „od ostatniego resetu” pokazują dokładnie, co zdarzyło się między dwiema wizytami, a pola „od inicjalizacji” pozwalają wykryć pominięty odczyt. Jeśli Twoje oprogramowanie analizuje tylko liczniki skumulowane, powinno obliczać różnicę między kolejnymi plikami i traktować ujemną różnicę jako reset płytki lub wymianę sterownika, nigdy jako ujemną sprzedaż.

Jak plik DEX trafia od maszyny do Ciebie

Są trzy typowe ścieżki, a większość tras korzysta z więcej niż jednej.

1. Przy maszynie. Najstarszy sposób to przenośne urządzenie podłączane do portu DEX podczas wizyty. Bardziej powszechnym, nowoczesnym odpowiednikiem jest urządzenie telemetryczne lub czytnik kart, który zapisuje odczyt i przekazuje go do telefonu przez Bluetooth lub Wi-Fi albo pozwala wyeksportować go jako plik. W obu przypadkach otrzymujesz .dex lub .txt plik na maszynę i na wizytę.
2. Bezprzewodowo. Czytniki kart Nayax, Cantaloupe, PayRange i innych pobierają odczyt DEX ze sterownika według harmonogramu i go przesyłają. Portal operatora pokazuje wtedy stan magazynowy dla każdej spirali, a niektórzy dostawcy udostępniają to przez API, dzięki czemu inne oprogramowanie może to pobrać.
3. Przez własne API Jeśli używasz urządzenia telemetrycznego lub czytnika z kanałem deweloperskim, najwygodniejszym rozwiązaniem jest urządzenie, które wysyła surowy plik do punktu końcowego natychmiast po jego pobraniu, dzięki czemu nikt nie musi nosić plików ze sobą.

Co z tym zrobić

Wartość pliku DEX nie tkwi w samym pliku, lecz w trzech pytaniach, na które odpowiada bez liczenia.

• Co sprzedała każda spirala? Odejmij PA2 sprzedane od ostatniej wizyty sztuki od ostatniego stanu napełnienia, a otrzymasz aktualny stan każdej pozycji, zanim ktokolwiek otworzy drzwiczki. To podstawa listy kompletacyjnej przygotowywanej w magazynie, a nie przy automacie.
• Ile gotówki powinno być w skarbonce? CA3 minus CA4, lub pole gotówki w skarbonce, jeśli automat je raportuje, to kwota, którą kierowca powinien odebrać. Porównaj ją z tym, co faktycznie zostało policzone, a problem z ubytkami wyjdzie już przy pierwszej wizycie, a nie dopiero w kwartalnym przeglądzie.
• Dlaczego automat przestał działać? Te EA zdarzenia mają znaczniki czasu. Automat, którego sprzedaż spadła do zera trzy dni przed wizytą, a w tym samym czasie zarejestrowano zacięcie walidatora banknotów, wymaga naprawy, a nie oznacza martwej lokalizacji.

Elementy, które się psują

DEX to standard z dialektami. Spodziewaj się poniższych sytuacji i wybieraj oprogramowanie, które traktuje je jako ostrzeżenia, a nie błędy:

• Niektóre sterowniki pomijają ID4, więc czytnik musi założyć walutę i liczbę miejsc po przecinku. Inne wysyłają je z zerem miejsc po przecinku przy walucie, która wyraźnie ma grosze.
• Producenci dodają własne rekordy lub umieszczają dodatkowe pola w standardowych. Ścisły parser odrzuca cały plik; tolerancyjny zachowuje standardowe pola i oznacza resztę.
• Plik pobrany w trakcie sprzedaży albo przesłany przez sieć komórkową i przerwany, nie przechodzi G85 sumy kontrolnej. Odrzuć go i pobierz ponownie zamiast zgadywać.
• Identyfikatory selekcji nie zawsze odpowiadają numerowi wydrukowanemu na spirali. Utwórz mapowanie raz dla każdego automatu i zachowaj je.
• Wymiana sterownika zeruje wszystkie liczniki skumulowane. Oprogramowanie, które po cichu zapisuje dużą ujemną liczbę sprzedaży, tego nie zauważyło.

Więcej poradników: wszystkie poradniki Adelyons