Schnittstelle

Die beiden Hälften sprechen über eine schmale HTTPS-Schnittstelle miteinander. Dieses Kapitel beschreibt, wie sie das tun – für die Einrichtung und für die Fehlersuche.

Wozu dient dieser Bereich?

• Den Zugang einrichten.
• Verstehen, welche Daten in welche Richtung fließen.
• Erkennen, was passiert, wenn eine Anfrage wiederholt wird.

Vorgehen

1. Die App erzeugt je Shop einen Verbindungsschlüssel, der nur einmal angezeigt wird. Die App speichert ihn selbst nur als Prüfsumme – geht er verloren, wird ein neuer erzeugt.
2. Der NCS-Webservice hinterlegt Adresse und Schlüssel verschlüsselt in den Schnittstellen.
3. Von SAP zur App: Artikel, Bestände, Kunden, kundenspezifische Preise und Versandmeldungen.
4. Von der App zu SAP: Bestellungen – und Stornierungen von Bestellungen, die bereits übernommen waren.
5. Längere Aufgaben werden als Auftrag angenommen; der Webservice fragt den Stand später ab und bekommt je Datensatz ein Ergebnis: angelegt, aktualisiert, unverändert, übersprungen oder fehlgeschlagen.
6. Jede schreibende Anfrage trägt einen Wiederholungsschlüssel. Kommt dieselbe Anfrage zweimal an, wird sie nicht zweimal ausgeführt – sondern dasselbe Ergebnis zurückgegeben. Das ist der Schutz davor, dass ein erneuter Lauf Bestellungen oder Artikel verdoppelt.

Gut zu wissen

Die Verbindung geht ausschließlich von Ihrem Haus nach außen. Die App ruft nie bei Ihnen an. Für die Firewall heißt das: ausgehendes HTTPS genügt, es muss nichts von außen erreichbar sein.