29 maja 2020
Parametr GTIN w ofertach oraz produktach
Od 29.06.2020 udostępnimy parametr globalny numer jednostki handlowej tzw. GTIN. W większości kategorii oznaczymy 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 będzie nadrzędny wobec pola “ean”, którego wartości automatycznie przeniesiemy 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
Nowy parametr GTIN dla produktów będzie funkcjonować równolegle z dotychczasową tablicą “eans”. Aktualne wartości “eans” przeniesiemy 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.
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.
Tydzień przed wdrożeniem zmiany udostępnimy na Sandbox kategorię oraz produkt z nowym parametrem GTIN, co pozwoli Wam przetestować jego działanie. O szczegółach poinformujemy w komunikacie na naszym forum.