Zum Inhalt
v26.3

Lieferdienst-Anbindung

Über die Lieferdienst-Anbindung laufen Bestellungen von Lieferplattformen wie Lieferando, Wolt, Uber Eats oder foodora als normale Lieferaufträge in DiKAS ein. Statt für jede Plattform eigene Zugangsdaten zu pflegen, genügt ein Zugang: Die Anbindung nimmt die Bestellungen entgegen und meldet Annahme, Ablehnung und Statuswechsel an die Plattform zurück.

Welche Plattformen und Bestellsysteme mit DiKAS zusammenarbeiten, steht in der Übersicht „Lieferdienste und Bestellsysteme“. Die Bedienung der Aufträge selbst (Online-Tab, Küche, Fahrer) beschreibt das Modul Lieferservice.

Voraussetzungen

Voraussetzung Hinweis
Modul Lieferservice In der Lizenz enthalten bzw. zugebucht
Freischaltung Ihres Restaurants Die Zugangsdaten (Zugangsschlüssel, Restaurant-Kennung, Webhook-Secret) erhalten Sie von DiKAS, sobald Ihr Restaurant für die Lieferdienst-Anbindung eingerichtet ist. Wenden Sie sich dafür an den DiKAS-Support.
Erreichbarer Server DiKAS muss die Bestellungen annehmen können — in der Cloud-Version ist das immer der Fall

Welche Plattformen?

Über die Anbindung sind u. a. Lieferando, Wolt, Uber Eats, foodora, MJAM, Deliveroo und Just Eat Takeaway.com erreichbar (vollständige Liste in der Übersicht). Voraussetzung ist ein Vertrag mit der jeweiligen Plattform. Welche davon für Ihr Restaurant in Frage kommen und welche Daten die jeweilige Plattform in welche Richtung austauscht, hängt von der Plattform und vom Land ab. Die Freischaltung erfolgt je Restaurant auf Anfrage; DiKAS klärt das vorab mit Ihnen.

Einrichtung

  1. Admin → Online-/QR-Einstellungen → Reiter „Bestellung“ → Lieferzonen & Gebühren, Abschnitt „Lieferplattformen“ öffnen.
  2. Die Karte „Lieferdienst-Anbindung“ einschalten (Häkchen vor dem Namen).

  3. Die Zugangsdaten eintragen, die Sie von DiKAS erhalten haben:

    Feld Bedeutung
    Zugangsschlüssel Ihr persönlicher Zugang zur Anbindung. Wird nach dem Speichern nie wieder angezeigt.
    Restaurant-Kennung Kennzeichnet Ihr Restaurant in der Anbindung
    Webhook-Secret Geheimer Schlüssel, mit dem DiKAS prüft, dass eingehende Bestellungen wirklich von der Anbindung stammen

  4. Optional „Automatisch annehmen“ einschalten (siehe Annehmen).

  5. Speichern, danach „Verbindung prüfen“ wählen (nur für Administratoren). Geprüft wird der gespeicherte Stand; die Meldung steht direkt unter dem Knopf.
  6. Die unter der Karte angezeigte Webhook-Adresse (https://[Server]/api/v1/webhooks/anbindung) mit Kopieren übernehmen. Sie wird bei der Einrichtung der Anbindung hinterlegt; DiKAS übernimmt das auf Wunsch für Sie.

Unter der Karte steht „Webhook zuletzt empfangen“ mit der Zeit der letzten eingegangenen Meldung (oder „noch nie“).

Testbestellung

Nach der Einrichtung lässt sich über den DiKAS-Support eine Testbestellung auslösen. Sie erscheint nach spätestens einer Minute im Online-Tab des Lieferservice — mit dem Hinweis „Test“ auf dem Auftrag.

So läuft eine Bestellung ab

  1. Der Gast bestellt bei der Plattform.
  2. Die Anbindung meldet die Bestellung an DiKAS (Webhook). Zusätzlich fragt DiKAS etwa einmal pro Minute offene Bestellungen selbst ab — fällt eine Meldung aus, geht die Bestellung deshalb nicht verloren.
  3. DiKAS legt einen Lieferauftrag an. Quelle und Bestellnummer der Plattform stehen auf dem Auftrag.
  4. Sie nehmen die Bestellung im Online-Tab an (oder DiKAS nimmt automatisch an). Die Annahme wird an die Plattform gemeldet, die Küchenbons werden gedruckt. Ablehnen meldet die Ablehnung an die Plattform.
  5. Weitere Statuswechsel (in Zubereitung, bereit, unterwegs, geliefert bzw. abgeholt) werden automatisch zurückgemeldet.

Was in den Auftrag übernommen wird

  • Positionen mit Optionen und Aufpreisen — z. B. „Burger + Extra Käse“ mit dem richtigen Preis.
  • Rabatte der Plattform als negative Position, Servicegebühren als eigene Position.
  • Liefergebühr der Plattform — es wird keine zweite Zonen-Gebühr aufgeschlagen.
  • Kundendaten und Lieferadresse, Wunschzeit und Hinweise des Gastes.
  • Zahlungsstatus: Bereits online bezahlte Bestellungen werden als bezahlt verbucht. Ist nur ein Teil online bezahlt oder wird bar bei Lieferung kassiert, gilt die Bestellung als noch nicht bezahlt und wird wie üblich kassiert.
  • Positionen, die DiKAS keinem Artikel zuordnen kann, laufen mit Namen und Preis der Plattform als manuelle Position ein — keine Position geht verloren. Damit Steuersatz und Auswertung stimmen, sollten Sie Artikeln die Artikelnummer (PLU) der Plattform zuordnen.

Bestellungen annehmen

Einstellung Wirkung
Automatisch annehmen aus (Standard) Bestellungen erscheinen im Online-Tab und müssen von Ihnen angenommen oder abgelehnt werden
Automatisch annehmen ein Eingehende Bestellungen werden sofort angenommen, an die Plattform gemeldet und an die Küche gesendet

Storno durch die Plattform

Storniert die Plattform oder der Gast eine Bestellung, wird der Auftrag in DiKAS gestoppt und die Stornierung bestätigt. Bereits abgeschlossene Aufträge bleiben unverändert.

Störungen und häufige Fragen

„Webhook zuletzt empfangen: noch nie“ — was bedeutet das?

Es ist noch keine Meldung eingegangen. Das ist vor der ersten Bestellung normal. Kommen trotz Bestellungen keine Meldungen an, prüfen Sie, ob die Webhook-Adresse bei der Einrichtung der Anbindung hinterlegt ist, und wenden Sie sich an den DiKAS-Support. Bestellungen holt DiKAS in der Zwischenzeit selbst ab.

Eine Bestellung erscheint nicht im Online-Tab

Prüfen Sie, ob die Karte Lieferdienst-Anbindung eingeschaltet und gespeichert ist und „Verbindung prüfen“ ohne Fehler endet. Der Abruf läuft etwa einmal pro Minute. Meldet die Plattform einen Status, den DiKAS nicht sicher einordnen kann, legt DiKAS die Bestellung nicht automatisch an und zeigt einen Hinweis — in dem Fall bitte den Support kontaktieren.

Ein hinterlegtes Geheimnis ist nicht mehr lesbar

Das kann nach dem Einspielen einer neuen Lizenz passieren. Zugangsschlüssel und Webhook-Secret neu eintragen und speichern.

Kann ich Lieferando oder Wolt weiter direkt anbinden?

Bereits eingerichtete direkte Anbindungen laufen weiter. Neue Plattformen richten Sie über die Lieferdienst-Anbindung ein.

Was kostet die Anbindung?

Die Konditionen nennt Ihnen der DiKAS-Vertrieb auf Anfrage.

Siehe auch