Czas realizacji i opłaty (dotyczy tylko starszej wersji)

.

W tym samouczku omawiamy:

  1. Ogólny opis opłat i obsługiwane przypadki użycia czasu realizacji
  2. Szczegółowe instrukcje dotyczące określania czasu realizacji zamówienia i opłat action_link w Twoich plikach danych
  3. Oczekiwania dotyczące dokładności

Przykładowy plik danych przedstawiający wykorzystanie czasu realizacji zamówienia i opłat znajdziesz w Zamawianie przekierowywania EPA – przykład.

Opłata i przypadki użycia czasu realizacji

Przypadki użycia opłat

Opłaty można określać na kilka sposobów. Poniższe punkty opisują różne zastosowania wraz z przykładem podobnym do tego, co użytkownik zobaczy na interfejsu.

  • 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ę 6–30 PLN” lub „Opłaty za obsługę 3–6%”
  • Otwarte zakresy: „Opłaty za dostawę zaczynają się od 5%”. lub „Opłaty za obsługę do 20 PLN”

Jak widać w przykładach powyżej, 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ą aktualizowania opłat w ciągu dnia lub zmiany na podstawie informacji o użytkowniku.

Przypadki użycia czasu realizacji

Zezwalamy na kilka różnych formatów określania dostępności, aby zapewnić dostarczając dokładne dane. Poniższe punkty opisują różne obsługiwane przypadki użycia. z przykładowym językiem podobnym do tego, co zobaczy użytkownik w interfejsie.

  • 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”
  • Otwarte zakresy czasu: „Dostawa za ponad 10 minut” lub „Odbiór w ciągu 1 godz.”

Czas realizacji zamówienia można określić zarówno w przypadku odbioru, jak i dostawy, używając popularnego formatu (opisane poniżej). Jak widać w przykładach powyżej, tekst wyświetlany użytkownikom odzwierciedlają realizację typ określony w linku do działania.

Nieobsługiwane to przypadki użycia, które wymagają aktualizacji godzin w ciągu dnia lub zmian na podstawie informacji o użytkowniku.

Określanie czasu realizacji zamówienia za pomocą plików danych

Czas realizacji zamówienia w przypadku linków do działań jest podany w pliku danych sprzedawcy action_link w ramach food_ordering_metadata . Dla każdej wartości action_link powiązanego ze sprzedawcą, musisz zapewnić za pomocą jednej ze ścieżek wiadomości.

Stały czas realizacji

  • Merchant.action_link.food_ordering_metadata.fulfillment_lead_time_duration

Wiadomość powinna 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

Wiadomość powinna mieć następujący format:

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

Określanie opłat w plikach danych

Podobnie jak w przypadku czasu realizacji zamówienia, opłaty mogą być uwzględnione w action_link wiadomość pod linkiem food_ordering_metadata . W przypadku każdej jednostki action_link powiązanej ze sprzedawcą możesz: podaj informacje o opłatach, używając ś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ę wynosząca 1,99 USD: 
    [
  {
    "type": "DELIVERY",
    "fee_amount": {
      "amount": {
        "currency_code": "USD",
        "units": "1",
        "nanos": "990000000"
      }
    }
  }
]
  • Procentowa opłata za dostawę wynosi 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"
      }
    }
  }
]
.

Opłata i dokładność czasu realizacji

Dokładność opłat

Gdy podajesz dane dotyczące opłat dla sprzedawcy, oczekujemy, że podasz poprawne informacje Twoich opłat. 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ślenia opłat w postaci zakresów, w tym zakresów otwartych. Kiedy opłaty mogą się różnić Należy upewnić się, że podany zakres obejmuje opłaty, które użytkownik może transakcji.

Jeśli nie wiesz, co jest wymagane w Twoim przypadku, skontaktuj się ze swoim Kontakt z Centrum działań.

Dokładność czasu realizacji zamówienia

Rozumiemy, że szczegóły realizacji zamówienia zmiany czasu w zależności od różnych czynników. Czynniki te obejmują:

  • zmiany czasu realizacji zamówienia na podstawie wielkości zamówienia;
  • zmiany czasu realizacji zamówienia na podstawie czasu do złożenia zamówienia oraz proces 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 realizacja zamówienia czas wyświetlony użytkownikowi nie jest dokładnym czasem realizacji zamówienia, który pojawi się przy kasie. Cel implementacji czasu realizacji nie jest całkowicie je wyeliminować, ale też dostarczyć użytkownikom jasne informacje jak najczęściej.

Partnerzy powinni zadbać o to, aby wdrożenie było dokładne czas realizacji zamówienia wyświetlany użytkownikom tak często, jak to możliwe, w miarę możliwości podstaw. Jeśli z powodu tych czynników występują znaczne różnice w czasie, sugerujemy, podaj zakres czasowy obejmujący tę zmienność. Ponadto, jeśli czas realizacji zamówienia zmienia się ze względu na szczegóły zamówienia, powinna być wyraźnie widoczna dla użytkowników na etapie składania zamówienia.

Jeśli nie masz pewności co dokładnie jest wymagane w Twoim przypadku, skontaktuj się z osobą kontaktową w Centrum działań.