allegro / allegro/allegro-api

[NEWS] POST /pricing/offer-fee-preview - dostosowaliśmy kalkulator opłat do aktualnych metod promowań / POST /pricing/offer-fee-preview - we have adapted the fee calculator to current promotion methods

未關閉
#8,407 0 則留言 0 個 reaction 已指派 1 人 已被 @AureliuszBrussy 認領 在 GitHub 檢視
News
主要語言
沒有語言資料
星號
244
分支
40
PR 合併指標
30 天內沒有已合併 PR

描述

Dzięki kalkulatorowi opłat sprzedający mogą sprawdzić, jakie opłaty pobieramy dla konkretnej oferty.

**Jakie zmiany wprowadziliśmy?**

Dla [POST /pricing/offer-fee-preview](https://developer.allegro.pl/documentation#operation/calculateFeePreviewUsingPOST) w obiekcie "promotion" zaktualizowaliśmy dostępne typy promowań.

Dodaliśmy:

- **emphasized1d** - Wyróżnienie Elastyczne, za które opłatę naliczamy codziennie,
- **emphasized10d** - Wyróżnienie, za które opłatę naliczamy co dziesięć dni,
- **promoPackage** - Pakiet Promo (Wyróżnienie + Podświetlenie + Pogrubienie), dla którego opłatę naliczamy codziennie.

Usunęliśmy równocześnie nieaktualne już metody promowań:

- **emphasized**,
- **bold**,
- **highlight**,
- **emphasizedHighlightBoldPackage**.

Samą listę dostępnych w serwisie promowań odczytasz za pomocą [GET /sale/offer-promotion-packages](https://developer.allegro.pl/documentation/#operation/getAvailableOfferPromotionPackages), a włączone w ofertach promowanie pobierzesz za pomocą [GET /sale/offers/promo-options](https://developer.allegro.pl/documentation/#operation/getPromoOptionsForSellerOffersUsingGET) oraz [GET /sale/offers/{offerId}/promo-options](https://developer.allegro.pl/documentation/#operation/getOfferPromoOptionsUsingGET).

Dodatkowo [w dokumentacji](https://developer.allegro.pl/documentation#operation/calculateFeePreviewUsingPOST) zaktualizowaliśmy strukturę przyjmowanego w requeście payloadu - pozostawiliśmy w niej tylko pola, które rzeczywiście mogą mieć wpływ na naliczanie opłaty dla oferty.

Zmiany te nie spowodują występowania błędów walidacji dla [POST /pricing/offer-fee-preview](https://developer.allegro.pl/documentation#operation/calculateFeePreviewUsingPOST) w przypadku wysyłania nadmiarowych pól - nie zostaną one wzięte pod uwagę podczas kalkulacji opłat.
_______
With the fee calculator, sellers can see what fees are charged for a specific offer.

**What changes have we implemented?**

For [POST /pricing/offer-fee-preview](https://developer.allegro.pl/documentation#operation/calculateFeePreviewUsingPOST) in the "**promotion**" object, we have updated the available promotion types.

We have added:

- **emphasized1d** - Flexible Emphasized, for which we charge daily,
- **emphasized10d** - Emphasized for which we charge every ten days,
- **promoPackage** - Promo Package (Emphasized + Highlight + Bold), for which we charge daily.

At the same time, we removed the now obsolete promotion methods:

- **emphasized**,
- **bold**,
- **highlight**,
- **emphasizedHighlightBoldPackage**.

You can get the list of available promotions by using [GET /sale/offer-promotion-packages](https://developer.allegro.pl/documentation/#operation/getAvailableOfferPromotionPackages), and you will retrieve the promotions enabled in the offers with [GET /sale/offers/promo-options](https://developer.allegro.pl/documentation/#operation/getPromoOptionsForSellerOffersUsingGET) and [GET /sale/offers/{offerId}/promo-options](https://developer.allegro.pl/documentation/#operation/getOfferPromoOptionsUsingGET).

In addition, [in the documentation](https://developer.allegro.pl/documentation#operation/calculateFeePreviewUsingPOST), we have updated the structure of the payload accepted in the request - we have kept only the fields that can actually affect the fee calculation for the offer.

These changes will not cause validation errors for [POST /pricing/offer-fee-preview](https://developer.allegro.pl/documentation#operation/calculateFeePreviewUsingPOST) when sending redundant fields - they will not be taken into account when calculating fees.

貢獻指南

這個儲存庫沒有索引到貢獻指南

評估

這個 Issue 還沒有評估資料。

把新 issue 寄到你的電子郵件信箱

精選適合新手參與的 GitHub issue 摘要。