Bearbeitungszeit und Gebühren (nur alte Version)

In dieser Anleitung erfahren Sie Folgendes:

  1. Eine allgemeine Beschreibung der Anwendungsfälle für Gebühren und Lieferzeit, die unterstützt werden
  2. Spezifische Anleitung zum Angeben der Lieferzeit und Gebühren für action_link(s) in Ihren Feeds
  3. Erwartungen an die Genauigkeit

Ein vollständiges Feedbeispiel, das die Verwendung der Zeit für die Auftragsausführung und der Gebühren zeigt, finden Sie im Beispiel für eine EPA mit Bestellweiterleitung.

Anwendungsfälle für Gebühren und Lieferzeit

Anwendungsfälle für Gebühren

Es gibt mehrere Möglichkeiten, Gebühren anzugeben. Im Folgenden werden die verschiedenen unterstützten Anwendungsfälle beschrieben. Außerdem finden Sie einige Beispieltexte, die dem entsprechen, was Nutzer im Frontend sehen.

  • Pauschalgebühr: „Liefergebühr 5 €“ oder „Servicegebühr 5 €“
  • Prozentuale Gebühr: „Liefergebühr 5 %“ oder „Servicegebühr 5 %“
  • Gebührenspannen: „Liefergebühren 2–10 €“ oder „Servicegebühren 3–6 %“
  • Offene Bereiche: „Liefergebühren ab 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. Es ist auch möglich, mehrere Gebühren anzugeben (z.B. „Servicegebühr 5–10 %, Liefergebühr 5 €“).

Nicht unterstützt werden Anwendungsfälle, bei denen Gebühren im Laufe des Tages aktualisiert oder anhand von Informationen zum Nutzer geändert werden müssen.

Anwendungsfälle für die Lieferdauer

Wir erlauben mehrere Formate für die Angabe der Verfügbarkeitszeiten, damit Sie korrekte Daten angeben können. Im Folgenden werden die verschiedenen unterstützten Anwendungsfälle beschrieben. Außerdem finden Sie einige Beispieltexte, die dem entsprechen, was Nutzer im Frontend sehen.

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

Die Lieferzeit kann sowohl für die Abholung als auch für die Lieferung in einem gemeinsamen Format angegeben werden (siehe unten). Wie in den Beispielen oben dargestellt, entspricht der den Nutzern angezeigte Text dem Typ der Auftragsausführung, der im Aktionslink angegeben ist.

Nicht unterstützt werden Anwendungsfälle, bei denen Zeiten im Laufe des Tages aktualisiert oder anhand von Informationen zum Nutzer geändert werden müssen.

Lieferzeit für Bestellungen über Feeds angeben

Die Auftragsausführungszeit für Action-Links ist im Händlerfeed in der Nachricht action_link im Feld food_ordering_metadata enthalten. Für jeden action_link, der mit dem Händler verknüpft ist, müssen Sie über einen der Nachrichtenpfade Informationen zur Auftragsausführung angeben.

Feste Auftragsausführung

  • Merchant.action_link.food_ordering_metadata.fulfillment_lead_time_duration

Diese Nachrichten müssen das folgende Format haben:

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

Ausführungszeit des Bereichs

  • Merchant.action_link.food_order_metadata.fulfillment_lead_time_duration_range

Diese Nachricht muss folgendes Format haben:

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

Gebühren über Feeds angeben

Ähnlich wie bei der Lieferdauer können Gebühren in der action_link-Nachricht im Feld food_ordering_metadata enthalten sein. Für jede action_link, die mit einem Händler verknüpft ist, können Sie über den Nachrichtenpfad Gebühreninformationen angeben:

merchant.action_link.food_ordering_metadata.fee_details

Im Folgenden finden Sie einige Beispiele für die verschiedenen Anwendungsfälle.
  • Eine 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"
        }
      }
    }
  }
]
  • Ein Prozentsatz für die Servicegebühr von 1,2% bis 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"
      }
    }
  }
]

Richtigkeit von Gebühren und Lieferzeit

Richtigkeit der Gebühren

Wenn Sie Gebührendaten für einen Händler angeben, müssen diese korrekt sein. Sie sollten alle Versand- und Servicegebühren angeben, 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 können Sie Gebühren als Bereiche angeben, einschließlich offener Bereiche. Wenn Gebühren stark variieren können, muss der angegebene Bereich alle Gebühren umfassen, die einem Nutzer bei einer Transaktion in Rechnung gestellt werden können.

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

Richtigkeit der Angaben zur Auftragsausführung

Uns ist bewusst, dass sich die Dauer der Auftragsausführung aufgrund verschiedener Faktoren ändern kann. Diese Faktoren umfassen:

  • Änderungen bei der Lieferzeit je nach Bestellmenge
  • Änderungen an der Lieferzeit der Bestellung basierend auf der Zeit, die für die Bestellung und den Bezahlvorgang benötigt wird
  • Latenz zwischen der Aktualisierung der Änderungen bei der Auftragsausführung über Feeds
  • Die Lieferadresse des Nutzers.

Diese Faktoren können dazu führen, dass die ursprünglich angezeigte Lieferzeit der Bestellung nicht mit der genauen Lieferzeit übereinstimmt, die der Nutzer an der Kasse sieht. Ziel der Implementierung der Lieferdauer ist es nicht, diese Probleme vollständig zu beseitigen, sondern Nutzern so oft wie möglich klare Informationen zur Verfügung zu stellen.

Partner müssen eine Implementierung bereitstellen, die dazu führt, dass Nutzern so oft wie möglich eine korrekte Lieferzeit angezeigt wird. Wenn sich die Zeit aufgrund dieser Faktoren erheblich ändern kann, sollten Sie einen Zeitraum angeben, der diese Variabilität abdeckt. Wenn sich die Lieferzeit aufgrund von Bestelldetails ändert, sollte dies den Nutzern klar angezeigt werden, wenn sie den Bestellvorgang starten.

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