Einrichten und Inhalte der Speisekarte
Unsere Pipeline für Marktplatz-Integration ist derzeit ausgelastet. Wir nehmen im Moment keine neuen Partner an, sind aber dabei, Self-Service-Tools für das Onboarding von Anbietern zu entwickeln. Bitte fülle das Formular für Interessenten der Marktplatz-Integration aus, um mit DoorDash in Kontakt zu treten, bevor du deine Integration erstellst.
Wo finde ich Beispieldaten für eine verschachtelte Speisekarte?
Sieh dir den Abschnitt „Referenzen“ an.
Gibt es eine Maximalgröße für Speisekarten?
Wir können Speisekarten mit einer Größe von bis zu 25 MB verarbeiten.
Wie wird der Abschnitt „Favoriten“ angezeigt?
Was in diesem Abschnitt angezeigt wird, basiert auf einer Berechnung von DoorDash mittels maschinellem Lernen. Wenn die Speisekartenphase fehlgeschlagen ist, erstellen wir keine Speisekarte und die Speisekarten-ID ist gleich null.
Wie kann ich eine Speisekarte entfernen?
Um eine Speisekarte von der Plattform von DoorDash zu entfernen, schickst du eine Speisekarten-PATCH-Anfrage, in der du active auf false setzt.
Kann ich den Status einer Speisekarte steuern?
Ja. Zur Aktivierung/Deaktivierung einer Speisekarte schickst du eine Anfrage zur Aktualisierung der Speisekarte, in der du das Feld active je nach dem gewünschten Ergebnis auf true oder false setzt.
Wo liegt der Unterschied zwischen „price“ und „base_price“?
Bei base_price handelt es sich um ein optionales Feld, das auf der Ebene des Artikels und der Zusatzoptionen gespeichert wird. Du kannst damit die duale Preisgestaltung für die Abholung durch den:die Kund:innen aktivieren. Dieses Feld enthält den Preis vor Ort für einen Artikel oder eine Option, unabhängig von einem Inflationsaufschlag, der ggf. auf den Lieferpreis angewendet wird. Das Feld price bleibt ein Pflichtfeld und sollte den Lieferpreis für einen Artikel oder eine Option enthalten (einschließlich Inflationsaufschlag, falls der Anbieter dies möchte). Wenn ein base_price für einen Artikel oder eine Option vorhanden ist, wird dieser Preis für Speisekarten zur Abholung verwendet. Wenn Kund:innnen auf der Website von Abholung auf Lieferung (oder andersherum) wechseln, werden die Preise entsprechend von base_price (Abholung) auf price (Lieferung) aktualisiert (oder andersherum). Wir empfehlen dir, einen Support für die Abholpreisgestaltung einrichtest, um unsere gemeinsame Kundenerfahrung zu schützen. Weitere Informationen findest du hier. Wenn du die Nutzung dieser Funktion in Erwägung ziehst, wende dich an deinen DoorDash-Kontakt, um dies auf Unternehmensebene zu aktivieren.
Was verbirgt sich hinter Artikel/Extra/Option?
Wie kann ich einen Steuersatz angeben?
Ab dem Jahr 2020 unterstützen wir die Angabe von Steuersätzen auf der Ebene des Artikels und der Zusatzoptionen Wenn dieser Wert angegeben wird, verwendet DoorDash diesen Steuersatz zur Berechnung der Steuern für Staaten ohne Richtlinien für Marktplatzvermittler (Nicht-MPF-Staaten). Der Steuersatz sollte als ganze Zahl angegeben werden. Nehmen wir an, mein Steuersatz für einen Artikel ist 5 %. Für tax_rate sollte dann der Wert 5 (nicht .05) in der Speisekarten-Payload angegeben werden. Wenn in der Speisekarte keine Steuersätze angegeben sind, wird für die Steuerberechnung das Drittanbieter-Steuermodul von DoorDash verwendet. Wenn du Steuersätze in der Speisekarte angeben möchtest, kannst du dich für weitere Informationen an deinen Kontakt bei DoorDash wenden. Standardmäßig akzeptieren wir nur für Anbieter in Staaten ohne Richtlinien für Marktplatzvermittler die im Speisekarten-Payload angegebenen Steuersätze auf Artikelebene. Für Anbieter in Staaten mit Richtlinien für Marktplatzvermittler (MPF-Staaten) verwenden wir die Steuerberechnungen von DoorDash, da DoorDash dafür verantwortlich ist, diese Steuerbeträge im Namen des Anbieters abzuführen und zu zahlen. Wenn du glaubst, dass einer oder mehrere deiner Anbieter von den von DoorDash berechneten Steuerbeträgen in einem MPF-Staat befreit werden sollten, wende dich an deinen primären DoorDash-Kontakt. Diese Befreiung wird nur für besondere Ausnahmen gewährt und bedarf der Genehmigung durch das DoorDash-Steuerteam.
Wo finde ich eine Liste der MFP-Staaten?
Eine aktuelle Liste der MFP-Staaten findest du hier.
Berücksichtigt das Steuermodul von DoorDash Zuschläge wie Steuern für zuckerhaltige Getränke und Flaschenpfand?
Das Steuermodul von DoorDash berücksichtigt derzeit keine dieser Zuschläge bei der Berechnung von Steuern für Bestellungen. Solche Steuern müssen vom Anbieter über die Speisekarte eingegeben werden, um Anwendung zu finden.
Wie erstelle ich eine standardmäßige „itemOption“?
Damit eine itemOption standardmäßig ausgewählt wird, musst du in der Speisekarten-Payload den Parameter „Standard“ auswählen und seinen Wert auf true festlegen.
Wie werden Kategorien, Artikel und Artikeloptionen sortiert?
Die Sortierung erfolgt nach der in der Speisekarten-Payload festgelegten sort_id. Wenn diese Feld nicht festgelegt ist, wird standardmäßig alphabetisch sortiert.
Wie erstelle ich ein Optionsfeld?
Zur Erstellung eines Optionsfelds solltest du max_num_options = 1 und min_num_options = 1 so festlegen, dass nur eine Option ausgewählt werden kann.
Was genau wird durch die Felder „Min“ und „Max“ jeweils gesteuert?
Du solltest diese Felder so einstellen, dass sie richtig zusammen funktionieren. Sonst kann es zu Problemen kommen, wenn Kund:innen die Anforderungen für die einzelnen Felder nicht erfüllen und dadurch einen Artikel nicht in den Warenkorb legen können. So kannst du beispielsweise nicht gleichzeitig min_nim_options = 1 (mindestens eine Option muss ausgewählt werden) und max_option_choice_quantity = 0 (von allen Optionen können nicht mehr als null Optionen ausgewählt werden) festlegen.
Im Folgenden findest du weitere Informationen zu diesen Feldern:
_num_options: Steuert, wie viele Optionen du auswählen kannst. Der maximale Wert kann dabei nie höher sein als die Anzahl an Optionen, die für das jeweilige Extra verfügbar sind.
Im Beispiel „Geschmacksrichtung für Flügel ohne Knochen auswählen“ ist die min_num_options = 2 und die max_num_options = 2. Dies macht das Extra erforderlich und sorgt dafür, dass der:die Kund:in nicht mehr als zwei Optionen auswählen kann.
_option_choice_quantity: Steuert die maximal erlaubte Menge einer einzelnen Option. Wenn dieses Feld einen Wert ungleich null hat, wird statt einem Kontrollkästchen oder Optionsfeld eine Mehrfachauswahl für die Menge angezeigt (siehe Screenshot unten).
In diesem Beispiel ist min_option_choice_quantity = 2. Das bedeutet, dass der:die Kund:in mindestens zwei Flügel pro gewählter Geschmacksrichtung auswählen muss.
In diesem Beispiel ist max_option_choice_quantity = 10. Das bedeutet, dass der:die Kund:in nicht mehr als zehn Flügel pro gewählter Geschmacksrichtung auswählen kann.
_aggregate_choice_quantity: Steuert die maximale erlaubte Summe der von einer Option gewählten Menge.
In diesem Beispiel ist min_aggregate_choice_quantity = 10 und max_aggregate_choice_quantity = 10. Dadurch muss der:die Kund:in insgesamt zehn Flügel für die gewählten Geschmacksrichtungen auswählen.
num_free_options: In Verbindung mit der „option_choice_quantity“. Wenn eine Bestellung die vorgesehene Anzahl ausgewählter Optionen überschreitet, wird bei jeder darauf folgenden Option ein Preis angewendet.
In diesem Beispiel ist _num_free_options = 4. Das bedeutet, dass dem/der Kund:in jede weitere Option mit dem jeweils angegebenen Preis berechnet wird, wenn mehr als vier Optionen ausgewählt wurden.
Wenn die Preise der Optionen unterschiedlich hoch sind und die Anzahl der ausgewählten Optionen die num_free_options überschreitet, stellt DoorDash dem/der Kund:in die teuerste Option in Rechnung.
Wie kann ich mehrere Speisekarten verwalten („Day-Parting“)?
Wenn du mehrere Speisekarten mit unterschiedlichen Zeiten (tageszeitabhängige Speisekarten) per POST veröffentlichst, wird standardmäßig die Speisekarte angezeigt, die der aktuellen Tageszeit entspricht. Bei diesen Speisekarten wird eine kontinuierliche Speisekartenlogik angewendet, wenn die Zeit zwischen der Endzeit der ersten Speisekarte und die Startzeit der zweiten Speisekarte weniger als eine Minute beträgt. Das bedeutet, dass DoorDash den Zeitpuffer von 20 Minuten nicht auf die Endzeit der ersten Speisekarte anwendet.
Wenn du mehrere Speisekarten mit sich überschneidenden Zeiten per POST veröffentlichst, werden alle auf der Plattform von DoorDash angezeigt, wie im Dropdown-Menü im Screenshot unten dargestellt. Wenn die Zeiten sich überschneiden, wird für diesen Zeitraum standardmäßig die zuletzt erstellte Speisekarte angezeigt. Beispiel: Wenn du eine Frühstücks-Speisekarte und eine ganztägig gültige Speisekarte hast, ist die standardmäßig auf DoorDash angezeigte Speisekarte diejenige, die zuletzt erstellt wurde.
Wie kann ich meiner Speisekarte Bilder hinzufügen?
Wir haben unsere POS-Integration erweitert, um Fotos direkt aus der Quelle abzurufen, wenn wir die restlichen Elemente der Speisekarte für den heutigen Tag abrufen. Wenn das System erkennt, dass die Foto-URL, die zusammen mit einem Artikel bereitgestellt wurde, mit der URL des letzten Speisekarten-Updates übereinstimmt, wird kein neues Foto eingepflegt. Wenn das System eine neue Foto-URL erkennt, wird das Bild in die Systeme von DoorDash eingepflegt und an unser internes Foto-Team weitergeleitet. Das Team überprüft, genehmigt und schneidet die Fotos zu und verknüpft sie dann oder lehnt sie gemäß unseren Richtlinien für Bildqualität ab. Dieser Verknüpfungsvorgang nutzt die Zuordnung Item<>PhotoURL aus der POS-Speisekarten-Payload, um festzustellen, welche Fotos mit welchem Artikel verknüpft werden müssen. Genehmigte Bilder werden in der Regel innerhalb von drei Werktagen eingepflegt.
URL-Anforderungen
- Im Format http oder https
- Keine Abfrageparameter in der url
- Endung auf .jpg, .jpeg oder .png
- Bild für DoorDash zugänglich und nicht durch Berechtigungsanforderungen wie Autorisierungsprobleme (403) gesperrt
Anforderungen an Fotos
Zur korrekten Darstellung auf der Website müssen Fotos für die Plattform von DoorDash bestimmte Kriterien erfüllen. Folgende Voraussetzungen müssen erfüllt sein:
Seitenverhältnis von 16:9
Maximale Dateigröße von 2 MB
Im Format .jpg, .jpeg oder .png
Wenn die Dateigröße, das Dateiformat oder die URL-Kriterien nicht erfüllt werden, funktioniert diese neue Funktion nicht erwartungsgemäß und der Artikel wird nicht mit einem Foto verknüpft. Wenn das Seitenverhältnis eines Fotos den Voraussetzungen nicht entspricht, versucht DoorDash, das Foto zuzuschneiden, ohne die Bildqualität zu beeinträchtigen. Wenn das Zuschneiden zu schlechten Bildeinstellungen führt, wird das Foto abgelehnt.
Kann ich auf meiner DoorDash-Speisekarte Alkohol verkaufen?
DoorDash erlaubt Anbietern den Verkauf von Alkohol über die Plattform, sobald diese eine Alkohol-Zusatzvereinbarung unterzeichnet haben. Wende dich an deinen DoorDash-Kontakt, um die Alkohol-Zusatzvereinbarung zu lesen und zu unterzeichnen. Sobald dies passiert ist, kennzeichnen wir alkoholhaltige Artikel in der Speisekarten-Payload mit der Markierung is_alcohol. Wenn dies auf true gesetzt ist, kennzeichnen wir den Artikel in unserem Backend als „Über 21“. Achte bitte darauf, dass alle alkoholhaltigen Artikel in der Speisekarte als true gekennzeichnet sind, um rechtliche Probleme zu vermeiden.
Gibt es eine Einschränkung hinsichtlich der Anzahl der Artikel/Alternativen/Unteralternativen in einer Speisekarte?
DoorDash erlaubt etwa 600.000 Artikel insgesamt (einschließlich Alternativen und Unteralternativen) pro Speisekarte („ItemOptions“, „ItemExtraOptions“). Wenn du dieses Limit erreichst, solltest du sicherstellen, dass du in allen Speisekarten-PATCH-Updates die gleichen Werte für die merchant_supplied_id verwendest wie im ursprünglichen Speisekarten-POST. Wenn die Werte für die merchant_supplied_id sich zwischen dem POST und einem der nachfolgenden Speisekarten-PATCHES ändert, gilt jeder eindeutige Wert als neuer Artikel, wodurch die Grenze von 600.000 viel schneller als erwartet erreicht wird.