allegro / allegro/allegro-api

[NEWS] Kampanie - udostępniliśmy nowe zasoby do obsługi programu Allegro Ceny / Campaigns - we have introduced new resources for managing the Allegro Prices program

未关闭
#13,081 9 条评论 1 个 reaction 已指派 1 人 已被 @PrzemyslawLukanowski 认领 在 GitHub 查看
Breaking change News Offer - Badges and Promotion campaigns
主要语言
没有语言数据
星标
244
派生
40
PR 合并指标
30 天内没有已合并 PR

描述

**Allegro Ceny** to program wsparcia konkurencyjności dla sprzedających. Automatycznie obniżamy w nim ceny wybranych produktów. Dzięki temu klient kupuje u sprzedającego i płaci mniej, a sprzedający nic nie traci. Kwotę, o którą została obniżona cena, zwracamy partnerowi w formie rabatu na rachunek.

Więcej informacji na temat programu Allegro Ceny znajdziesz w artykule na stronie [Pomoc dla sprzedających](https://help.allegro.com/pl/sell/c/allegro-ceny).

**Co zmieniliśmy?**

Udostępniliśmy nowe zasoby do obsługi programu Allegro Ceny:

- [GET /sale/allegro-prices/accounts/participations](https://developer.allegro.pl/documentation#tag/Allegro-Prices/operation/getAccountParticipation) - pobierz status uczestnictwa na wszystkich obsługiwanych rynkach
- [PATCH /sale/allegro-prices/accounts/participations](https://developer.allegro.pl/documentation#tag/Allegro-Prices/operation/updateAccountParticipation) - zmień status uczestnictwa na wybranych rynkach
- [POST /sale/allegro-prices/offers/submit-offer-commands](https://developer.allegro.pl/documentation#tag/Allegro-Prices/operation/submitOfferCommands) - zleć dodanie ofert do programu
- [GET /sale/allegro-prices/offers/submit-offer-commands/{commandId}](https://developer.allegro.pl/documentation#tag/Allegro-Prices/operation/getSubmitOfferCommandStatus) - pobierz status i szczegóły zlecenia dodania ofert do programu
- [POST /sale/allegro-prices/offers/exclusion-commands](https://developer.allegro.pl/documentation#tag/Allegro-Prices/operation/excludeOfferCommands) - zleć wykluczenie ofert z programu
- [GET /sale/allegro-prices/offers/exclusion-commands/{commandId}](https://developer.allegro.pl/documentation#tag/Allegro-Prices/operation/getExcludeOfferCommandStatus) - pobierz status i szczegóły zlecenia wykluczenia ofert z programu
- [POST /sale/allegro-prices/offers-queries](https://developer.allegro.pl/documentation#tag/Allegro-Prices/operation/getAllegroPricesOffers) - pobierz listę ofert i ich obecny status w programie.

Więcej szczegółów odnośnie obsługi nowych zasobów znajdziesz w [naszym poradniku](https://developer.allegro.pl/tutorials/jak-przypisac-oferte-kampanii-GRaj0q6Gwuy#allegro-ceny-jak-zarzadzac-udzialem-w-programie).

Dodatkowo, **wcześniejsze zasoby**, do obsługi programu Allegro Ceny, **oznaczyliśmy jako deprecated** i usuniemy je **25.05.2026**:

- [GET /sale/allegro-prices-offer-consents/{offerId}](https://developer.allegro.pl/documentation#tag/Allegro-Prices/operation/getAllegroPricesConsentForOffer) - pobierz aktualną zgodę dla oferty
- [PUT /sale/allegro-prices-offer-consents/{offerId}](https://developer.allegro.pl/documentation#tag/Allegro-Prices/operation/updateAllegroPricesConsentForOffer) - zaktualizuj zgodę dla oferty
- [GET /sale/allegro-prices-account-eligibility](https://developer.allegro.pl/documentation#tag/Allegro-Prices/operation/getAllegroPricesEligibilityForAccount) - pobierz aktualne uprawnienia dla konta
- [PUT /sale/allegro-prices-account-consent](https://developer.allegro.pl/documentation#tag/Allegro-Prices/operation/updateAllegroPricesConsentForAccount) - zaktualizuj zgodę dla konta.

**Dlaczego wprowadzamy nowe zasoby do obsługi programu Allegro Ceny?**

Chcemy dostosować API do aktualnego działania programu Allegro Ceny:

- Sprzedający mogą teraz zwiększać atrakcyjność swoich ofert, deklarując własny udział w obniżce ceny. Dotychczasowe zasoby nie pozwalały na przekazywanie takich deklaracji.

- Monitorowanie korzyści z udziału w programie jest łatwiejsze - sprzedający pobiorą informacje o konkretnych kwotach obniżek w ofertach, które biorą udział w programie.

- Poprzednio wprowadzony endpoint [PUT /sale/allegro-prices-offer-consents/{offerId}](https://developer.allegro.pl/documentation#tag/Allegro-Prices/operation/updateAllegroPricesConsentForOffer) nie pozwalał na operacje masowe, co zmuszało użytkowników do wysyłania oddzielnych żądań dla każdej oferty. Za pomocą nowych zasobów jest to już możliwe - sprzedający mogą włączyć lub wykluczyć z programu wiele ofert naraz.

Więcej o Allegro Ceny przeczytasz w [naszym poradniku](https://developer.allegro.pl/tutorials/jak-przypisac-oferte-kampanii-GRaj0q6Gwuy#allegro-ceny-jak-zarzadzac-udzialem-w-programie).

-----

**Allegro Prices** is a competitiveness support program for sellers. We use it to automatically lower the prices of selected products. This allows customers to pay less when buying from a seller without the seller losing any profit. The amount by which the price was reduced is refunded to the partner as a discount on their invoice.

More information about the Allegro Prices program can be found in the article on the [Help for sellers](https://help.allegro.com/en/sell/c/allegro-prices#ZMl7xw8Y6Uw) page.

**What have we changed?**

We have introduced new resources for managing the Allegro Prices program:

- [GET /sale/allegro-prices/accounts/participations](https://developer.allegro.pl/documentation#tag/Allegro-Prices/operation/getAccountParticipation) - retrieve the account participation status for all supported marketplaces
- [PATCH /sale/allegro-prices/accounts/participations](https://developer.allegro.pl/documentation#tag/Allegro-Prices/operation/updateAccountParticipation) - update the account participation status for selected marketplaces
- [POST /sale/allegro-prices/offers/submit-offer-commands](https://developer.allegro.pl/documentation#tag/Allegro-Prices/operation/submitOfferCommands) - submit a command to add offers to the program
- [GET /sale/allegro-prices/offers/submit-offer-commands/{commandId}](https://developer.allegro.pl/documentation#tag/Allegro-Prices/operation/getSubmitOfferCommandStatus) - retrieve the status and details of a submitted offer command
- [POST /sale/allegro-prices/offers/exclusion-commands](https://developer.allegro.pl/documentation#tag/Allegro-Prices/operation/excludeOfferCommands) - submit a command to exclude offers from the program
- [GET /sale/allegro-prices/offers/exclusion-commands/{commandId}](https://developer.allegro.pl/documentation#tag/Allegro-Prices/operation/getExcludeOfferCommandStatus) - retrieve the status and details of a submitted exclusion command
- [POST /sale/allegro-prices/offers-queries](https://developer.allegro.pl/documentation#tag/Allegro-Prices/operation/getAllegroPricesOffers) - retrieve a list of offers and their status in the program.

You can find more information about handling new resources in [our tutorial](https://developer.allegro.pl/tutorials/how-to-submit-offers-to-campaigns-AgGjd6EmyH4).

Additionally, we have marked **previous** resources for the Allegro Prices program **as deprecated**. We will  remove them on **25.05.2026**:

- [GET /sale/allegro-prices-offer-consents/{offerId}](https://developer.allegro.pl/documentation#tag/Allegro-Prices/operation/getAllegroPricesConsentForOffer) - retrieve current offer consent 
- [PUT /sale/allegro-prices-offer-consents/{offerId}](https://developer.allegro.pl/documentation#tag/Allegro-Prices/operation/updateAllegroPricesConsentForOffer) - update current offer consent 
- [GET /sale/allegro-prices-account-eligibility](https://developer.allegro.pl/documentation#tag/Allegro-Prices/operation/getAllegroPricesEligibilityForAccount) - retrieve current account eligibility
- [PUT /sale/allegro-prices-account-consent](https://developer.allegro.pl/documentation#tag/Allegro-Prices/operation/updateAllegroPricesConsentForAccount) - update account consent.

**Why are we introducing new resources for the Allegro Prices program?**

We want to align our API with the current functionality of the Allegro Prices program:

- Sellers can now increase the attractiveness of their offers by declaring their own contribution to the price reduction. Previous resources did not support these declarations.
- Monitoring the benefits of program participation is now easier - sellers can retrieve information on specific reduction amounts for offers participating in the program.
- Bulk operations are now supported. The previously introduced endpoint [PUT /sale/allegro-prices-offer-consents/{offerId}](https://developer.allegro.pl/documentation#tag/Allegro-Prices/operation/updateAllegroPricesConsentForOffer) did not allow for bulk actions, forcing users to send separate requests for each offer. With the new resources, this is now possible - sellers can opt-in or exclude multiple offers at once.

You can read more about Allegro Prices in [our tutorial](https://developer.allegro.pl/tutorials/how-to-submit-offers-to-campaigns-AgGjd6EmyH4).

贡献指南

这个仓库没有索引到贡献指南

评估

这个 Issue 还没有评估数据。

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。