allegro / allegro/allegro-api

[NEWS] Cenniki dostaw – od 22 lipca 2026 pola type i dispatchCountry będą obowiązkowe / Shipping rates – from July 22, 2026, the type and dispatchCountry fields will be mandatory

Open
#13,670 0 comments 0 reactions 1 assignee Claimed by @Aureliusz-Brussy View on GitHub
Breaking change News Sale settings
Dominant language
No language data
Stars
244
Forks
40
PR merge metrics
No merged PRs in 30d

Description

W [kwietniu](https://developer.allegro.pl/news/cenniki-dostaw-wprowadzilismy-nowe-pola-dla-cennikow-manualnych-eKbgl61Eaiy) informowaliśmy o wprowadzeniu nowych pól dla cenników manualnych oraz o planowanym zakończeniu okresu przejściowego. Dzisiaj przychodzimy z konkretnymi szczegółami dotyczącymi daty wdrożenia tego obowiązku oraz uruchomienia narzędzi do konwersji.

**Jakie zmiany wprowadzimy?**

Dla endpointów:

* [POST /sale/shipping-rates](https://developer.allegro.pl/documentation/#operation/createShippingRatesSetUsingPOST)
* [GET /sale/shipping-rates/{id}](https://developer.allegro.pl/documentation/#operation/getShippingRatesSetUsingGET)
* [PUT /sale/shipping-rates/{id}](https://developer.allegro.pl/documentation/#operation/modifyShippingRatesSetUsingPUT)

od **22 lipca 2026 roku** obsługa pola `type` (oraz zależnego od niego pola `dispatchCountry` w przypadku wartości `PHYSICAL`) stanie się **obowiązkowa**.

Mając dotychczas na względzie kompatybilność wsteczną, wspieraliśmy możliwość zdefiniowania zarówno cenników nowego typu, zawierających wartości w tych polach, jak i starego, bez zdefiniowanych wartości w żadnym z nich. **Od 22 lipca 2026 roku kończymy wsparcie dla kompatybilności wstecznej** – od tego dnia wspierać będziemy tylko cenniki ze zdefiniowanymi wartościami w polach `type` oraz `dispatchCountry`. Dostosuj swoją aplikację jak najszybciej, aby Twoi użytkownicy mogli bez przeszkód zarządzać cennikami.

**Narzędzia do konwersji i automatyczne zmiany**

Przygotowaliśmy rozwiązania, które pomogą sprzedającym dostosować się do nowych wymagań:

* **Narzędzia w Sales Center są już dostępne:** Sprzedający mogą już korzystać z narzędzi umożliwiających konwersję istniejących cenników do nowych wymagań. Opcja ta jest widoczna bezpośrednio w [Sales Center](https://salescenter.allegro.com/delivery-settings/shipping-rates/convert).
* **Automatyczna konwersja cenników:** Cenniki, które do 22 lipca 2026 roku nie zostaną przekonwertowane ręcznie przez sprzedających, **zostaną przekonwertowane przez nas automatycznie**.

Zachęcamy jednak do jak najszybszego dostosowania integracji, aby sprzedający mogli samodzielnie i w pełni świadomie zarządzać procesem migracji swoich cenników.

**Dlaczego wprowadzamy tę zmianę?**

Chcemy, aby zarządzanie cennikami było przejrzyste i intuicyjne oraz definiowane w oparciu o kraj wysyłki.

Więcej o cennikach dostawy oraz działaniu narzędzi do konwersji przeczytasz [w naszym poradniku](https://developer.allegro.pl/tutorials/jak-zarzadzac-kontem-danymi-uzytkownika-ZM9YAKgPgi2#ustawienia-i-cenniki-dostaw).

------

In April, [we informed you](https://developer.allegro.pl/news/shipping-rates-we-have-added-new-fields-for-manual-rates-eKbgl61Eaiy) about the introduction of new fields for manual shipping rates and the planned end of the transitional period. Today, we are sharing specific details regarding the effective date of this requirement and the launch of conversion tools.

**What changes are we introducing?**

For the following endpoints:

* [POST /sale/shipping-rates](https://developer.allegro.pl/documentation/#operation/createShippingRatesSetUsingPOST)
* [GET /sale/shipping-rates/{id}](https://developer.allegro.pl/documentation/#operation/getShippingRatesSetUsingGET)
* [PUT /sale/shipping-rates/{id}](https://developer.allegro.pl/documentation/#operation/modifyShippingRatesSetUsingPUT)

as of **July 22, 2026**, support for the `type` field (and the dependent `dispatchCountry` field for the `PHYSICAL` value) will become **mandatory**.

To ensure backward compatibility, we have so far supported defining both new-type shipping rates (containing values in these fields) and old-type ones (without defined values in either field). **As of July 22, 2026, we are ending backward compatibility support** – from that day forward, we will only support shipping rates with defined values in `type` and `dispatchCountry`. Please adapt your application as soon as possible so that your users can manage their shipping rates without any disruption.

**Conversion tools and automatic changes**

We have prepared solutions to help sellers adapt to the new requirements:

* **Tools in Sales Center are already available:** Sellers can now use tools to convert existing shipping rates to meet the new requirements. This option is available directly in [Sales Center](https://salescenter.allegro.com/delivery-settings/shipping-rates/convert).
* **Automatic conversion of shipping rates:** Shipping rates that are not manually converted by sellers by July 22, 2026, **will be converted by us automatically**.

However, we encourage you to adapt your integration as soon as possible so that sellers can independently and fully consciously manage the migration process of their shipping rates.

**Why are we introducing this change?**

We want shipping rate management to be transparent, intuitive, and defined based on the country of dispatch.

You can read more about shipping rates and how the conversion tools work [in our guide](https://developer.allegro.pl/tutorials/account-and-user-data-management-jn9vBjqjnsw#delivery-settings-and-shipping-rates).

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.