allegro / allegro/allegro-api

[NEWS] GPSR - udostępniliśmy grupową edycję osoby odpowiedzialnej za zgodność produktu z przepisami unijnymi oraz informacji o bezpieczeństwie produktu / GPSR - we have enabled the possibility to modify the responsible person for the compliance of the product with EU regulations and product safety information in multiple offers

オープン
#10,457 コメント 2 件 リアクション 0 件 担当者 1 名 @MaciejFrackowiak が担当を希望しています GitHub で見る
News Offer - management
主要言語
言語のデータがありません
スター
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?**

Osobę odpowiedzialną oraz informację o bezpieczeństwie produktu można było przypisać do ofert korzystając z [POST /sale/product-offers](https://developer.allegro.pl/documentation/#operation/createProductOffers) podczas tworzenia oferty oraz [PATCH /sale/product-offers/{offerId}](https://developer.allegro.pl/documentation/#operation/editProductOffers) przy jej edycji.

**Co zmieniliśmy?**

Udostępniliśmy dzisiaj możliwość grupowej zmiany z wykorzystaniem [PUT /sale/offer-modification-commands/{commandId}](https://developer.allegro.pl/documentation/#operation/modificationCommandUsingPUT):

* osoby odpowiedzialnej za zgodność produktu z przepisami unijnymi

**Przykładowy request:**

```json5
curl -X PUT \
'https://api.allegro.pl/sale/offer-modification-commands/{commandId}' \
-H 'Authorization: Bearer {token}' \
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Content-Type: application/vnd.allegro.public.v1+json' \
-d '{
"modification": {
"responsiblePerson": {
"id": "817ab828-255e-4ca8-a4da-c6defa3e6918" // identyfikator osoby odpowiedzialnej pobrany z GET /sale/responsible-persons
}
},
"offerCriteria": [
{
"offers": [ // lista ofert, w których chcesz dokonać zmian
{
"id": "11223344556"
},
{
"id": "11335577991"
}
],
"type": "CONTAINS_OFFERS"
}
]
}'
```
>
* informacji o bezpieczeństwie produktu

**Przykładowy request:**

```json5
curl -X PUT \
'https://api.allegro.pl/sale/offer-modification-commands/{commandId}' \
-H 'Authorization: Bearer {token}' \
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Content-Type: application/vnd.allegro.public.v1+json' \
-d '{
"modification": {
"safetyInformation": {
"type": "TEXT", // dostępne wartości: TEXT, ATTACHMENTS, NO_SAFETY_INFORMATION
"description": "To jest informacja o bezpieczeństwie produktu.\n Jedná se o bezpečnostní informace o výrobku."
}
},
"offerCriteria": [
{
"offers": [ // lista ofert, w których chcesz dokonać zmian
{
"id": "11223344556"
},
{
"id": "11335577991"
}
],
"type": "CONTAINS_OFFERS"
}
]
}'
```
>
**Uwaga!** Grupowo osobę odpowiedzialną oraz informacje o bezpieczeństwie produktu zmienisz **tylko** dla **pierwszego** produktu w zestawie (productSet).

**Dlaczego wprowadziliśmy zmianę?**

Zależy nam, aby sprzedający mogli w możliwie najwygodniejszy dla siebie sposób uzupełnić oferty osobami odpowiedzialnymi za zgodność produktu z przepisami unijnymi oraz informacjami o bezpieczeństwie produktu, 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?**

The responsible person and product safety information could be assigned to offers using [POST /sale/product-offers](https://developer.allegro.pl/documentation/#operation/createProductOffers) when creating an offer and [PATCH /sale/product-offers/{offerId}](https://developer.allegro.pl/documentation/#operation/editProductOffers) when editing it.

**What have we changed?**

Today we have introduced the ability to batch change using [PUT /sale/offer-modification-commands/{commandId}](https://developer.allegro.pl/documentation/#operation/modificationCommandUsingPUT):

* responsible person for the compliance of the product with EU regulations

**Sample request:**

```json5
curl -X PUT \
'https://api.allegro.pl/sale/offer-modification-commands/{commandId}' \
-H 'Authorization: Bearer {token}' \
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Content-Type: application/vnd.allegro.public.v1+json' \
-d '{
"modification": {
"responsiblePerson": {
"id": "817ab828-255e-4ca8-a4da-c6defa3e6918" // responsible person identifier retrieved from GET /sale/responsible-persons
}
},
"offerCriteria": [
{
"offers": [ // list of offers you want to edit
{
"id": "11223344556"
},
{
"id": "11335577991"
}
],
"type": "CONTAINS_OFFERS"
}
]
}'
```
>
* product safety information

**Sample request:**

```json5
curl -X PUT \
'https://api.allegro.pl/sale/offer-modification-commands/{commandId}' \
-H 'Authorization: Bearer {token}' \
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Content-Type: application/vnd.allegro.public.v1+json' \
-d '{
"modification": {
"safetyInformation": {
"type": "TEXT", // available values: TEXT, ATTACHMENTS, NO_SAFETY_INFORMATION
"description": "This is a product safety information.\n Jedná se o bezpečnostní informace o výrobku."
}
},
"offerCriteria": [
{
"offers": [ // list of offers you want to edit
{
"id": "11223344556"
},
{
"id": "11335577991"
}
],
"type": "CONTAINS_OFFERS"
}
]
}'
```
>

**Note!** You will batch change the responsible person and product safety information **only** for the **first** product in the set (productSet).

**Why have we made the change?**

We want sellers to be able to complete their offers as conveniently as possible with the responsible persons for the compliance of the product with EU regulations and product safety information, which will be required under the GPSR regulation as of **December 13, 2024**.

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

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

評価

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

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

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