Externe API - Bestellen (Externe Kanäle)

Kontext

In diesem Artikel werden die Schritte erläutert, die erforderlich sind, um bei der Integration eines externen Bestellkanals in das MENU-Ökosystem Zugang zur API-Dokumentation zu erhalten, einschließlich des NDA-Prozesses (Non-Disclosure Agreement).

Geheimhaltungsvereinbarung (NDA)

Für jede Integration muss eine Geheimhaltungsvereinbarung unterzeichnet werden. Um dir die Vorbereitung auf diesen Prozess zu erleichtern, kannst du dir die NDA-Vorlage hier ansehen. Ein Dokument in ähnlicher Form (ausgefüllt mit den Daten der jeweiligen Beteiligten) wird nach dem Kick-off-Meeting unterzeichnet.

Prozessschritte

Hier ist ein Überblick darüber, wie der Zugang zur API funktioniert:

Ressourcen von deinem Integrationsmanager:

• Zugang zum CMS / Management Center:  Das CMS und das Management Center sind die beiden Verwaltungsportale von MENU, mit denen Marken das gesamte digitale Einkaufserlebnis konfigurieren können, von der Speisekarte über die Läden bis hin zu sämtlichen Integrationen. Das CMS ist das alte Verwaltungsportal von MENU, das derzeit zum Management Center migriert wird – du kannst mit einer einzigen Anmeldung auf beide Plattformen zugreifen und nahtlos zwischen ihnen navigieren
• Marken-Sandbox:  Deine vorkonfigurierte Marken-Sandbox, in der alle Konfigurationstypen aktiviert sind und gegen die du entwickeln wirst.  In Absprache mit deinem Integrationsmanager kann die Sandbox so konfiguriert werden, dass sie bestimmte Integrationen enthält, z. B. zu Zahlungsabwicklern und POS-systemen.
• Anwendung: Wir erstellen eine autorisierte Anwendung (für die Sandbox –  produktiver Zugang wird erst nach der Zertifizierung gewährt) für dich, einschließlich deines Anwendungsschlüssels, den du in allen API-Aufrufen als  Application  HTTP Header angibst
• Wissensdatenbank: Da bist du ja! Hier kannst du auf einen umfangreichen Katalog (mit Hunderten von Artikeln) zugreifen, um mehr über die Nutzung der MENU-Plattform zu erfahren

Integrationssupport

• Wir vereinbaren einen Termin mit dir, um den Integrationsprozess zu besprechen und sicherzustellen, dass alle Fragen beantwortet werden.
• Slack: Wir können einen gemeinsamen Slack-Kanal einrichten, um die Kommunikation während der Integrationsentwicklung zu vereinfachen und sicherzustellen, dass Bedenken und Probleme schnell gelöst werden.
• Wöchentlicher 30-minütiger Check-in: Wir koordinieren ein wöchentliches 30-minütiges Gespräch, um dich auf den neuesten Stand der Integration zu bringen und sicherzustellen, dass du die nötige Unterstützung erhältst, um deine Integration abzuschließen (in den ersten 3 Monaten nach dem Start der Integration werden wir wöchentliche Gespräche führen, danach werden wir uns je nach Fortschritt der Integration zurückziehen)
• Integrationsmanager: Dein Integrationsmanager ist immer dein Hauptansprechpartner für deine Integration - wenn du keinen Integrationsmanager hast,  öffne ein Support-Ticket

Zertifizierung

• Nachdem du die Integrationsentwicklung abgeschlossen hast, prüfen und zertifizieren wir deinen Antrag
• Während des Integrationsentwicklungsprozesses erhältst du von deinem Integrationsmanager Zertifizierungsfälle, basierend auf den angeglichenen Fähigkeiten, die in deiner Implementierung enthalten sein sollten
• Während des Zertifizierungsgesprächs werden wir gemeinsam die Zertifizierungsfälle durchgehen und beobachten, wie deine Anwendung mit unseren APIs interagiert. So können wir sicherstellen, dass du unsere APIs optimal nutzen kannst.
• Wenn die Zertifizierung erfolgreich ist, erhältst du eine autorisierte Produktionsanwendung (pro Umgebung, je nachdem, in welchen Regionen deine Integration angeboten werden soll), einschließlich deines Anwendungsschlüssels.
• Wenn deine Zertifizierung Mängel aufweist, werden wir Folgetermine festlegen, bis die Integration zertifiziert werden kann.

Zeit für die Einführung!

Während der Einführung arbeitet dein Integrationsmanager weiterhin eng mit dir zusammen, um sicherzustellen, dass die Integration korrekt funktioniert und Verbesserungsmaßnahmen schnell erkannt werden.

Produktionssupport

Der Produktionssupport hängt von der Support-Vereinbarung der Marken ab, mit denen du zusammenarbeitest – sie haben die Möglichkeit, ein  Support-Ticket zu eröffnen, um gemäß den vereinbarten SLAs Unternehmens-Support zu erhalten.

Nächste Schritte

Initialisierung

Application Initialization: (Initialisierung der Anwendung) In diesem Leitfaden erfährst du, wie du die erste Verbindung zu MENU herstellst, um die Konfigurationseinstellungen für deine Marke zu übernehmen.

Bitte beachte: der Ablauf für die benutzerdefinierten Bestellanwendungen beginnt mit diesem Schritt!

API-Dokumentation

Die API-Dokumentation kann nach der Unterzeichnung der Geheimhaltungsvereinbarung weitergegeben werden – du erhältst also entsprechende Links und/oder Dateien zu diesen Dokumenten, sobald dieser Schritt abgeschlossen ist.

Weitere Informationen zu Integrationen findest du in diesem Abschnitt der Wissensdatenbank.