[NEWS] Zarządzanie ofertami - wdrożyliśmy nowe zasoby do grupowej edycji ceny i stanu magazynowego / Offer Management - we have implemented new features for batch editing of prices and stocks

Obecna forma grupowej edycji pozwala zmieniać cenę lub stan magazynowy w wielu ofertach, ale na jedną lub o jedną wartość. Wychodząc naprzeciw Waszym głosom, wdrożyliśmy **nowe zasoby do grupowej edycji**, gdzie można **zmienić cenę i stan magazynowy w jednym requeście, w wielu ofertach i na różne wartości**.

**Dotychczasowe zasoby grupowej edycji:**

Dla ceny:

- [PUT /sale/offer-price-change-commands/{commandId}](https://developer.allegro.pl/documentation/#operation/priceModificationCommandUsingPUT)
- [GET /sale/offer-price-change-commands/{commandId}](https://developer.allegro.pl/documentation/#operation/getPriceModificationCommandStatusUsingGET)
- [GET /sale/offer-price-change-commands/{commandId}/tasks](https://developer.allegro.pl/documentation/#operation/getPriceModificationCommandTasksStatusesUsingGET)

Dla liczby przedmiotów:

- [PUT /sale/offer-quantity-change-commands/{commandId}](https://developer.allegro.pl/documentation/#operation/quantityModificationCommandUsingPUT)
- [GET /sale/offer-quantity-change-commands/{commandId}](https://developer.allegro.pl/documentation/#operation/getQuantityModificationCommandStatusUsingGET)
- [GET /sale/offer-quantity-change-commands/{commandId}/tasks](https://developer.allegro.pl/documentation/#operation/getQuantityModificationCommandTasksStatusesUsingGET)

**Jakie zasoby dodaliśmy?**

Nowe endpointy pozwolą Ci na zmianę ceny i liczby sztuk w wielu ofertach na różne wartości w ramach jednego requestu, które przeprocesujesz w trzech krokach:

- [POST /sale/offer-bulk-modification-commands](https://developer.allegro.pl/documentation/#tag/Batch-offer-modification/operation/batchOfferModificationUsingPOST) - zlecenie operacji grupowej
- [GET /sale/offer-bulk-modification-commands/{commandId](https://developer.allegro.pl/documentation/#tag/Batch-offer-modification/operation/batchOfferModificationCommandStatusUsingGET)} - raport dla operacji grupowej
- [GET /sale/offer-bulk-modification-commands/{commandId}/tasks](https://developer.allegro.pl/documentation/#tag/Batch-offer-modification/operation/batchOfferModificationCommandTaskStatusesUsingGET) - raport szczegółowy dla operacji grupowej

Możesz wykonać **maksymalnie 25 modyfikacji w jednym requeście**. W przyszłości planujemy zwiększyć tę wartość.

Zasoby te wdrożyliśmy **w wersji "beta"**, dlatego czekamy na wszelkie uwagi. **W lipcu** br. planujemy przejście na wersję **"public"**. Konkretną datę podamy w oddzielnym komunikacie.

**Przykład zlecenia operacji grupowej**

```
curl -X POST \
'https://api.allegro.pl/sale/offer-bulk-modification-commands' \
-H 'Authorization: Bearer {token}' \
-H 'Accept: application/vnd.allegro.beta.v1+json' \
-H 'Content-Type: application/vnd.allegro.beta.v1+json' \
-d '{
"commandId": "13d5ac36-77e7-4813-ab6b-f71763e10e74", // wymagane, podaj we własnym zakresie numer [UUID](https://developer.allegro.pl/tutorials/informacje-podstawowe-b21569boAI1#identyfikatory-zasobow)
"modifications": [
{
"offerId": "1000012340",
"prices": { // możliwy typ do zmiany - "prices" lub "stock"
"allegro-cz": { // marketplace np. allegro-cz, allegro-pl (nie null)
"changeType": "FIXED", // typ zmiany: FIXED (zmiana ceny na podaną wartość), PERCENTAGE (zmiana ceny o podany procent, dla zmniejszenia wartości podaj wartość z minusem), GAIN (dodaj/odejmij wartość, by odjąć, podaj wartość z minusem)
"value": { // dla typów FIXED i GAIN
"amount": "1250",
"currency": "CZK"
}
}
}
},
{
"offerId": "1000012340",
"stock": { // typ zmiany
"changeType": "FIXED", // typ zmiany: FIXED (zmiana liczby przedmiotów na podaną liczbę), GAIN (dodaj/odejmij liczbę przedmiotów, by odjąć podaj, wartość z minusem)
"value": 1
}
},
{
"offerId": "1000012341",
"prices": {
"allegro-pl": {
"changeType": "PERCENTAGE", // dla typu PERCENTAGE
"percentage": "10"
}
}
},
{
"offerId": "1000012341",
"stock": {
"changeType": "GAIN",
"value": 10,
}
}
]
}
```

Wszelkie szczegóły znajdziesz w naszej [dokumentacji](https://developer.allegro.pl/documentation) oraz w [poradniku](https://developer.allegro.pl/tutorials/jak-zarzadzac-ofertami-7GzB2L37ase#cena-i-liczba-przedmiotow).

----

The current version of batch editing allows you to change the price or stock status across multiple listings, but only by a single value. Based on your feedback, we have implemented **new batch editing features that let you change the price and stock status in a single request, across multiple listings, and to different values**.

**Existing batch editing features:**

For price:
- [PUT /sale/offer-price-change-commands/{commandId}](https://developer.allegro.pl/documentation/#operation/priceModificationCommandUsingPUT)
- [GET /sale/offer-price-change-commands/{commandId}](https://developer.allegro.pl/documentation/#operation/getPriceModificationCommandStatusUsingGET)
- [GET /sale/offer-price-change-commands/{commandId}/tasks](https://developer.allegro.pl/documentation/#operation/getPriceModificationCommandTasksStatusesUsingGET)

For stock:
- [PUT /sale/offer-quantity-change-commands/{commandId}](https://developer.allegro.pl/documentation/#operation/quantityModificationCommandUsingPUT)
- [GET /sale/offer-quantity-change-commands/{commandId}](https://developer.allegro.pl/documentation/#operation/getQuantityModificationCommandStatusUsingGET)
- [GET /sale/offer-quantity-change-commands/{commandId}/tasks](https://developer.allegro.pl/documentation/#operation/getQuantityModificationCommandTasksStatusesUsingGET)

**What resources have we added?**

The new endpoints will allow you to change the price and quantity for multiple listings to different values in a single request, which you can process in three steps:

- [POST /sale/offer-bulk-modification-commands](https://developer.allegro.pl/documentation/#tag/Batch-offer-modification/operation/batchOfferModificationUsingPOST) - bulk operation request
- [GET /sale/offer-bulk-modification-commands/{commandId}](https://developer.allegro.pl/documentation/#tag/Batch-offer-modification/operation/batchOfferModificationCommandStatusUsingGET) - report for a bulk operation
- [GET /sale/offer-bulk-modification-commands/{commandId}/tasks](https://developer.allegro.pl/documentation/#tag/Batch-offer-modification/operation/batchOfferModificationCommandTaskStatusesUsingGET) - detail report for a bulk operation

You can perform **up to 25 modifications in a single request**. We plan to increase this limit in the future.

We have implemented these resources in the **"beta"** version, so we are waiting for your feedback. We plan to launch **the “public” version this July**. We will provide the exact date in a separate announcement.
Example of a bulk operation request

```
curl -X POST \
'https://api.allegro.pl/sale/offer-bulk-modification-commands' \
-H 'Authorization: Bearer {token}' \
-H 'Accept: application/vnd.allegro.beta.v1+json' \
-H 'Content-Type: application/vnd.allegro.beta.v1+json' \
-d '{
"commandId": "13d5ac36-77e7-4813-ab6b-f71763e10e74", // required, please provide the [UUID](https://developer.allegro.pl/tutorials/informacje-podstawowe-b21569boAI1#identyfikatory-zasobow) yourself
"modifications": [
{
"offerId": "1000012340",
"prices": { // possible type to change - "prices" or "stock"
"allegro-cz": { // marketplace e.g., allegro-cz, allegro-pl (not null
"changeType": "FIXED", // change type: FIXED (change price to the specified value ), PERCENTAGE (change price by the specified percentage; to decrease enter the value with a minus sign), GAIN (increase/decrease the value; to decrease, enter a value with a minus sign)
"value": { // for FIXED and GAIN types
"amount": "1250",
"currency": "CZK"
}
}
}
},
{
"offerId": "1000012340",
"stock": { // change type
"changeType": "FIXED", // change type: FIXED (change price to the specified value ), GAIN (increase/decrease the value; to decrease, enter a value with a minus sign)
"value": 1
}
},
{
"offerId": "1000012341",
"prices": {
"allegro-pl": {
"changeType": "PERCENTAGE", // for PERCENTAGE type
"percentage": "10"
}
}
},
{
"offerId": "1000012341",
"stock": {
"changeType": "GAIN",
"value": 10,
}
}
]
}
```

You can find all the details in our [documentation](https://developer.allegro.pl/documentation) and in the [guide](https://developer.allegro.pl/tutorials/how-to-process-list-of-offers-m09BKA5v8H3#price-and-stock).