18 marca 2026
Zarządzanie ofertami - wdrożyliśmy nowe zasoby do grupowej edycji ceny i stanu magazynowego
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}
- GET /sale/offer-price-change-commands/{commandId}
- GET /sale/offer-price-change-commands/{commandId}/tasks
Dla liczby przedmiotów:
- PUT /sale/offer-quantity-change-commands/{commandId}
- GET /sale/offer-quantity-change-commands/{commandId}
- GET /sale/offer-quantity-change-commands/{commandId}/tasks
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 - zlecenie operacji grupowej
- GET /sale/offer-bulk-modification-commands/{commandId} - raport dla operacji grupowej
- GET /sale/offer-bulk-modification-commands/{commandId}/tasks - 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 oraz w poradniku.
