Diese Seite soll den Nutzern der LINA Third Party API (TP API) und Softwareentwicklern der Partner /Drittanbieter einen Überblick verschaffen, wie auf Daten in LINA zugegriffen wird.

Die Schnittstelle LINA TP API hat verschiedenen Endpunkte, an denen sie je nach Einstellung und Berechtigung Daten lesen und/oder schreiben.


Für die Entwicklung und Test von Software empfehlen wir ein Demosystem getrennt von den Produktiv-Systemen der Kunden. Einen LINA Laden können sie für die konkrete Entwicklung auf "Demo" setzen lassen, so dass keine Lizenzgebühren anfallen.
Ist zusätzlich eine konfigurierte Kasse notwendig (z.B. Endpunkt 'POS /Webkasse'), buchen sie bitte unsere Schulung. Hier ist ein vollständiges Demosystem mit LINA Kasse und Artikeln enthalten.


INHALTSVERZEICHNIS


Begriffe in der Third Party API

API

API ist eine Abkürzung für den englischen Ausdruck „Application Programming Interface“ und beschreibt eine „Programmierschnittstelle“ von LINA . Es handelt sich um ein Element der LINAWebseite, um Programmen von Dritten (Third Party)  die Anbindung und den Austausch von Daten zu ermöglichen.

Die Programmierschnittstelle ist das technische Gegenstück zum User-Interface. Beim User-Interface gibt der Mensch Daten auf dem Bildschirm ein und erhält Antworten /Daten zurück.
Bei der Programmierschnittstelle stellt das Programm eines Drittanbieters verschiedene genau definierten Anfragen an unsere Webseite mittels https-code und erhält einen Satz von Antworten als formatiertes json-Objekt zurück. Die Anfrage kann auch den Auftrag zum Schreiben von Daten enthalten, die Antwort bestätigt den Erfolg.

Endpunkte

Die LINA Third Party API (TP API) ist eine Schnittstelle, die als RESTful-API implementiert ist. An einem spezifischen "Endpunkt"  stehen Daten zum Lesen und/oder Schreiben aus den LINA Modulen bereit.

Endpunkte müssen in LINA lizensiert werden.


Für den Endpunkt TP API 'POS /Webkasse' ist immer notwendig, dass die LINA Kasse im Betrieb mit LINATeamcloud synchronisiert und diese konfiguriert ist. Dies richten Sie bitte selbst oder mit Ihrem Fachhandelspartner ein, der den LINA Kassenserver im Betrieb betreut.


Redirect URI / Clients

Für jeden lizensierten Endpunkt werden Clients registriert, an die die Daten übertragen werden. Jedem dieser Clients wird als Redirect-URI die Webadresse eingetragen, an die die Daten von LINA gesendet werden. Unter dieser Adresse ist der Client des Drittanbieters zur Kommunikation erreichbar.


Sicherheit

Der Zugriff auf die TPAPI erfolgt  ausschließlich über das standardisierte OAuth2-Verfahren. Vor dem Zugriff auf die Endpunkte wird mit Token der Zugriff authentifiziert. 

Für den wiederholten Zugriff in der Entwicklung kann ein Refresh-Token in LINA erzeugt werden. Im Produktivbetrieb beim Kunden authentifiziert dieser einmalig den Zugriff auf den Endpunkt durch Benutzername und Passwort.

Die Daten werden anschließend verschlüsselt übertragen und nur zu dem System, das beim Anlegen der Schnittstelle durch den Ladenbesitzer, erlaubt wurde.


Voraussetzungen in LINA 

Für die Nutzung von Schnittstellen, die die TP API nutzen, ist ein LINA Laden mit Nutzern und Lizenzen erforderlich, in dem die benötigten Endpunkte freigeschaltet und die Clients registriert werden.


  1. Schnittstelle (Endpunkt) lizensieren
  2. für Endpunkt 'POS /Webkasse': Datensynchronisation Kassenserver mit LINA Laden einrichten und  Kassenmodul vorbereiten
  3. Client (API-Zugang) einrichten und berechtigen 


für die genau benötigen Endpunkte und Lizenzen, die Erstellung der Clients und Berechtigungen und evtl. die passende Konfiguration der Kasse prüfen sie bitte die Dokumentation der einzelnen Schnittstelle und die Voraussetzungen auf der Seite des Drittanbieters.


Die Beschreibung für den Ladenbesitzer finden Sie in unserem Handbuchartikel Daten an einen Drittanbieter senden (Third-Party-API erstellen)


Programmzugriff auf die TP API Schnittstelle


Operator-ID

TBD


Dokumentation in Postman

Für die Entwicklung mit der TP API ist die vollständige Schnittstelle in in Postman dokumentiert: Third-Party-API postman Dokumentation


Entwicklung mit der TP API

Für die sichere Entwicklung mit der TP API wird vom Drittanbieter selbst ein Laden in LINA registriert. Auch für den kostenfreien Testzeitraum müssen Daten vollständig angelegt werden inklusive der Bezahldaten. Durch Registrierung beim Support der Gastro-MIS (support_at_gastro-mis.de) wird der LINA Laden auf "Demo" gesetzt, so dass die Nutzung über den Testzeitraum hinaus kostenfrei bleibt.


Die Gastro-MIS übernimmt keine Verantwortung für die inhaltlich richtige Nutzung der Schnittstellen und Endpunkte.


Demosystem Kasse

Für die Entwicklung im Zusammenspiel mit der Kasse wird eine konfigurierte Installation der LINA POS benötigt. Die Daten werden mit dem LINA Laden synchronisiert und über die Amadeus SQL Abfragesprache (ASQL) können Bestellungen boniert und Zahlungen "wie im Restaurant" gemacht werden.

Eine vollständig konfigurierte Kasse mit Artikeln, Finanzwegen, Steuern usw. ist eine komplexe Konfiguration, die für die Kunden von LINA durch die spezialisierten Fachhandelspartner durchgeführt und an lokale Besonderheiten und Abläufe der gastronomischen Geschäfts angepasst wird. Für die Entwicklung von Bestell- und Bezahlsystemen, Warenwirtschaft o.ä. wird ein solches System benötigt. Eine Lizenz für die Installation auf einem lokalen Rechner kann über den Support der Gastro-MIS angefordert werden. Für Installation und gewünschte Konfiguration stehen hier im Handbuch umfangreiche Artikel bereit - ebenso wie für die Programmierung der TP API und ASQL. Ein Support kann hier nicht geleistet werden.


Wir empfehlen für die Programmierung ein vollständiges Demosystem mit LINA Laden und konfigurierter Kasse. So können sie sich auf die Entwicklung der wesentlichen Komponenten konzentrieren und bekommen Support bei Fragen.
Bitte buchen Sie dazu unsere Schulung im LINA Laden.

weiterführende Artikel für Entwickler

  1. Übersicht Third Party API
  2. Anmeldung
  3. Zugriff auf Ressourcen
  4. Fehlerbehandlung
  5. Endpunkte zum Datenaustausch