API-Schnittstelle (Vending)

Von EVA-DTS zur REST-API

Der EVA-DTS-Standard der European Vending & Coffee Service Association (EVA), entwickelt in Kooperation mit der US-amerikanischen NAMA, definiert seit den 1990er-Jahren ein herstellerneutrales Datenformat für Automaten- und Zahlungssystemdaten: Umsatz, Füllstand, Störmeldungen, Kassenbestand. Übertragen wird es über das DDCMP-Protokoll — klassisch lokal per USB-Stick oder Handheld direkt am Gerät (DEX-Auslesung), heute zunehmend per Mobilfunkmodul aus der Ferne.

Moderne VMS-Plattformen kapseln diese Rohdaten in eine REST-API: Endpunkte liefern strukturierte Daten (meist JSON) über HTTPS, der Zugriff wird per OAuth 2.0 — Token statt Passwort — abgesichert. Damit lassen sich Verkaufszahlen, Lagerbestände und Servicefälle je nach Anbieter nahezu in Echtzeit oder im Stunden- bis Tagesrhythmus in ERP-, Buchhaltungs- oder BI-Systeme ziehen, ohne dass jemand eine Exportdatei von Hand hochlädt.

Was über die Schnittstelle typischerweise fließt

• Transaktionsdaten: Produkt, Preis, Zahlungsart, Zeitstempel
• Füllstände und Nachfüllbedarf je Fach oder Spirale
• Störmeldungen und Betriebszustände (Out-of-Service, Fehlercodes)
• Bei cashless-fähigen Geräten aggregierte Zahlungsdaten zur Abstimmung mit dem Payment-Provider

Datenformat und Anbieterwechsel

EVA-DTS liefert feste Textdatensätze (etwa ID1, PA1, PA2 für Produkt- und Verkaufsdaten) statt eines flexiblen Objektmodells — für die Integration in moderne Systeme müssen diese Datensätze erst geparst und auf das Zielschema gemappt werden, entweder durch die VMS-Plattform selbst oder durch eine Middleware dazwischen. Das ist der Grund, warum reine EVA-DTS-Anbindungen in der Praxis selten direkt an ein ERP gehen, sondern über eine REST-Schicht laufen, die genau dieses Mapping übernimmt.

Ein oft übersehener Punkt beim Anbieterwechsel: Nicht jede API gibt historische Daten vollständig heraus. Wer die Telemetrie- oder VMS-Plattform wechselt, sollte vorab klären, ob sich Verkaufs- und Servicehistorie vollständig exportieren lassen oder ob nur laufende Daten ab dem Umstellungstag verfügbar sind — sonst reißt die Zeitreihe für Reporting und Vorjahresvergleiche.

Bewertungskriterien für Betreiber

Bei der Auswahl zählen drei Dinge: welche Daten überhaupt herausgegeben werden, wie aktuell sie sind, und ob die Nutzung im Vertrag enthalten oder gesondert berechnet wird. Der dritte Punkt wird am häufigsten übersehen. Bei kleineren VMS-Anbietern ist der API-Zugriff nicht immer im Basispaket enthalten, sondern wird pro angebundenem Fremdsystem oder pro Abfragevolumen abgerechnet — das entscheidet am Ende, ob eine Anbindung an das eigene ERP wirtschaftlich bleibt oder die eingesparte manuelle Arbeit wieder auffrisst.

Ohne Schnittstelle bleibt nur der Umweg über manuelle Exporte: Verkaufszahlen werden aus dem VMS als Tabelle gezogen, per E-Mail weitergegeben und irgendwann von Hand in die Buchhaltung nachgetragen — mit entsprechendem Zeitverlust und Fehlerpotenzial bei jeder Übertragung.