Wenn wir eine Speisekarte mit Wolt synchronisieren:
- Wir nehmen die interne Speisekarte des Restaurants (aus SIDES).
- Wir konvertieren es in das von Wolt erwartete Format.
- Wir laden es über die API von Wolt in das System von Wolt hoch.
- Wenn Wolt es akzeptiert, ist die Speisekarte innerhalb weniger Minuten online!
Was du zuerst überprüfst
Bevor du dich mit den technischen Details befasst, stelle Folgendes sicher:
Das Restaurant ist im SIDES-System aktiv.
Die Speisekarte ist in SIDES sichtbar und aktuell.
Die Wolt Restaurant-ID, der Benutzername und das Passwort liegen vor.
Prüfe mit dem Wolt-Team, ob du für den Speisekarten-Push berechtigt bist (die Speisekartensynchronisierung sollte aktiviert sein).
So löst du eine Speisekartensynchronisierung aus
1. Gehe zur Administrations-Navigationsleiste unter Admin: Externe Dienste > Lieferportal-Accounts, und suche das Portal, für das du eine Speisekartensynchronisierung starten möchtest.
Klicke auf die Schaltfläche "Menü synchronisieren"
.
2. Warte auf die Bestätigung der Erfolgsmeldung. Wenn keine Bestätigung erscheint: Überprüfe die Anmeldedaten oder die Protokolle.
Die Speisekartensynchronisierung muss mit Sorgfalt durchgeführt werden, wenn es aktive Werbeaktionen bei Wolt gibt. Damit die Werbeaktionen nach der Speisekartensynchronisierung weiterhin funktionieren, gilt Folgendes:
- Der Artikel darf nicht die Kategorie wechseln.
- Der Artikel darf nicht aus der Speisekarte entfernt werden.
- Die POS-ID des Artikels darf sich nicht ändern.
Was wird synchronisiert
Warengruppen
Das SIDES-Speisekartensystem ist flexibler und detaillierter, daher übersetzt und überarbeitet unser System die Speisekarte, bevor es an Wolt gesendet wird. Warengruppen aus SIDES werden in Wolt-Kategorien umgewandelt.
SIDES erlaubt verschachtelte Warengruppen (z. B. Ebene 1 → Ebene 2 → Ebene 3), aber Wolt unterstützt nur flache Kategorien. Die tiefste (spezifischste) Gruppe, die einem Artikel zugeordnet ist, wird als Wolt-Kategorie verwendet. Wenn ein Artikel zu mehreren Warengruppen gehört, kann er in Wolt in mehreren Kategorien erscheinen.
Warengruppe → Wolt-Kategorie
Warengruppe-Untergruppe → Wolt-Kategorie
Jeder an Wolt gesendete Kategoriename wird nach folgender Logik bestimmt:
- Wenn die Warengruppe einen "Namen für externe Dienste" hat (z. B. "Burger"), wird dieser verwendet.
- Wenn der externe Name leer ist, greift das System auf den internen Namen "Warengruppenname" zurück.
SIDES (Warengruppen) | Wolt |
Warengruppen | In Wolt-Kategorien umgewandelt. |
Warengruppe-Untergruppe | In Wolt-Kategorien umgewandelt (in Wolt gibt es keine verschachtelten Warengruppen). |
ID von URL | Als interne Wolt-Nummern verwendet.
|
Externer Name | Als Kategoriename verwendet, wenn nicht leer – kundenseitig sichtbarer Kategoriename, der in Wolt angezeigt wird. |
Name | Fallback, wird nur verwendet, wenn der externe Name fehlt oder ungültig ist. |
Beschreibung | Die Kategoriebeschreibung wird an Wolt übertragen. |
Aktiv? | Nur aktive Gruppen werden mit Wolt synchronisiert. |
Die Warengruppen befinden sich unter Admin: Artikelverwaltung > Warengruppen > Bearbeiten. Folgende Felder werden mit Wolt synchronisiert.
Sortierung
SIDES sortiert die Speisekarte anhand der folgenden Einstellungen:
- Warengruppen: Sortierindex aus der Bearbeitungsseite für Warengruppen.
- Toppinggruppen: Sortierindex aus der Bearbeitungsseite für Toppinggruppen.
- Artikel: Sortierreihenfolge Webshop/App von der Artikelseitenbearbeitung → Der Abschnitt "Extra" wird verwendet, um Artikel innerhalb einer Warengruppe oder einer Toppinggruppe zu sortieren.
- Menügruppen: Sortierindex der Menügruppen innerhalb eines Menüs, der per Drag & Drop auf der Menüartikelbearbeitungsseite festgelegt wird → Der Abschnitt "Menü" wird zum Sortieren von Menügruppen verwendet.
Sortierung | So richtest du es ein |
Kategorien (Warenguppen) | Lege die Sortierindex-Werte für Warengruppen fest. (Admin: Artikelverwaltung > Warengruppen > Bearbeiten > Soriterindex). |
Toppinggruppen | Lege die Sortierindex-Werte für Toppinggruppen fest. (Admin: Artikelverwaltung > Toppinggruppen > Bearbeiten > Sortierungs-Index). |
Artikel | Lege die Sortierreihenfolge Webshop/App-Werte bei den Artikeln auf der Bearbeitungsseite fest -> im Bereich "Extra". (Admin: Artikelverwaltung > Artikel > Bearbeiten > Extra > Sortierfolge Webshop/App). |
Menügruppen | Ordne Menügruppen per Drag & Drop an. (Admin: Artikelverwaltung > Artikel > Bearbeiten > Menü). |
Artikel
Der nächste Schritt besteht darin, dass jeder Verkaufsartikel in SIDES in einen Wolt-Artikel umgewandelt wird. Dazu müssen einige Voraussetzungen erfüllt sein: Der Artikel muss einen Namen und einen Preis haben, einem Store zugeordnet sein, Teil einer Warengruppe sein und darf kein Topping sein. Wenn diese Informationen korrekt sind, wird der Artikel an Wolt gesendet. Toppings und Menüs (Kombinationen) werden später behandelt und beschrieben.
SIDES Artikelfeld | Wolt |
Nummer des Artikels | Eindeutige ID, die an Wolt gesendet wird. |
Name | Produktname |
Beschreibung or LMIV-Pflichtangaben | Wenn LMIV-Informationen verfügbar sind, ersetzen diese die Hauptbeschreibung. Wenn das Feld leer ist, wird nichts an Wolt gesendet. |
Fest im Code hinterlegt (hardgecodet) | Enthält immer: ["LIEFERUNG", "ZUM HIERESSEN", "ZUM MITNEHMEN"] für alle Verkaufsartikel von SIDES.
|
Pfand | Wenn vorhanden und gültig; enthält Preis + MwSt. |
Preise (vom Store) | Auf 2 Dezimalstellen gerundet. |
Steuersatz | Der Steuersatz des Artikels wird an Wolt gesendet. |
Verfügbarkeit im Store | Die Verfügbarkeit in den Store-Einstellungen bei SIDES steuert, ob der Artikel mit Wolt synchronisiert wird. |
Bilder | Es wird nur das erste gültige Bild verwendet. |
Alkoholgehalt | Der Alkoholgehalt aus dem Abschnitt "Extra" wird an Wolt gesendet, sofern er nicht 0 ist. Dieses Feld wird verwendet, um Kuriere anzuweisen, das Alter zu überprüfen.
|
Mindestalter | Mindestalter aus dem Artikel → Abschnitt "Extra" wird an Wolt gesendet.
|
Nährwertangaben | Detaillierte Aufschlüsselung, pro 100 g oder 100 ml.
Die übermittelten Daten enthalten Werte für:
- Energie (kcal)
- Energie (kJ)
- Fett
- Gesättigte Fettsäuren
- Kohlenhydrate
- Zucker
- Eiweiß
- Salz
Und falls verfügbar: - Einfach ungesättigte Fettsäuren, mehrfach ungesättigte Fettsäuren, Ballaststoffe, Kalzium, Kalium, Natrium, Vitamin C, Magnesium, Chlorid, Fluorid, Stärke, Polyole
Siehe weiter unten für mehr Informationen. |
Grundpreis | Der Grundpreis bei Wolt wird automatisch anhand von zwei Feldern berechnet und angezeigt.
Siehe die folgenden Anmerkungen zur Einrichtung unter "Anmerkung zur Menge".
|
Koffein | Die automatisch berechneten Werte pro 100 g werden an Wolt gesendet. Diese Informationen werden verwendet, um Kunden eine Warnung anzuzeigen.
|
Allergene | Falls verfügbar, werden alle Allergenbezeichnungen als Zeichenfolge (DE- und EN-Übersetzungen) an Wolt gesendet.
|
Zusatzstoffe | Falls verfügbar, werden alle Zusatzstoffbezeichnungen als Zeichenfolge (nur in DE) an Wolt gesendet.
|
Inhaltsstoffe | Optionale Informationen aus der LMIV, falls vorhanden. |
Hersteller | Optionale Informationen aus der LMIV, falls vorhanden. |
Inverkehrsbringer | Optionale Informationen aus der LMIV, falls vorhanden. |
Herstellungsland | Optionale Informationen aus der LMIV, falls vorhanden. |
Aufbewahrungs- und Verwendungshinweise | Optionale Informationen aus der LMIV, falls vorhanden.
|



Die Artikel mit den einzelnen Abschnitten (wie z. B. "Extra", "LMIV-Pflichtangaben", etc.) befinden sich unter Admin: Artikelverwaltung > Artikel > Bearbeiten.
Anmerkung zur Menge
Der Grundpreis bei Wolt wird automatisch anhand von zwei Feldern berechnet und angezeigt.
Um sicherzustellen, dass diese Informationen korrekt von SIDES übertragen werden, beachte bitte die folgenden Schritte, wenn du deine Artikel bearbeitest.
1. Gehe zu Admin: Arikelverwaltung > Artikel > Bearbeiten > Extra > Text für Grundpreis-Einheit und füge eine Einheit hinzu.
Unterstützte Einheiten:
- pro l
- pro Liter
- pro g
- pro Gramm
- per litre
- per liter
- per l
- per g
- per gram
- pro Stück
- per stuk
- per piece
- per unit
- per slice
2. Mengenangaben (z. B. Volumen in ml oder Gewicht in g) werden aus dem Feld "Gewicht bzw. Inhalt des Artikels (in gramm)" übernommen, unter Admin: Artikelverwaltung: Artikel > Bearbeiten > Nährwertangaben > Gewicht bzw. Inhalt des Artikels (in gramm).
(Das Feld "Gewicht bzw. Inhalt des Artikels (in gramm)" wird angezeigt, wenn es sich bei dem Artikel um einen "Rohstoff" handelt (unter Admin: Artikelverwaltung > Artikel > Bearbeiten > Artikel > unter Eigenschaften > Rohstoff) und die Nährwertangaben beim Artikel aktiviert sind (unter Admin: Globale Einstellungen > Storeübergreifende Einstellungen > Sonstige Einstellungen > Stammdaten-Einstellungen für Artikel, Warenwirtschaft und Buchhaltung > Nährwerte beim Artikel angeben > Ja)).
3. Sobald sowohl die Angezeigeeinheit als auch das Gewicht/Volumen festgelegt sind, werden die Mengenangaben automatisch zusammen mit deinem Artikel an Wolt übermittelt und der Grundpreis wird berechnet.
Toppings
Toppings für normale Artikel werden mit Wolt synchronisiert (Menüs werden später behandelt). Jede Toppinggruppe wird zu einer Option, und die Artikel innerhalb der Gruppe werden zu Optionswerten. Die folgenden Informationen werden bezüglich der Toppinggruppen an Wolt gesendet:
Felder in SIDES | Beschreibung |
Aktiv? | Nur aktive Toppinggruppen werden mit Wolt synchronisiert. |
Name | Allgemeiner Name des Toppings (z. B. Pommes-Sauce). |
Topping ID | Die ID der Toppinggruppe aus der URL wird als ExternalData gesendet. |
Umschalter Freie Toppinggruppe → Ja | Der Preis aller Toppings wird auf 0 Euro gesetzt (dies wirkt sich auf Toppings für Artikel oder Teile von Menügruppen aus).
|
Einzelauswahl oder Mehrfachauswahl | Entweder Einzelauswahl oder Mehrfachauswahl, abhängig von der maximalen Menge für Einzelverkäufe. Wenn = 1, wird der Typ als Einzelauswahl gesendet, wenn nicht 1, wird der Typ als Mehrfachauswahl gesendet. |
Min. und Max. der einzelnen Artikel | Min. und max. werden an Wolt gesendet. Wenn max. 0 ist → dann wird das Maximum von 10 festgelegt.
|
Die Toppinggruppen befinden sich unter Admin: Artikelverwaltung > Toppinggruppen > Bearbeiten.
Jeder als Topping gekennzeichnete Artikel wird zu einem Optionswert innerhalb der Optionsgruppe. Für jeden Optionswert werden die folgenden Informationen übertragen:
SIDES Felder (Intern) | Anmerkungen / Erläuterungen |
Verfügbarkeit im Store? | Die Verfügbarkeit in den Store-Einstellungen bei SIDES steuert, ob der Topping mit Wolt synchronisiert wird. |
Nummer | Eindeutige Kennung, die zur Zuordnung von SIDES-Artikeln zu Wolt verwendet wird. |
Name | Toppingname |
Preis | Auf 2 Dezimalstellen gerundet. |
Erster Eintrag in der Liste | Der erste Topping wird als Standard markiert, nachdem die Sortierung angewendet wurde. |
Pfand | Optional – Wird nur hinzugefügt, wenn gültige Pfandinformationen vorhanden sind. |
Nährwertangaben | Detaillierte Aufschlüsselung pro 100 g oder 100 ml.
Die übermittelten Daten enthalten Werte für:
- Energie (kcal)
- Energie (kJ)
- Fett
- Gesättigte Fettsäuren
- Kohlenhydrate
- Zucker
- Eiweiß
- Salz
Und falls verfügbar: - Einfach ungesättigte Fettsäuren, mehrfach ungesättigte Fettsäuren, Ballaststoffe, Kalzium, Kalium, Natrium, Vitamin C, Magnesium, Chlorid, Fluorid, Stärke, Polyole
Siehe weiter unten für mehr Informationen. |
Allergene | Falls verfügbar, werden alle Allergenbezeichnungen als Zeichenfolge (DE- und EN-Übersetzungen) an Wolt gesendet. |
Zusatzstoffe
| Falls verfügbar, werden alle Zusatzstoffbezeichnungen als Zeichenfolge (nur in DE) an Wolt gesendet. |
Inhaltsstoffe | Optionale Informationen aus der LMIV, falls vorhanden. |
Hersteller | Optionale Informationen aus der LMIV, falls vorhanden. |
Inverkehrsbringer | Optionale Informationen aus der LMIV, falls vorhanden. |
Herstellungsland | Optionale Informationen aus der LMIV, falls vorhanden. |
Aufbewahrungs- und Verwendungshinweise | Optionale Informationen aus der LMIV, falls vorhanden.
|

Menüs
In SIDES ist ein Menüartikel (bei Wolt als "Bundle" bezeichnet) ein spezieller Artikel, der folgende Eigenschaften aufweisen kann:
- Kombiniert mehrere Komponenten (z. B. Burger + Getränk + Pommes).
- Enthält Menügruppen (z. B. "Hauptgericht auswählen", "Getränk auswählen").
- Kann optional Toppings für diese Komponenten beinhalten.
Bundles in Wolt sind sehr streng, und nur Menüs, die die folgenden Kriterien erfüllen, können an Wolt übertragen werden. Wenn eines dieser Kriterien nicht erfüllt ist, überspringt die Synchronisierung das Menü und fährt mit dem nächsten Artikel fort.
Regel | Beschreibung |
Muss zu einem Store gehören | Muss in einem Store gültig sein. |
Muss einen Preis haben | Muss einen Preis haben. |
Muss mindestens eine Menügruppe mit Artikeln enthalten | Das Menü muss mindestens eine Gruppe mit auswählbaren Artikeln enthalten. |
Die Kennzeichnung "Artikelpreis ist Aufpreis" darf nicht gesetzt sein | Menügruppen dürfen keine Aufpreise enthalten (Admin: Artikelverwaltung > Artikel > Bearbeiten > Menü > Bearbeiten > Artikelpreis ist Aufpreis) (Regel von Wolt). |
Preisvalidierung | Der Preis des Menüs, der im Abschnitt "Preis" (Admin: Artikelverwaltung > Artikel > Bearbeiten > Preis) festgelegt ist, muss niedriger sein als die Summe der günstigsten Artikel in jeder Menügruppe (Regel von Wolt).
|
Toppings aus Menüs: Wenn alle Artikel in einer Menügruppe die gleichen Toppings haben (z. B. Saucen für alle Hauptgerichte) und das Topping auf "kostenlos" gesetzt ist (in der Toppinggruppe umschaltbar, unter Admin: Artikelverwaltung > Toppinggruppen > Bearbeiten > Freie Toppinggruppe), wird diese Toppinggruppe zum Menü hinzugefügt.
Durch Hinzufügen der maximalen Anzahl auswählbarer Artikel innerhalb der Menügruppe können Benutzer bis zu x-mal Artikel aus dieser Menügruppe auswählen. Stelle dir vor, du hast eine Donut-Box, die 6 Donuts aufnehmen kann. Anstatt die Menügruppe 6 Mal hinzuzufügen, kannst du sie einmal hinzufügen und unter der maximalen Anzahl auswählbarer Artikel innerhalb der Menügruppe 6 hinzufügen (Admin: Artikelverwaltung > Artikel > Bearbeiten > Menü > Bearbeiten > Max. Anzahl für auswählbare Artikel innerhalb der Menügruppe). Durch Auswahl des Schalters direkt darunter bei "Auswahl erforderlich" muss der Benutzer genau 6 auswählen.
Weitere Informationen zur maximalen Anzahl auswählbarer Artikel innerhalb einer Menügruppe ist hier zu finden.
Die Menüs befinden sich unter Admin: Artikelverwaltung > Artikel > Bearbeiten > Menü > Bearbeiten.
Wenn die Menügruppe mit dem Multiplikator keine Toppings enthält, wird die Gruppe nur einmal angezeigt:
Wenn die Menügruppe Toppings enthält, wird die gesamte Kombination x-mal wiederholt, damit Benutzer Toppings für jeden Artikel in der Menügruppe auswählen können:
Nährwertangaben
Die Nährwertangaben stammen aus den folgenden Teilen des SIDES-Systems:
Für die Konfiguration:
Gehe unter Admin: Artikelverwaltung > Nährwerte, für die Speisekarte:
Bitte beachte, dass die Synchronisierung nur auf Nährwerte mit den folgenden Namen beschränkt ist:
kcal, Energie kcal, Brennwert, kJ, Energie kJ, Fett, Eiweiß, Kohlenhydrate, davon Zucker, Salz, davon gesättigte Fettsäuren, davon einfach ungesättigte Fettsäuren, davon mehrfach ungesättigte Fettsäuren, Ballaststoffe, Natrium, Vitamin C, Kalium, Calcium, Magnesium, Chlorid, Fluorid, Stärke, davon mehrwertige Alkohole, Koffein
Was die Nährwerte selbst betrifft, kannst du jeden Artikel im Admin-Bereich bearbeiten und den Abschnitt "Nährwerte" überprüfen, sofern der Artikel die folgenden Kriterien erfüllt:
- Es handelt sich nicht um ein Menü.
- Es handelt sich um ein Rohstoff (Artikel-Eigenschaften > Rohstoffkennzeichnung "Ja" unter Admin: Artikelverwaltung > Artikel > Bearbeiten > Artikel > unter Eigenschaften > Rohstoff > Ja).
Die Artikel und Nährwertangaben befinden sich unter Admin: Artikelverwaltung > Artikel > Bearbeiten.
Wenn alle Nährwerte in SIDES auf 0 gesetzt sind, werden keine Nährwerte an Wolt gesendet. Sobald mindestens ein Nährwert angegeben ist, werden alle verpflichtenden Nährwerte sowie einige zusätzliche Werte (sofern diese ungleich 0 sind) an Wolt übertragen.
Wenn ein Produkt Koffein enthält, füge dies bitte unter den Nährwerten hinzu. Wenn der Wert höher als 15 ml (oder mg) ist, fügt Wolt automatisch einen Kommentar zum Produkt hinzu: "Erhöhter Koffeingehalt. Für Kinder und schwangere oder stillende Frauen nicht empfohlen", gefolgt von einem Verweis in Klammern auf den Koffeingehalt, ausgedrückt in mg pro 100 g.
Häufige Schwierigkeiten und was zu tun ist
Es wird nichts bei Wolt angezeigt
- Überprüfe erneut, ob die Anmeldedaten korrekt sind, gespeichert wurden und das Portal aktiv ist.
- Überprüfe die Protokolle (derzeit nur in Signoz, wir arbeiten daran, eine Schnittstelle in SIDES zu erstellen).
- Bitte SIDES um Unterstützung.
Häufige Schwierigkeiten und was zu tun ist:
Die Synchronisierung schlägt mit der Fehlermeldung "Paketpreis zu hoch" fehl
- Das bedeutet, dass der Preis für ein Menü-Bundle höher ist als die Summe seiner Optionen.
- Passe den Bundle-Preis an, indem du ihn senkst. Die Summe der günstigsten Optionen in allen Menügruppen und Toppings sollte niedriger sein als der Preis des Menüs.
Die Synchronisierung schlägt mit der Fehlermeldung "Aufschlag nicht zulässig" fehl
- Eine der Menüoptionen (Topping) hat eine Zuschlagseinstellung.
- Deaktiviere für diese Gruppe die Option "Artikelpreis ist Aufpreis" (Admin: Artikelverwaltung > Artikel > Bearbeiten > Menü > Bearbeiten > Artikelpreis ist Aufpreis). Wolt unterstützt keine Zuschläge für Menüs.
Pfand wird nicht akzeptiert
- Wolt erlaubt nur bestimmte Pfandbeträge mit festgelegten Steuerwerten. Wenn unser Wert nicht mit dem Pfand bei Wolt übereinstimmt, wird der Pfand übersprungen und der Artikel ohne Pfand hinzugefügt.
- Verwende Standard-Pfandbeträge
Mehrwertsteuersatz | Akzeptierte Pfandbeträge (€) |
19% | 0.08, 0.10, 0.15, 0.16, 0.25, 0.28, 0.30, 0.32, 0.35, 0.40, 0.45, 0.48, 0.50, 0.75, 0.80, 0.90, 0.96, 1.00, 1.35, 1.50, 1.60, 1.80, 1.92, 2.00, 2.25, 2.50, 3.00, 3.10, 3.30, 3.50, 8.00 |
7% | 0.15, 0.25, 5.00, 6.00, 6.50, 10.00, 12.00, 13.50, 15.00 |
Andere Themen
Beschreibungen sind optional, werden jedoch empfohlen. Fehlen sie, wird der Name wiederverwendet.
Überprüfe, ob die Artikel Preise in SIDES haben. Artikel ohne Preise werden nicht synchronisiert.
Überprüfe, ob die Artikel und Gruppen im Store aktiv sind, wenn die Speisekartensynchronisierung durchgeführt wird.