Zgodnie z wcześniejszą zapowiedzią dzisiaj udostępniliśmy parametr globalny numer jednostki handlowej tzw. GTIN. W większości kategorii oznaczyliśmy go jako parametr podstawowy, czyli taki, który identyfikuje produkt w ofercie. Jeżeli chcesz określić lub zmienić GTIN, w zależności od kategorii, skorzystaj z dostępnych parametrów:

• EAN (id parametru=225693),
• ISBN (id parametru=245669),
• ISSN (id parametru=245673).

Pamiętaj, że parametry dostępne w danej kategorii sprawdzisz za pomocą GET /sale/categories/{categoryId}/parameters.

GTIN w ofertach

W ofertach parametr GTIN jest nadrzędny wobec pola “ean”, którego wartości przenieśliśmy do nowego parametru. Wartość EAN, ISBN lub ISSN możesz uzupełnić jedynie w parametrze GTIN, aby to zrobić pobierz aktualny stan oferty poprzez GET /sale/offers/{offerId}, a następnie edytuj poprzez PUT /sale/offers/{offerId}. Jeśli spróbujesz zmienić wartość pola “ean” w ofercie, otrzymasz komunikat błędu: “Pole ean jest tylko do odczytu. Wartość z pola ean podaj w parametrze o id: {id}.”

Jeżeli dotychczas w integracji używasz pola “ean” by rozpoznać swoje oferty (jako sygnaturę), wykorzystaj w tym celu dedykowane dla sygnatury pole “external.id”.

GTIN w produktach

Parametr GTIN dla produktów funkcjonuje równolegle z dotychczasową tablicą “eans”. Aktualne wartości “eans” przenieśliśmy do nowego parametru. Zgłaszając propozycję produktu przez POST /sale/product-proposals możesz przekazać wartość EAN, ISBN lub ISSN tylko w parametrze GTIN.

Parametr GTIN zyskał flagę “isGTIN” w strukturze “options” parametrów produktu. Dzięki temu podczas dodawania oferty na podstawie produktu rozpoznasz, że jeśli parametr ma wiele wartości, to możesz przekazać tylko jedną z nich.

Przykładowy request:

curl -X GET \
        ‘https://api.allegro.pl/sale/products/0ca14fc3-7084-4fa2-83da-d04104e8b162’ \
        -H 'Accept: application/vnd.allegro.public.v1+json'

Przykładowy response:

...
"parameters": [
{
    "id": "225693",
    "name": "EAN",
    "valuesLabels": [
        "0901362561720"
    ],
    "values": [
        "0901362561720"
    ],
    "unit": null,
    "options": {
        "identifiesProduct": true,
        "isGTIN": true
    }
}
],
...

Ważne! W przyszłości pole “ean” w ofercie oraz tablicę “eans” w produkcie usuniemy. Wartość GTIN (czyli EAN, ISBN, ISSN) zmienisz tylko korzystając z parametru, dlatego już dzisiaj rozpocznij prace nad ich poprawną obsługą w swojej aplikacji.