[NEWS] "Ważne informacje dla sprzedającego" w zamówieniu - ustaw, czy pole ma być opcjonalne, czy ukryte / "Important information for the seller" in the order - set whether the field should be optional or hidden

Aktualnie podczas składania zamówienia kupujący może wprowadzić opcjonalną wiadomość dla sprzedającego, którą następnie wyświetlimy w polu "**messageToSeller**", gdy pobierzesz zamówienie poprzez:

* [GET /order/checkout-forms](https://developer.allegro.pl/documentation/#operation/getListOfOrdersUsingGET),
* [GET /order/checkout-forms/{id}](https://developer.allegro.pl/documentation/#operation/getOrdersDetailsUsingGET).

Chcemy, aby sprzedający miał większą kontrolę nad tym, czy kupujący może wprowadzić taką wiadomość dla sprzedającego.

**Co zmieniliśmy?**

Rozszerzyliśmy dzisiaj strukturę oferty o nowy obiekt "**messageToSellerSettings**", gdzie w polu "**mode**" możesz przekazać jedną z wartości:

* **OPTIONAL** - wyświetlimy kupującemu pole “Ważne informacje dla sprzedającego” w formularzu dostawy i płatności, ale nie będzie musiał go uzupełniać - “Ważne informacje dla sprzedającego” będą działać jak dotychczas,
* **HIDDEN** - ukryjemy pole “Ważne informacje dla sprzedającego” w formularzu dostawy i płatności - kupujący nie będzie mógł wprowadzić żadnej wiadomości.

Zmianę wprowadziliśmy dla:

* [GET /sale/offers/{offerId}](https://developer.allegro.pl/documentation/#operation/getOfferUsingGET),
* [POST /sale/offers](https://developer.allegro.pl/documentation/#operation/createOfferUsingPOST),
* [PUT /sale/offers/{offerId}](https://developer.allegro.pl/documentation/#operation/updateOfferUsingPUT),
* [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).

Jeżeli nie przekażesz żadnej wartości w tym obiekcie (lub przekażesz **null**) - domyślnie, tak jak dotychczas, wypełnienie "Ważnych informacji dla sprzedającego" przez Kupującego będzie opcjonalne.

**Przykład prawidłowo uzupełnionej struktury:**

```
{
"id": "7276261934",
"name": "Test offer",
...
"messageToSellerSettings": {
"mode": "HIDDEN" -- określ, czy "Ważna wiadomość do
sprzedającego" ma być opcjonalna
(OPTIONAL), czy ukryta (HIDDEN).
}
...
}
```

**Jakie będą kolejne zmiany?**

Do końca pierwszego kwartału 2022 planujemy wprowadzić zmiany, aby sprzedający mógł określić, czy pole wiadomości dla sprzedającego ma być obowiązkowe dla kupującego. Będzie mógł dodać również podpowiedź, która powinna ułatwić kupującemu wskazanie dokładnych informacji, które są niezbędne, aby zrealizować zamówienie. W ten sposób kupujący nie będzie musiał wracać do strony oferty, aby wiedzieć jak uzupełnić pole wiadomości dla sprzedającego.

Informacje o zmianie znajdziesz także w naszych poradnikach:

* [Jak jednym requestem wystawić ofertę powiązaną z produktem](https://developer.allegro.pl/product_offers/#ważne-informacje-dla-sprzedającego),
* [Jak wystawić ofertę](https://developer.allegro.pl/sale/#ważne-informacje-dla-sprzedającego).

-----------

Currently, when placing an order, the buyer can enter an optional message for the seller, which we will then display in the "**messageToSeller**" field when you retrieve the order through:

* [GET /order/checkout-forms](https://developer.allegro.pl/en/documentation/#operation/getListOfOrdersUsingGET),
* [GET /order/checkout-forms/{id}](https://developer.allegro.pl/en/documentation/#operation/getOrdersDetailsUsingGET).

We want the seller to have more control over whether the buyer can enter such a message for the seller.

**What changes have we made?**

Today we extended the offer structure with a new "**messageToSellerSettings**" object, where you can pass one of the values in the "**mode**" field:

* **OPTIONAL** - we will display the "Important information for the seller" field in the delivery and payment form to the buyer, but they will not have to fill it in - "Important information for the seller" will work as before,
* **HIDDEN** - we will hide the "Important information for the seller" field in the delivery and payment form - the buyer will not be able to enter any message.

We introduced the change for:

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

If you do not pass any value in this object (or pass **null**) - by default, as before, it will be optional for the buyer to fill in "Important information for the seller".

**Sample request structure:**
```
{
"id": "7276261934",
"name": "Test offer",
...
"messageToSellerSettings": {
"mode": "HIDDEN" -- specify whether “Important message to
seller” should be optional (OPTIONAL)
or hidden (HIDDEN).
}
...
}
```
**What will be the next changes?**

By the end of the first quarter of 2022, we plan to add an option so that the seller can specify whether the "Important information to seller" field is mandatory for the buyer. He will also be able to add a hint, which should make it easier for the buyer to indicate the exact information that is needed to complete the order. This way, the buyer will not have to go back to the listing page, to know how to complete the message for the seller field.

You can also find information about the change in our guides:

* [How to list an offer assigned to a product with one request](https://developer.allegro.pl/en/product_offers/#important-information-for-the-seller),
* [Listing offers](https://developer.allegro.pl/en/sale/#important-information-for-the-seller).