[NEWS] - 9 maja 2023 włączymy wymagalność pola “language” w ofercie / On May 9, 2023, we will mark the “language” field in the offer as "required"

[PrzemyslawLukanowski]

Pole “language” w strukturze oferty odpowiada za informację o jej języku bazowym. Wartość, którą w nim wskażesz, jest podstawą do dalszych tłumaczeń oferty. Języki, które na tę chwilę wspieramy, to polski (wartość “pl-PL”) oraz angielski (“en-US”).

Jak obsługujemy pole “language” obecnie?

Jeśli nie wysyłasz nam tego pola lub nie wskazujesz w nim żadnej wartości, automatycznie przypisujemy język polski - “pl-PL”. Zmianę wartości umożliwiamy, jeśli oferta jest w statusie “INACTIVE”.

Jakie zmiany wprowadzimy?

9 maja 2023 wprowadzimy zmiany związane z tym polem:

• dla POST /sale/offers - oznaczymy to pole jako wymagane. Jeśli w polu “language” nie wskażesz żadnej z dostępnych wartości, zwrócimy błąd, który uniemożliwi wystawienie oferty!
• niezależnie od zasobu, zmiana wartości tego pola nie będzie możliwa na utworzonej ofercie.

Dla POST /sale/product-offers pole pozostanie niewymagane. Gdy nie wstawisz wartości, ustawimy ją na podstawie języka interfejsu z ustawień konta użytkownika. W tym przypadku nie musisz wykonywać żadnych zmian po swojej stronie.

---

The “language” field in the offer structure indicates its base language. The provided value is the basis for further translations of the offer. Currently supported languages are Polish (“pl-PL” value) and English (“en-US”).

How do we handle the “language” field currently?

If you do not send or set value in this field, we automatically assign the Polish language - “pl-PL”. Changing the value is possible only if offer is in “INACTIVE” status.

What changes will we make?

On May 9, 2023, we will introduce changes regarding the “language” field:

• for POST /sale/offers - we will mark it as “required”. This means that, if you do not set any of the available values in the "language" field, we will return an error that will prevent you from listing the offer!
• changing the value will not be possible at any offer status.

For POST /sale/product-offers the field will remain not required. If you do not send any value in this field, we will set it automatically based on the interface language from the user’s account settings. In this case, you do not need to change anything in your application.

[FromAnyHole]

Czyli nie od jutra (19.04) jak to było podawane...?

[PrzemyslawLukanowski]

19 kwietnia planujemy włączyć wymagalność dla POST /sale/product-proposals, czyli zasobu do tworzenia produktów. Ten news dotyczy stricte POST /sale/offers.

[FromAnyHole]

Ok, to w sumie bez znaczenia, niech wchodzi po kawałku.

[PiotrPioro]

Dostałem maila że się nie dostosowałem do tej zmiany. Dodałem pole "language" i ustawiam tam wartość "pl-PL" tu jest mój request: https://api.allegro.pl/sale/offers requestBody={"afterSalesServices":{"impliedWarranty":{"id":"ef9a4f06-0c6e-4dcc-9414-7390a1348f56"},"returnPolicy":{"id":"f387e0e4-6250-45bf-9bb9-37fddc657159"}},"category":{"id":"76034"},"delivery":{"shippingRates":{"id":"35ff5dd8-c6fa-495b-bfc8-e0f67ab68835"},"handlingTime":"PT24H"},"external":{"id":"stocksell_111949005"},"images":[{"url":"https://a.allegroimg.com/original/11629c/4047750340ce9f5e307cc6f9a2fb"},{"url":"https://a.allegroimg.com/original/11fb20/8eeeb92d469b80339428eb45189a"}],"location":{"city":"Skawina","countryCode":"PL","postCode":"32-050","province":"MALOPOLSKIE"},"parameters":[{"id":"249512","valuesIds":["249512_1647424"]},{"id":"11323","valuesIds":["11323_2"]},{"id":"127708","valuesIds":["127708_10"]},{"id":"216925","valuesIds":["216925_1191143"]},{"id":"18293","valuesIds":["18293_1"]},{"id":"3766","valuesIds":["3766_1"]},{"id":"59","valuesIds":["59_9"]},{"id":"54","valuesIds":["3806_4"]},{"id":"201017","valuesIds":["201017_2377"]},{"id":"15851","valuesIds":["15851_1"]},{"id":"201025","valuesIds":["201025_2521"]},{"id":"201021","valuesIds":["201021_2481"]},{"id":"3786","valuesIds":["3786_1648501"]}],"name":"SHEIN BLUZKA DAMSKA BEŻOWA DŁUGI RĘKAW 38 1VBA","payments":{"invoice":"VAT"},"publication":{"republish":false},"sellingMode":{"format":"BUY_NOW","price":{"amount":67.99,"currency":"PLN"}},"stock":{"available":1,"sold":0,"unit":"UNIT"},"description":{"sections":[{"items":[{"type":"TEXT","content":"\u003ch2\u003eSHEIN BLUZKA DAMSKA BEŻOWA DŁUGI RĘKAW\u003c/h2\u003e"}]},{"items":[{"type":"IMAGE","url":"https://a.allegroimg.com/original/11629c/4047750340ce9f5e307cc6f9a2fb"},{"type":"TEXT","content":"\u003ch2\u003eOpis Produktu\u003c/h2\u003e\u003cul\u003e\u003cli\u003e\u003cb\u003eMarka\u003c/b\u003e Shein\u003c/li\u003e\u003cli\u003e\u003cb\u003eKolor\u003c/b\u003e beżowy\u003c/li\u003e\u003cli\u003e\u003cb\u003eSkład\u003c/b\u003e 97% poliester, 3% spandex\u003c/li\u003e\u003cli\u003e\u003cb\u003eMetka papierowa\u003c/b\u003e Brak\u003c/li\u003e\u003cli\u003e\u003cb\u003eMetka wewnętrzna\u003c/b\u003e \tTak\u003c/li\u003e\u003cli\u003e\u003cb\u003eRozmiar\u003c/b\u003e 38\u003c/li\u003e\u003cli\u003e\u003cb\u003eStan przedmiotu\u003c/b\u003e Zapach użytkowania.\u003c/li\u003e\u003cli\u003e\u003cb\u003eCena katalogowa\u003c/b\u003e 53,99 zł\u003c/li\u003e\u003cli\u003e\u003cb\u003eUwaga\u003c/b\u003e stan idealny\u003c/li\u003e\u003c/ul\u003e"}]},{"items":[{"type":"IMAGE","url":"https://a.allegroimg.com/original/11fb20/8eeeb92d469b80339428eb45189a"}]}]},"tax":{"percentage":"23.00"},"product":{"id":"86668c27-2103-4757-973b-674ad92c03a2"},"language":"pl-PL"} responseBody={"id":"13677237454","name":"SHEIN BLUZKA DAMSKA BEŻOWA DŁUGI RĘKAW 38 1VBA","category":{"id":"76034"},"product":{"id":"86668c27-2103-4757-973b-674ad92c03a2"},"parameters":[{"id":"249512","valuesIds":["249512_1647424"],"values":[],"rangeValue":null},{"id":"11323","valuesIds":["11323_2"],"values":[],"rangeValue":null},{"id":"127708","valuesIds":["127708_10"],"values":[],"rangeValue":null},{"id":"216925","valuesIds":["216925_1191143"],"values":[],"rangeValue":null},{"id":"18293","valuesIds":["18293_1"],"values":[],"rangeValue":null},{"id":"3766","valuesIds":["3766_1"],"values":[],"rangeValue":null},{"id":"59","valuesIds":["59_9"],"values":[],"rangeValue":null},{"id":"54","valuesIds":["3806_4"],"values":[],"rangeValue":null},{"id":"201017","valuesIds":["201017_2377"],"values":[],"rangeValue":null},{"id":"15851","valuesIds":["15851_1"],"values":[],"rangeValue":null},{"id":"201025","valuesIds":["201025_2521"],"values":[],"rangeValue":null},{"id":"201021","valuesIds":["201021_2481"],"values":[],"rangeValue":null},{"id":"3786","valuesIds":["3786_1648501"],"values":[],"rangeValue":null}],"customParameters":null,"description":{"sections":[{"items":[{"type":"TEXT","content":"

SHEIN BLUZKA DAMSKA BEŻOWA DŁUGI RĘKAW

"}]},{"items":[{"type":"IMAGE","url":"https://a.allegroimg.com/original/11629c/4047750340ce9f5e307cc6f9a2fb"},{"type":"TEXT","content":"

Opis Produktu

• Marka Shein
• Kolor beżowy
• Skład 97% poliester, 3% spandex
• Metka papierowa Brak
• Metka wewnętrzna \tTak
• Rozmiar 38
• Stan przedmiotu Zapach użytkowania.
• Cena katalogowa 53,99 zł
• Uwaga stan idealny

"}]},{"items":[{"type":"IMAGE","url":"https://a.allegroimg.com/original/11fb20/8eeeb92d469b80339428eb45189a"}]}]},"compatibilityList":null,"tecdocSpecification":null,"images":[{"url":"https://a.allegroimg.com/original/11629c/4047750340ce9f5e307cc6f9a2fb"},{"url":"https://a.allegroimg.com/original/11fb20/8eeeb92d469b80339428eb45189a"}],"sellingMode":{"format":"BUY_NOW","price":{"amount":"67.99","currency":"PLN"},"startingPrice":null,"minimalPrice":null,"netPrice":null},"tax":{"percentage":"23.00","rate":"23.00","subject":null,"exemption":null,"id":"b763d782-572a-47db-8752-8b2cb32b3d0a"},"stock":{"available":1,"unit":"UNIT"},"publication":{"duration":null,"status":"INACTIVE","startingAt":null,"endingAt":null,"endedBy":null,"republish":false,"marketplaces":{"base":{"id":"allegro-pl"},"additional":[]}},"delivery":{"shippingRates":{"id":"35ff5dd8-c6fa-495b-bfc8-e0f67ab68835"},"handlingTime":"PT24H","additionalInfo":null,"shipmentDate":null},"payments":{"invoice":"VAT"},"discounts":null,"afterSalesServices":{"impliedWarranty":{"id":"ef9a4f06-0c6e-4dcc-9414-7390a1348f56"},"returnPolicy":{"id":"f387e0e4-6250-45bf-9bb9-37fddc657159"},"warranty":null},"additionalServices":null,"sizeTable":null,"fundraisingCampaign":null,"promotion":{"emphasized":false,"bold":false,"highlight":false,"departmentPage":false,"emphasizedHighlightBoldPackage":false},"location":{"countryCode":"PL","province":"MALOPOLSKIE","city":"Skawina","postCode":"32-050"},"external":{"id":"stocksell_111949005"},"attachments":[],"contact":null,"validation":{"errors":[],"warnings":[{"code":"VALIDATION_WARNING","message":"As a merchant, take care of an accurate description of the offered goods. If you have information on the qualitative composition of the materials from which the product is made, include this data in the offer's description. At the same time, include percentage value of each material used in producing the goods.","details":"","path":"name","userMessage":"As a merchant, take care of an accurate description of the offered goods. If you have information on the qualitative composition of the materials from which the product is made, include this data in the offer's description. At the same time, include percentage value of each material used in producing the goods."},{"code":"VALIDATION_WARNING","message":"Did you know you can reach more customers by adding export options to your offers? Don't wait, add export options now, and increase your sales. Make sure the product has the required labeling in the official language of the country to which it will be delivered.","details":"","path":"name","userMessage":"Did you know you can reach more customers by adding export options to your offers? Don't wait, add export options now, and increase your sales. Make sure the product has the required labeling in the official language of the country to which it will be delivered."}],"validatedAt":"2023-05-09T21:52:16.685Z"},"b2b":{"buyableOnlyByBusiness":false},"messageToSellerSettings":null,"createdAt":"2023-05-09T21:52:16.000Z","updatedAt":"2023-05-09T21:52:16.719Z","language":"pl-PL","additionalMarketplaces":{"allegro-cz":{"sellingMode":null,"publication":{"state":"NOT_REQUESTED"}}},"taxSettings":{"rates":[{"rate":"23.00","countryCode":"PL"}],"subject":null,"exemption":null}} trace-id=[46de57018b076121] co trzeba jeszcze zmienić?

[PrzemyslawLukanowski]

@PiotrPioro Request jest prawidłowy, świadczy o tym wartość w language, którą otrzymałeś w response, dodatkowo potwierdziłem to w naszych logach. W wysyłce maila braliśmy pod uwagę cały zeszły tydzień, być może tam pojawiły się oferty, jeszcze bez ustawionego języka.

[PiotrPioro]

Tą zmianę mamy od piątku więc to pewnie dlatego, dziękuję za odpowiedź.