allegro / allegro/allegro-api

[NEWS] GPSR - GET /sale/products - dodaliśmy dane o bezpieczeństwie produktu / GPSR - GET /sale/products - we have added product safety data

オープン
#10,483 コメント 9 件 リアクション 0 件 担当者 1 名 @MaciejFrackowiak が担当を希望しています GitHub で見る
News Offer - Products
主要言語
言語のデータがありません
スター
244
フォーク
40
PR マージ指標
30日以内にマージされた PR はありません

説明

**13 grudnia 2024** zacznie obowiązywać nowe rozporządzenie Unii Europejskiej **[General Product Safety Regulation](https://commission.europa.eu/business-economy-euro/doing-business-eu/eu-product-safety-and-labelling/product-safety/general-product-safety-regulation_en)**. Celem GPSR jest pokazanie kupującemu, skąd pochodzi produkt, który może kupić na Allegro.

**Jak było dotychczas?**

Jeżeli wybrany produkt z Katalogu Produktów Allegro posiada zdefiniowane dane o bezpieczeństwie produktu (“**productSafety**”), które zawierają dane teleadresowe producenta (“**responsibleProducers**”) oraz informacje o bezpieczeństwie produktu (“**safetyInformation**”), zwracaliśmy je wyłącznie w odpowiedzi do [GET /sale/products/{productId}](https://developer.allegro.pl/documentation/#operation/getSaleProduct).

**Co zmieniliśmy?**

Dzisiaj, dla [GET /sale/products](https://developer.allegro.pl/documentation/#operation/getSaleProducts), udostępniliśmy również pole “**productSafety**”, dzięki któremu już w wynikach wyszukiwania produktów zwracamy dane teleadresowe producenta (“**responsibleProducers**”) oraz informacje o bezpieczeństwie produktu (“**safetyInformation**”), jeżeli wybrany produkt z Katalogu Produktów Allegro je posiada.

**Przykładowy response:**

```json5
{
"products": [
{
"id": "f5c67f19-851e-4bb3-bbfb-2d873ac3e2e8",
"name": "ŻARÓWKA 8GH 002 089-361 HELLA",
...
"productSafety": {
"responsibleProducers": [
{
"id": "e1000ecb-a77d-45f6-97ca-b03c484de58e",
"name": "moto - Hella",
"producerData": {
"tradeName": "Hella",
"address": {
"street": "Rixbecker Str.75",
"postalCode": "59552",
"city": "Lippstadt",
"countryCode": "DE"
},
"contact": {
"email": "info@hella.com",
"phoneNumber": null
}
}
}
],
"safetyInformation": {
"type": "ATTACHMENTS",
"attachments": [
{
"id": "34b2f604-c585-4597-8c35-2446073c845c"
}
]
}
}
}
],
...
"filters": [],
"nextPage": null
}
```
>

Tym samym, przekazując identyfikator produktu (“**product.id**”) podczas tworzenia oferty ([POST /sale/product-offers](https://developer.allegro.pl/documentation/#operation/createProductOffers)), uwzględnimy dane o bezpieczeństwie produktu w samej ofercie.

**Dlaczego wprowadziliśmy zmianę?**

Zależy nam, aby sprzedający mogli w możliwie najwygodniejszy dla siebie sposób uzupełnić oferty danymi teleadresowymi producentów oraz informacjami o bezpieczeństwie produktów, które z dniem **13 grudnia 2024** będą wymagane zgodnie z rozporządzeniem GPSR.

-----

On **December 13, 2024**, the new European Union Regulation **[General Product Safety Regulation](https://commission.europa.eu/business-economy-euro/doing-business-eu/eu-product-safety-and-labelling/product-safety/general-product-safety-regulation_en)** will come into effect. The goal of the GPSR is to show the buyer where the product available on Allegro originates.

**How was it so far?**

If the selected product from the Allegro Product Catalog has the defined product safety data (“**productSafety**”) which contains the contact information of the product producer (“**responsibleProducers**”) and product safety information (“**safetyInformation**”), we returned it only in the response to [GET /sale/products/{productId}](https://developer.allegro.pl/documentation/#operation/getSaleProduct).

**What have we changed?**

Today, for [GET /sale/products](https://developer.allegro.pl/documentation/#operation/getSaleProducts), we have also provided the “**productSafety**” field, which already returns the contact information of the product producer (“**responsibleProducers**”) and product safety information (“**safetyInformation**”) in the product search results, if the selected product from the Allegro Product Catalog has it.

**Sample response:**

```json5
{
"products": [
{
"id": "f5c67f19-851e-4bb3-bbfb-2d873ac3e2e8",
"name": "ŻARÓWKA 8GH 002 089-361 HELLA",
...
"productSafety": {
"responsibleProducers": [
{
"id": "e1000ecb-a77d-45f6-97ca-b03c484de58e",
"name": "moto - Hella",
"producerData": {
"tradeName": "Hella",
"address": {
"street": "Rixbecker Str.75",
"postalCode": "59552",
"city": "Lippstadt",
"countryCode": "DE"
},
"contact": {
"email": "info@hella.com",
"phoneNumber": null
}
}
}
],
"safetyInformation": {
"type": "ATTACHMENTS",
"attachments": [
{
"id": "34b2f604-c585-4597-8c35-2446073c845c"
}
]
}
}
}
],
...
"filters": [],
"nextPage": null
}
```
>

Thus, by passing the product identifier (“**product.id**”) when creating an offer ([POST /sale/product-offers](https://developer.allegro.pl/documentation/#operation/createProductOffers)), we will include the product safety data in the offer itself.

**Why have we made the change?**

We want sellers to be able to complete their offers as conveniently as possible with the contact information of product producers and product safety information, which will be required under the GPSR regulation as of **December 13, 2024**.

コントリビューションガイド

このリポジトリのコントリビューションガイドは索引されていません

評価

この issue はまだ評価されていません。

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。