Czas realizacji i opłaty (tylko starsza wersja)

W tym samouczku omawiamy:

Ogólny opis przypadków użycia, w których są obsługiwane opłaty i czas realizacji
szczegółowe instrukcje dotyczące określania czasu realizacji zamówienia i opłat dla action_link w plikach danych;
Oczekiwania dotyczące dokładności

Pełny przykład pliku danych, który pokazuje czas realizacji zamówienia i opłaty, znajdziesz w pliku przykładowym EPA dla przekierowania zamówienia.

Opłaty i czas realizacji zamówienia

Przypadki użycia opłat

Opłaty można określić na kilka sposobów. W punktach poniżej opisano różne obsługiwane przypadki użycia oraz podano przykładowe wyrażenia podobne do tych, które użytkownik zobaczy w interfejsie.

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 zł” 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 USD”

Jak widać w przytoczonych powyżej przykładach, opłaty mogą być określone jako opłata za dostawę lub opłata za obsługę. Możesz też podać kilka opłat (np. „Opłata za obsługę 5–10%, opłata za dostawę 5 zł”).

Nie są obsługiwane przypadki użycia, które wymagają aktualizowania opłat w ciągu dnia lub zmiany na podstawie informacji o użytkowniku.

Przypadki użycia dotyczące czasu realizacji

Aby ułatwić Ci podawanie dokładnych danych, zezwalamy na kilka formatów określania czasu dostępności. W punktach poniżej opisujemy różne obsługiwane przypadki użycia oraz przykładowe wyrażenia, które użytkownik zobaczy w interfejsie.

Stały czas: „Dostawa w ciągu 30 minut” lub „Odbiór w ciągu 15 minut”
Zakresy czasowe: „Dostawa w ciągu 30 minut – 1 godz.” lub „Odbiór w ciągu 15–20 minut”
Otwarte zakresy czasowe: „Dostawa w ciągu ponad 10 minut” lub „Odbiór w mniej niż 1 godzinę”.

Czas realizacji może być określony zarówno w przypadku odbioru, jak i dostawy, za pomocą wspólnego formatu (opisanego poniżej). Jak widać na przykładach powyżej, tekst wyświetlany użytkownikom będzie odzwierciedlał typ realizacji określony w linku do działania.

Nie są obsługiwane przypadki użycia, które wymagają aktualizowania godzin w ciągu dnia lub ich zmiany na podstawie informacji o użytkowniku.

Określanie czasu realizacji zamówienia w plikach danych

Czas realizacji zamówienia w przypadku linków do działań jest uwzględniony w wiadomości z pliku danych sprzedawcy action_link w polu food_ordering_metadata. W przypadku każdego action_linkpowiązanego ze sprzedawcą musisz podać informacje o wypełnieniu zamówienia, korzystając z jednego z ścieżek wiadomości.

Czas realizacji

Merchant.action_link.food_ordering_metadata.fulfillment_lead_time_duration

Treść wiadomości powinna mieć taki format:

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

Czas realizacji zakresu

Merchant.action_link.food_order_metadata.fulfillment_lead_time_duration_range

Treść wiadomości powinna mieć taki format:

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

Ostrzeżenie: nie należy określać jednocześnie właściwości fulfillment_lead_time_duration i fulfillment_lead_time_duration_range w ramach jednego obiektu action_link.

Uwaga: elementy fulfillment_lead_time_duration, fulfillment_lead_time_duration_range.min_duration, fulfillment_lead_time_duration_range.max_duration są typu google.protobuf.Duration i informują użytkowników o szacowanym czasie dotarcia do miejsca docelowego.

Określanie opłat w plikach danych

Podobnie jak czas realizacji zamówienia, opłaty mogą być uwzględnione w ramach wiadomości action_link w polu food_ordering_metadata. W przypadku każdego action_link powiązanego z handlowcem możesz podać informacje o opłatach za pomocą ścieżki wiadomości:

merchant.action_link.food_ordering_metadata.fee_details

Poniżej znajdziesz kilka przykładów różnych zastosowań.

stała opłata za dostawę w wysokości 1,99 USD:

[
  {
    "type": "DELIVERY",
    "fee_amount": {
      "amount": {
        "currency_code": "USD",
        "units": "1",
        "nanos": "990000000"
      }
    }
  }
]

Opłata za dostawę w wysokości 5,6%.

[
  {
    "type": "DELIVERY",
    "fee_amount": {
      "cart_percentage": {
        "value": "5.6"
      }
    }
  }
]

Opłata za obsługę wynosi od 1,99 do 9,99 USD

[
  {
    "type": "SERVICE",
    "fee_amount": {
      "amount_range": {
        "min_amount": {
          "currency_code": "USD",
          "units": "1",
          "nanos": "990000000"
        },
        "max_amount": {
          "currency_code": "USD",
          "units": "9",
          "nanos": "990000000"
        }
      }
    }
  }
]

Opłaty za obsługę wynoszą od 1,2% do 2,7%

[
  {
    "type": "SERVICE",
    "fee_amount": {
      "cart_percentage": {
        "value_range": {
          "min_value": "1.2",
          "max_value": "2.7"
        }
      }
    }
  }
]

2 opłaty: opłata za obsługę w wysokości 5 USD i opłata za dostawę w wysokości 1,2%.

[
  {
    "type": "SERVICE",
    "fee_amount": {
      "amount": {
        "currency_code": "USD",
        "units": "5",
        "nanos": "0"
      }
    }
  },
  {
    "type": "DELIVERY",
    "fee_amount": {
      "cart_percentage": {
        "value": "1.2"
      }
    }
  }
]

Uwaga: wpisy amount i amount_range są typu google.type.Money

Dokładność opłat i czasu realizacji

Dokładność opłat

Gdy podajesz dane o opłatach dla sprzedawcy, oczekujemy, że będą one dokładne. Uwzględnij wszystkie opłaty za dostawę i obsługę, które mogą mieć zastosowanie do zamówienia.

Zdajemy sobie sprawę, że opłaty mogą się różnić w zależności od czasu i użytkowników. Z tego powodu oferujemy możliwość określania opłat w zakresie, w tym w zakresie otwartym. W przypadku opłat, które mogą się znacznie różnić, upewnij się, że podany zakres obejmuje opłaty, które użytkownik może zobaczyć podczas transakcji.

Jeśli nie masz pewności, 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 może się zmieniać w zależności od różnych czynników. Te czynniki to m.in.:

Zmiany czasu realizacji zamówienia w zależności od jego wielkości
Zmiany czasu realizacji zamówienia na podstawie czasu potrzebnego na złożenie zamówienia i dokonanie płatności
Opóźnienie między aktualizacją czasu realizacji zamówienia w plikach danych
Adres dostawy użytkownika.

Każdy z tych czynników może prowadzić do sytuacji, w której czas realizacji zamówienia wyświetlany użytkownikowi na początku nie jest dokładnym czasem realizacji, jaki zobaczy w okresie płatności. Celem wdrożenia czasu realizacji nie jest całkowite wyeliminowanie tych problemów, ale jak najczęstsze dostarczanie użytkownikom przejrzystych informacji.

Oczekuje się, że partnerzy zapewnią implementację, która spowoduje, że czas realizacji będzie wyświetlany użytkownikom tak często, jak to możliwe, w miarę możliwości. Jeśli ze względu na te czynniki czas jest bardzo zróżnicowany, podaj zakres czasów, który uwzględnia tę zmienność. Jeśli czas realizacji zmienia się ze względu na szczegóły zamówienia, należy wyraźnie poinformować o tym użytkowników, gdy dotrą do odpowiedniego etapu procesu zamawiania.