[NEWS] Serwisy zagraniczne Allegro - w zasobach /sale/product-offers dodaliśmy informację o przyczynie odmowy publikacji oferty na danym rynku dodatkowym / Allegro foreign marketplaces - in the /sale/product-offers resources we have added information about refusal reason for publishing offer on a given additional marketplace

W ramach zasobów /sale/product-offers, w sekcji **additionalMarketplaces.{marketplaceId}.publication**, w której zwracamy informacje na temat statusu publikacji oferty na danym rynku dodatkowym, dodaliśmy dziś nowe pole, przeznaczone wyłącznie do odczytu - **refusalReasons**. Zwrócimy w nim powód odmowy udostępnienia oferty na danym rynku.

**Przykładowa struktura odpowiedzi:**

```
{
...
"additionalMarketplaces": { - informacje o rynkach dodatkowych
"allegro-cz": {
"sellingMode": {...},
"publication": { - informacje o publikacji oferty na rynkach
dodatkowych
"state": "REFUSED", - status publikacji
"refusalReasons": [ - powód odmowy publikacji oferty na rynku
dodatkowym. Dla statusów innych niż "REFUSED"
zwrócimy pustą tablicę
{
"code": "VQR009_PRICE_IN_ADDITIONAL_MARKETPLACE_MISMATCH"
- kod powodu odmowy publikacji oferty
"userMessage": "price difference too big",
- powód odrzucenia w języku zdefiniowanym w
nagłówku "Accept-Language"
"parameters": { - dodatkowe informacje, które możemy zwrócić
w określonych przypadkach
"maxAllowedPriceDecreasePercent": ["20"]
}
}
]
}
}
...
}
```

**Jakich zasobów dotyczy zmiana?**

Nowe pole zwrócimy w odpowiedzi:

- [POST /sale/product-offers](https://developer.allegro.pl/documentation#operation/createProductOffers),
- [PATCH /sale/product-offers/{offerId}](https://developer.allegro.pl/documentation#operation/editProductOffers),
- [GET /sale/product-offers/{offerId}](https://developer.allegro.pl/documentation#operation/getProductOffer).

**Dlaczego wprowadziliśmy zmianę?**

Do tej pory informację o przyczynie odmowy publikacji na rynku dodatkowym zwracaliśmy wyłącznie w dzienniku zdarzeń w ofertach [GET /sale/offer-events](https://developer.allegro.pl/documentation#operation/getOfferEvents). W odpowiedzi na Wasze sugestie dodaliśmy tę informację także na poziomie szczegółów oferty.

Więcej informacji o serwisach zagranicznych Allegro znajdziesz w naszym [dedykowanym poradniku](https://developer.allegro.pl/tutorials/wystawianie-i-zarzadzanie-oferta-w-serwisach-zagranicznych-wwzjP4M8gTZ).

-----

As part of the /sale/product-offers resource, in the **additionalMarketplaces.{marketplaceId}.publication** section, where we return information about the publication status of an offer on a given additional market, we have added a new read-only field - **refusalReasons**. We will return the refusal reason for publishing an offer on a given additional marketplace.

**Sample response structure:**

```
{
...
"additionalMarketplaces": {
"allegro-cz": {
"sellingMode": {...},
"publication": {
"state": "REFUSED",
"refusalReasons": [ - refusal reason for publishing offer on a
given additional marketplace. For states
other than "REFUSED" we will return an
empty array.
{
"code": "VQR009_PRICE_IN_ADDITIONAL_MARKETPLACE_MISMATCH"
- code of refusal reason for publishing offer
on a given additional marketplace
"userMessage": "price difference too big",
- refusal reason in the language
defined in the "Accept-Language" header
"parameters": { - additional information that can be
returned in some cases
"maxAllowedPriceDecreasePercent": ["20"]
}
}
]
}
}
...
}
```
>

**Which resources are affected by the change?**

New field will be returned in the response of following resources:
* [POST /sale/product-offers](https://developer.allegro.pl/documentation#operation/createProductOffers),
* [PATCH /sale/product-offers/{offerId}](https://developer.allegro.pl/documentation#operation/editProductOffers),
* [GET /sale/product-offers/{offerId}](https://developer.allegro.pl/documentation#operation/getProductOffer).

**Why have we implemented the change?**

Till now, the information about the refusal reason for publishing an offer on an additional marketplace was returned only in the offer event journal [GET /sale/offer-events](https://developer.allegro.pl/documentation#operation/getOfferEvents). In response to your suggestion, we have added this information also at the offer details level.

You can find more information about Allegro foreign marketplaces in our [dedicated tutorial](https://developer.allegro.pl/tutorials/wystawianie-i-zarzadzanie-oferta-w-serwisach-zagranicznych-wwzjP4M8gTZ).