allegro / allegro-api

Issue tracker and wiki for Allegro REST API
https://developer.allegro.pl/
217 stars 39 forks source link

[NEWS] GPSR - udostępniliśmy grupową edycję danych teleadresowych producentów produktów w ofertach / GPSR - we have enabled the possibility to modify the contact information of product producers in multiple offers #10328

Open MaciejFrackowiak opened 3 days ago

MaciejFrackowiak commented 3 days ago

13 grudnia 2024 zacznie obowiązywać nowe rozporządzenie Unii Europejskiej General Product Safety Regulation. Celem GPSR jest pokazanie kupującemu, skąd pochodzi produkt, który może kupić na Allegro.

Jak było dotychczas?

Dane teleadresowe producentów produktów mogłeś przypisać do ofert korzystając z POST /sale/product-offers podczas tworzenia oferty oraz PATCH /sale/product-offers/{offerId} przy jej edycji.

Co zmieniliśmy?

Udostępniliśmy dzisiaj możliwość grupowej zmiany danych teleadresowych producentów produktów w ofertach z wykorzystaniem PUT /sale/offer-modification-commands/{commandId}.

Przykładowy request:

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": {
            "responsibleProducer": {
               "id": "59a8b818-0a38-4540-92f4-3645923cb9c6" // identyfikator danych teleadresowych pobrany z
            }                                                   // GET /sale/responsible-producers lub GET /sale/responsible-producers/{id}
    },
    "offerCriteria": [      
            {
               "offers": [                              // lista ofert, w których chcesz dokonać zmian
                     {
                        "id": "11223344556"
                     },
                     {
                        "id": "11335577991"
                     }
               ],
               "type": "CONTAINS_OFFERS"
            }
    ]
}'

Uwaga! Grupowo dane teleadresowe producentów produktów 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 danymi teleadresowymi producentów 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 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?

You could assign the contact information of product producers to offers using POST /sale/product-offers when creating an offer and PATCH /sale/product-offers/{offerId} when editing it.

What have we changed?

Today we have introduced the ability to batch change the contact information of product producers in offers using PUT /sale/offer-modification-commands/{commandId}.

Sample request:

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": {
            "responsibleProducer": {
               "id": "59a8b818-0a38-4540-92f4-3645923cb9c6" // responsible producer data identifier retrieved from 
            }                                                   // GET /sale/responsible-producers or GET /sale/responsible-producers/{id}
    },
    "offerCriteria": [      
            {
               "offers": [                              // list of offers you want to edit
                     {
                        "id": "11223344556"
                     },
                     {
                        "id": "11335577991"
                     }
               ],
               "type": "CONTAINS_OFFERS"
            }
    ]
}'

Note! You will batch change the contact information of product producers 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 contact information of product producers, which will be required under the GPSR regulation as of December 13, 2024.