02 września 2026
Wprowadziliśmy zmiany w zakresie zarządzania informacjami o składnikach znajdujących się w produkcie
W związku z nowymi przepisami unijnymi (w tym GPSR) oraz krajowymi, wymagane jest, aby kupujący w internecie miał przed zakupem dostęp do kluczowych informacji o produkcie, jego bezpieczeństwie i cechach charakterystycznych. W przypadku produktów kosmetycznych lista składników jest ważną informacją o produkcie i powinna odpowiadać informacjom przedstawionym na opakowaniu lub etykiecie produktu.
Wprowadziliśmy kilka zmian, które ułatwią sprzedającym:
- spełnienie powyższych standardów,
- prezentację pełnego składu INCI na stronie oferty.
Jakie zmiany wprowadziliśmy?
W żądaniu i odpowiedzi dla:
oraz w odpowiedzi dla:
od dzisiaj zwracamy nowy obiekt “composition” określający skład produktu, składający się z komponentów i ich składników.
Przykładowa część body requestu:
{
"productSet": [
{
"product": {
"id": "4f8c6dc0-bb1d-46a7-a9ee-8681aec1bb93"
},
...
"composition": {
"components": [
{
"name": "Cream",
"ingredients": [
{
"name": "Aqua"
}
]
}
]
}
}
]
}
...
]Przykładowy fragment odpowiedzi:
"productSet": [
{
"product": {
"id": "4f8c6dc0-bb1d-46a7-a9ee-8681aec1bb93"
},
...
"composition": {
"mode": "MANUAL",
"components": [
{
"name": "Cream",
"ingredients": [
{
"name": "Aqua"
}
]
}
]
}
...
]
...- Udostępniliśmy dzisiaj nowy endpoint POST /ingredients/parse, za pomocą którego w treści żądania przekażesz tekst z nazwą produktu i od nowej linii - listą składników, np.
"shampoo:\n aqua, sodium chloride, parfum"Dzięki temu:
- automatycznie przetworzysz i ustrukturyzujesz nieustandaryzowane deklaracje tekstowe (surowy ciąg znaków) czy też dane/listy składników w innym formacie - na formalną reprezentację danych zgodną ze słownikiem INCI,
uzyskasz ustrukturyzowaną listy produktów, wykrytych elementów (“items”) oraz przetworzonych składników (“ingredients”),
uzyskasz listę błędów (“errors”) i ostrzeżeń (“warnings”) dla:
- nierozpoznanych składników: UNKNOWN_INGREDIENT,
- zduplikowanych nazw składników: DUPLICATE_INGREDIENT_NAME,
- brak zawartości lub elementów na liście składników: EMPTY_INGREDIENTS.
Ważne! Każdą przesłaną deklarację przetwarzamy niezależnie dla jednego lub wielu produktów.
Przykładowy request:
curl -X POST
'https://api.allegro.pl/ingredients/parse'
-H 'Authorization: Bearer {token}'
-H 'Accept: application/vnd.allegro.public.v1+json'
-H 'Content-Type: application/vnd.allegro.public.v1+json'
-d '{
"products": [
{
"productId": "0e810d4a-bbee-495c-8979-866bb06d3904", // ID produktu - pole OPCJONALNE
"ingredients": "shampoo:\n aqua, sodium chloride, parfum" // lista komponentów i składników
}
]
}'Przykładowy response:
{
"products": [
{
"productId": "0e810d4a-bbee-495c-8979-866bb06d3904", // ID produktu
"items": [ // lista wykrytych elementów
{
"name": "shampoo", // nazwa produktu
"ingredients": [ // lista składników
{
"name": "aqua"
}
],
"errors": [ // lista błędów
{
"code": "UNKNOWN_INGREDIENT",// dostępne wartości: UNKNOWN_INGREDIENT, DUPLICATE_INGREDIENT_NAME, EMPTY_INGREDIENTS
"message": "Ingredient is not present in the known ingredients collection", // opis błędu
"context": "Unknownium" // ogólny kontekst błędu, który odnosi się do konkretnego składnika
}
],
"warnings": [ // lista ostrzeżeń
{
"code": "UNKNOWN_INGREDIENT",
"message": "Ingredient is not present in the known ingredients collection",
"context": "Unknownium"
}
]
}
],
"errors": [
{
"code": "UNKNOWN_INGREDIENT",
"message": "Ingredient is not present in the known ingredients collection",
"context": "Unknownium"
}
],
"warnings": [
{
"code": "UNKNOWN_INGREDIENT",
"message": "Ingredient is not present in the known ingredients collection",
"context": "Unknownium"
}
]
}
]
}