3rd Party eCommerce API
Diese eCommerce Anbindung ist als Webservice ausgeführt. Sie stellt anderen Systemen die in Hypersoft verwendeten Stammdaten des Artikelstamms und angrenzende Informationen zur Verfügung. Als Rückkanal empfängt sie die Buchungen oder Bestellungen als Bewegungsdaten
Bewegungsdaten sind meist zeitlich relevant und liefern die Informationen für Auswertungen. In der Hypersoft-Suite z.B.Kassenbuchungen.. Hiermit werden Self Order Terminals, Order Services auf Smartphones, Lieferservices, sowie Kassensysteme anderer Hersteller integriert.
Die bekannte Funktionstiefe von Hypersoft findet sich auch in der eCommerce Schnittstelle wieder, da Hypersoft sie ebenfalls für die eigenen eCommerce Programme verwendet. Deshalb verfügen die Artikeldaten zum Beispiel über zusätzlich Informationen wie Preisebenen, Abfragen (Modifier), und zahlreiche weitere wie Bildkanäle und Textbeschreibungen (auch als HTML).
Bei der Rückgabe der Buchungen an Hypersoft werden unter anderem auch Mehrwertsteuer, Menükartenwechsel, Abfragen und freie Anhänge unterstützt. Alle Buchungen werden entsprechend dem Einsatzort (Land) rechtskonform gespeichert. Die Bestellungen erscheinen im Programm Online Order, und können dort je nach Channel automatisch weitergeleitet oder manuell eingecheckt werden:
Der technische Zugang zur Schnittstelle wird 3rd Parties auf Anfrage zur Verfügung gestellt. Die Grundsätzliche Beschreibung finden Sie auf der Seite 3rd Party eCommerce Entwicklung.
Für weiterreichende Anbindungen gibt es auch Schnittstellen für Kundendaten und Reservierungen und anderes: 3rd Party Kunden, Reservierung, Tickets API, Externes Bestellsystem, Interface 55: MOBILE PEOPLE Kundendaten API, Interface 56: MOBILE PEOPLE Reservierung API.
Die Hypersoft Systemlösung
Die Hypersoft Systemlösung wird auf Grund der Komplexität und des standortübergreifenden Aufbaus im Standard (Best Practice) auf unterschiedlichen Ebenen (siehe Abbildung 1) betrachtet. Die 3rd Party Anbindung ist auf Grundlage dieser Dokumentation in die Hypersoft Systemlandschaft implementiert.
Zielbestimmung
Diese Dokumentation hat zum Ziel, die angebundene 3rd-Party Schnittstelle in ihrer aktuellen Funktionsweise zu beschreiben. Hierbei wird primär die Hypersoft Perspektive betrachtet, welche unter entsprechenden Restriktionen als Hypersoft Best Practice freigegeben ist.
Insofern sich Abweichungen zum freigegebenen Hypersoft Best Practice ergeben, so sind diese im Rahmen eines Change Request Verfahrens zu bearbeiten. Alle Abweichungen von den hier beschriebenen Funktionsweisen sind durch Hypersoft nicht zertifiziert und nicht für den Markt freigegeben.
Betriebsebene
Zugangspunkt/ externe Systeme...
Die in diesem Dokument beschriebene Schnittstelle kommuniziert derzeit ausschließlich aus der Betriebsebene. Folglich müssen entsprechende Zugänge als Grundlage zur Kommunikation der Schnittstelle gewährleistet sein.
Voraussetzungen zur Nutzung des eCommerce-Interfaces
Bitte Buchen Sie für die Anbindung (zwei bis drei Tage Support (je nach Aufgabenstellung kann dies auch mehr werden) der Hypersoft Entwicklungsabteilung. Hiermit können wir Ihnen mit dem Aufbau einer Testumgehung, Beantwortung von Fragen und gegebenenfalls Zertifizierung dienlich sein.
- Schriftliche Beschreibung der gewünschten Funktion sowie des Workflows
- Enterprise Supportstufe (Mindestlaufzeit 12 Monate)
- Unterzeichneter LOI (Letter of Intent) zwischen dem Technologiepartner und Hypersoft
- Nennung der technischen Ansprechpartner/ Entwickler des Technologiepartners
- Beauftragung von (mindestens) 3 Tagen Support & Entwicklungsunterstützung
Sobald die oben genannten Anforderungen erfüllt sind, erfolgen folgende Schritte:
- Bereitstellung einer virtuellen Kasse. *1
- Freischaltung aller Lizenzen für den unproduktiven Einsatz
- Schulung der Hypersoft Basics (mittels Teamviewer oder ähnlichem)
- Vorgespräch zwischen unserer, sowie der Entwicklungsabteilung des Technologiepartners
- Übergabe der eCommerce Schnittstellenbeschreibung
- Unterstützung der Anbindung seitens des Technologiepartners
- Gemeinsame unproduktive Tests
- going-Live & Projektabschluss
*1 = Wir stellen Ihnen eine Virtuelle Kasse Online für Testzwecke zur Verfügung. Dies erfolgt im Standard für 12 Monate und kann im Ausnahmefall verlängert werden. Nach dieser Zeit betrachten wir die Anzahl der Kunden, die wir mit Ihrer Anbindung gemeinsam betreuen. Wenn aus der Zusammenarbeit ein entsprechender Erfolg erwirkt wurde, können wir diese Leistung kostenfrei fortsetzen. Andernfalls können wir Ihnen dann die Fortsetzung unseres Services mit einer Kostenpauschale anbieten.
Dieses Thema betrifft planungspflichtige Projektarbeit.
Das Hypersoft // System ist ein Standardprogramm, das in vielen verschiedenen Konfigurationen eingesetzt werden kann. Die korrekte Anwendung der hier beschriebenen Themen erfordert Expertenwissen und einen Abgleich der Erwartungen und nicht alle Hypersoft Mitarbeiter und Partner sind in allen so gekennzeichneten Themen gleichermaßen geschult. Aus diesem Grund kennzeichnen wir diese Themen als planungspflichtige Projektarbeit, damit Sie sich rechtzeitig mit dieser notwendigen Planung an Ihren Hypersoft Vertriebspartner oder den Hypersoft Support wenden können. Diese Vorgehensweise stellt sicher, dass wir Ihre Anforderungen entsprechend sorgfältig aufnehmen und zielorientiert beantworten.
eCommerce Anbindung einige wichtige Funktionen
| Funktionen |
Status |
| Artikeldaten pro Standort | ja |
| Artikeltexte detailliert | ja |
| Allergene und Zusatzstoffe pro Artikel und Rezeptur | ja |
| Artikel eines Vorgangs abrufen und ergänzen | ja |
| Bestandsinformationen und Mengenkontrolle | ja |
| Bezahlstatus übermitteln | ja |
| Fiskalische Signierung von Buchungen | Link... |
| Kundendaten | ja |
| Mehrere 3rd Party Channels an einem Kassensystem | ja |
| Nährwerte pro Artikel und Rezeptur | ja |
| Schankanlagenanbindung | ja |
| Superheldenfunktion | ja |
| Trinkgelder | ja |
| Tischnummern (mit Pagernummern) | ja |
| Warengruppen (auch Haupt- und Untergruppen inklusive Bilderkanal) | ja |
Sofern Sie für Ihre Lösung diese Techniken und Daten verwenden sind die dazugehörigen Stamminformationen aus dem Hypersoftsystem zu beziehen. Das Nichtverwenden bereitgestellter Ressourcen im Zusammenhang mit "manueller Ergänzung" zum Beispiel bei Artikelbildern ist in Verbindung mit der Nutzung eines Hypersoft POS Systems nicht vorgesehen. Da aber jeder eCommerce Partner den Leistungsumfang selbst bestimmt und auch nicht alle bereitgestellten Funktionen benötigt, empfehlen wir Ihnen dringend einen Erwartungsabgleich durchzuführen.
Methoden zur Kooperation mit dem eCommerce Partner
Tabellarische Übersicht der Komponenten und Funktionen einiger unserer eCommerce Partner und der Hypersoft Programme. Hypersoft verwendet die selben Schnittstellen wie die 3rd Parties, so dass es sich für alle um belastbare Standard Technologie handelt. Aber jede 3rd Party entscheidet den Umfang der unterstützen Leistungen selbst, so dass wir Ihnen in dieser Tabelle und in der Tabelle Funktionsvergleich im Online Order Bereich einen ungefähren Eindruck der aus unserer Sicht unterstützten Funkionen je 3rd Party geben:
| Funktionen und Software | Yoordi | ||
| Artikelstammdaten von Hypersoft | ja | ja | ja |
| Artikelabfragen konform zu POS (Zwang und Mehrfach) | nicht bekannt | ja | nicht bekannt |
| Artikel Preis- und Textänderungen | nicht bekannt | nicht bekannt | nicht bekannt |
| Artikelbilder von Hypersoft | nein | ja | nein |
| Artikel Warengruppenbilder von Hypersoft | nicht bekannt | nein | nicht bekannt |
| Artikel Allergene/Inhaltsstoffe von Hypersoft | nein | nein | nein |
| Artikel/Bestellungen an Hypersoft | ja | ja | ja |
| Unterstützt Bestandssperre, manuelle Sperre | nicht bekannt | nicht bekannt | nicht bekannt |
| Vorgänge mit Superheldenfunktion | nein | ja | nein |
| Mobile People Kundendaten kompatibel | nein | nein | nicht bekannt |
| Pick Up Screen (von 3rd Party) | nein | ja | nein |
| Self Order Terminal (von 3rd Party) | nicht bekannt | ja | nein |
| Speisekarte/Webshop | Website | iOS Android | Website |
| Stammdatenaktualisierung | Echtzeit | Echtzeit | Echtzeit |
| Mobile Payment | m.E. | ja | nicht bekannt |
| Gutscheine | - | - | - |
| Bewertung durch /User Endbenutzer des Programms, einer Webseite oder App. |
nicht bekannt | nicht bekannt | nicht bekannt |
| YourAPP Coupon (Freie Artikelnummer) | nicht bekannt | nicht bekannt | nicht bekannt |
Lizenzierung für die Nutzung der eCommerce API
Weiterführende Dokumentation:
IF 01: eCommerce und App Integration
Variante IF 01: eCommerce Payment-Only...
Weiterführende Dokumentation:
3rd Party eCommerce Integration einrichten
3rd Party eCommerce Fiskalanforderungen
3rd Party eCommerce Entwicklung
Zurück zur übergeordneten Seite: eCommerce Integrationen