10 sierpnia 2021
Kampanie - zmieniamy sposób działania oraz dodamy nowe możliwości
24 sierpnia 2021 udostępnimy nowe operacje na zasobach do zarządzania zgłoszeniami ofert do kampanii, programów specjalnych oraz oznaczeń Allegro:
- PATCH /sale/badges/offers/{offerId}/campaigns/{campaignId} - zleć operację zmiany ceny lub zakończenia oznaczenia oferty w kampanii:
Przykładowy request dla zmiany ceny:
curl -X PATCH
‘https://api.allegro.pl/sale/badges/offers/12345678/campaigns/BARGAIN’
-H ‘Authorization: Bearer {token}’
-H ‘Content-Type: application/vnd.allegro.beta.v1+json‘
-d ‘{
"prices": {
"bargain": {
"value": {
"amount": "9.99",
"currency": "PLN"
}
}
}
}’
Przykładowy request dla zakończenia oznaczenia:
curl -X PATCH
‘https://api.allegro.pl/sale/badges/offers/12345678/campaigns/BARGAIN’
-H ‘Authorization: Bearer {token}’
-H ‘Content-Type: application/vnd.allegro.beta.v1+json‘
-d ‘{
"process": {
"status": "FINISHED"
}
}’
Przykładowy response:
{
"id": "154179f0-ed4c-4b84-9260-302d2dec3801" -- identyfikator operacji
}
- GET /sale/badge-operations/{operationId} - sprawdź status wykonania operacji zmiany ceny lub zakończenia oznaczenia:
Przykładowy request:
curl -X GET
‘https://api.allegro.pl/sale/badge-operations/154179f0-ed4c-4b84-9260-302d2dec3801’
-H ‘Authorization: Bearer {token}’
-H Accept: application/vnd.allegro.beta.v1+json‘
Przykładowy response:
{
"id": "154179f0-ed4c-4b84-9260-302d2dec3801",
"type": "FINISH",
"createdAt": "2021-08-09T12:49:17.347Z",
"updatedAt": "2021-08-09T12:49:17.530Z",
"campaign": {
"id": "BARGAIN"
},
"offer": {
"id": "12345678"
},
"process": {
"status": "REQUESTED",
"rejectionReasons": []
}
}
24 sierpnia rozpoczniemy także migrację wszystkich kampanii na mechanizm, w którym funkcjonuje już program Allegro Ceny.
Jak to działa aktualnie?
Wraz z zakwalifikowaniem oferty do kampanii (prócz programu Allegro Ceny), aktualizujemy również cenę w jej strukturze. Zmiana ta jest widoczna w polu sellingMode.price.amount na zasobach:
- /sale/offers,
- /sale/product-offers.
W przypadku zmiany bazowej ceny w strukturze oferty będącej w kampanii - oznaczenie jest usuwane, a oferta wykluczana z kampanii.
Jakie zmiany wprowadzimy?
Od 24 sierpnia 2021 jeżeli oferta zostanie zakwalifikowana do kampanii:
- nie zaktualizujemy ceny w jej strukturze - bazowa cena, którą zwrócimy w polu sellingMode.price.amount pozostanie bez zmiany,
- jeżeli dojdzie do zmiany ceny bazowej w ofercie w polu sellingMode.price.amount w trakcie trwania kampanii - nie zostanie ona z niej wykluczona,
- w odpowiedzi na GET /sale/offer-events nie zwrócimy zdarzenia o zmianie ceny w ofercie w wyniku jej zakwalifikowania do kampanii.
Zmiana ceny w ofercie, która jest w trakcie kampanii lub jej usunięcie z kampanii będzie możliwe dzięki PATCH /sale/badges/offers/{offerId}/campaigns/{campaignId}.
Dlaczego wprowadzamy zmianę?
Chcemy ułatwić zarządzanie kampaniami i programami. Dzięki zmianie sprzedający będą mogli ustawić nową cenę, która będzie obowiązywać tylko na czas trwania kampanii lub programu i będzie niezależna od ceny bazowej oferty.
Więcej informacji o kampaniach i oznaczeniach przeczytasz w pomocy Allegro.