allegro / allegro-api

Issue tracker and wiki for Allegro REST API
https://developer.allegro.pl/
217 stars 39 forks source link

[NEWS] Wysyłam z Allegro - zmienimy identyfikatory usług dostawy / Ship with Allegro - we will change delivery services IDs #6159

Open Lukasz-Zurek opened 2 years ago

Lukasz-Zurek commented 2 years ago

Wysyłam z Allegro to narzędzie, które pozwala na nadawanie przesyłek bezpośrednio z poziomu Allegro. Wybrana przez kupującego metoda dostawy ma wpływ na to, jaką usługę dostawy sprzedawca musi wybrać dla danego zamówienia.

Co zmienimy?

26 października 2022 zmienimy identyfikatory usług dostawy, które zwracamy w polu “deliveryServices.id” na zasobie GET /parcel-management/delivery-services.

Jak to działa obecnie?

Jeśli kupujący wybrał metodę dostawy np. "Allegro Kurier UPS", sprzedawca musi po nazwie metody powiązać ją z odpowiednią usługą dostawy, tj. "Allegro UPS", zgodnie z tabelą dostępną w naszym poradniku. Każda usługa dostawy posiada swój identyfikator, który zwracamy w polu “deliveryServices.id” dla GET /parcel-management/delivery-services. Identyfikator ten jest indywidualny i różni się w zależności od danego konta w Serwisie Allegro.

Jak to będzie funkcjonowało po zmianie?

  1. Dla umowy Allegro - identyfikatory usług dostawy będą jednakowe dla wszystkich sprzedawców i zostaną one na stałe przypisane do metod dostawy, np.

    Metoda dostawy: 0e4c7d59-64b6-4b06-89c3-c1d941506dd0 ("Allegro Kurier UPS") - usługa dostawy: 0e4c7d59-64b6-4b06-89c3-c1d941506dd0 ("Allegro Kurier UPS").

    Metoda dostawy: 199d2a2a-7c90-4ca7-aaf3-c1d941506dd0 ("Allegro Kurier UPS pobranie") - usługa dostawy: 199d2a2a-7c90-4ca7-aaf3-c1d941506dd0 ("Allegro Kurier UPS pobranie").

  2. Dla umowy własnej - dla każdej z nich utworzymy dedykowane usługi dostawy odpowiadające metodom. Identyfikator każdej usługi (“deliveryServices.id”) otrzyma konstrukcję: id_metody#id_umowy_wlasnej, np.

    Metoda dostawy: b20ef9e1-faa2-4f25-9032-adbea23e5cb9 ("Allegro Paczkomaty InPost pobranie") - usługa dostawy: b20ef9e1-faa2-4f25-9032-adbea23e5cb9#abcdef-ghij-klmn-opqrs123.

Dlaczego wprowadzimy zmianę?

Chcemy maksymalnie uprościć proces wyboru właściwych usług dostawy podczas tworzenia paczek w ramach usługi “Wysyłam z Allegro”.

Więcej informacji na temat usług dostawy znajdziesz w poradniku.


Ship from Allegro is a service that allows you to send parcels directly from Allegro. The delivery method the buyer chooses determines which delivery service the seller must choose for a given order.

What will we change?

On October 26, 2022, we will change the IDs of the delivery services that we return in the "deliveryServices.id" field on the GET /parcel-management/delivery-services resource.

How does it work today?

If the buyer has chosen a delivery method, e.g. "Allegro UPS courier", the seller must use the delivery method name to associate it with the appropriate delivery service, i.e. "Allegro UPS", according to the table available in our guide. Each delivery service has its ID, which we return in the "deliveryServices.id" field for GET /parcel-management/delivery-services. This identifier is individual and varies depending on the account on the Allegro website.

How will it work after the change?

  1. For the Allegro contract - the delivery service IDs will be the same for all sellers and they will be permanently assigned to delivery methods, e.g.

    Delivery method: 0e4c7d59-64b6-4b06-89c3-c1d941506dd0 ("Allegro UPS courier") - delivery service: 0e4c7d59-64b6-4b06-89c3-c1d941506dd0 ("Allegro UPS courier").

    Delivery method: 199d2a2a-7c90-4ca7-aaf3-c1d941506dd0 ("Allegro UPS courier, payment on delivery") - delivery service: 199d2a2a-7c90-4ca7-aaf3-c1d941506dd0 ("Allegro UPS courier, payment on delivery").

  2. For own contract - for each of them we will create dedicated delivery services corresponding to the methods. The identifier of each service (“deliveryServices.id”) will be given the following structure: method_id # custom_id, e.g.

    Delivery method: b20ef9e1-faa2-4f25-9032-adbea23e5cb9 ("Allegro Paczkomaty, payment on delivery") - delivery service: b20ef9e1-faa2-4f25-9032-adbea23e5cb9#abcdef-ghij-klmn-opqrs123.

Why are we making a change?

We want to simplify the process of choosing the right delivery services when creating packages under the "Ship with Allegro" service.

More information on delivery services you will find in the guide.

Onixarts commented 2 years ago

Czy stary sposób, tj przekazywanie serviceId w postaci liczbowej będzie nadal działał? Bo jeśli nie to zamiast maksymalnie uprościć, to maksymalnie utrudniliście nam i sprzedawcom życie. Nie dość, że trzeba będzie dość mocno przerabiać istniejący i działający już mechanizm w programach to jeszcze zmiana w ciągu jednego dnia? To jest niewykonalne aby wszyscy nasi klienci jednego dnia zaktualizowali program desktopowy, bo zmienia się sposób identyfikacji dostaw w WzA.

Myślałem, ze chociaż będzie można zrezygnować z mapowania dostaw - co by rzeczywiście uprościło wybór dostawy w WzA, ale dla dostaw własnych i tak takie mapowanie musi być zrobione, wiec i tak nie można się wprost posłużyć GUIDem dostawy z zamówienia bo trzeba sprawdzić czy sprzedawca nie wybrał swojej własnej umowy z kurierem dla tego typu dostawy. Czyli w całym algorytmie po naszej stronie będzie dodatkowo więcej ifów na poziomie konfiguracji mapowań jak i wyboru guida usługi w WzA - czyli de facto dwa odrębne sposoby na obsługę dostaw, a był jeden.

P.S - kiedy zmiana będzie dostępna na sandboxie?

Lukasz-Zurek commented 2 years ago

Obecny sposób będzie nadal funkcjonował również po wdrożeniu tych zmian. Zależy nam na tym, aby każdy mógł się do niej wcześniej przygotować. Dopiero później planujemy pozostawić jedynie nowy sposób działania.

Zmianę planujemy udostępnić wcześniej na sandboxie, nie jestem jednak w stanie zadeklarować konkretnego terminu. Wrócę z informacją w tym wątku.

Onixarts commented 2 years ago

No to całe szczęście :).

hahyes commented 2 years ago

Czyli jeżeli dobrze rozumiem, nie będzie trzeba szukać w GET /parcel-management/delivery-services tylko po prostu przypisać UUID dostawy z zamówienia? Brzmi bardzo fajnie.

Lukasz-Zurek commented 2 years ago

@hahyes Dokładnie tak. Chyba, że mówimy o umowie własnej - wtedy przypisujemy id_metody#id_umowy_wlasnej.

Lukasz-Zurek commented 2 years ago

Aktualizacja - 25.10.2022:

Zmianę dotyczącą identyfikatorów usług dostawy wdrożymy 03.11.2022.


Update - 25.10.2022:

We will implement the change of delivery services IDs on 03.11.2022.

Lukasz-Zurek commented 2 years ago

Aktualizacja - 03.11.2022:

Zmianę dotyczącą identyfikatorów usług dostawy wdrożymy 08.11.2022.


Update - 03.11.2022:

We will implement the change of delivery services IDs on 08.11.2022.

Lukasz-Zurek commented 2 years ago

Aktualizacja - 08.11.2022:

Wdrożyliśmy dzisiaj zmianę.


Update - 08.11.2022:

We have implemented the change today.

kamil-maslowski commented 1 year ago

Jedno pytanie, skąd mogę wziąć id_umowy_wlasnej?

Lukasz-Zurek commented 1 year ago

@kamil-maslowski Identyfikator umowy własnej uzyskasz bezpośrednio od przewoźnika.