Ausführungszeit und -gebühren

In dieser Anleitung werden folgende Themen behandelt:

  1. Eine allgemeine Beschreibung der unterstützten Anwendungsfälle zu Gebühren und Auftragsausführungszeit
  2. Spezifische Anleitung zum Angeben der Auftragsausführungszeit und -gebühren für action_link in deinen Feeds
  3. Erwartungen an die Genauigkeit

Ein vollständiges Feedbeispiel, das die Nutzung der Ausführungszeit und der Gebühren für die Bestellung zeigt, findest du im EPA-Beispiel für Bestellweiterleitung.

Anwendungsfälle für Gebühren und Ausführungszeit

Anwendungsfälle für Gebühren

Es gibt verschiedene Möglichkeiten, Gebühren anzugeben. Im Folgenden werden die verschiedenen unterstützten Anwendungsfälle sowie einige Beispielsprachen beschrieben, die der Sprache ähneln, die der Nutzer im Front-End sieht.

  • Feste Gebühr: „Liefergebühr 5 €“ oder „Servicegebühr 5 €“
  • Prozentgebühr: „Liefergebühr 5 %“ oder „Servicegebühr 5 %“
  • Gebührenbereiche: „Liefergebühren 2–10 $“ oder „Servicegebühren 3–6 %“
  • Offene Bereiche: „Liefergebühren beginnen bei 5 %“ oder „Servicegebühren bis zu 20 $“

Wie in den Beispielen oben gezeigt, können Gebühren entweder als Liefer- oder als Servicegebühr angegeben werden. Sie können auch mehrere Gebühren angeben, z.B. „Servicegebühr 5–10 %, Liefergebühr 5 €“.

Nicht unterstützt sind Anwendungsfälle, bei denen Gebühren im Laufe des Tages aktualisiert werden müssen oder bei denen sich die Gebühren je nach Nutzerinformationen ändern müssen.

Anwendungsfälle für die Ausführungszeit

Die Verfügbarkeitszeit kann in verschiedenen Formaten angegeben werden, damit Sie korrekte Daten angeben können. Die folgenden Punkte beschreiben die verschiedenen unterstützten Anwendungsfälle sowie einige Beispielsprachen, die denen im Front-End ähnlich sind.

  • Feste Zeiten: „Liefert in 30 Minuten“ oder „Abholung in 15 Minuten“
  • Zeiträume: „Liefert in 30 Min. bis 1 Std.“ oder „Abholung in 15–20 Min.“
  • Offene Zeiträume: „Liefert in mehr als 10 Minuten“ oder „Abholung in weniger als 1 Std.“

Die Auftragsausführungszeit kann sowohl für Abholung als auch für Lieferung in einem gängigen Format angegeben werden (siehe unten). Wie in den Beispielen oben gezeigt, entspricht der den Nutzern angezeigte Text dem im Aktionslink angegebenen Fulfillment-Typ.

Nicht unterstützt werden Anwendungsfälle, bei denen Zeiten im Laufe des Tages aktualisiert oder anhand von Nutzerinformationen angepasst werden müssen.

Ausführungszeit für Bestellungen über Feeds festlegen

Die Auftragsausführungszeit für Aktionslinks ist in der Nachricht action_link des Händlerfeeds im Feld food_ordering_metadata enthalten. Für jede mit dem Händler verknüpfte action_link musst du Informationen zur Auftragsausführung über einen der Nachrichtenpfade angeben.

Feste Ausführungszeit

  • Merchant.action_link.food_ordering_metadata.fulfillment_lead_time_duration

Diese Nachrichten sollten das folgende Format haben:

{
  "fulfillment_lead_time_duration": {
    "seconds" : 1800
  }
}

Ausführungszeit für Bereich

  • Merchant.action_link.food_order_metadata.fulfillment_lead_time_duration_range

Diese Nachricht sollte das folgende Format haben:

{
  "fulfillment_lead_time_duration_range": {
    "min_duration": {
       "seconds" : 1800
     },
    "max_duration": {
     "seconds" : 2400
    }
  }
}

Gebühren über Feeds angeben

Ähnlich wie bei der Auftragsabwicklung können Gebühren als Teil der action_link-Nachricht im Feld food_ordering_metadata angegeben werden. Für jedes mit einem Händler verknüpfte action_link kannst du Gebühreninformationen über den Nachrichtenpfad angeben:

merchant.action_link.food_ordering_metadata.fee_details

Nachfolgend finden Sie einige Beispiele für die verschiedenen Anwendungsfälle.
  • Feste Liefergebühr von 1,99 $: 
    [
  {
    "type": "DELIVERY",
    "fee_amount": {
      "amount": {
        "currency_code": "USD",
        "units": "1",
        "nanos": "990000000"
      }
    }
  }
]
  • Eine prozentuale Liefergebühr von 5,6 % 
    [
  {
    "type": "DELIVERY",
    "fee_amount": {
      "cart_percentage": {
        "value": "5.6"
      }
    }
  }
]
  • Die Servicegebühr liegt zwischen 1,99 $und 9,99 $. 
    [
  {
    "type": "SERVICE",
    "fee_amount": {
      "amount_range": {
        "min_amount": {
          "currency_code": "USD",
          "units": "1",
          "nanos": "990000000"
        },
        "max_amount": {
          "currency_code": "USD",
          "units": "9",
          "nanos": "990000000"
        }
      }
    }
  }
]
  • Der Prozentsatz der Servicegebühr liegt zwischen 1,2% und 2,7 %. 
    [
  {
    "type": "SERVICE",
    "fee_amount": {
      "cart_percentage": {
        "value_range": {
          "min_value": "1.2",
          "max_value": "2.7"
        }
      }
    }
  }
]
  • Zwei Gebühren, eine Servicegebühr von 5 $und eine Liefergebühr von 1, 2%. 
    [
  {
    "type": "SERVICE",
    "fee_amount": {
      "amount": {
        "currency_code": "USD",
        "units": "5",
        "nanos": "0"
      }
    }
  },
  {
    "type": "DELIVERY",
    "fee_amount": {
      "cart_percentage": {
        "value": "1.2"
      }
    }
  }
]

Genauigkeit von Gebühren und Ausführungszeit

Genauigkeit der Gebühren

Wenn Sie Gebührendaten für einen Händler zur Verfügung stellen, erwarten wir, dass Sie Ihre Gebühren korrekt angeben. Geben Sie alle Liefer- und Servicegebühren an, die für eine Bestellung anfallen können.

Uns ist bewusst, dass die Gebühren im Laufe der Zeit und je nach Nutzer variieren können. Aus diesem Grund bieten wir die Möglichkeit, Gebühren als Bereiche anzugeben, auch offene Bereiche. Wenn die Gebühren stark variieren können, achte darauf, dass der angegebene Bereich die Gebühren umfasst, die der Nutzer während der Transaktion sehen kann.

Wenn Sie sich nicht sicher sind, was genau in Ihrem Fall erforderlich ist, wenden Sie sich an Ihren Actions Center-Ansprechpartner.

Genauigkeit der Auftragsausführungszeit

Uns ist bewusst, dass sich die Einzelheiten der Auftragsabwicklung aufgrund einer Vielzahl von Faktoren ändern. Diese Faktoren umfassen:

  • Änderungen der Bearbeitungszeit der Bestellung basierend auf der Bestellgröße
  • Änderungen der Auftragsausführungszeit basierend auf der Zeit bis zum Abschluss der Bestellung und des Bezahlvorgangs
  • Latenz zwischen der Aktualisierung von Änderungen der Auftragsausführungszeit über Feeds
  • Die Lieferadresse des Nutzers.

Jeder dieser Faktoren kann dazu führen, dass die dem Nutzer anfangs angezeigte Ausführungszeit nicht der genauen Ausführungszeit entspricht, die dem Nutzer an der Kasse angezeigt wird. Das Ziel der Implementierung der Auftragsausführungszeit besteht nicht darin, diese vollständig zu beseitigen, sondern den Nutzern so oft wie möglich klare Informationen bereitzustellen.

Von Partnern wird erwartet, dass sie eine Implementierung anbieten, die dazu führt, dass Nutzern so oft wie möglich und auf Best-Effort-Basis eine genaue Zeit für die Auftragsausführung angezeigt wird. Wenn es aufgrund dieser Faktoren erhebliche Schwankungen beim Timing gibt, empfehlen wir, einen Zeitraum anzugeben, in dem diese Schwankungen berücksichtigt werden. Wenn sich die Auftragsausführungszeit aufgrund von Bestelldetails ändert, sollte dies den Nutzern bei der Ankunft im Bestellablauf deutlich angezeigt werden.

Wenn Sie sich nicht sicher sind, was genau in Ihrem Fall erforderlich ist, wenden Sie sich an Ihren Actions Center-Ansprechpartner.