cptgoldd
commented
4 years ago Dzień dobry,
Dodanie pola fulfillment w odpowiedzi zwracanej w metodzie GET /order/checkout-forms spowodowało problem z pobieraniem zamówień w aplikacji, z której korzystamy do obsługi zamówień Allegro. Jest to zewnętrzna aplikacja i chciałbym potwierdzić, że problem leży po stronie dewelopera tej aplikacji. Według dewelopera nie było wcześniejszej informacji o planowanym dodaniu pola, jednak jak rozumiem nie była to zmiana, która powinna spowodować problemy z funkcjonowaniem aplikacji przy jej poprawnym zaprojektowaniu. Kod aplikacji z tego co rozumiem został wygenerowany głównie przy pomocy pliku swagger.yaml Tutaj pytanie, czy rzeczywiście powinniśmy od Państwa otrzymywać wcześniejszą informacje o takiej zmianie, aby deweloper mógł się do niej dostosować, czy problem tkwi w jego aplikacji?
PrzemyslawLukanowski
Dodaliśmy nowe pole fulfillment.status w:
Pokazujemy w nim aktualny status realizacji zamówienia, zgodny z informacją, jaką ustawił sprzedawca w zakładce Zamówienia.
Aktualnie dostępne wartości fulfillment.status to:
Listę statusów znajdziesz w naszej dokumentacji.
Ważne! Wartość w polu fulfillment.status zwracamy dla zamówień utworzonych po 15.01.2020 lub w sytuacji, kiedy sprzedawca zmienił status po tej dacie.
Możesz filtrować zamówienia według statusu realizacji - w tym celu przekaż pole fulfilment.status wraz z wartością jako parametr w requeście, np.
GET /order/checkout-forms?fulfillment.status=SENT - zwróci wysłane zamówienia.
Status realizacji zamówienia sprzedawca może zmienić w zakładce Zamówienia. W najbliższym czasie udostępnimy tę funkcjonalność także w REST API.
W związku z tą zmianą, dla GET /order/events wprowadziliśmy nowy typ eventu - FULFILLMENT_STATUS_CHANGED. Zdarzenie pojawi się w przypadku zmiany statusu realizacji zamówienia. Możesz je przekazać w żądaniu jako wartość parametru type, dzięki czemu ograniczysz wyniki w odpowiedzi.
Więcej informacji na temat obsługi zamówień znajdziesz w naszym poradniku.
We have introduced new field fulfillment.status in:
in which you will find information about current fulfillment status, according to the information set by the seller in the Orders tab.
The currently available values for the fulfillment.status are:
List of statuses can be found in our documentation.
Note! We return the value in the field fulfillment.status for orders created after 15.01.2020 or in a situation where the seller has changed status after this date.
You can filter your orders by fulfillment status - provide the fulfillment.status field with value as a parameter in your request, e.g.
GET /order/checkout-forms?fulfillment.status=SENT - will return shipped orders.
Order fulfillment status seller can change in Orders tab. In the near future we will provide this functionality via REST API.
Due to this change, we have introduced a new event type in GET /order/events - FULFILLMENT_STATUS_CHANGED. Event will occurs, if the status of the order fulfillment has been changed. You can pass it in your request as a value of type parameter, which will limit the results in the response.
You will find more information about order management in our guide.