W tym samouczku omawiamy:
- Ogólny opis obsługiwanych przypadków użycia opłat i czasu realizacji
- Szczegółowe instrukcje dotyczące określania czasu realizacji zamówienia i opłat w przypadku plików danych o usługach.
- Oczekiwania dotyczące dokładności
Przykład pełnego pliku danych przedstawiający wykorzystanie czasu realizacji zamówienia i opłat znajdziesz w przykładzie EPA przekierowania zamówienia.
Opłaty
Opłaty można określać na kilka sposobów:
- Opłata stała: „Opłata za dostawę 5 zł” lub „Opłata za obsługę 5 zł”.
- Opłata procentowa: „Opłata za dostawę 5%” lub „Opłata za obsługę 5%”.
- Zakresy opłat: „Opłaty za dostawę 2–10 USD” lub „Opłaty za obsługę 3–6%”.
- Zakresy otwarte „Opłaty za dostawę zaczynają się od 5%” lub „Opłaty za obsługę do 20 PLN”
Opłaty można określić jako opłatę za dostawę lub za obsługę. Możesz też określić kilka opłat (np. „Opłata za obsługę 5–10%, Opłata za dostawę 5 zł”).
Nieobsługiwane to przypadki użycia, które wymagają, aby opłaty zmieniały się na podstawie informacji o użytkowniku.
Przykłady opłat
Opłaty za dostawę i odbiór
Aplikacja obsługuje typy opłat „DOSTAWA” i „USŁUGA”.Dostawa
{
"fee": {
"fee_id": "12345/delivery_fee",
"fee_type": "DELIVERY",
"fixed_amount": {
"currency_code": "USD",
"units": 10,
"nanos": 0
},
"service_ids": ["service/entity002"]
}
}
Usługa
{
"fee": {
"fee_id": "12345/service_fee",
"fee_type": "SERVICE",
"fixed_amount": {
"currency_code": "USD",
"units": 10,
"nanos": 0
},
"service_ids": ["service/entity002"]
}
}
Różne typy opłat
Poniżej znajdziesz kilka prostych przykładów, jak określić wybrany rodzaj opłaty.Naprawiono
{
"fee": {
"fee_id": "12345/delivery_fee",
"fee_type": "DELIVERY",
"fixed_amount": {
"currency_code": "USD",
"units": 10,
"nanos": 0
},
"service_ids": ["service/entity002"]
}
}
Procent koszyka
{
"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"
]
}
}
Zakres
{
"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"
]
}
}
Czas realizacji
Zezwalamy na określenie czasu dostępności na kilka różnych formatów, aby zapewnić, że dane będą prawidłowe. W poniższych punktach znajdziesz opis różnych obsługiwanych przypadków użycia wraz z przykładowym językiem podobnym do tego, co użytkownik zobaczy w frontendzie.
- Stały czas: „Dostawa za 30 min” lub „Odbiór w 15 min”.
- Zakresy czasu: „Dostawa w ciągu 30 min–1 godz.” lub „Odbiór w ciągu 15–20 min”.
Czas realizacji zamówienia można określić zarówno w przypadku odbioru, jak i dostawy za pomocą popularnego formatu (opisanego poniżej).
Nieobsługiwane to przypadki użycia, w których szacowany czas dotarcia na miejsce zmienia się na podstawie informacji o użytkowniku.
Przykłady czasu realizacji
Czas realizacji zamówienia w przypadku linków do działań jest podany w komunikacie Plik danych usług ETA jako część pola FoodOrderingService.
Naprawiono
{
"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"
}
},
Zakres czasowy
{
"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"
}
},
Dokładność informacji o opłatach i czasie realizacji
Dokładność opłat
Gdy podasz dane o opłatach dla sprzedawcy, oczekujemy, że podasz dokładne informacje o swoich opłatach. Należy uwzględnić wszystkie opłaty za dostawę i obsługę, które mogą mieć zastosowanie do zamówienia.
Zdajemy sobie sprawę, że opłaty mogą się zmieniać z upływem czasu i dla różnych użytkowników. Z tego powodu oferujemy możliwość określania opłat w formie zakresów, w tym zakresów otwartych. Jeśli opłaty mogą znacznie się różnić, upewnij się, że podany zakres obejmuje opłaty, które użytkownik może zobaczyć w trakcie transakcji.
Jeśli nie wiesz, co jest wymagane w Twoim przypadku, skontaktuj się z osobą kontaktową w Centrum działań.
Dokładność czasu realizacji zamówienia
Rozumiemy, że czas realizacji zamówienia zmienia się w zależności od wielu czynników. Czynniki te obejmują:
- zmiany czasu realizacji zamówienia na podstawie wielkości zamówienia;
- Zmiany czasu realizacji zamówienia na podstawie czasu potrzebnego do złożenia zamówienia i płatności
- Czas oczekiwania między aktualizacją czasu realizacji zamówienia za pomocą plików danych
- Adres dostawy użytkownika.
Każdy z tych czynników może prowadzić do sytuacji, w których czas realizacji zamówienia wyświetlany użytkownikowi nie jest dokładnym czasem realizacji zamówienia, który zobaczy on w momencie płatności. Celem wdrożenia w czasie realizacji nie jest całkowite ich wyeliminowanie, a jedynie jak najczęstsze udostępnienie użytkownikom jasnych informacji.
Partnerzy powinni zadbać o to, by w miarę możliwości jak najczęściej wyświetlali użytkownikom jak najdokładniejszy czas realizacji zamówienia. Jeśli z powodu tych czynników występują znaczne zmienności czasu, zalecamy podanie zakresu czasowego, który obejmuje tę zmienność. Ponadto, jeśli czas realizacji zamówienia zmienia się ze względu na szczegóły zamówienia, należy to wyraźnie podać użytkownikom, gdy będą oni gotowi do składania zamówień.
Jeśli nie wiesz, co jest wymagane w Twoim przypadku, skontaktuj się z przedstawicielem Centrum działań.
Terminowe informacje na temat opłat i szacowanego czasu dotarcia
Przetwarzanie zmian wprowadzonych w ramach zwykłego przesyłania pliku danych może potrwać co najmniej 2 godziny. Jest to szczególnie ważne, jeśli planujesz często zmieniać szacowany czas dotarcia na miejsce.
Zdecydowanie zachęcamy partnerów do wdrożenia aktualizacji w czasie rzeczywistym, które pozwalają wywołać interfejs API na zmianę pliku danych usługi (łącznie z opłatami i szacowanym czasem dotarcia na miejsce) w ciągu maksymalnie 5 minut.