Bearbeitungszeit und Gebühren

In dieser Anleitung wird Folgendes beschrieben:

  1. Eine allgemeine Beschreibung der unterstützten Anwendungsfälle für Gebühren und Bearbeitungszeiten
  2. Spezifische Anleitung zum Angeben der Bearbeitungszeit und Gebühren für Servicefeeds.
  3. Erwartungen an die Genauigkeit

Ein vollständiges Feedbeispiel, in dem die Verwendung von Auftragsbearbeitungszeit und Gebühren gezeigt wird, finden Sie unter Beispiel für EPA für die Weiterleitung von Bestellungen.

Gebühren

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

  • Pauschalgebühr: „Liefergebühr 5 €“ oder „Servicegebühr 5 €“
  • Prozentuale Gebühr: „Liefergebühr 5 %“ oder „Servicegebühr 5 %“
  • Gebührenbereiche: „Liefergebühren 2–10 $“
  • Offene Bereiche „Servicegebühren bis zu 20 $“

Gebühren können entweder als Liefergebühr oder als Servicegebühr angegeben werden. Es ist auch möglich, mehrere Gebühren anzugeben, z.B. „Servicegebühr 5%, Versandgebühr 5 $“.

Anwendungsfälle, bei denen sich Gebühren auf Grundlage von Nutzerinformationen ändern müssen, werden nicht unterstützt.

Gebührenbeispiele

Liefer- und Abholgebühren

Die App unterstützt die Gebührtypen `DELIVERY` und `SERVICE`.

Auslieferung

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

Dienst

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

Verschiedene Gebührenarten

Im Folgenden finden Sie einige benutzerfreundliche Beispiele für die Angabe eines ausgewählten Gebührentyps.

Behoben

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

Prozentsatz des Einkaufswagens

{
  "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"
    ]
  }
}

Bereich

{
  "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

Wir lassen verschiedene Formate für die Angabe der Verfügbarkeitszeit zu, damit Sie genaue Daten angeben können. In den folgenden Punkten werden die verschiedenen unterstützten Anwendungsfälle beschrieben. Außerdem finden Sie dort einige Beispielformulierungen, die Nutzer im Frontend sehen.

  • Feste Zeiten: „Lieferung in 30 Minuten“ oder „Abholung in 15 Minuten“
  • Zeiträume: „Lieferung in 30 Minuten bis 1 Stunde“ oder „Abholung in 15–20 Minuten“

Die Bearbeitungszeit kann sowohl für die Abholung als auch für die Lieferung in einem gemeinsamen Format angegeben werden (siehe unten).

Anwendungsfälle, bei denen sich die geschätzte Ankunftszeit basierend auf Nutzerinformationen ändern muss, werden nicht unterstützt.

Beispiele für die Ausführungszeit

Die Zeit für die Auftragsabwicklung für Aktionslinks ist im Services-Feed in der Nachricht ETA im Feld FoodOrderingService enthalten.

Behoben

{
    "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"
    }
},

Zeitraum

{
    "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 Ausführung

Mit ServiceHours können Erfüllungszeiten für einen bestimmten Zeitraum festgelegt werden. Der Standard-lead_time, der im FoodOrderingService festgelegt ist, wird außerhalb der Zeitfenster der Servicezeiten verwendet.

In diesem Beispiel wird die lead_time von 2400s von 11:00 bis 13:30 Uhr angezeigt.
Die lead_time von 1200s wird vor 11:00 Uhr und nach 13:30 Uhr angezeigt. 
{
  "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ühren- und Ausführungszeitgenauigkeit

Gebührenrichtigkeit

Wenn Sie Gebührendaten für einen Händler angeben, müssen diese korrekt sein. Geben Sie alle Liefer- und Servicegebühren an, die für eine Bestellung anfallen können.

Wir wissen, dass Gebühren im Laufe der Zeit und je nach Nutzer variieren können. Aus diesem Grund können Sie Gebühren als Bereiche angeben, auch als offene Bereiche. Wenn Gebühren erheblich variieren können, muss der angegebene Bereich die Gebühren umfassen, die einem Nutzer während der Transaktion angezeigt werden könnten.

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

Genauigkeit der Zeit für die Auftragsabwicklung

Wir wissen, dass die genauen Zeiten für die Auftragsabwicklung von einer Vielzahl von Faktoren abhängen. Diese Faktoren umfassen:

  • Änderungen der Bearbeitungszeit von Bestellungen je nach Bestellgröße
  • Änderungen an der Zeit für die Auftragsabwicklung basierend auf der Zeit für die Bestellung und den Bezahlvorgang
  • Latenz zwischen der Aktualisierung von Änderungen an der Auftragsausführungszeit über Feeds
  • Die Lieferadresse des Nutzers.

Jeder dieser Faktoren kann dazu führen, dass die dem Nutzer anfangs angezeigte Zeit für die Auftragsabwicklung nicht der genauen Zeit entspricht, die er an der Kasse sieht. Ziel der Implementierung der Erfüllungszeit ist es nicht, diese vollständig zu eliminieren, sondern Nutzern so oft wie möglich klare Informationen zu geben.

Partner müssen eine Implementierung bereitstellen, die möglichst oft eine genaue Erfüllungszeit für Nutzer anzeigt. Wenn es aufgrund dieser Faktoren zu erheblichen Schwankungen beim Timing kommt, empfehlen wir, einen Zeitraum anzugeben, der diese Schwankungen abdeckt. Wenn sich die Bearbeitungszeit aufgrund von Bestelldetails ändert, sollte dies den Nutzern außerdem deutlich angezeigt werden, wenn sie in Ihrem Bestellvorgang ankommen.

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

Aktuelle Updates zu Gebühren und voraussichtlichen Ankunftszeiten

Änderungen, die über einen normalen Feed-Upload vorgenommen werden, können mindestens zwei Stunden in Anspruch nehmen. Das ist besonders wichtig, wenn Sie die voraussichtlichen Ankunftszeiten häufig ändern möchten.

Partner werden dringend gebeten, Echtzeit-Updates zu implementieren. Dadurch kann der Dienstfeed (einschließlich Gebühren und geschätzter Ankunftszeiten) innerhalb von maximal 5 Minuten über einen API-Aufruf geändert werden.

Zurück
Service feed
Weiter
.proto-Set für Feeds