Zum Inhalt springen

Schnittstellen & API für Verkaufsautomaten Alles verbunden.

Steuer das Terminal aus deiner eigenen Software, frag deine Automaten per KI, binde es direkt an deinen Automaten an oder lass deine Kasse darüber kassieren. SENVEND Payment Terminal und my.SENVEND passen sich in die Systeme ein, die du schon nutzt.

KI-Assistent · MCP Cloud-API · bald Software · gRPC Automat · MDB Kasse · ZVT

Software-Anbindung · gRPC-API

Programmier dein Terminal.

Über die SENVEND API steuert deine eigene Software das Payment Terminal direkt im lokalen Netzwerk: Zahlung starten, Alter prüfen, Ware über MDB ausgeben. Die Verkäufe landen wie gewohnt in my.SENVEND.

Mitschnitt einer Zahlung mit Altersprüfung

  1. Software · Start · +0,00 s{"start": {"amount": 100, "age_verification": {"min_age": 18}}}Kassiere 1,00 €, prüf vorher das Alter ab 18.
  2. Terminal · Altersprüfung · +0,05 sageApiSuccess: VERIFICATION_STARTEDKunde wählt seinen Altersnachweis.
  3. Terminal · Alter bestätigt · +6,40 s{"ageSuccess": {}}Alter passt.
  4. Terminal · Zahlung · +6,42 sapiSuccess: PAYMENT_STARTEDKunde hält die Karte vor.
  5. Terminal · Freigabe · +9,10 s{"approved": {"amount": 100}}Bezahlt: 1,00 €.
  6. Software · Ware ausgegeben · +11,30 s{"goods_issued": {}}Ware ist raus.
  7. Terminal · Bestätigung · +11,31 sapiSuccess: GOODS_ISSUED_ACCEPTEDVerstanden.
  8. Terminal · Abschluss · +11,35 s{"success": {}}Vorgang abgeschlossen.

Vereinfacht: ohne Vorgangs-ID, Statusmeldungen gekürzt, die Zeiten sind Beispielwerte.

  • Bezahlen

    Zahlung starten, Betrag bis zur Freigabe anpassen und Bargeld für die Auswertung mitmelden.

  • Altersprüfung

    Allein oder vor der Zahlung. Dein Kunde wählt am Terminal aus allen eingerichteten Methoden.

  • Warenausgabe

    Deine Software gibt Ware über den angeschlossenen MDB-Automaten aus, einzeln oder als Liste.

  • Bald

    Cloud-API

    Dieselben Abläufe über das Internet, ohne lokales Netzwerk. Die Definitionen liegen schon auf GitHub.

Offen auf GitHub Proto-Definitionen, Doku mit Beispielabläufen und Beispiel-Clients für Rust, Python, Kotlin und C#. Fertige Pakete gibt’s auf crates.io, PyPI, Maven Central und NuGet.

KI-Anbindung · MCP

Frag einfach deine Automaten.

Über MCP, den offenen Standard für KI-Anbindungen, verbindest du deine KI mit my.SENVEND, zum Beispiel Claude oder ChatGPT. Du meldest dich mit deinem my.SENVEND-Login an, einen Schlüssel brauchst du nicht.

  • Nur lesen
  • Nur deine Daten
  • Claude & Co.
  • Zugang inklusive

Beispielfragen

  • „Welche Automaten sind gerade fast leer?“
  • „Welche Produkte laufen am Bahnhof gut und am Campus gar nicht?“

Mehr Daten. Mehr Möglichkeiten.

Über die MCP-Anbindung kann deine KI auch Daten abfragen und kombinieren, die in der Oberfläche von my.SENVEND nicht direkt verfügbar sind. Deine Benutzerrechte gelten dabei weiterhin.

Hinweis

Für die KI selbst brauchst du ein eigenes Konto bei Claude, ChatGPT & Co., je nach Tarif kostenpflichtig.

Telemetrie

Beispiele ansehen

Sechs Anwendungsfälle, jeweils mit einer möglichen Unterhaltung mit deiner KI: Standorte vergleichen Kasse prüfen Preise bewerten Ausfälle finden Ladenhüter erkennen Neuen Automaten planen

Automatenanbindung · MDB

Der Standard im Automaten.

Über MDB spricht dein Automat mit Bezahlgeräten wie Münzwechsler, Scheinleser und Kartenterminal. Wie das SENVEND Payment Terminal dabei arbeitet, dokumentieren wir offen auf GitHub – für Automatenhersteller und Integratoren.

Mitschnitt eines Verkaufs

  1. Automat · Vend Request · +0,00 s13 00 00 64 00 01Fach 1 gewählt, 1,00 €. Zahlt der Kunde?
  2. Terminal · ACK · +0,01 s00Verstanden.
  3. Terminal · Vend Approved · +2,41 s05 00 64Bezahlt, gib die Ware aus.
  4. Automat · ACK · +2,41 s00Ok.
  5. Automat · Vend Success · +4,02 s13 02 00 01Ware ist raus.
  6. Terminal · ACK · +4,02 s00Verstanden.
  7. Automat · Session Complete · +4,20 s13 04Vorgang beendet.
  8. Terminal · ACK · +4,20 s00Alles klar.

Vereinfacht, ohne Abfragen (POLL) und Prüfsummen, die Zeiten sind Beispielwerte.

  • Kartenzahlung (Cashless)

    Wie das Terminal am Automaten als bargeldloses Zahlungsgerät arbeitet.

  • Altersprüfung

    Wie Altersprüfung und Automat über MDB zusammenspielen.

  • Altersprüfgerät

    Die Anbindung als eigenes Altersprüfgerät am Bus (Age Verification Device).

Offen auf GitHub Die komplette MDB-Dokumentation liegt offen auf GitHub. Fehlt dir etwas? Issues und Pull Requests sind willkommen.

MDB-Adapter · Hardware

Ein Adapter. Alles verbunden.

Der SENVEND MDB-Adapter verbindet Terminal, Automat und Bargeldgeräte. Er sorgt für eine zuverlässige Kommunikation und ermöglicht die Integration auch dort, wo sie bisher schwierig war.

SENVEND UX700USB-C2-POLIGAUTOMATGERÄTEMDB-AdapterAutomat (VMC)Bargeldgeräte1234
  1. 1USB-Kabel vom Terminal zum Adapter
  2. 2Stromkabel vom Terminal zum Adapter
  3. 3Automat am rechten MDB-Port
  4. 4Bargeldgeräte am linken MDB-Port
Platine des SENVEND MDB-Adapters von oben: links USB-C-Buchse und zweipoliger Stromanschluss, in der Mitte der Mikrocontroller RP2350, rechts die beiden MDB-Buchsen.
  1. AUSB-C: Daten zum Terminal
  2. BStrom vom Terminal (2-polig)
  3. CRP2350: Raspberry-Pi-Mikrocontroller
  4. DMDB-Buchsen: Automat und Bargeldgeräte

Das Gerät selbst: MDB-Adapter in der Hardware-Übersicht

  • Stabile Verbindung

    Kartenzahlung, Altersprüfung und Automat verstehen sich zuverlässiger, auch bei Automaten, die sonst Probleme machen.

  • Bargeld läuft weiter

    Münzwechsler und Scheinleser werden am Adapter angeschlossen und funktionieren wie bisher.

  • Kein eigenes Netzteil

    Strom kommt über die MDB-Buchse des Terminals, Daten über USB-C. Die Kabel liegen bei, dazu brauchst du nur ein USB-Kabel von A auf C.

Bald

Master-Telemetrie

In naher Zukunft wird mit dem Adapter auch eine Master-Telemetrie möglich.

Kassenanbindung · ZVT

Deine Kasse. Unser Terminal.

Du hast eine eigene Kasse oder Bezahlstation? Über ZVT, den Standard für Kartenterminals in Deutschland, kassiert sie mit dem SENVEND Payment Terminal. Dazwischen sitzt unser ZVT-Proxy.

Mitschnitt einer Kartenzahlung

  1. Kasse · Autorisierung · +0,00 s06 01 07 04 00 00 00 00 01 00Kassiere bitte 1,00 €.
  2. Terminal · ACK · +0,02 s80 00 00Verstanden.
  3. Terminal · Zwischenstatus · +1,84 s04 FF 01 0AKunde hält die Karte vor.
  4. Kasse · ACK · +1,85 s80 00 00Ok.
  5. Terminal · Statusinformation · +3,91 s04 0F …Bezahlt. Hier die Belegdaten.
  6. Kasse · ACK · +3,92 s80 00 00Erhalten.
  7. Terminal · Abschluss · +4,11 s06 0F 00Fertig.
  8. Kasse · ACK · +4,11 s80 00 00Alles klar.

Vereinfacht: Der ZVT-Proxy dazwischen ist ausgeblendet, die Zeiten sind Beispielwerte.

  • ZVT-Proxy

    Deine Kasse verbindet sich per TCP mit SENVEND (Port 20000), nicht direkt mit dem Terminal.

  • Was durchgeht

    Zahlung, Rückbuchung, Diagnose und Abbruch leitet der Proxy weiter. Altersprüfung und Sprache beantwortet SENVEND selbst.

  • Gemeinsam einrichten

    Die Terminal-ID vergibt SENVEND. Schreib uns an api@senvend.com, wir richten die Anbindung mit dir ein.

Offen auf GitHub Dokumentation und Test-Tool zvt_cli für Linux und Windows liegen offen auf GitHub. Fehlt dir etwas? Issues und Pull Requests sind willkommen.

Häufige Fragen

Was du wissen willst.

Was kann die API?

Deine Software startet über das lokale Netzwerk Zahlungen, Altersprüfungen und die Warenausgabe über MDB, direkt am SENVEND Payment Terminal. Die Verkäufe erscheinen wie gewohnt in my.SENVEND. Eine Cloud-API für den Zugriff über das Internet folgt.

Was kostet die KI-Anbindung?

Nichts extra. Die KI-Anbindung (MCP) ist in SENVEND Telemetrie enthalten. Für die KI selbst brauchst du ein eigenes Konto bei Claude, ChatGPT & Co., je nach Tarif kostenpflichtig.

Brauche ich Programmierkenntnisse?

Für die KI-Anbindung nicht: Adresse eintragen, mit my.SENVEND anmelden, fertig. Die API richtet sich an Entwickler. Die Kassenanbindung über ZVT und die MDB-Anbindung richten Kassen- oder Automatentechniker ein, gemeinsam mit uns.

Kann die KI etwas an meinen Automaten ändern?

Nein. Die KI-Anbindung ist reiner Lesezugriff. Terminal neu starten, Ware ausgeben oder Guthaben buchen geht weiterhin nur direkt in my.SENVEND.

Welche KI-Assistenten werden unterstützt?

Grundsätzlich jeder MCP-fähige Assistent. Schritt-für-Schritt-Anleitungen für Claude und ChatGPT findest du im Hilfezentrum zur KI-Anbindung.

Was passiert mit meinen Daten?

Du siehst nur die Daten deines Unternehmens, mit denselben Rechten wie in my.SENVEND. Deine Fragen und die Antworten daraus verarbeitet der KI-Anbieter, den du verbindest, zum Beispiel Anthropic oder OpenAI. Dafür gelten dessen Datenschutzbestimmungen. Welche Fragen du stellst, entscheidest du selbst.

Brauche ich den MDB-Adapter?

Nicht immer. Bei vielen Automaten läuft das Terminal direkt über MDB. Bei manchen macht der Adapter die Verbindung stabiler, bei einigen überhaupt erst möglich. Ob du ihn brauchst, klärst du am besten mit deinem Fachhändler.

Was kosten die Kassen- und die MDB-Anbindung?

Das hängt von deinem Projekt ab. Schreib uns an api@senvend.com, dann machen wir dir ein Angebot.

Bereit zum Verbinden?

Neu bei SENVEND

Entdecke unsere Pakete und Preise.

Pakete ansehen

Schon Kunde?

Verbinde my.SENVEND mit deinem KI-Assistenten und frag einfach drauflos.

Zu my.SENVEND

Du planst eine Integration?

Erzähl uns von deinem Projekt, wir finden mit dir den passenden Weg.

Projekt anfragen