[NEWS] Zmiany w warunkach zwrotów / Changes to the terms of return policy

W **październiku 2021** [zmienimy](https://allegro.pl/dla-sprzedajacych/allegro-zwroty) proces zwrotów przedmiotów na Allegro oraz [formularz warunków zwrotu](https://allegro.pl/moje-allegro/sprzedaz/warunki-zwrotow). **20 lipca 2021** wprowadzimy zmiany w API Allegro, aby każdy miał czas na dostosowanie swojej aplikacji.

**Na jakie zasoby mają wpływ te zmiany?**

* [POST /after-sales-service-conditions/return-policies](../../documentation/#operation/createAfterSalesServiceReturnPolicyUsingPOST) - dodaj warunki zwrotów,
* [GET /after-sales-service-conditions/return-policies/{returnPolicyId}](../../documentation/#operation/getAfterSalesServiceReturnPolicyUsingGET) - pobierz szczegółowe dane warunków zwrotów,
* [PUT /after-sales-service-conditions/return-policies/{returnPolicyId}](../../documentation/#operation/updateAfterSalesServiceReturnPolicyUsingPUT) - edytuj warunki zwrotów.

**Co zmienimy od 20 lipca 2021?**

Na tym etapie, do aktualnej struktury:

1. Dodamy walidację adresu. Dla **"countryCode": "PL"**:
* **miasto** - same polskie litery (bez kodów pocztowych i znaków specjalnych),
* **kod pocztowy** - walidacja poprawności wg wzorca (dd[-]ddd),
* **ulica** - bez specjalnych znaków zgodna z regułami walidacji przewoźników.

"address": {
"name": "Allegro.pl Sp. z o.o.",
"street": "Grunwaldzka 182",
"postCode": "60-166",
"city": "Poznań",
"countryCode": "PL"
},

2. Dodamy strukturę **"contact"** z informacjami kontaktowymi - numer telefonu i adres email.

"contact": {
"phoneNumber": "123 123 123",
"email": "useridentifier@domain.com"
},

3. Dodamy nową strukturę **"options"**, która zawierać będzie wybrane opcje:
* **"cashOnDeliveryNotAllowed"** - "Nie przyjmuję zwrotów nadanych za pobraniem",
* **"freeAccessoriesReturnRequired"** - "Otrzymałeś gratis? - w przypadku zwrotu towaru odeślij go również do nas",
* **"refundLoweredByReceivedDiscount"** - "Otrzymałeś rabat na kolejną sztukę? - w przypadku zwrotu towaru pomniejszymy zwrot wpłaty o wartość udzielonego rabatu",
* **"refundOfCheapestItemInCombinedDiscount"** - "Podczas zakupu zestawu otrzymałeś rabat na kolejny produkt? - w przypadku zwrotu jednego produktu z zestawu, otrzymasz zwrot pieniędzy za tańszy produkt",
* **"businessReturnAllowed"** - "Przyjmuję zwroty od firm (nie dotyczy jednoosobowych działalności gospodarczych)",
* **"collectBySellerOnly"** - "Osobiście odbieram zwrot od kupującego".

"options": {
"cashOnDeliveryNotAllowed": true,
"freeAccessoriesReturnRequired": true,
"refundLoweredByReceivedDiscount": true,
"refundOfCheapestItemInCombinedDiscount": false,
"businessReturnAllowed": false,
"collectBySellerOnly": false
}

4. Dla wartości **"range": "RESTRICTED":**
* w polu **restrictionCause.name** dodamy jedną wartość **"VALUE_DEPENDENT_ON_FINANCIAL_MARKET"** - "Usługę lub przedmiot, których ceny zależą od wahań na rynku finansowym, nad którymi sprzedający nie ma kontroli, a które mogą wystąpić przed upływem terminu na odstąpienie od umowy. Np.: produkty inwestycyjne: sztabki złota, monety kolekcjonerskie, srebro, platyna."
* zmienimy opisy dla istniejących wartości w polu **restrictionCause.description**:
* **"SHORT_SHELF_LIFE"** - "Produkt z krótkim terminem przydatności do spożycia lub taki, który szybko się psuje. Np.: twaróg, świeże warzywa, rośliny doniczkowe."
* **"SEALED_MEDIA"** - "Nagranie dźwiękowe, wizualne, program komputerowy w zapieczętowanym opakowaniu. Np.: kiedy kupujący zdejmie folię ochronną z fabrycznie nowej gry, lub płyty z muzyką czy filmem."
* **"PRESS"** - "Dziennik, periodyk lub czasopismo – z wyjątkiem umów o prenumeratę."
* **"CUSTOM_ITEM"** - "Rzecz wyprodukowaną na indywidualne zamówienie kupującego, według jego wytycznych.Np.: koszulka z zaprojektowanym przez kupującego nadrukiem."
* **"SEALED_ITEM_NO_RETURN_DUE_HEALTH_OR_HYGIENE"** - "Rzecz, której po otwarciu nie możesz zwrócić ze względu na ochronę zdrowia lub higienę – na przykład: bielizna osobista, test ciążowy, końcówki do szczoteczki elektrycznej, soczewki kontaktowe, maseczki."
* **"NOT_RECORDED_DIGITAL_CONTENT"** - "Treść cyfrową, nie zapisaną na nośniku materialnym, z której kupujący zgodził się skorzystać. Np.: pobranie ebooka, kodu do gry."
* **"INSEPARABLY_LINKED"** - "Rzecz, którą po dostarczeniu trwale połączysz z innymi rzeczami. Np.: olej samochodowy, który wlejesz do auta."
* **"MEDICINAL_PRODUCT"** - "Produkt leczniczy w rozumieniu prawa farmaceutycznego. Np.: leki OTC (bez recepty), leki dla zwierząt."

"availability": {
"range": "RESTRICTED",
"restrictionCause": {
"name": "VALUE_DEPENDENT_ON_FINANCIAL_MARKET",
"description": "Usługi lub przedmioty, których cena zależy od wahań na rynku finansowym, nad czym sprzedający nie ma kontroli, a które mogą wystąpić przed upływem terminu na odstąpienie od umowy. Np.: produkty inwestycyjne: sztabki złota, monety kolekcjonerskie, srebro, platyna."
},

**Przykładowy response dla GET /after-sales-service-conditions/return-policies/{returnPolicyId}:**

{
"name": "zwrot towaru",
"availability": {
"range": "FULL",
"restrictionCause": null
},
"withdrawalPeriod": "P14D",
"returnCost": {
"coveredBy": "SELLER"
},
"attachment": {
"id": "54702c96-4ccd-4c0e-b4c7-382a71e810b5",
"name": "Przykładowy formularz odstąpienia.pdf",
"url": "https://after-sales.allegrostatic.com/after-sales-service-d2/d7be84bc-5408-42d2-8d0d-acf3ea02feba"
},
"address": {
"name": "Allegro.pl sp. z o.o.",
"street": "Grunwaldzka 182",
"postCode": "60-166",
"city": "Poznań",
"countryCode": "PL"
},
"description": "Informacje dodatkowe",
"contact": {
"phoneNumber": "123 123 123",
"email": "useridentifier@domain.com"
},
"options": {
"cashOnDeliveryNotAllowed": true,
"freeAccessoriesReturnRequired": true,
"refundLoweredByReceivedDiscount": true,
"refundOfCheapestItemInCombinedDiscount": false,
"businessReturnAllowed": false,
"collectBySellerOnly": false
}
}

**Co trzeba zrobić, aby dostosować warunki zwrotów do zmian?**

Już teraz możesz sprawdzić i dostosować adresy zwrotu do podanych wytycznych. W innym wypadku, od **20 lipca 2021**, podczas tworzenia lub edytowania warunków zwrotu otrzymasz błąd.

**20 lipca 2021** dodamy nowe pola i wartości do dotychczasowej struktury, aby można było je dostosować do zmian. Na tym etapie nie będą one obowiązkowe.

**Co zmienimy w październiku 2021?**

1. Usuniemy pole **"attachment"**.
2. Usuniemy pole **"description"** i zastąpimy opcjonalnym obiektem **"contact"**.
3. Przesłanie pełnej struktury **"options"** będzie obowiązkowe.
4. Usuniemy 3 wartości z **restrictionCause.name**:
* **"ALCOHOL"**,
* **"BOOKED_SERVICE"**,
* **"FULLY_IMPLEMENTED_SERVICE"**.

--------------

In **October 2021**, we will [change](https://allegro.pl/dla-sprzedajacych/allegro-zwroty) the process of returning items on Allegro and the [return policy form](https://allegro.pl/moje-allegro/sprzedaz/warunki-zwrotow). Already in **July**, we will introduce changes to the Allegro API so that everyone has time to adapt their application.

**Which resources are affected by these changes?**

* [POST /after-sales-service-conditions/return-policies](../../en/documentation/#operation/createAfterSalesServiceReturnPolicyUsingPOST) - create new user's return policy,
* [GET /after-sales-service-conditions/return-policies/{returnPolicyId}](../../en/documentation/#operation/getAfterSalesServiceReturnPolicyUsingGET) - get the user's return policy,
* [PUT /after-sales-service-conditions/return-policies/{returnPolicyId}](../../en/documentation/#operation/updateAfterSalesServiceReturnPolicyUsingPUT) - change the user's return policy.

**What will we change from July 20th, 2021?**

To the current structure:

1. We will add address validation. For **"countryCode": "PL"**:
* **city** - only Polish letters (without zip code and special characters),
* **zip code** - validation according to the pattern (dd [-] ddd),
* **street** - without special signs, in accordance with the rules of carrier validation.

"address": {
"name": "Allegro.pl Sp. z o.o.",
"street": "Grunwaldzka 182",
"postCode": "60-166",
"city": "Poznań",
"countryCode": "PL"
},

2. We will add a new **"contact"** section with contact information - phone number and email address.

"contact": {
"phoneNumber": "123 123 123",
"email": "useridentifier@domain.com"
},

3. We will add a new **"options"** section which will contain the selected options:
* **"cashOnDeliveryNotAllowed"** - "Nie przyjmuję zwrotów nadanych za pobraniem",
* **"freeAccessoriesReturnRequired"** - "Otrzymałeś gratis? - w przypadku zwrotu towaru odeślij go również do nas",
* **"refundLoweredByReceivedDiscount"** - "Otrzymałeś rabat na kolejną sztukę? - w przypadku zwrotu towaru pomniejszymy zwrot wpłaty o wartość udzielonego rabatu",
* **"refundOfCheapestItemInCombinedDiscount"** - "Podczas zakupu zestawu otrzymałeś rabat na kolejny produkt? - w przypadku zwrotu jednego produktu z zestawu, otrzymasz zwrot pieniędzy za tańszy produkt",
* **"businessReturnAllowed"** - "Przyjmuję zwroty od firm (nie dotyczy jednoosobowych działalności gospodarczych)",
* **"collectBySellerOnly"** - "Osobiście odbieram zwrot od kupującego".

"options": {
"cashOnDeliveryNotAllowed": true,
"freeAccessoriesReturnRequired": true,
"refundLoweredByReceivedDiscount": true,
"refundOfCheapestItemInCombinedDiscount": false,
"businessReturnAllowed": false,
"collectBySellerOnly": false
}

4. For value **"range": "RESTRICTED":**
* in the **restrictionCause.name** field we will add one value **"VALUE_DEPENDENT_ON_FINANCIAL_MARKET"** - "Usługę lub przedmiot, których ceny zależą od wahań na rynku finansowym, nad którymi sprzedający nie ma kontroli, a które mogą wystąpić przed upływem terminu na odstąpienie od umowy. Np.: produkty inwestycyjne: sztabki złota, monety kolekcjonerskie, srebro, platyna."
* we will change the descriptions for existing values in the **restrictionCause.description** field:
* **"SHORT_SHELF_LIFE"** - "Produkt z krótkim terminem przydatności do spożycia lub taki, który szybko się psuje. Np.: twaróg, świeże warzywa, rośliny doniczkowe."
* **"SEALED_MEDIA"** - "Nagranie dźwiękowe, wizualne, program komputerowy w zapieczętowanym opakowaniu. Np.: kiedy kupujący zdejmie folię ochronną z fabrycznie nowej gry, lub płyty z muzyką czy filmem."
* **"PRESS"** - "Dziennik, periodyk lub czasopismo – z wyjątkiem umów o prenumeratę."
* **"CUSTOM_ITEM"** - "Rzecz wyprodukowaną na indywidualne zamówienie kupującego, według jego wytycznych.Np.: koszulka z zaprojektowanym przez kupującego nadrukiem."
* **"SEALED_ITEM_NO_RETURN_DUE_HEALTH_OR_HYGIENE"** - "Rzecz, której po otwarciu nie możesz zwrócić ze względu na ochronę zdrowia lub higienę – na przykład: bielizna osobista, test ciążowy, końcówki do szczoteczki elektrycznej, soczewki kontaktowe, maseczki."
* **"NOT_RECORDED_DIGITAL_CONTENT"** - "Treść cyfrową, nie zapisaną na nośniku materialnym, z której kupujący zgodził się skorzystać. Np.: pobranie ebooka, kodu do gry."
* **"INSEPARABLY_LINKED"** - "Rzecz, którą po dostarczeniu trwale połączysz z innymi rzeczami. Np.: olej samochodowy, który wlejesz do auta."
* **"MEDICINAL_PRODUCT"** - "Produkt leczniczy w rozumieniu prawa farmaceutycznego. Np.: leki OTC (bez recepty), leki dla zwierząt."

"availability": {
"range": "RESTRICTED",
"restrictionCause": {
"name": "VALUE_DEPENDENT_ON_FINANCIAL_MARKET",
"description": "Usługi lub przedmioty, których cena zależy od wahań na rynku finansowym, nad czym sprzedający nie ma kontroli, a które mogą wystąpić przed upływem terminu na odstąpienie od umowy. Np.: produkty inwestycyjne: sztabki złota, monety kolekcjonerskie, srebro, platyna."
},

**Sample response for GET /after-sales-service-conditions/return-policies/{returnPolicyId}:**

{
"name": "zwrot towaru",
"availability": {
"range": "FULL",
"restrictionCause": null
},
"withdrawalPeriod": "P14D",
"returnCost": {
"coveredBy": "SELLER"
},
"attachment": {
"id": "54702c96-4ccd-4c0e-b4c7-382a71e810b5",
"name": "Przykładowy formularz odstąpienia.pdf",
"url": "https://after-sales.allegrostatic.com/after-sales-service-d2/d7be84bc-5408-42d2-8d0d-acf3ea02feba"
},
"address": {
"name": "Allegro.pl sp. z o.o.",
"street": "Grunwaldzka 182",
"postCode": "60-166",
"city": "Poznań",
"countryCode": "PL"
},
"description": "Informacje dodatkowe",
"contact": {
"phoneNumber": "123 123 123",
"email": "useridentifier@domain.com"
},
"options": {
"cashOnDeliveryNotAllowed": true,
"freeAccessoriesReturnRequired": true,
"refundLoweredByReceivedDiscount": true,
"refundOfCheapestItemInCombinedDiscount": false,
"businessReturnAllowed": false,
"collectBySellerOnly": false
}
}

**What do you need to adapt your returns policy to the changes?**

From now on, you can check and adjust the return addresses to the given guidelines. Otherwise, from **July 20th, 2021**, you will get an error when creating or editing your return policy.

On **July 20th, 2021**, we will add new fields and values to the existing structure so that they can be adapted to changes. They will not be obligatory at this stage.

**What will we change in October 2021?**

1. We will remove the **"attachment"** field.
2. We will remove the **"description"** field and replace it with an optional **"contact"** object.
3. Sending the full **"options"**structure will be obligatory.
4. We will remove 3 values from **restrictionCause.name**:
* **"ALCOHOL"**,
* **"BOOKED_SERVICE"**,
* **"FULLY_IMPLEMENTED_SERVICE"**.