[NEWS] Nowe statusy realizacji zamówienia / New statuses of order fulfillment

Dodaliśmy nowe pole **fulfillment.status** w:

- [GET /order/checkout-forms,](https://developer.allegro.pl/documentation/#operation/getListOfOrdersUsingGET)
- [GET /order/checkout-forms/{id}](https://developer.allegro.pl/documentation/#operation/getOrdersDetailsUsingGET).

Pokazujemy w nim aktualny status realizacji zamówienia, zgodny z informacją, jaką ustawił sprzedawca w zakładce [Zamówienia](https://allegro.pl/moje-allegro/sprzedaz/zamowienia).

Aktualnie dostępne wartości **fulfillment.status** to:

- NEW - nowe zamówienie,
- PROCESSING - zamówienie w realizacji,
- READY_FOR_SHIPMENT - zamówienie do wysłania,
- SENT - zamówienie wysłane,
- CANCELLED - zamówienie anulowane.

Listę statusów znajdziesz w [naszej dokumentacji](https://developer.allegro.pl/documentation/#operation/getListOfOrdersUsingGET).

**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](https://allegro.pl/moje-allegro/sprzedaz/zamowienia). **W najbliższym czasie udostępnimy tę funkcjonalność także w REST API.**

W związku z tą zmianą, dla [GET /order/events](https://developer.allegro.pl/documentation/#operation/getOrderEventsUsingGET) 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](https://developer.allegro.pl/orders/).

-----

We have introduced new field **fulfillment.status** in:

- [GET /order/checkout-forms](https://developer.allegro.pl/documentation/#operation/getListOfOrdersUsingGET),
- [GET /order/checkout-forms/{id}](https://developer.allegro.pl/documentation/#operation/getOrdersDetailsUsingGET),

in which you will find information about current fulfillment status, according to the information set by the seller in the [Orders ](https://allegro.pl/moje-allegro/sprzedaz/zamowienia)tab.

The currently available values for the fulfillment.status are:

- NEW - new order,
- PROCESSING - order in progress,
- READY_FOR_SHIPMENT - order to sent,
- SENT - order sent,
- CANCELLED - order cancelled.

List of statuses can be found in [our documentation](https://developer.allegro.pl/documentation/#operation/getListOfOrdersUsingGET).

**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](https://allegro.pl/moje-allegro/sprzedaz/zamowienia) 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](https://developer.allegro.pl/documentation/#operation/getOrderEventsUsingGET) - **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](https://developer.allegro.pl/en/orders/).