Ausführungszeit und -gebühren

In dieser Anleitung werden folgende Schritte erläutert:

1. Eine allgemeine Beschreibung der Gebühr und Anwendungsfälle für die Auftragsausführung werden unterstützt
2. Spezifische Anweisungen zur Angabe der Dauer der Auftragsabwicklung und der Gebühren für Dienstfeeds:
3. Erwartungen an die Genauigkeit

Ein vollständiges Feedbeispiel, das die Nutzung von Dauer und Gebühren für die Auftragsabwicklung zeigt, finden Sie in der EPA-Beispiel für Ordering Redirect:

Gebühren

Es gibt verschiedene Möglichkeiten, Gebühren anzugeben. Beispiele:

• Fixed Fee (Feste Gebühr): „Liefergebühr 5 €“ oder „Servicegebühr 5 €“
• Prozentuale Gebü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 $“

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

Nicht unterstützt werden Anwendungsfälle, bei denen sich die Gebühren je nach Informationen ändern müssen über die Nutzenden.

Gebührenbeispiele

Liefer- und Abholgebühren

{
  "fee": {
    "fee_id": "12345/delivery_fee",
    "fee_type": "DELIVERY",
    "fixed_amount": {
      "currency_code": "USD",
      "units": 10,
      "nanos": 0
    },
    "service_ids": ["service/entity002"]
  }
}

{
  "fee": {
    "fee_id": "12345/service_fee",
    "fee_type": "SERVICE",
    "fixed_amount": {
      "currency_code": "USD",
      "units": 10,
      "nanos": 0
    },
    "service_ids": ["service/entity002"]
  }
}

Verschiedene Gebührentypen

{
  "fee": {
    "fee_id": "12345/delivery_fee",
    "fee_type": "DELIVERY",
    "fixed_amount": {
      "currency_code": "USD",
      "units": 10,
      "nanos": 0
    },
    "service_ids": ["service/entity002"]
  }
}

{
  "fee": {
    "fee_id": "12345/delivery_fee",
    "fee_type": "DELIVERY",
    "cart_percentage": {
      "base_value": {
        "currency_code": "USD",
        "units": 3,
        "nanos": 500000000
      },
      "percentage_of_cart_value": 10
    },
    "service_ids": [
      "service/entity002"
    ]
  }
}

{
  "fee": {
    "fee_id": "12345/delivery_fee",
    "fee_type": "DELIVERY",
    "range_amount": {
      "min_amount": {
        "currency_code": "USD",
        "units": 3,
        "nanos": 500000000
      },
      "max_amount": {
        "currency_code": "USD",
        "units": 5,
        "nanos": 600000000
      }
    },
    "service_ids": [
      "service/entity002"
    ]
  }
}

Ausführungszeit

Die Verfügbarkeitszeit kann in verschiedenen Formaten angegeben werden, damit Sie korrekte Daten liefern. Im Folgenden werden die verschiedenen unterstützten Anwendungsfälle beschrieben. mit einer Beispielsprache, die dem ähnelt, was der Nutzer auf dem Frontend sieht.

• Feste Zeiten: „Wird in 30 Min. geliefert“ oder „Abholung in 15 Min.“
• Zeiträume: „Wird in 30 Min.–1 Std. bereitgestellt.“ oder „Abholung in 15–20 Minuten“

Die Auftragsausführungszeit kann sowohl für Abhol- als auch für Lieferungen in einem gängigen Format angegeben werden. wie unten beschrieben.

Nicht unterstützt werden Anwendungsfälle, bei denen sich die erweiterte Textanzeige je nach Nutzerinformationen ändern muss.

Beispiele für die Ausführungszeit

Die Auftragsausführungszeit für Aktionslinks ist im Dienstleistungsfeed enthalten ETA als Teil des FoodOrderingService ein.

{
    "service": {
        "service_id": "service-id",
        "service_type": "TAKEOUT",
        "parent_entity_id": "entity-id",
        "lead_time": {
            "min_lead_time_duration": "900s"
        },
        "action_link_id": "action-link-id"
    }
},

{
    "service": {
        "service_id": "service-id",
        "service_type": "TAKEOUT",
        "parent_entity_id": "entity-id",
        "lead_time": {
            "min_lead_time_duration": "900s"
            "max_lead_time_duration": "1200s"

        },
        "action_link_id": "action-link-id"
    }
},

Zeitfenster für die Auftragsausführung

Mit ServiceHours Lieferzeiten können für ein bestimmtes Zeitfenster festgelegt werden. Standardeinstellung lead_time festgelegt im FoodOrderingService wird verwendet wenn es außerhalb der Öffnungszeiten liegt.

{
  "data": [
    {
      "service": {
        "service_id": "merchant-1-service-delivery",
        "service_type": "DELIVERY",
        "parent_entity_id": "merchant-1",
        "lead_time": {
          "min_lead_time_duration": "1200s"
        },
        "action_link_id": "merchant-1-takeout-delivery-action"
      }
    },
    {
      "service_hours": {
        "hours_id": "merchant-1-advance-hours-delivery",
        "service_ids": ["merchant-1-service-delivery"],
        "asap_hours": [
          {
            "time_windows": {
              "time_windows": {
                "open_time": {
                  "hours": 11
                },
                "close_time": {
                  "hours": 13,
                  "minutes": 30
                }
              }
            },
            "lead_time": {
              "min_lead_time_duration": "2400s"
            }
          }
        ]
      }
    }
  ]
}

Gebühr und Genauigkeit der Ausführungszeit

Gebührengenauigkeit

Wenn Sie Gebührendaten für einen Händler angeben, erwarten wir von Ihnen, dass Sie genau angeben, Ihrer Gebühren. Geben Sie alle Liefer- und Servicegebühren an, die für eine Bestellung anfallen können.

Uns ist bewusst, dass 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, einschließlich offener Bereiche. In Fällen, in denen Gebühren variieren können müssen Sie deutlich darauf achten, dass der angegebene Bereich die Gebühren umfasst, die für den Nutzer anfallen, ihre Transaktion durchführen.

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

Genauigkeit der Zeit für die Auftragsausführung

Uns ist bewusst, dass die Besonderheiten der Auftragsabwicklung basierend auf einer Vielzahl von Faktoren. Diese Faktoren umfassen:

• Änderungen an der Dauer der Auftragsabwicklung je nach Bestellumfang
• Änderungen der Dauer der Auftragsabwicklung basierend auf der Zeit, die zum Abschließen der Bestellung benötigt wird Bezahlvorgang
• Latenz zwischen der Aktualisierung von Änderungen an der Auftragsausführung über Feeds
• Die Lieferadresse des Nutzers.

Jeder dieser Faktoren kann dazu führen, dass die Ausführung der Bestellung Zeit, die dem Nutzer anfänglich angezeigt wird, entspricht nicht dem genauen Zeitpunkt, zu dem er angezeigt wird. Das Ziel der Implementierung ist diese vollständig zu entfernen, sondern den Nutzenden klare Informationen und zwar so oft wie möglich.

Partner müssen eine Implementierung vornehmen, die zu präzisen Ausführungszeit wird Nutzern so oft wie möglich angezeigt, soweit dies möglich ist zu verstehen. Wenn es aufgrund dieser Faktoren erhebliche zeitliche Schwankungen gibt, schlagen wir vor, geben Sie einen Zeitraum an, der diese Variabilität umfasst. Wenn sich die Zeit für die Auftragsausführung aufgrund von Bestelldetails ändert, Dies sollte Nutzern bei der Lieferung während des Bestellvorgangs deutlich angezeigt werden.

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

Rechtzeitige Aktualisierungen von Gebühren und voraussichtlichen Ankunftszeiten

Änderungen mit einem normalen Feedupload können mindestens zwei Stunden dauern. zu verarbeiten. Das ist besonders wichtig, wenn Sie Ihre voraussichtlichen Ankunftszeiten ändern möchten. häufig auftreten.

Partnern wird dringend empfohlen, Echtzeitaktualisierungen, Dadurch kann über einen API-Aufruf der Dienstfeed (einschließlich Gebühren und voraussichtliche Ankunftszeiten) innerhalb von maximal 5 Minuten geändert werden.