DEXファイルとは？自動販売機オペレーター向けガイド
DEXファイルは、自動販売機が自分自身について作成する監査記録です。これまでに何回販売したか、いくら現金を受け取ったか、各商品がいくらで何個売れたか、どのエラーを記録したかが含まれます。形式はDEX/UCSで、EVA-DTS規格に準拠したデータを含みます。一度読み方がわかれば、前回の訪問以降に機械が何をしたかを知るために手作業で数える必要はなくなります。
名称の由来
DEX は Direct Exchange の略で、 UCS Uniform Communication Standard の略です。この名称の組み合わせは、1990年代初頭に食料品業界から借用されたものです。全米自動販売協会（National Automatic Merchandising Association）が、ルート担当の運転手が機械式カウンターを開けずに自動販売機の数値を読み取れる方法を必要としていたためです。ファイル内のデータは次の形式に従っています EVA-DTS（European Vending Association Data Transfer Standard）。実際には同じものを指すため、両方の名称が使われるのを目にするでしょう。「DEXファイル」「DEX読み取り」「DEX監査」「EVA-DTSファイル」は、いずれも同じ意味で使われています。
過去25年間に製造されたほぼすべてのスナック、飲料、食品の自動販売機は、これを生成できます。古い機種はコントローラー基板のDEXポートを通じて提供します。新しい機種や、ほとんどのカードリーダー・テレメトリ機器は同じファイルを生成し、携帯電話網を通じて送信します。
DEXファイルの中身
テキストエディタで開くと、1行に1レコードずつ並んだプレーンテキストファイルが表示されます。各レコードはコードの後にアスタリスクで区切られたフィールドが続く形式です。外枠は DXS で始まり、 DXEで終わり、その間に実際の内容が入ります。 ST および SE 短い例は次のようになります:
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オペレーターにとって重要なレコードの種類:
| 記録 | 送信内容 | これが重要な理由 |
|---|---|---|
ID1 | マシンのシリアル番号、機種、ソフトウェアビルド | 誰も入力せずに、ファイルを正しいマシンに対応付けます |
ID4 | 通貨と、金額フィールドで使われる小数点以下の桁数 | 125 が 1.25 を意味するのか、125 を意味するのかを示します |
VA1 | 初期化以降、および前回リセット以降の、売上の合計金額と販売回数 | マシンの主要な売上数値 |
CA2 / CA3 / CA4 | 現金売上、現金入金(紙幣と硬貨)、現金出金(支払った釣銭、金庫への移送) | 開けたときに現金ボックスにあるべき金額 |
DA2 | キャッシュレス売上(カードリーダー) | カード決済事業者の明細と照合します |
PA1 – PA5 | 各商品選択:その ID と価格、続いて販売数と金額、さらに値引き、テスト販売、無料販売 | 商品コイル(スロット)ごとの売上。これが補充リストの元になります |
EA1 – EA7 | イベント:扉の開放、電源断、紙幣詰まり、売り切れ、およびそれが発生した時刻 | 訪問と訪問の間にマシンが停止した理由 |
MA5 | メーカー固有のフィールド | 例えば飲食用マシンの温度。形式はメーカーによって異なります |
G85 | それより上のすべての内容に対する CRC-16 チェックサム | 転送中にファイルが切り捨てられたり破損したりしていないことを証明します |
区間カウンターおよび累積カウンター
ほとんどの集計レコードには2組の数値が含まれています。マシンの初期化以降の数値と、前回リセット以降の数値です。通常、読み取りによって区間カウンターはリセットされるため、「前回リセット以降」のフィールドを見れば2回の訪問の間に何が起きたかが正確にわかります。また「初期化以降」のフィールドを使えば、読み取りの取りこぼしを検出できます。ソフトウェアが累積カウンターしか見ていない場合は、連続するファイル間の差分を計算し、負の差分はボードのリセットやコントローラーの交換によるものとして扱うべきで、決してマイナスの売上として扱ってはいけません。
DEX ファイルがマシンからあなたの手元に届くまで
一般的な方法は3つあり、ほとんどのルートでは複数の方法を併用しています。
- マシン側で 最も古い方法は、訪問時に携帯端末を DEX ポートに接続するものです。より一般的な現代の方法は、読み取りデータを保存し、Bluetooth や Wi-Fi でスマートフォンに送るか、ファイルとしてエクスポートできるテレメトリー機器やカードリーダーです。いずれの場合も、マシン1台・訪問1回ごとに1つの
.dexまたは.txtファイルが得られます。 - 無線経由で Nayax、Cantaloupe、PayRange などのカードリーダーは、スケジュールに従ってコントローラーから DEX の読み取りデータを取得し、アップロードします。オペレーター向けポータルはコイルごとの在庫数を表示し、一部のベンダーはこれを API で公開しているため、他のソフトウェアからも取得できます。
- 独自の API 経由で テレメトリボックスや開発者向けフィードを備えたリーダーをお使いの場合、最も簡単な構成は、ファイルを取得した時点で生データをエンドポイントへ送信するデバイスです。これなら、ファイルを持ち運ぶ必要がありません。
活用方法
DEXファイルの価値はファイルそのものにはありません。数えなくても答えられる3つの問いにこそあります。
- 各コイルの販売数は？ 前回訪問以降の
PA2販売数を、前回の補充時の在庫量から差し引けば、誰かがドアを開ける前に全セレクションの現在在庫がわかります。これは、機械の前ではなく倉庫で作成するピックリストの基礎になります。 - 箱の中には現金がいくら入っているべきか？
CA3マイナスCA4、またはマシンが報告している場合はcash-to-boxフィールドの値が、ドライバーが回収すべき金額です。実際に数えた金額と比べれば、四半期ごとの見直しを待たず、最初の訪問時点で現金の不足（シュリンク）が見つかります。 - マシンが停止したのはなぜか？ アカウントに保存した
EAイベントにはタイムスタンプが付いています。訪問の3日前に売上がゼロになり、同じ時刻に紙幣識別機の詰まりが記録されているマシンは、死んだ設置場所ではなく修理が必要な機械です。
問題が起きやすい箇所
DEXは標準規格ですが、方言があります。以下のような違いを想定し、それらを失敗ではなく警告として扱うソフトウェアを選んでください：
- 一部のコントローラーは
ID4を省略するため、リーダーは通貨と小数点以下の桁数を推測する必要があります。別の機種では、明らかにセント単位がある通貨なのに、小数点以下の桁数をゼロで送信してきます。 - メーカーは独自のレコードを追加したり、標準レコードに余分なフィールドを加えたりします。厳密なパーサーはファイル全体を拒否しますが、寛容なパーサーは標準のフィールドを残し、それ以外にフラグを立てます。
- 販売途中に取得したファイルや、途中で途切れたモバイル回線のアップロードは、
G85チェックサムの検証に失敗します。推測せず、そのファイルを破棄して取り直してください。 - セレクションIDが、コイルに印字された番号と一致しないことがあります。対応表はマシンごとに一度作成し、保管しておいてください。
- コントローラーを交換すると、すべての累積カウンターがリセットされます。大きな負の販売数を黙って記録するソフトウェアは、その事態に気づいていません。
Vending RouteでのDEXファイルの活用方法 Vending Route EVA-DTSファイルを直接読み込みます。ドライバーが訪問画面でファイルを追加するか、任意のデバイスが生ファイルを運営のインジェストAPIに送信すると、読み取りデータは、マシンの ID1 シリアル。商品選択ごとの売上で在庫推定値を減らし、集金箱の現金はドライバーが回収した金額と照合します。マシンページのすべての数値には、DEX読み取り、Nayax同期、インポート、手動カウント、推定のいずれから得られたかが表示されます。購入が必要なケーブルやシリアルアダプターはありません。DEXの読み取りデータはファイルまたはAPI経由で届きます。最大3台のマシンまで無料で Webアプリで、スマホアプリはGoogle Playから利用できます。 Vending Routeについて詳しく見る.
その他のガイド： Adelyons のすべてのガイド