Rozporządzenie GPSR - konfiguracja niezbędnych elementów

Rozporządzenie GPSR ma na celu zapewnienie ochrony konsumentów oraz bezpieczeństwo w odniesieniu do określonych produktów. Od 13 grudnia 2024 r. nakłada na sprzedawców nowe obowiązki w zakresie zgodności z przepisami. Poniżej znajdziesz komplet informacji, jak szybko dostosować ofertę do nowych wymagań.

W panelu dodaliśmy możliwość ustawienia danych Producenta odpowiedzialnego lub jeżeli producent jest spoza UE, dodanie danych Osoby odpowiedzialnej.

Producenta odpowiedzialnego dodasz w sekcji TOWARY > Baza atrybutów > Producenci odpowiedzialni

Dodając nowego producenta odpowiedzialnego uzupełnij jego dane kontaktowe.

Jeśli producent jest spoza UE, wymagane jest podanie danych osoby odpowiedzialnej.

Osoby odpowiedzialne dodasz w sekcji TOWARY > Baza atrybutów> Osoby odpowiedzialne.

Podobnie jak w przypadku producenta odpowiedzialnego, należy uzupełnić dane kontaktowe osoby odpowiedzialnej.

API Admin 3 od wersji 4.0 umożliwia dodawanie podmiotów odpowiedzialnych do sekcji Towary > Baza atrybutów > Producenci odpowiedzialni/Osoby odpowiedzialne, przez bramkę responsibilities/entities.

Struktura żądania API, która doda podmioty odpowiedzialne, wygląda następująco:

{
  "params": {
    "type": "producer", // producer - Producent odpowiedzialny, person - Osoba odpowiedzialna
    "entities": [
      {
        "code": "Kod_producenta_odpowiedzialnego", // unikalny kod podmiotu odpowied
        "name": "Nazwa producenta odpowiedzialnego",
        "mail": "email@producenta.odpowiedzialnego.pl",
        "street": "Ulica",
        "number": "23",
        "subnumber": "1",
        "zipcode": "71-064",
        "city": "Szczecin",
        "country": "PL"
      }
    ]
  }
}

W tablicy entities sprawdzana jest unikalność parametru code, na podstawie której odbywa się aktualizowanie, pobieranie i usuwanie informacji o podmiotach przez tę bramkę API.

Producenta odpowiedzialnego i osobę odpowiedzialną możesz uzupełnić w towarach na kilka sposobów.

Karta towaru

Na karcie towaru w zakładce Podstawowe, pojawiły się dwa nowe elementy do uzupełnienia. Możesz ręcznie dla każdego towaru ustawić podmiot odpowiedzialny.

Grupowa Edycja Towarów (GET)

Przypisanie podmiotów odpowiedzialny na wielu towarach wykonasz również za pomocą GET. Po zaznaczeniu produktów z poziomu listy i wyborze opcji Edycja Grupowa, istnieje możliwość przypisania wcześniej zdefiniowanych podmiotów dopowiedzialnych.

Import webowy - plik CSV lub XML

Aktualizacja danych

Podczas aktualizacji danych stosujemy podejście, które gwarantuje precyzyjne dopasowanie informacji do towarów. Proces przebiega w następujących krokach:

1. Identyfikacja po identyfikatorze:

   • Jeśli w pliku CSV/XML został podany identyfikator producenta czyosoby odpowiedzialnej, sprawdzamy, czy istnieje w bazie danych.

   • W przypadku pozytywnego wyniku przypisujemy do towaru.

2. Weryfikacja po unikalnym kodzie:

   • Jeśli identyfikator nie istnieje, sprawdzamy unikalną nazwę rekordu danych (kulumna z "code" w nazwie).

   • Gdy znajdziemy odpowiedni rekord, przypisujemy do towaru.

3. Porównanie danych rekordu danych:

   • Jeśli rekord danych nie zostanie znaleziona, generujemy jej podpis MD5 na podstawie wszystkich danych.

   • Jeśli znajdziemy zgodny wpis w bazie, przypisujemy rekord do towaru.

4. Dodanie nowej rekordu danych:

   • Gdy żadne z powyższych kryteriów nie zostaną spełnione, dodajemy nową wpis do bazy i przypisujemy do towaru.

   • W przypadku błędu walidacji rekord danych nie zostanie przypisana.

Usuwanie działa zgodnie z logiką:

Usunięcie przypisania do towaru producenta czy osoby odpowiedzialnej jest możliwe poprzez wskazanie w węzłach lub odpowiednich nagłówkach zawierających ID wartości „0” (zero).

Nagłówki dotyczące producenta

• /responsible_entity/producer/@id: Identyfikator liczbowy wpisu

• /responsible_entity/producer/code: Nazwa rekordu producenta odpowiedzialnego

• /responsible_entity/producer/name: Pełna nazwa producenta odpowiedzialnego

• /responsible_entity/producer/street: Ulica

• /responsible_entity/producer/number: Numer budynku

• /responsible_entity/producer/subnumber: Numer lokalu

• /responsible_entity/producer/zipcode: Kod pocztowy

• /responsible_entity/producer/city: Miasto

• /responsible_entity/producer/country: Kraj

• /responsible_entity/producer/mail: E-mail

• /responsible_entity/producer/phone: Telefon (opcjonalny)

• /responsible_entity/producer/description: Dodatkowy opis (opcjonalny)

Nagłówki dotyczące osoby odpowiedzialnej

• /responsible_entity/persons/@id: Identyfikator liczbowy wpisu w panelu

• /responsible_entity/persons/code: Nazwa rekordu osoby odpowiedzialnej

• /responsible_entity/persons/name: Pełna nazwa osoby odpowiedzialnej

• /responsible_entity/persons/street: Ulica

• /responsible_entity/persons/number: Numer budynku

• /responsible_entity/persons/subnumber: Numer lokalu

• /responsible_entity/persons/zipcode: Kod pocztowy

• /responsible_entity/persons/city: Miasto

• /responsible_entity/persons/country: Kraj

• /responsible_entity/persons/mail: E-mail

• /responsible_entity/persons/phone: Telefon (opcjonalny)

• /responsible_entity/persons/description: Dodatkowy opis (opcjonalny)

API

API Admin 3 od wersji 4.0 umożliwia również przypisywanie podmiotów odpowiedzialnych do karty towaru, jest to możliwe zarówno podczas tworzenia nowej karty towaru przez bramkę products/products i metodę POST, oraz jej aktualizacji metodą PUT.

Struktura żądania w JSON, która zaktualizuje istniejącą kartę towaru i doda podmioty odpowiedzialne, wygląda następująco:

{
  "params": {
    "products": [
      {
        "productIndex": "Identyfikator towaru",
        "responsibleProducerCode": "KOD_PRODUCENTA_ODPOWIEDZIALNEGO",
        "responsiblePersonCode": "KOD_OSOBY_ODPOWIEDZIALNEJ"
      }
    ]
  }
}

Szablony standardowe wyświetlają w sekcji parametrów informacje o Podmiocie odpowiedzialnym. Jeżeli jest to jedynie producent, to po rozwinięciu będą widoczne jego dane. Jeżeli będzie także osoba odpowiedzialna, to jej dane będą także widoczne. Pozostałe elementy związane z bezpieczeństwem realizowane są w oparciu o parametry.

Aktualizacja szablonu standardowego

W celu aktualizacji szablonu Standard przejdź do sekcji MODERACJA > Wygląd sklepu > Zarządzanie szablonami stron. Następnie kliknij w szablonie opcję aktualizacji do najnowszej wersji.

Aktualizacja komponentu w Composer

Jeśli masz szablon indywidualny, do wyświetlenia informacji o podmiotach odpowiedzialnych, musisz posiadać najnowszą wersję komponentu który wyświetla parametry na karcie towaru.

W celu aktualizacji komponentu w Composer, przejdź do sekcji MODERACJA > Wygląd sklepu > Composer - budowanie własnych szablonów stron.

1. Przejdź do edycji odpowiedniego szablonu.

2. Aktualizuj komponent odpowiedzialny za wyświetlanie parametrów na karcie towaru i zakończ edycję na dole strony.

3. Odczekaj chwilę na wygenerownie nowej wersji i opublikuj szablon w sklepie.

Dodaliśmy nowe konteksty specjalne do parametrów produktów, które pozwolą wysłać informację np. o zagrożeniach czy oznaczyć materiały niebezpieczne.

• piktogram informacyjny

• Rodzaj ostrzeżenia

• piktogram ostrzegawczy

• rodzaj zagrożenia

• słowo sygnalizacyjne

Konteksty specjalne parametrów możesz ustawić przez GET lub za pomocą narzędzia do webowej aktualizacji towarów.

Dodaliśmy możliwość określenia typu załącznika. Wprowadziliśmy takie oznaczenia jak:

1. Etykieta energetyczna - dodaliśmy pole opisowe, które będzie też wysyłane do eBay jako wymagany atrybut opis załącznika

2. Instrukcja z informacją o bezpieczeństwie 

3. Instrukcja obsługi 

4. Instrukcja montażu 

5. Karta produktu 

6. Poradnik 

7. Inne

Załącznik może mieć przypisanych wiele typów z powyższej listy.

Załączniki w towarach możesz dodać na kilka sposobów:

Załącznik dodasz z poziomu zakładki Zdjęcia i ikony na karcie produktu.

Wymagania dotyczące pliku CSV

• Separator: Przecinek (,).

• Kodowanie: UTF-8.

• Nagłówki kolumn: Muszą być zgodne z powyższym przykładem.

• Adres URL: Plik wskazany w kolumnie /attachments/document/doc@url musi być dostępny publicznie.

Struktura pliku CSV

Plik CSV powinien zawierajać następujące nagłówki:

• @id: Identyfikator towaru

• /attachments/document/doc@url: Adres URL załącznika (np. instrukcji obsługi).

• /attachments/document/doc@lang: Kod języka dla nazwy załącznika (dopuszczalne wartości: pol, eng, ger itd.).

• /attachments/document/doc@name: Nazwa załącznika.

• /attachments/document/file/iaiext:document_types/document_type@type: Typ załącznika (np. user_manual, guide).

• /attachments/document/doc@attachment_file_extension: Rozszerzenie pliku załącznika (np. pdf).

• @type: Typ towaru (np. regular, configurable).

Przykład pliku CSV

@id,@type,/attachments/document/doc@url,/attachments/document/doc@lang,/attachments/document/doc@name,/attachments/document/doc@attachment_file_extension,/attachments/document/doc/iaiext:document_types/document_type@type
1234,regular,https://testowadomena.pl/data/include/cms//intrukcja.pdf,pol,Testowy załącznik,pdf,user_manual

Dodanie pliku CSV

1. Przejdź do modułu webowego:

   • Lokalizacja w panelu:
     Towary → Import, aktualizacja i przywracanie towarów z kopii → Zaktualizować istniejące towary.

2. Dodaj plik CSV:

   • Kliknij przycisk Dodaj źródło danych.

   • Wybierz przygotowany plik CSV

3. Ustawienia importu:

   • Upewnij się, że wszystkie kolumny z powyższego schematu są dodane w pliku CSV.

   • Dla opcji Synchronizuj ofertę po wybranym identyfikatorze wybierz wartość identyfikator towaru w panelu IdoSell.

Aktualizacja rozpocznie się automatycznie w ciągu około 15 minut.

Endpoint:

https://idosell.readme.io/reference/productsparametersput-1

Przykładowy Request:

{
  "params": {
    "products": [
      {
        "productIndex": "BLOZ7-8721801",
        "attachments": [
          {
            "attachmentUrl": "https://i.ytimg.com/vi/V6kfsfb-nes/default.jpg",
            "attachmentName": {
              "attachmentLanguages": [
                {
                  "langId": "pol",
                  "langValue": "Zalacznik 3"
                }
              ]
            },
            "attachmentFileType": "image",
            "attachmentEnable": "all",
            "attachmentDownloadLog": "n",
            "documentTypes": [
              {
                "documentType": "user_manual"
              }
            ]
          }
        ],
        "attachmentOperationValues": "add"
      }
    ]
  }
}

Wyjaśnienie parametrów:

• productIndex: W tym parametrze można przesłać: Identyfikator towaru w panelu IdoSell, kod zewnętrznego systemu, kod producenta lub kod IAI.

• attachmentUrl: Adres URL załącznika (np. obraz, instrukcja).

• attachmentName: Nazwa załącznika w różnych językach (langId to identyfikator języka, np. "pol" dla polskiego).

• attachmentFileType: Typ pliku (dozwolone wartości: "audio", "video", "doc", "other", "image").

• attachmentEnable: Określa, dla kogo załącznik jest dostępny (dozwolone wartości: "all", "ordered", "wholesaler", "wholesaler_or_orderer", "wholesaler_and_ordered").

• documentTypes: Tablica zawierająca znacznik dokumentu.

  • documentType: Typ dokumentu (z listy enum, patrz niżej).

• attachmentOperationValues: Określa operację na załączniku (np. "add" do dodania).

DocumentType:

Dozwolone wartości pola documentType:

• "energy_label" - Etykieta energetyczna.

• "instruction_with_safety_information" - Instrukcja z informacjami o bezpieczeństwie.

• "user_manual" - Instrukcja obsługi.

• "installation_instructions" - Instrukcja instalacji.

• "product_card" - Karta produktu.

• "guide" - Przewodnik.

• "others" - Inny dokument.

Ważne Uwagi:

1. Identyfikator produktu (productIndex) musi być poprawny i istnieć w systemie.

2. Typ dokumentu (documentType) musi być jedną z dozwolonych wartości enum.

3. Jeśli wystąpi błąd, sprawdź komunikat o błędzie i popraw dane zgodnie z dokumentacją API.

Podmiot odpowiedzialny

Jeśli na karcie towaru w momencie wystawiania oferty będzie ustawiony Producent odpowiedzialny, to zostanie on wysłany do Allegro.
Będzie to niezależne z ustawieniem wartości w parametrze Allegro "Produkt wprowadzony do obrotu na terenie UE przed 13.12.2024"

Informacja o podmiotach odpowiedzialnych będzie wysyłana, zawsze jeśli jest ustawiona w towarze.

Jeśli chcesz przesłać informację o podmiocie odpowiedzialnym na trwającą ofertę, możesz to zrobić z poziomu karty towaru lub Grupowej Edycji Ofert:

• Karta towaru

  Przejdź do sekcji SERWISY SPRZEDAŻOWE, następnie wyświetl listę trwających ofert.

  Przy odpowiedniej ofercie kliknij aktualizuj i wybierz opcję aktualizacji danych związanych z podmiotem odpowiedzialnym.

• aktualizacja przez Grupową Edycję Ofert (GEO)

  Przejdź do sekcji MARKETING I INTEGRACJE > Marketplaces > Allegro > Ustawienia Marketplace > Wyszukiwarka i grupowa edycja ofert

  
  

Informacje dotyczące bezpieczeństwa produktu

Informacje dotyczące bezpieczeństwa będą wysyłane, jeśli w towarze będzie dodany odpowiedni parametr z kontekstem specjalnym. Szczegółowe informacje znajdziesz w akapicie powyżej.

Aktualizacja informacji o bezpieczeństwie produktu na trwających ofertach, wykonywana jest podobnie jak przesłanie informacji o podmiotach odpowiedzialnych. Możesz to zrobić z poziomu karty towaru i GEO.

• Karta towaru

  Przejdź do sekcji SERWISY SPRZEDAŻOWE, następnie wyświetl listę trwających ofert.

  Przy odpowiedniej ofercie kliknij aktualizuj i wybierz opcję aktualizacji danych związanych z bezpieczeństwem.

• aktualizacja przez Grupową Edycję Ofert (GEO)

  Przejdź do sekcji MARKETING I INTEGRACJE > Marketplaces > Allegro > Ustawienia Marketplace > Wyszukiwarka i grupowa edycja ofert

Załączniki do ofert

Podczas wystawiania oferty możesz przesłać załącznik typu Instrukcja z informacją o bezpieczeństwie do Allegro.

Pozostałych typów załączników nie wysyłamy do Allegro.

• Jeżeli w towarze nie ma załącznika typu Instrukcja z informacją o bezpieczeństwie, to nasz system sprawdza czy towar posiada parametry z kontekstem specjalnym, o których znajdziesz informacje w akapicie powyżej.

• Jeżeli w towarze nie ma załącznika odpowiedniego typu oraz parametrów z odpowiednim kontekstem specjalnym, podczas wystawiania oferty przesyłamy do Allegro ustawienie Produkt nie zawiera informacji o bezpieczeństwie.

Informacje dotyczące aktualizacji tych danych również znajdziesz w akapicie powyżej.

Podczas wystawiania ofert może pojawić się komunikat błędu dotyczący braku załączników jak na zrzucie poniżej. Nie blokuje on wystawienia ofert, więc możesz go zignorować.

Podmiot odpowiedzialny

Tak jak w przypadku Allegro, informacje o podmiocie odpowiedzialnym o eBay przesyłamy zgodnie z ustawieniami towaru. Jeśli na karcie towaru w momencie wystawiania oferty będzie ustawiony Producent odpowiedzialny, to zostanie on wysłany do eBay.

Informacja o podmiotach odpowiedzialnych będzie wysyłana, zawsze jeśli jest ustawiona w towarze.

Jedyną różnicą między eBay, a Allegro jest aktualizacja danych podmiotu. Jeżeli zaktualizowałeś dane podmiotu w panelu, należy ręcznie zaktualizować wszystkie oferty eBay z tym podmiotem.

Sposób aktualizacji podmiotów odpowiedzialnych na eBay odbywa się w taki sam sposób jak dla Allegro, co jest opisane w akapicie powyżej .

Informacje dotyczące bezpieczeństwa produktu

Informacje o zagrożeniach

Informacje te są przekazywane na podstawie uzupełnionych parametrów z kontekstem specjalnym “Zagrożenia - X”. Lista dostępnych parametrów:

• Zagrożenie - rodzaj zagrożenia

• Zagrożenie - słowo sygnalizacyjne (do eBay przesyłamy tylko Niebezpieczeństwo, w innym przypadku zawsze przesyłamy Ostrzeżenie)

• Zagrożenie - piktogram ostrzegawczy

Informacje o bezpieczeństwie

Tak samo jak w przypadku informacji o zagrożeniach, działamy na podstawie parametrów:

• Bezpieczeństwo - rodzaj ostrzeżenia

• Bezpieczeństwo - piktogram informacyjny

Aktualizacja informacji o bezpieczeństwie produktu na trwających ofertach eBay, wykonywana jest podobnie jak przesłanie informacji o podmiotach odpowiedzialnych. Możesz to zrobić z poziomu karty towaru i GEO. Informacje dotyczące aktualizacji tych danych również znajdziesz w akapicie powyżej.

Załączniki do ofert

Etykieta energetyczna

Abyśmy przesłali te informacje do eBay, należy dodać do towaru poniższe załączniki:

• etykieta energetyczna (wraz z opisem)

• karta produktu

Oba załączniki muszą być zdjęciem (np. jpg). Jeśli nie zostaną one stworzone, lub etykieta energetyczna nie będzie mieć opisu, nasz system nie przekaże tych informacji do eBay.

Pozostałe załączniki (dokumenty)

W przypadku eBay obsługujemy typu załączników:

• Instrukcja obsługi

• Instrukcja z informacją o bezpieczeństwie

• Instrukcja montażu

• Poradnik

• Karta produktu

Załączniki mogą być w formie zdjęcia lub PDF. Priorytetowo nasz system będzie przesyłać tylko te załączniki, które są w języku serwisu (np. do eBay.pl będziemy wysyłać załączniki w języku polskim)

Jeśli jednak, nie będzie dodany załącznik w języku serwisu, będziemy przesyłać załącznik z innego języka, dodając oznaczenie że załącznik jest w języku serwisu oraz w języku jaki jest oznaczony w panelu IdoSell.

Informacje dotyczące aktualizacji tych danych znajdziesz w akapicie powyżej.

Podmiot odpowiedzialny

W przypadku Ceneo Kup Teraz, dodajemy do feedu produktowego odpowiednie węzły, jeżeli w towarze uzupełniona jest osoba odpowiedzialna oraz producent odpowiedzialny.

Nie musisz wykonywać innych działań związanych z aktualizacją tych danych.

Informacje dotyczące bezpieczeństwa produktu

Nasz mechanizm dla Ceneo Kup Teraz działa w następujący sposób:

• priorytetowo sprawdzamy czy do towaru został dodany załącznik o typie dokumentu "instrukcja z informacją o bezpieczeństwie" i jeśli tak to przesyłamy url do tego pliku.

• Jeżeli w towarze nie ma załącznika typu Instrukcja z informacją o bezpieczeństwie, to nasz system sprawdza czy towar posiada parametr z kontekstem specjalnym "Bezpieczeństwo - rodzaj ostrzeżenia" i jeżeli taki parametr występuje, przesyłamy go do Ceneo Kup Teraz.