Ta strona została przetłumaczona przez Cloud Translation API.

Czas realizacji i opłaty

W tym samouczku omawiamy:

Ogólny opis obsługiwanych przypadków użycia opłaty i czasu realizacji zamówienia
Szczegółowe instrukcje określania czasu realizacji zamówienia i opłat za: action_link w plikach danych
Oczekiwania dotyczące dokładności

Aby zobaczyć pełny przykładowy plik danych, który pokazuje czas realizacji zamówienia i opłaty, zapoznaj się z przykładowym przekierowaniem do zamówień EPA.

Przypadki użycia opłaty i czasu realizacji

Przypadki użycia opłat

Opłaty można określać na kilka sposobów. W poniższych punktach opisujemy różne obsługiwane przypadki użycia. Zawierają też przykładowe sformułowania podobne do tego, co 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%”.
Przedziały opłat: „Opłaty za dostawę 2–10 zł” lub „Opłaty za obsługę 3%–6%”
Ograniczone zakresy: „Opłaty za dostawę zaczynają się od 5%” lub „Opłaty za obsługę do 20 zł”.

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

Nieobsługiwane są przypadki użycia, w których opłaty muszą być aktualizowane w ciągu dnia lub zmieniać się na podstawie informacji o użytkowniku.

Przypadki użycia czasu realizacji

Udostępniamy kilka różnych formatów określania czasu dostępności, aby zapewnić podawanie dokładnych danych. W poniższych punktach opisujemy różne obsługiwane przypadki użycia. Zawierają też przykładowe sformułowania podobne do tego, co użytkownik zobaczy w interfejsie.

Stały czas: „Dostawa w 30 min” lub „Odbiór w 15 minut”.
Zakresy czasu: „Dostawa w 30 min-1 h” lub „Odbiór w 15-20 min”.
Otwarte zakresy czasu: „Dostawa za ponad 10 minut” lub „Odbiór w mniej niż 1 godz.”

Czas realizacji zamówienia można określić zarówno w przypadku odbioru, jak i dostawy w popularnym formacie (opisanym poniżej). Jak pokazano w powyższych przykładach, tekst wyświetlany użytkownikom będzie odpowiadać typowi realizacji określonym w linku do działania.

Nieobsługiwane są przypadki użycia, w których trzeba aktualizować godziny w ciągu dnia lub zmieniać się 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 podany w komunikacie „action_link” pliku danych sprzedawcy, w polu food_ordering_metadata. W przypadku każdego action_link powiązanego ze sprzedawcą musisz podać informacje o realizacji zamówienia za pomocą jednej ze ścieżek wiadomości.

Ustalony czas realizacji

Merchant.action_link.food_ordering_metadata.fulfillment_lead_time_duration

Powinny one mieć następujący format:

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

Czas realizacji zakresu

Merchant.action_link.food_order_metadata.fulfillment_lead_time_duration_range

Powinien on mieć następujący format:

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

Ostrzeżenie: nie określaj zarówno fulfillment_lead_time_duration, jak i fulfillment_lead_time_duration_range jako elementu jednego obiektu action_link.

Uwaga: fulfillment_lead_time_duration, fulfillment_lead_time_duration_range.min_duration, fulfillment_lead_time_duration_range.max_duration jest typu google.protobuf.Duration i podaje użytkownikom szacowany czas dotarcia na miejsce związane z wykonaniem działania.

Określanie opłat w plikach danych

Podobnie jak w przypadku czasu realizacji zamówienia opłaty mogą zostać uwzględnione w komunikacie action_link w polu food_ordering_metadata. W przypadku każdego action_link powiązanego ze sprzedawcą możesz podać informacje o opłacie, korzystając z ścieżki komunikatu:

merchant.action_link.food_ordering_metadata.fee_details

Poniżej znajduje się 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"
      }
    }
  }
]

Procent opłaty 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 USD 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"
        }
      }
    }
  }
]

Procent opłaty za obsługę wynosi od 1,2% do 2,7%.

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

Dwie opłaty, opłata za obsługę w wysokości 5 zł 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

Podając dane dotyczące opłat sprzedawcy, oczekujemy, że będą one dokładnie opisane. Należy uwzględnić wszystkie opłaty za dostawę i obsługę, które mogą obowiązywać przy zamówieniu.

Zdajemy sobie sprawę, że opłaty mogą zmieniać się wraz z upływem czasu i w zależności od użytkowników. Dlatego oferujemy możliwość określenia opłat jako zakresów, w tym zakresów otwartych. Jeśli opłaty mogą się znacznie różnić, zadbaj o to, aby podany zakres uwzględniał opłaty, które użytkownik może zobaczyć podczas transakcji.

Jeśli nie wiesz, co dokładnie jest wymagane w Twoim przypadku, skontaktuj się ze swoją osobą kontaktową w Centrum działań.

Dokładność czasu realizacji zamówienia

Zdajemy sobie sprawę, że czas realizacji zamówienia zależy od wielu czynników. Do czynników tych należą:

Zmiany czasu realizacji zamówienia na podstawie rozmiaru zamówienia
Zmiany czasu realizacji zamówienia zależne od czasu potrzebnego do złożenia zamówienia i realizacji transakcji
Czas oczekiwania między zmianą 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 początkowo nie jest zgodny z dokładnym czasem realizacji, który zobaczy w momencie płatności. Celem wdrożenia czasu realizacji nie jest całkowite wyeliminowanie tych problemów, lecz jak najszybsze udostępnienie użytkownikom jasnych informacji.

Oczekujemy, że partnerzy zapewnią implementację, która pozwoli użytkownikom uzyskać dokładny czas realizacji zamówienia tak często, jak to możliwe, i w miarę możliwości. Jeśli z powodu tych czynników występuje znaczna zmienność czasu, zalecamy podanie zakresu okresów, które obejmują tę zmienność. Dodatkowo, jeśli czas realizacji zamówienia zmieni się ze względu na szczegóły zamówienia, użytkownicy powinni wyraźnie widzieć tę informację na etapie składania zamówienia.

Jeśli nie wiesz, co dokładnie jest wymagane w Twoim przypadku, skontaktuj się ze swoją osobą kontaktową w Actions Center.