[NEWS] 6 października 2025 włączymy walidację zaufanych elementów produktu / On October 6, 2025, we will enable validation of trusted product components

[24 kwietnia 2025](https://developer.allegro.pl/news/zasoby-sale-products-zwracamy-informacje-o-zaufanych-wartosciach-produktu-1n28YqGRWs8) w danych produktu dodaliśmy pole **"trustedContent.paths"**, gdzie widoczne są elementy produktu, które są zaufane - czyli takie, których wartości pochodzą bezpośrednio od producenta, jego dystrybutora lub z innego wiarygodnego źródła. **Od 6 października wprowadzimy wymóg korzystania z danych produktowych (parametrów, zdjęć, opisów i nazw) z zaufanych źródeł**, a już od dziś umożliwimy pobranie informacji o tych elementach produktu, do których nie można zgłaszać sugestii zmiany.

**Jakich zasobów dotyczy zmiana?**

- [GET /sale/products/{productId}](https://developer.allegro.pl/documentation/#operation/getSaleProduct)
- [GET /sale/products](https://developer.allegro.pl/documentation/#operation/getSaleProducts)
- [POST /sale/product-offers](https://developer.allegro.pl/documentation#operation/createProductOffers)
- [PATCH /sale/product-offers/{offerId}](https://developer.allegro.pl/documentation#operation/editProductOffers)
- [POST /sale/products/{productId}/change-proposals](https://developer.allegro.pl/documentation/#operation/productChangeProposal)

**Co zmienimy?**
1. **6 października 2025** uruchomimy walidację zaufanych elementów produktu - opis, zdjęcia, nazwa i parametry.
2. Na ścieżce **/sale/products** dodaliśmy pole **"trustedContent.productPaths"**, dzięki któremu dowiesz się do jakich elementów produktu nie możesz zgłaszać sugestii:
```
"trustedContent": {
"paths": ["description", "images", "name"] // elementy zaufane w produkcie - dla tych elementów nie możesz przekazać własnych wartości w ofercie
"productPaths": ["description", "images", "name", "category"] // elementy zablokowane do zgłaszania sugestii
}
```

3. Na środowisku [Sandbox](https://allegro.pl.allegrosandbox.pl/) znajdziesz już wszystkie zmiany, które będą obowiązywały od 6 października 2025. Przykładowe produkty do testowania:

- d73b3e23-dcf1-4e70-b320-1fa73f5b3fb1
- 017bbfbd-56f0-47bb-974b-991b15323225
- 7aac5776-3629-4593-bf8e-110a68c8f12a
- 30f797d7-9f87-4f5f-b3a9-1c7b7ad06b0b
- 33571f6a-2c54-4f72-a376-b812ae38e8b7
- 4d857aa1-c207-4517-a71e-c5790e6e5d61

**Warunki uruchomienia walidacji podczas wystawiania i edycji oferty:**

- produkt przypisany do oferty zawiera zaufane dane w **"trustedContent.paths"** lub w przypadku parametrów wartość **"true"** dla flagi **"parameters.options.isTrusted"**,
- w przypadku elementów z **"trustedContent.paths"** tylko dla ofert ze stanem **"Nowy"**,
- oferta jest wystawiona na rynku bazowym **"allegro-pl"**,
- oferta **nie jest zestawem produktowym**,
- podczas edycji [PATCH /sale/product-offers/{offerId}](https://developer.allegro.pl/documentation#operation/editProductOffers) podawane jest więcej elementów niż tylko cena i liczba przedmiotów.

**Na co należy zwrócić uwagę?**

- elementy zaufane zwracamy w **"trustedContent.paths"**, a dla parametrów zwracamy flagę **"isTrusted"** zagnieżdżoną w **"parameters.options"**,
- wszystkie oferty z produktami, które mają dane z zaufanego źródła muszą być w pełni zgodne z danymi produktowymi w naszym Katalogu, dlatego **nie będziesz mógł podać własnych wartości dla elementów zaufanych takich jak opis, zdjęcia, nazwa i parametry**. W innym wypadku otrzymasz błąd "ProductConstraintViolationException.TrustedDataIntegrity",
- zmiana dotyczy sprzedających, którzy **wystawiają nowe i edytują trwające oferty z produktami, które mają zaufane dane**.
- walidacja nie obejmie edycji liczby sztuk i ceny w ofercie - gdy w requeście PATCH /sale/product-offers/{offerId} podasz [tylko dane do zmiany ceny lub stanu magazynowego](https://developer.allegro.pl/tutorials/jak-zarzadzac-ofertami-7GzB2L37ase#edycja-pol-oferty), jak również skorzystasz z [dedykowanych endpointów do edycji grupowej](https://developer.allegro.pl/tutorials/jak-zarzadzac-ofertami-7GzB2L37ase#edycja-wielu-ofert-jednoczesnie).
- sprzedający **nie może zgłosić przez API sugestii** ([POST /sale/products/{productId}/change-proposal](https://developer.allegro.pl/documentation#operation/productChangeProposal)) **do elementów które w produkcie będą zwracane w polu "trustedContent.productPaths"**, tak samo jak to jest w przypadku parametrów i wartości **"true"** dla flagi **"parameters.options.isTrusted"** - zwrócimy wtedy błąd "ParametersCannotBeModifiedException". Zmianę dla tych elementów można zgłosić jedynie przez [formularz kontaktowy](https://allegro.pl/pomoc/kontakt).

**Dlaczego wprowadzamy zmiany?**

Wprowadzamy tę zmianę, aby zapewnić spójność i integralność danych produktowych w Katalogu Produktów zarówno dla sprzedających (uproszczenie wystawiania ofert), jak i kupujących. W ofertach tych samych produktów będą się różnić tylko cena, stan magazynowy, metody dostawy i inne ustawienia ofertowe. Dzięki temu kupujący będą mogli skupić się na kluczowych aspektach oferty, takich jak cena, dostępność i opcje dostawy, co przełoży się na łatwiejszy wybór.

Poza tym chcemy by dane produktów na Allegro były spójne. Chcemy, aby informacje pochodzące z zaufanych źródeł były takie same w Katalogu Produktów i w ofertach. Dzięki temu zmniejszy się ryzyko błędów. Proces wystawiania ofert będzie szybszy dla sprzedających. Kupujący będą mieli większe zaufanie do informacji o produktach.

----

[On April 24, 2025](https://developer.allegro.pl/news/zasoby-sale-products-zwracamy-informacje-o-zaufanych-wartosciach-produktu-1n28YqGRWs8), we added the **"trustedContent.paths"** field to product data, where you can see product elements that are trusted - that is, those whose values come directly from the manufacturer, its distributor, or another reliable source. **From October 6, 2025, we will require the use of product data (parameters, photos, descriptions, and names) from trusted sources**, and from now we enable the download of information about those product elements for which no change suggestions can be submitted.

**What resources are affected by this change?**

- [GET /sale/products/{productId}](https://developer.allegro.pl/documentation/#operation/getSaleProduct)
- [GET /sale/products](https://developer.allegro.pl/documentation/#operation/getSaleProducts)
- [POST /sale/product-offers](https://developer.allegro.pl/documentation#operation/createProductOffers)
- [PATCH /sale/product-offers/{offerId}](https://developer.allegro.pl/documentation#operation/editProductOffers)
- [POST /sale/products/{productId}/change-proposals](https://developer.allegro.pl/documentation/#operation/productChangeProposal)

**What will we change?**
1. **October 6, 2025** we will launch the validation of trusted product elements - description, photos, name, and parameters.
2. We have added the **“trustedContent.productPaths”** field to the **/sale/products** path, which tells you which product elements you cannot submit suggestions for:

```
"trustedContent": {
"paths": ["description", "images", "name"] // trusted elements in the product - you cannot provide your own values for these elements in the offer
"productPaths": ["description", "images", "name", "category"] // elements blocked for submitting suggestions
}
```

3. All changes that will take effect on October 6, 2025, are already available in the [Sandbox](https://allegro.pl.allegrosandbox.pl/) environment. Sample products for testing:

- d73b3e23-dcf1-4e70-b320-1fa73f5b3fb1
- 017bbfbd-56f0-47bb-974b-991b15323225
- 7aac5776-3629-4593-bf8e-110a68c8f12a
- 30f797d7-9f87-4f5f-b3a9-1c7b7ad06b0b
- 33571f6a-2c54-4f72-a376-b812ae38e8b7
- 4d857aa1-c207-4517-a71e-c5790e6e5d61

**Conditions for activating validation when issuing and editing an offer:**

- the product assigned to the offer contains trusted data in **"trustedContent.paths"** or, in the case of parameters, the value **"true"** for the **"parameters.options.isTrusted"** flag,
- in the case of items from **"trustedContent.paths"** only for offers with the status **"New"**,
- the offer is listed on the **"allegro-pl"** base marketplace,
- the offer **is not a product set**,
- when editing [PATCH /sale/product-offers/{offerId}](https://developer.allegro.pl/documentation#operation/editProductOffers), more elements than just the price and stock are provided.

**What should you pay attention to?**

- trusted elements are returned in **"trustedContent.paths"**, and for parameters, we return the **"isTrusted"** flag nested in **"parameters.options"**.
- all offers with products that have data from a trusted source must be fully consistent with the product data in our Catalog, so **you will not be able to specify your own values for trusted elements such as description, photos, name, and parameters**. Otherwise, you will receive a “ProductConstraintViolationException.TrustedDataIntegrity" error.
- that change applies to sellers who **list new offers and edit existing offers with products that have trusted data**.
- validation will not cover editing the number of items and price in the offer - when you specify [only the data to change the price or stock](https://developer.allegro.pl/tutorials/jak-zarzadzac-ofertami-7GzB2L37ase#edycja-pol-oferty) in the PATCH /sale/product-offers/{offerId} request, as well as when you [use dedicated endpoints for group editing](https://developer.allegro.pl/tutorials/jak-zarzadzac-ofertami-7GzB2L37ase#edycja-wielu-ofert-jednoczesnie).
- the seller **cannot submit suggestions via API** ([POST /sale/products/{productId}/change-proposal](https://developer.allegro.pl/documentation#operation/productChangeProposal)) **for elements that will be returned in the "trustedContent.productPaths" field in the product**, as is the case with parameters and values of **"true"** for the **"parameters.options.isTrusted"** flag. - we will then return a "ParametersCannotBeModifiedException" error. Changes to these elements can only be submitted via [the contact form](https://allegro.pl/pomoc/kontakt).

**Why are we making these changes?**

We are making this change to ensure the consistency and integrity of product data in the Product Catalog for both sellers (simplifying listing) and buyers. Offers for the same products will only differ in price, stock availability, delivery methods, and other offer settings. This will allow buyers to focus on key aspects of the offer, such as price, availability, and delivery options, which will make it easier for them to choose.

In addition, we want product data on Allegro to be consistent. We want information from trusted sources to be the same in the Product Catalog and in offers. This will reduce the risk of errors. The process of listing offers will be faster for sellers. Buyers will have greater confidence in product information.