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.