allegro / allegro-api

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

[NEWS] Wysyłam z Allegro - od 22 sierpnia 2024 dla usług dostawy Allegro Standard nie skorzystasz już z umowy własnej / Ship with Allegro - as of August 22, 2024, you will no longer use the custom agreement for Allegro Standard delivery services #9625

Open AureliuszBrussy opened 1 month ago

AureliuszBrussy commented 1 month ago

Od 22 sierpania 2024 roku podczas nadania przesyłki z dostawą w ramach Allegro Standard, sprzedający nie będzie mógł już skorzystać z umowy własnej. Przesyłki takie nada wyłącznie w ramach umowy Allegro.

Ponadto, dla usług dostawy spoza Allegro Standard, dla których sprzedający posiada umowy własne, nie będzie mógł już zmienić przewoźnika realizującego dostawę. Oznacza to, że powinien utworzyć przesyłkę zgodnie z wybranym przez kupującego w zamówieniu przewoźnikiem.

Jak rozpoznać usługę Allegro Standard?

Gdy odpytasz o dostępne usługi dostawy za pomocą GET /shipment-management/delivery-services, dla usługi Allegro Standard, w polu "owner" zwrócimy wartość "ALLEGRO".

Tworząc przesyłkę (POST /shipment-management/shipments/create-commands) z metodą dostawy Allegro Standard, w polu "credentialsId" nie przekazuj żadnej wartości lub przekaż null.

Od 22 sierpnia, gdy spróbujesz utworzyć przesyłkę niezgodnie z nowymi wytycznymi - zwrócimy odpowiedni komunikat błędu:

{
  code: VALIDATION_ERROR,
  path: „deliveryMethodId”,
  message: „Cannot create a shipment using own contract. Method assigned to this order is the Allegro Standard one. Change method and try again.”
}

Więcej o Wysyłam z Allegro przeczytasz w naszym poradniku.


From August 22, 2024, when shipping with Allegro Standard delivery, the seller will no longer be able to use a custom agreement. The seller will only send such shipments under the Allegro contract.

In addition, for delivery services outside of Allegro Standard, for which the seller has his own agreements, he will no longer be able to change the carrier handling the delivery. This means that the seller should create the shipment following the carrier selected by the buyer in the order.

How to recognize the Allegro Standard service?

When you check out available delivery services using GET /shipment-management/delivery-services, we will return the "ALLEGRO" value in the "owner" field for Allegro Standard services.

When creating a shipment (POST /shipment-management/shipments/create-commands) with the Allegro Standard delivery method, in the "credentialsId" field, do not pass any value or pass null.

From August 22, when you try to create a shipment that does not comply with the new guidelines - we will return the appropriate error message:

{
  code: VALIDATION_ERROR,
  path: „deliveryMethodId”,
  message: „Cannot create a shipment using own contract. Method assigned to this order is the Allegro Standard one. Change method and try again.”
}

You can read more about Ship from Allegro in our guide.

jesiiu commented 1 month ago

Czy dotyczy to również inpostu? Zasób /shipment-management/delivery-services zwraca taką odpowiedź (wzięte z dokumentacji allegro) "services": [ { "id": { "deliveryMethodId": "c3066682-97a3-42fe-9eb5-3beeccab840c", "credentialsId": "c9e6f40a-3d25-48fc-838c-055ceb1c5bc0" }, Teraz tworząc etykietę przekazuję deliveryMethodId oraz credentialsId, po tej akutalizacji nie będzie można utworzyć etykiety w momencie w którym będzie przekazane credentialsId?

AureliuszBrussy commented 1 month ago

Nie, Allegro InPost nie należy do usług z grupy Allegro Standard, więc nic się nie zmieni. Metody dostawy Allegro Standard są wymienione w pomocy, w komunikacie także podałem link.

jesiiu commented 1 month ago

Czyli jeżeli na ten moment mamy podpiętą umowę InPost oraz OrlenPaczka to wystarczy, że odepniemy umowę orlenu dnia 22 i w zasób zwróci mi metodę dostawy jako owner ALLEGRO a nie CLIENT a owner allegro nie zawiera credentialsId

AureliuszBrussy commented 1 month ago

Już teraz dla usług Orlen sprzedający ma dostęp do umowy, której właścicielem jest Allegro. Możecie w dowolnym momencie zacząć z niej korzystać. Od 22 sierpnia, jeżeli kupujący wybierze jedną z metod dostawy Allegro Standard, nadasz ją tylko na umowie Allegro.

InPostu ta sytuacja faktycznie nie dotyczy, gdyż ta usługa dostawy nie jest częścią Allegro Standard.

jesiiu commented 1 month ago

"name": "ORLEN Paczka (Orlen - Mastersport)", "carrierId": "ORLEN", "additionalServices": [], "additionalProperties": [], "owner": "CLIENT",

"name": "Allegro Odbiór w Punkcie ORLEN Paczka", "carrierId": "ALLEGRO", "additionalServices": [], "owner": "ALLEGRO",

Czyli jeżeli klient zamówi dostawę pierwszą tj. ORLEN Paczka (Orlen - Mastersport) to etykieta sie nie wygeneruje ale jeżeli będzie to opcja druga czyli Allegro Odbiór w Punkcie ORLEN Paczka to etykieta zostanie wygenerowana poprawnie?

AureliuszBrussy commented 1 month ago

Nie, jeżeli klient złoży zamówienie z dostawą Allegro Standard, np. Allegro Odbiór w Punkcie ORLEN Paczka, to będziesz mógł utworzyć paczkę tylko za pomocą umowy Allegro, nie będziesz mógł skorzystać z umowy klienta. Sprzedający wciąż może udostępniać w swoim cenniku dostawy metodę "ORLEN Paczka", czyli taką nie będącą częścią Allegro Standard. Wtedy, jeżeli kupujący wybierze tą metodę dostawy, wciąż nadasz ją na umowie sprzedającego.

Wszystko zależy od tego, co sprzedający udostęnia w cenniku dostawy oraz z jakiej konkretnie metody dostawy skorzysta kupujący przy finalizowaniu zamówienia.

ZAK28ZAK commented 1 month ago

Dzień dobry, Czy ta zmiana oznacza, że jeśli wysyłałem przesyłki Allegro Kurier DPD i realizowałem je za pomocą API DPD, to po 22 sierpnia muszę te przesyłki realizować za pomocą API Wysyłam z Allegro? Inaczej nie wygeneruje tej przesyłki, czy po prostu wygeneruje ją za pomocą API DPD ale po stawkach własnej umowy z DPD?

AureliuszBrussy commented 1 month ago

Ustalam to. Wrócę z odpowiedzią.

AureliuszBrussy commented 1 month ago

@ZAK28ZAK wciąż będziesz mógł swobodnie nadawać przesyłki za pomocą API DPD. Nic się dla Ciebie nie zmieni.

Ewkaaa92 commented 1 week ago

Witam, podbijam wątek, bo mamy podobny problem. Do tej pory wszystkie zamówienia z Allegro były realizowane poprzez umowę własną (nie byliśmy tego świadomi). Teraz chcemy to naprawić i wysyłać Orlen Paczkę z umową Allegro. Etykiety generujemy przez zewnętrzny system. Nasz dostawca oprogramowania dodał odpowiednie przesyłki: Allegro Odbiór w Punkcie Orlen Paczka i Allegro Automat Orlen Paczka. Złożyliśmy testowe zamówienie i przy próbie wystawienia etykiety dostaliśmy błąd: _Cannot create a shipment using the Allegro Standard contract. Delivery method assigned to this order is the merchant controlled one. Change the service and try again. (Nie można utworzyć przesyłki przy użyciu umowy Allegro Standard. Metoda przypisana do tego zamówienia to umowa własna. Zmień umowę i spróbuj ponownie.) - path: deliveryMethodId__

Nasz dostawca oprogramowania napisał, że musimy ustawić numer umowy Credentials Id, bo jest to jako carrier ALLEGRO, ale chyba dla ORLENU wymaga jakiegoś dodatkowego zmapowania.

Nie bardzo wiemy jaki Credentials Id mamy ustawić dla tych przesyłek.

AureliuszBrussy commented 1 week ago

@Ewkaaa92 sprawdź, czy w cennikach dostawy masz udostępnione odpowiednie metody dostawy, czyli te wliczające się do Allegro Standard (czyli te z dopiskiem Allegro ORLEN). Wygląda na to, że udostępniasz w cenniku dostawy kupującym metody dostawy spoza umowy Allegro i próbujesz dla tych zamówień (gdzie kupujący wybrał taką metodę dostawy) wygenerować przesyłkę w ramach umowy Allegro.

Ewkaaa92 commented 1 week ago

W cennikach dostawy mam udostępnione Allegro Delivery:

image

Nie mam podpiętej żadnej umowy własnej.

AureliuszBrussy commented 1 week ago

@Ewkaaa92 w takim razie potrzebuję trace-id próby utworzenia przesyłki, kończącej się tym komunikatem błędu. Sprawdzę ten konkretny przypadek. Trace-id znajduje się w nagłówku response'a - dostęp do niego powinien mieć support aplikacji.

Ewkaaa92 commented 1 week ago

traceid: 35f98c01d2a59050

{"commandId":"6a0d910e-376a-4157-9adb-f904fa382b39","status":"ERROR","errors":[{"code":"DELIVERY_METHOD_NOT_AVAILABLE","message":"Cannot create a shipment using the Allegro Standard contract. Delivery method assigned to this order is the merchant controlled one. Change the service and try again.","details":"Delivery Method is not available for this order","path":"deliveryMethodId","userMessage":"Nie można utworzyć przesyłki przy użyciu umowy Allegro Standard. Metoda przypisana do tego zamówienia to umowa własna. Zmień umowę i spróbuj ponownie."}],"shipmentId":null}', )

AureliuszBrussy commented 1 week ago

@Ewkaaa92 problem polega na niepoprawnym zmapowaniu metody dostawy z uslugą dostawy. Zwróć uwagę na to, jaki id metody dostawy zwracamy w zamówieniu (pole delivery.method.id). Takie samo id usługi dostawy musisz wybrać, generując przesyłkę. Próbujesz natomiast wykorzystać inną usługę.

Ewkaaa92 commented 1 week ago

Wysłałam Pana odpowiedź do supportu aplikacji, poniżej odpowiedź:

Jak rozumiem chodzi o deliveryMethodId, wystawiamy 025cb739-ef8e-45c4-9e7b-ce4e7fece8be (metoda shipment-management/shipments/create-commands)

Otrzymujemy z Allegro

array ( 'commandId' => '2d9b32bc-50f1-4c78-b2c8-e550d489fabd', 'input' => array ( 'deliveryMethodId' => '025cb739-ef8e-45c4-9e7b-ce4e7fece8be',

.....

Jak widać jest to ta sama metoda (id)

Następnie pytamy sie o

shipment-management/shipments/create-commands/2d9b32bc-50f1-4c78-b2c8-e550d489fabd

i tu dostajemy ten błąd

Ewkaaa92 commented 1 week ago

Nasz support sprawdza jeszcze jedną kwestię, także dam znać :)