Zum Hauptteil navigieren

Integrationsanforderungen

API: Drive (classic)

In diesem Dokument wird die Drive (classic)-API behandelt. Wenn du die Drive-API verwendest, siehe die Drive-Integrationsanforderungen.

Wir verfolgen ein einfaches Ziel: Wir möchten den kundenfreundlichsten, zuverlässigsten Service für lokale Lieferungen bieten und gleichzeitig unseren Anbieter, Kund:innen und Kurier:innen höchste Sicherheit bieten. Dafür stellen wir ein Self-Service-Portal bereit, über das Entwickler:innen für ihr eigenes Unternehmen auf die umfangreiche Flotte an Kurier:innen zugreifen können. Jede Integration wird von unserem Team auf Einhaltung technischer und rechtlicher Vorgaben geprüft.

Vor Anforderung des Zugriffs auf die Produktionsumgebung​

Bevor du auf unsere Produktionsumgebung zugreifen und Lieferungen durchführen kannst, prüft DoorDash dein entwickeltes Produkt. Gehe vorab die Checkliste im Folgenden durch, um eine erfolgreiche Prüfung zu gewährleisten. Das Erfüllen aller aufgeführten Bedingungen garantiert nicht die Genehmigung, räumt jedoch im Vorfeld die häufigsten Probleme aus.

Stelle Folgendes sicher:

  • Das Abholen oder Liefern von Artikeln, für die Einschränkungen gelten, wird mit angemessenen Maßnahmen verhindert. Zu diesen Artikeln gehören Tabak, Cannabis oder andere illegale Drogen, Waffen und Sprengstoff. Eine vollständige Liste von Artikeln, für die Einschränkungen gelten und die nicht durch DoorDash ausgeliefert werden, findest du im Folgenden.
  • Du hast unseren Lizenzbestimmungen für Technologien und den Nutzungsbedingungen zugestimmt.
  • Du hast mit dem Lieferungssimulator Testlieferungen erstellt und dich mit den Prozessen von DoorDash vertraut gemacht.
  • Du bist bereit für die Durchführung einer Live-Demo mit dem DoorDash-Team. Du führst uns über eine Bildschirmfreigabe durch sämtliche Schritte einer Testlieferung und demonstrierst die gesamte Benutzererfahrung.
  • Die erforderlichen Felder werden in sämtlichen API-Aufrufen übermittelt. Alle erforderlichen Felder werden in unserer API-Referenz registriert.
  • Wichtige Angaben zur Lieferung wie die von DoorDash bereitgestellte Lieferungs-/Support-ID werden den entsprechenden Benutzern in deiner API zur Verfügung gestellt. Weitere Informationen zu unseren Mindestanforderungen an die UI findest du im Folgenden und auf unserer Gewusst-wie-Seite zum Produktionszugriff.

Rechts- und Sicherheitsvorgaben​

DoorDash räumt der Sicherheit aller Benutzer:innen (Kurier:innen, Anbieter und Kund:innen) der Plattform und der Services höchste Priorität ein. Alle Benutzer:innen von DoorDash, die Lieferungen in Auftrag geben oder durchführen, sollen dies mit größtmöglicher Sicherheit tun können. Die wichtigsten diesbezüglichen Punkte sind im Folgenden zu finden, die Liste ist jedoch nicht vollständig. Wenn dein Unternehmen und/oder Produkt diese Anforderungen nicht erfüllt, kann DoorDash dir den Zugang zur Produktionsumgebung verweigern. Verfügst du bereits über den Zugang, behalten wir uns das Recht vor, diesen ggf. zu deaktivieren.

Artikel, für die Einschränkungen gelten​

DoorDash schränkt den Verkauf bestimmter Artikel ein (im Folgenden findest du eine unvollständige Übersicht), um eine hochwertige Benutzererfahrung garantieren zu können und um die Einhaltung geltenden Rechts sicherzustellen. Du bist für die Umsetzung angemessener Sicherheitsmaßnahmen verantwortlich, um das Abholen oder Liefern von Artikeln zu verhindern, für die Beschränkungen gelten.

In der folgenden (unvollständigen) Liste sind Artikel aufgeführt, für die Einschränkungen gelten. Diese Liste kann nach eigenem Ermessen von DoorDash geändert werden. DoorDash behält sich das Recht vor, die im Folgenden aufgeführten Artikel oder sämtliche anderen Artikel, die nach alleinigem Ermessen von DoorDash als unsicher oder unangemessen gelten, aufzulisten, zu transportieren, zuzustellen, zu liefern oder anderweitig über unsere Services verfügbar zu machen.

  • Menschen, Pflanzen, Tiere bzw. (Körper-)Teile oder sterbliche Überreste;
  • Illegale Artikel, Diebesgut;
  • Feuerwerkskörper, Sprengstoff, (Schusswaffen, Waffenteile, Munition, Munitionsteile, Anleitungen zum Bauen von Waffen;
  • Artikel, die Gewalt oder Kriminalität fördern;
  • Pornografische oder sittenwidrige Artikel;
  • Alle folgenden Artikel, für die keine Zusatzvereinbarung mit DoorDash getroffen wurde:
    • Alkohol
    • Tabak-/Vape-Produkte
    • Erkältungsmedikamente, Pharmazieprodukte, rezeptfreie Medikamente, Vitamine, medizinische Geräte oder Ergänzungsmittel
  • Partydrogen oder Utensilien für den Drogengebrauch, u. a. Cannabis oder CBD-Produkte, Kratom oder Inhalationsmittel wie Lachgas;
  • Giftige Substanzen
  • Artikel mit einem Gewicht von über 50 lbs (22 kg);
  • Alle Artikel, deren Lieferung ohne Genehmigung oder Lizenz nach geltendem örtlichen Recht untersagt ist;
  • Gefahrenstoffe wie medizinische Abfälle oder giftige bzw. brennbare Artikel, mit Ausnahme von Materialien, für die Folgendes gilt:
    • (i) ORM-D-Kennzeichnung oder (ii) Lieferung geringer Menge UND Konsumgut UND
    • In Mengen, die keinerlei Etikettierung erfordern
  • Geld, Gutscheine, Lottoscheine oder übertragbare Wertpapiere;
  • Produktfälschungen;
  • Rohes Fleisch oder rohe Schalentiere;
  • Produkte aus bedrohten Tier- oder Pflanzenarten; Artikel, die aus Produkten aus bedrohten Tier- oder Pflanzenarten hergestellt wurden (u. a. Elfenbein, Nashorn, Beluga, Buschfleisch);
  • Artikel, die Hassgruppen oder terroristische Gruppierungen unterstützen;
  • Produkte, die spezifische medizinische Wirkungen versprechen;
  • Alle Artikel, die als bedrohlich, sittenwidrig, belästigend oder unangemessen wahrgenommen werden können oder in anderer Weise gegen die geltenden allgemeinen Geschäftsbedingungen von DoorDash verstoßen.

Einhaltung von Gesetzen und Bestimmungen​

Dein Unternehmen und alle Mitarbeitenden, Beauftragten, Vertreter:innen, Subunternehmen und dein Produkt müssen allen geltenden Gesetzen und Bestimmungen in allen bedienten Märkten entsprechen.

Technologie/UI​

Wir möchten allen Beteiligten einen einfachen, reibungslosen und zuverlässigen Lieferservice bieten. Wie du dein Produkt entwickelst, liegt bei dir. Die folgenden Richtlinien zu Technik und Benutzeroberfläche sollen sicherstellen, dass bei Abholung und Lieferung alles glatt läuft. Auf unserer Gewusst-wie-Seite zum Produktionszugriff erfährst du mehr über den Demoprozess, und wie das DoorDash-Team Anträge auf Produktionszugriff prüft.

Anforderungen​

  • Die DoorDash-Liefer-ID (id) muss Anbietern, Geschäftsbetreiber:innen und/oder Benutzer:innen angezeigt werden, die Abholungen in Ihrer Benutzeroberfläche ermöglichen. Diese ganzzahlige, in allen Rückgaben der API enthaltene ID ist für alle Support-Anfragen erforderlich, einschließlich Drive-Anbietersupport (für nicht technische Fragen/Probleme mit Lieferungen wie Rückerstattungen) und Entwicklersupport (für Fragen zur Technik/API/Probleme in Zusammenhang mit Lieferungen).
  • Die Abholzeit muss Benutzern angezeigt werden, die die Abholung abwickeln. Hierbei handelt es sich in der Regel um den Anbieter oder den:die Betreiber:in eines Geschäfts.
  • „Pickup Business Name“ muss in Lieferanfragen stets übergeben werden, wenn es sich bei der Abholadresse um einen Unternehmensstandort handelt.
  • Die Endbenutzer:innen müssen eine klare Rückmeldung erhalten, wenn DoorDash das Angebot und/oder die Lieferanfrage ablehnt. Wenn beispielsweise DoorDash aufgrund einer ungültigen Lieferadresse einen Fehler in der API zurückgibt, muss der:die Endbenutzer:in vor dem Kaufabschluss aufgefordert werden, die Adresse zu korrigieren.
  • Name des Unternehmensexternen Unternehmens: Muss in allen Estimate-, Validate- und Create-Anfragen übergeben werden. Wird für Plattformpartner verwendet, die für mehrere Restaurantpartner agieren. Dies ist in der Regel der Markenname, z. B. McDonald's. Dieses Feld muss in der Testphase nicht ausgefüllt werden, in der Produktionsphase jedoch schon. Dieses Feld wird dem:der Kurier:in angezeigt, wenn „pickup_business_name“ nicht übergeben wird.
  • external_store_id Muss in allen Estimate-, Validate- und Create-Anfragen übergeben werden. Hierbei kann es sich um eine eindeutige alphanumerische Kennung für einen bestimmten Abholort handeln, die DoorDash intern speichert und auf Monatsrechnungen angibt.
  • Ein Trinkgeld in Höhe von 20 % muss in der den Kund:inneen angezeigten Benutzeroberfläche vorausgewählt sein und bei der Erstellung der Lieferung an DoorDash übergeben werden. Trinkgelder gehen zu 100 % direkt an Kurier:innen und sind ein wichtiger Bestandteil von deren Vergütung. Bei allen Produkten mit Onlinebestellung prüfen wir während der Live-Demo, ob ein Trinkgeld in Höhe von 20 % vorausgewählt ist. Kund:innen können selbstverständlich mehr oder weniger Trinkgeld geben. Wichtig ist jedoch, dass Kund:innen über die Benutzeroberfläche so einfach wie möglich Trinkgeld geben können und dass der volle Trinkgeldbetrag während der Erstellung der Lieferung an DoorDash übergeben wird.
  • Die Abhol- oder Lieferzeit wird in UTC angegeben.

Empfehlungen​

Diese Angaben sind nicht erforderlich, werden aber dringend empfohlen, um eine hochwertige Kundenerfahrung bei Abholung und Lieferung zu gewährleisten.

  • Übergib bei der Erstellung von Lieferungen klare Anweisungen für die Abholung und Übergabe.
  • Stelle Anbietern und Kund:innen den von DoorDash bereitgestellten Link zur Lieferungsverfolgung zur Verfügung.
  • Erstelle Funktionen, die es internen Administrator:innen und/oder Ihren Anbieterkund:innen ermöglichen, Lieferungen anzuzeigen und zu verwalten. Wenn es sich bei deinem Unternehmen beispielsweise um eine Plattform handelt, über die Kund:innen Blumen bei Blumenhändlern in ihrer Region bestellen können, empfehlen wir die Einrichtung eines Dashboards, über das die Blumenhändler:innen die Details zu aktuellen und abgeschlossenen Lieferungen anzeigen können.