[NEWS] GET /sale/offer-additional-services/categories - nowy zasób do zarządzania usługami dodatkowymi / GET /sale/offer-additional-services/categories - new resource for managing additional services

Udostępniliśmy dziś nowy zasób [GET /sale/offer-additional-services/categories](https://developer.allegro.pl/documentation/#operation/getListOfAdditionalServicesDefinitionsCategoriesUsingGET), dzięki któremu pobierzesz dostępne usługi dodatkowe z podziałem na kategorie. W przyszłości endpoint zwróci także listę specjalistycznych usług dodatkowych dla ofert przesyłek ciężkich i ponadwymiarowych.

**Przykładowy request:**

```json5
curl -X GET \
'https://api.allegro.pl/sale/offer-additional-services/categories’ \
-H 'Authorization: Bearer {token}' \
-H 'Accept: application/vnd.allegro.public.v1+json'
```
>
**Przykładowy response:**

```json5
{
"categories": [
{
"name": "Usługi wykonywane przed wysyłką", - kategoria usług dodatkowych
"definitions": [
{
"id": "GIFT_WRAP", - identyfikator usługi dodatkowej
"name": "Zapakuj na prezent", - nazwa usługi dodatkowej
"description": { - opis usługi
"hint": "Opisz, jak zapakujesz towar na prezent, jakiego użyjesz
papieru, wstążki, czy dodasz liścik, itd.",
"editable": true,
"default": null
},
"maxPrice": { - maksymalna cena usługi
"amount": "123.45",
"currency": "PLN"
},
"availableConstraints": [ - dostępne ograniczenia
{
"type": "COUNTRY_SAME_QUANTITY",
"availableDeliveryMethods": null
}
]
}
]
},
{
"name": "Usługi wniesienia",
"definitions": [
{
"id": "CARRY_IN",
"name": "Wniesienie",
"description": {
"hint": "Opisz, na co powinien przygotować się kupujący i czy są
jakieś ograniczenia, np. piętro, do którego dostarczasz przesyłkę.",
"editable": true,
"default": null
},
"maxPrice": {
"amount": "123.45",
"currency": "PLN"
},
"availableConstraints": [
{
"type": "COUNTRY_DELIVERY_SAME_QUANTITY",
"availableDeliveryMethods": [
"7203cb90-864c-4cda-bf08-dc883f0c78ad",
"259b5c7a-9056-4c74-80ec-9bb2978cf293"
]
}
]
},
{
"id": "CARRY_IN_AND_SETUP",
"name": "Wniesienie i ustawienie",
"description": {
"hint": "Opisz, na co powinien przygotować się kupujący i czy są jakieś ograniczenia,
np. piętro, do którego dostarczasz przesyłkę.",
"editable": true,
"default": null
},
"maxPrice": {
"amount": "123.45",
"currency": "PLN"
},
"availableConstraints": [
{
"type": "COUNTRY_DELIVERY_SAME_QUANTITY",
"availableDeliveryMethods": [
"7203cb90-864c-4cda-bf08-dc883f0c78ad",
"259b5c7a-9056-4c74-80ec-9bb2978cf293"
]
}
]
}
]
},
{
"name": "Usługi montażu specjalistycznego",
"definitions": [
{
"id": "FRIDGE_CARRY_IN_AND_SETUP_DOORS_DIRECTION",
"name": "Wniesienie i montaż lodówki, zmiana kierunku drzwi",
"description": {
"hint": null,
"editable": false,
"default": "Wniesienie maksymalnie na 4 piętro schodami lub dowolne piętro windą.
Demontaż i zabranie zużytego sprzętu (takiego jak zakupiony np. lodówka za lodówkę).
Montaż zakupionego sprzętu, ustawienie, wyrzucenie opakowań, sprzęt gotowy do użytku."
},
"maxPrice": {
"amount": "123.45",
"currency": "PLN"
},
"infoUrl": "https://allegro.pl/pomoc/dla-sprzedajacych/wystawianie-i-edycja-oferty/wniesienie-montaz-i-inne-uslugi-dodatkowe-w-ofertach-xG71gnKLDCG",
"availableConstraints": [
{
"type": "COUNTRY_DELIVERY_SAME_QUANTITY",
"availableDeliveryMethods": [
"7203cb90-864c-4cda-bf08-dc883f0c78ad",
"259b5c7a-9056-4c74-80ec-9bb2978cf293"
]
}
]
}
]
}
]
}
```
>

Jednocześnie, dotychczasowy zasób [GET /sale/offer-additional-services/definitions](https://developer.allegro.pl/documentation/#operation/getListOfAdditionalServicesDefinitionsUsingGET) zwracający tylko listę usług dodatkowych oznaczyliśmy jako **Deprecated**. W dniu **06.04.2023** całkowicie go usuniemy.

Więcej informacji o usługach dodatkowych znajdziesz w [naszym poradniku](https://developer.allegro.pl/tutorials/jak-zarzadzac-ofertami-7GzB2L37ase#jak-zarzadzac-uslugami-dodatkowymi).

-----
Today, we have introduced a new [GET /sale/offer-additional-services/categories](https://developer.allegro.pl/documentation/#operation/getListOfAdditionalServicesDefinitionsCategoriesUsingGET) resource, with which you will retrieve the available additional services by category. In the future, endpoint will also return a list of specialised value added services for Heavy and Bulky.

**Sample request:**

```json5
curl -X GET \
'https://api.allegro.pl/sale/offer-additional-services/categories’ \
-H 'Authorization: Bearer {token}' \
-H 'Accept: application/vnd.allegro.public.v1+json'
```
>
**Sample response:**

```json5
{
"categories": [
{
"name": "Usługi wykonywane przed wysyłką", - additional services category
"definitions": [
{
"id": "GIFT_WRAP", - additional service id
"name": "Zapakuj na prezent", - additional service name
"description": { - additional service description
"hint": "Opisz, jak zapakujesz towar na prezent, jakiego użyjesz
papieru, wstążki, czy dodasz liścik, itd.",
"editable": true,
"default": null
},
"maxPrice": { - maximum price of additional service
"amount": "123.45",
"currency": "PLN"
},
"availableConstraints": [ - additional service restrictions
{
"type": "COUNTRY_SAME_QUANTITY",
"availableDeliveryMethods": null
}
]
}
]
},
{
"name": "Usługi wniesienia",
"definitions": [
{
"id": "CARRY_IN",
"name": "Wniesienie",
"description": {
"hint": "Opisz, na co powinien przygotować się kupujący i czy są
jakieś ograniczenia, np. piętro, do którego dostarczasz przesyłkę.",
"editable": true,
"default": null
},
"maxPrice": {
"amount": "123.45",
"currency": "PLN"
},
"availableConstraints": [
{
"type": "COUNTRY_DELIVERY_SAME_QUANTITY",
"availableDeliveryMethods": [
"7203cb90-864c-4cda-bf08-dc883f0c78ad",
"259b5c7a-9056-4c74-80ec-9bb2978cf293"
]
}
]
},
{
"id": "CARRY_IN_AND_SETUP",
"name": "Wniesienie i ustawienie",
"description": {
"hint": "Opisz, na co powinien przygotować się kupujący i czy są jakieś ograniczenia,
np. piętro, do którego dostarczasz przesyłkę.",
"editable": true,
"default": null
},
"maxPrice": {
"amount": "123.45",
"currency": "PLN"
},
"availableConstraints": [
{
"type": "COUNTRY_DELIVERY_SAME_QUANTITY",
"availableDeliveryMethods": [
"7203cb90-864c-4cda-bf08-dc883f0c78ad",
"259b5c7a-9056-4c74-80ec-9bb2978cf293"
]
}
]
}
]
},
{
"name": "Usługi montażu specjalistycznego",
"definitions": [
{
"id": "FRIDGE_CARRY_IN_AND_SETUP_DOORS_DIRECTION",
"name": "Wniesienie i montaż lodówki, zmiana kierunku drzwi",
"description": {
"hint": null,
"editable": false,
"default": "Wniesienie maksymalnie na 4 piętro schodami lub dowolne piętro windą.
Demontaż i zabranie zużytego sprzętu (takiego jak zakupiony np. lodówka za lodówkę).
Montaż zakupionego sprzętu, ustawienie, wyrzucenie opakowań, sprzęt gotowy do użytku."
},
"maxPrice": {
"amount": "123.45",
"currency": "PLN"
},
"infoUrl": "https://allegro.pl/pomoc/dla-sprzedajacych/wystawianie-i-edycja-oferty/wniesienie-montaz-i-inne-uslugi-dodatkowe-w-ofertach-xG71gnKLDCG",
"availableConstraints": [
{
"type": "COUNTRY_DELIVERY_SAME_QUANTITY",
"availableDeliveryMethods": [
"7203cb90-864c-4cda-bf08-dc883f0c78ad",
"259b5c7a-9056-4c74-80ec-9bb2978cf293"
]
}
]
}
]
}
]
}
```
>

At the same time, we have marked the existing [GET /sale/offer-additional-services/definitions](https://developer.allegro.pl/documentation/#operation/getListOfAdditionalServicesDefinitionsUsingGET) resource returning only a list of additional services as **Deprecated**. On **April 6, 2023**, we will remove it completely.

You can find more information about additional services in [our tutorial](https://developer.allegro.pl/tutorials/how-to-process-list-of-offers-m09BKA5v8H3#how-to-manage-additional-services).