3rd Party Kunden, Reservierung, Tickets API
Die SOAP kompatible HTTP Schnittstelle B2B Data Interface, welche in der Version 3.0.0 vorliegt, können Sie unter https://api.myhypersoft.de/Service/API300.asmx (bzw. „b2b.myhypersoft.de/Service/API300.asmx“ oder „nocoo.de/Service/API300.asmx“) erreichen. Bei einer Anfrage mit SOAP-Headern wird im Requestbody eine XMLStruktur erwartet. Wahlweise können Sie im Request-Header das Feld Content-Type auf 'application/json; charset=UTF-8;' setzen und ihre Daten im JSON-Format übergeben. SOAP-Header werden bei dieser Anfrage nicht benötigt. Daten müssen mit der POST-Methode an die Schnittstelle übergeben werden. Sie können den Webservice auch einfach über einen Dienstverweis in ein Microsoft Visual Studio Projekt einbinden.
Tokens...
Für die Verwendung des Webservices benötigen Sie zwei Authentifizierungstokens (CusToken und Authtoken) welche ausschließlich durch Hypersoft vergeben werden.
Absichtliche Limitierung und Grenzen...
Die Anzahl der Webserviceaufrufe ist in der Zeitspanne von einer Minute auf 60 Aufrufe limitiert. Bei der Überschreitung der Limitierung wird jeder weitere Webserviceaufruf gesperrt. Eine Reaktivierung wird auf Nachfrage ausschließlich durch Hypersoft vorgenommen.
In diesem Dokument werden Servicemethoden (gruppiert nach ihren Bereichen), komplexe Datenstrukturen und Basisdatentypen beschrieben.
Für Komplexe Datenstrukturen werden die eigenen Felder, deren Datentypen und Gültigkeitsbereiche (min / max Werte) angegeben. Ist kein Gültigkeitsbereich angegeben, gilt der gesamte mögliche Bereich das angegeben Basisdatentypen.
Weblinks
Web References in Visual Studio (Esay way to use a Web Service in Visual Studio)
Web Services Description Language (WSDL) 1.1
Ergänzungen...
DateTime Felder werden als Date, Time oder DateTime vom Server gelesen. Bei Time, wie bei Erreichbar von-bis, ist im DateTime die Uhrzeit entscheidend und das Datum wird ignoriert, kann also z.B. 1970-01-01 sein.
Sollte z.B. der Geburtstag nicht über die Schnittstelle übergeben werden, aber im Kassensystem hinterlegt sein, so ist wichtig, dass das Feld beim SetCustomer übertragen wird, da es andernfalls gelöscht würde. Hierfür kann der Customer Datensatz über GetCustomer zuerst geholt werden, dann die zu ändernden Daten hinterlegt werden und danach diese mit SetCustomer festgeschrieben werden.
Das Hochladen von Datensätzen ist derzeit auf 500 begrenzt und muss somit in passenden Paketen erfolgen.
Zur Zeitumstellung...
Um mit dem POS System kompatibel zu sein, müssen Sie während der Zeitumstellung im Frühjahr und im Herbst im einstündigen Zeitraum der Zeitumstellung von 02:00 Uhr bis 03:00 Uhr immer auch alle Datensätze zurückgegeben werden, die sich seit 02:00 Uhr geändert haben.
Lizenzen
Die Nutzung der Kundendaten erfordert mindestens eine Kundenstamm Lizenz und je nach Nutzungskonzept weitere eSolutions Lizenzen.
Zusätzlich werden API Lizenzen benötigt:
Die Voraussetzung zum Abruf von Umsatzdaten ist eine Enterprise Reports Lizenz pro Standort.
Für Belege wird die NoCOO Lizenz benötigt: NoCOO Digital Billing Lizenzen
Interface 55: MOBILE PEOPLE Kundendaten API für die Nutzung mit Kundendaten.
Interface 56: MOBILE PEOPLE Reservierung API für die Nutzung mit Reservierungsdaten.
Weiterführende Dokumentation: Customer API Entwicklung
Zurück zur übergeordneten Seite: Integrationen und Schnittstellen