ДепозитарійКаталог ДепозитаріюДані GS1 УКРАЇНА
Про ДепозитарійДокументація

Документація

-SearchGTIN
 

SearchGTIN

Запит дозволяє шукати в каталозі інформацію про товар (Назву, Глобальний номер товарної позиції (GTIN), назву та Глобальний номер розташування виробника (GLN) виробника,НЕТТО товару).

Пошук відбувається за одним або декількома параметрами:

- назва товару;

- Глобальний номер розташування виробника (GLN) виробника;

- код з обраного класифікатора;

- розмірність.

Запит надає гнучкі можливості пошуку за розмірностями:

- вибір поля для пошуку за одиницями розмірності (НЕТТО, масою НЕТТО, масою БРУТТО, висотою, шириною, глибиною);

- пошук у діапазоні величин;

- пошук товарів за умовами, накладеними на задану величину (більше, меньше, дорівнюють, не дорівнюють тощо).

Параметри
Ім`я:КоментарЗа умовчаннямТип
GLNГлобальний номер розташування власника коду  nonNegativeInteger
classifierCodeКод з класифікатора, який визначено параметром classifierName  string
classifierNameНазва класифікатора. UNSPSC string
fromНомер позиції, починаючи з якої у відповідь будуть додаватися дані. int
languageКод мови за довідником "Коди мов" $INTERFACE_LANGUAGE string
measurementConditionУмова пошуку за одиницями виміру. Параметр може приймати значення:
=;
!= (не дорівнює);
<;
>;
<=;
>=;
BETWEEN (між значеннями, які передаються в параметрах measurementValueHi та measurementValueLo).

*Слід пам`ятати, що за правилами мови XML, символи
< та > є зарезервованими, тому в тілі запиту їх необхідно записувати таким чином:
&lt; - комбінація для символу <
&gt; - комбінація для символу > 
string
measurementFieldПерелік полів (через кому), які використовуються для пошука за розмірністю.
Можливі значення:
- NetContent (НЕТТО);
- ItemNetWeight (Маса НЕТТО);
- ItemGrossWeight (Маса БРУТТО);
- ItemHieght(Висота);
- ItemWidth (Ширина);
- ItemDepth (Глибина). 
ANY string
measurementValueHiВерхнє значення діапазону пошуку за розмірностями.
Параметр заповнюється лише в тому випадку, коли значення параметру measurementCondition - BETWEEN 
 double
measurementValueLoЗначення одиниці виміру при пошуку за розмірностями.
В тому випадку, коли параметр measurementCondition приймає значення BETWEEN, параметр measurementValueLo вказує нижню границю діапазону пошуку 
 double
nameНазва, або частина назви товару.
Про параметри запису частини назви див.____ 
 string
quantityМаксимальна кількість позицій, які будуть виводитись у відповіді. 20 int
quickCountВикористовувати механізм прискореного обчислення from, quantity и totalCount true boolean
searchLanguageЗадає код мови для значень мовно-залежних елементів.
Параметр може приймати такі значення:
• Будь-який код мови з довідника мов. Коли зазначено код мови, вибираються всі мовно-незалежні елементи і тільки ті мовно-залежні елементи , для яких існує переклад на зазначену мову .
• "ANY" Вибираються всі елементи для даної категорії інформації не залежно від мови . Для мовно-залежних полів вибираються всі наявні переклади . 
ANY string
setCountВиводити атрибут count.
В цьому атрибуті виводиться кількість позицій у відповіді. 
true boolean
setTotalCountВиводити атрибут totalCount.
Цей атрибут показує кількість позицій в каталозі, які відповідають заданим умовам. 
false boolean
unitOfMeasureКод одиниці виміру за довідником "Одиниці виміру"  string
Приклад запиту
  • <message>
    • <SearchGTIN>
      • <parameters>
        • <name>чумак</name>
        • <measurementField>netContent</measurementField>
        • <measurementCondition>&lt; </measurementCondition>
        • <measurementValueLo>1000</measurementValueLo>
        </parameters>
      </SearchGTIN>
    </message>
Приклад відповіді
  • <message_response>
    • <SearchGTIN>
      • <infoList count="5">
        • <row>
          • <GTIN>4820001352184</GTIN>
          • <NAME>Квасоля в томатному соусі торгівельної марки "Чумак"</NAME>
          • <GLN>4820001350005</GLN>
          • <GLN_NAME>ЗАТ "Чумак"</GLN_NAME>
          • <NETCONTENT>425</NETCONTENT>
          • <UNIT>мілілітр</UNIT>
          </row>
        • <row>
          • <GTIN>4820001352177</GTIN>
          • <NAME>Квасоля в ніжному соусі торгівельної марки "Чумак"</NAME>
          • <GLN>4820001350005</GLN>
          • <GLN_NAME>ЗАТ "Чумак"</GLN_NAME>
          • <NETCONTENT>425</NETCONTENT>
          • <UNIT>мілілітр</UNIT>
          </row>
        • <row>
          • <GTIN>4820001351989</GTIN>
          • <NAME>Сік томатний "Чумак"</NAME>
          • <GLN>4820001350005</GLN>
          • <GLN_NAME>ЗАТ "Чумак"</GLN_NAME>
          • <NETCONTENT>980</NETCONTENT>
          • <UNIT>мілілітр</UNIT>
          </row>
        • <row>
          • <GTIN>4820001352191</GTIN>
          • <NAME>Квасоля з овочами в томатному соусі торгівельної марки "Чумак"</NAME>
          • <GLN>4820001350005</GLN>
          • <GLN_NAME>ЗАТ "Чумак"</GLN_NAME>
          • <NETCONTENT>425</NETCONTENT>
          • <UNIT>мілілітр</UNIT>
          </row>
        • <row>
          • <GTIN>4820001352207</GTIN>
          • <NAME>Квасоля з овочами та грибами в томатному соусі торгівельної марки "Чумак"</NAME>
          • <GLN>4820001350005</GLN>
          • <GLN_NAME>ЗАТ "Чумак"</GLN_NAME>
          • <NETCONTENT>425</NETCONTENT>
          • <UNIT>мілілітр</UNIT>
          </row>
        </infoList>
      </SearchGTIN>
    </message_response>

Всі права захищені © Асоціація "GS1 Україна"
Розробка та дизайн Information Technology Services