MercuryG2B:GetProductItemList:v3.0

Общие сведения

1. Операция GetProductItemList предназначена для получения списка номенклатуры с возможностью фильтрации по дополнительным параметрам.
2. В список попадают только актуальные записи (active = true).
3. Поддерживается возможность постраничного вывода.
4. Добавить, изменить или удалить записи номенклатуры можно с помощью операции MercuryG2B:ModifyProducerStockList:v3.0.

Спецификация запроса

#	Название XML-элемента	Тип	Обязат.	Описание (нажмите [...] для отображения дополнительного описания)
001	<ws:getProductItemListRequest>
002	···<bs:listOptions>	bs:ListOptions	[0..1]	Параметры запрашиваемого списка
003	······<bs:count>?</bs:count>	xs:nonNegativeInteger	[0..1]	Максимальное запрашиваемое количество объектов в списке по умолчанию значение 100; максимально возможное значение 1000.
004	······<bs:offset>?</bs:offset>	xs:nonNegativeInteger	[0..1]	Номер элемента, по которому осуществляется смещение первого элемента списка по умолчанию значение 0.
005	···</bs:listOptions>
006	···<dt:productType>?</dt:productType>	dt:ProductType	[0..1]	Тип продукции первый уровень иерархического справочника продукции ИС Меркурий
007	···<dt:product>	dt:Product	[0..1]	Продукция второй уровень иерархического справочника продукции ИС Меркурий
008	······<bs:guid>?</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор продукции
009	···</dt:product>
010	···<dt:subProduct>	dt:SubProduct	[0..1]	Вид продукции третий уровень иерархического справочника продукции ИС Меркурий
011	······<bs:guid>?</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор вида продукции
012	···</dt:subProduct>
013	···<dt:businessEntity>	dt:BusinessEntity	[0..1]	Хозяйствующий субъект (владелец продукции)
014	······<bs:guid>?</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор хозяйствующего субъекта
015	···</dt:businessEntity>
016	···<dt:producer>	dt:BusinessMember	[0..1]	Производитель продукции
017	······<dt:businessEntity>	dt:BusinessEntity	[0..1]	Хозяйствующий субъект (производитель продукции)
018	·········<bs:guid>?</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор хозяйствующего субъекта
019	······</dt:businessEntity>
020	······<dt:enterprise>	dt:Enterprise	[0..1]	Предприятие-производитель продукции
021	·········<bs:guid>?</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор предприятия
022	······</dt:enterprise>
023	···</dt:producer>
024	···<dt:globalId>?</dt:globalId>	dt:GTINType	[0..1]	GTIN
025	</ws:getProductItemListRequest>

Спецификация ответа

#	Название XML-элемента	Тип	Обязат.	Описание (нажмите [...] для отображения дополнительного описания)
001	<ws:getProductItemListResponse>
002	···<dt:productItemList total="?" offset="?" count="?">	dt:ProductItemList	[1..1]	Список наименований продукции номенклатуры total - всего записей; offset - смещение относительно первого элемента; count - количество выводимых записей.
003	······<dt:productItem>	dt:ProductItem	[1..1]	Сведения о наименовании продукции (номенклатуре)
004	·········<bs:uuid>?</bs:uuid>	bs:UUID	[1..1]	Идентификатор версии записи
005	·········<bs:guid>?</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор записи
006	·········<bs:active>?</bs:active>	xs:boolean	[1..1]	Флаг активности записи true - запись активна; false - запись не активна.
007	·········<bs:last>?</bs:last>	xs:boolean	[1..1]	Флаг, указывающий на то, что запись является последней в истории true - да; false - нет.
008	·········<bs:status>?</bs:status>	bs:VersionStatus	[1..1]	Статус записи
009	·········<bs:createDate>?</bs:createDate>	xs:DateTime	[1..1]	Дата создания записи
010	·········<bs:updateDate>?</bs:updateDate>	xs:DateTime	[1..1]	Дата последнего изменения записи
011	·········<bs:previous>?</bs:previous>	bs:UUID	[0..1]	Идентификатор предыдущей версии записи
012	·········<dt:globalID>?</dt:globalID>	dt:GTINType	[0..1]	Trade Identification Number (GTIN) идентификационный номер продукции производителя
013	·········<dt:name>?</dt:name>	bs:String255	[0..1]	Наименование номенклатуры
014	·········<dt:code>?</dt:code>	bs:String255	[0..1]	Артикул код продукции в соответствии с внутренним кодификатором производителя
015	·········<dt:productType>?</dt:productType>	dt:ProductType	[1..1]	Тип продукции первый уровень иерархического справочника продукции ИС Меркурий
016	·········<dt:product>	dt:Product	[1..1]	Продукция второй уровень иерархического справочника продукции ИС Меркурий
017	············<bs:uuid>?</bs:uuid>	bs:UUID	[1..1]	Идентификатор версии записи
018	············<bs:guid>?</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор записи
019	············<dt:name>?</dt:name>	bs:String255	[1..1]	Наименование продукции
020	············<dt:code>?</dt:code>	bs:String256	[0..1]	Код ТН ВЭД
021	·········</dt:product>
022	·········<dt:subProduct>	dt:SubProduct	[1..1]	Вид продукции третий уровень иерархического справочника продукции ИС Меркурий
023	············<bs:uuid>?</bs:uuid>	bs:UUID	[1..1]	Идентификатор версии записи
024	············<bs:guid>?</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор записи
025	············<dt:name>?</dt:name>	bs:String255	[1..1]	Наименование вида продукции
026	············<dt:code>?</dt:code>	bs:String256	[0..1]	Код ТН ВЭД
027	·········</dt:subProduct>
028	·········<dt:correspondsToGost>?</dt:correspondsToGost>	xs:boolean	[1..1]	Соответствие ГОСТ
029	·········<dt:gost>?</dt:gost>	bs:String255	[0..1]	ГОСТ
030	·········<dt:producer>	dt:BusinessEntity	[0..1]	Хозяйствующий субъект (ХС) производитель продукции
031	············<bs:uuid>?</bs:uuid>	bs:UUID	[1..1]	Идентификатор версии ХС
032	············<bs:guid>?</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор ХС
033	············<dt:fullName>?</dt:fullName>	bs:String255	[0..1]	Наименование ХС
034	············<dt:fio>?</dt:fio>	bs:String255	[0..1]	ФИО ХС
035	·········</dt:producer>
036	·········<dt:tmOwner>	dt:BusinessEntity	[0..1]	ХС-собственник торговой марки
037	············<bs:uuid>?</bs:uuid>	bs:UUID	[1..1]	Идентификатор версии ХС
038	············<bs:guid>?</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор ХС
039	············<dt:fullName>?</dt:fullName>	bs:String255	[0..1]	Наименование ХС
040	············<dt:fio>?</dt:fio>	bs:String255	[0..1]	ФИО ХС
041	·········</dt:tmOwner>
042	·········<dt:producing>	dt:ProductItemProducing	[0..*]	Список площадок, на которых выпускается данная продукция
043	···········<dt:location>	dt:Enterprise	[1..1]	Площадка, осуществляющая выпуск продукции
044	···············<bs:uuid>?</bs:uuid>	bs:UUID	[1..1]	Идентификатор версии площадки
045	···············<bs:guid>?</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор площадки
046	···············<dt:name>?</dt:name>	bs:String255	[1..1]	Наименование площадки
047	············</dt:location>
048	·········</dt:producing>
049	·········<dt:packaging>	dt:Packaging	[0..1]	Фасовка
050	············<dt:packagingType>	dt:PackingType	[1..1]	Тип упаковки
051	···············<bs:uuid>?</bs:uuid>	bs:UUID	[1..1]	Идентификатор версии типа упаковки
052	···············<bs:guid>?</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор упаковки
053	···············<dt:globalID>?</dt:globalID>	dt:PackingCodeType	[1..1]	Уникальный идентификатор упаковки
054	···············<dt:name>?</dt:name>	bs:String255	[1..1]	Наименование упаковки
055	············</dt:packagingType>
056	············<dt:quantity>?</dt:quantity>	xs:integer	[0..1]	Количество единиц упаковки
057	············<dt:volume>?</dt:volume>	bs:Decimal	[0..1]	Объём единицы упаковки товара
058	············<dt:unit>	dt:Unit	[0..1]	Единица измерения объёма единицы упаковки товара
059	···············<bs:uuid>?</bs:uuid>	bs:UUID	[1..1]	Идентификатор версии единицы измерения
060	···············<bs:guid>?</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор единицы измерения
061	···············<dt:name>?</dt:name>	bs:String255	[1..1]	Наименование единицы измерения
062	············</dt:unit>
063	·········</dt:packaging>
064	·········<dt:additionalCharacteristics>	dt:ProductItemCharacterictics	[0..1]	Дополнительные характеристики продукции
065	············<dt:classification>	dt:ClassificationAttribute	[0..1]	Классификация продукции
066	···············<dt:attrCode>PRODUCT_CATEGORY</dt:attrCode>	dt:CodeType	[1..1]	Код атрибута - Категория продукции
067	···············<dt:attrName>Категория продукции</dt:attrName>	bs:Ntext	[1..1]	Наименование атрибута
068	···············<dt:classCode>?</dt:classCode>	dt:CodeType	[1..1]	Код значения атрибута "Категория продукции" Возможные значения: UNDEFINED - категория не определена UNCLASSIFIED – не классифицировано RAW – сырец, исходное сырьё INTERMEDIATE – полуфабрикат CONSUMER_PACKAGED – готовая продукция (в потреб. упаковке)
069	···············<dt:className>?</dt:className>	bs:Text	[1..1]	Наименование значения атрибута Текстовое представление значения classCode: Категория не определена Не классифицировано Сырец, исходное сырьё Полуфабрикат Готовая продукция (в потребительской упаковке)
070	············</dt:classification>
071	············<dt:classification>	dt:ClassificationAttribute	[0..1]	Классификация продукции
072	···············<dt:attrCode>INTENDED_USE</dt:attrCode>	dt:CodeType	[1..1]	Код атрибута - Предназначение партии подконтрольной продукции
073	···············<dt:attrName>Предназначение партии подконтрольной продукции</dt:attrName>	bs:Ntext	[1..1]	Наименование атрибута
074	···············<dt:classCode>?</dt:classCode>	dt:CodeType	[1..1]	Код значения атрибута "Предназначение партии подконтрольной продукции" Возможные значения: HUMAN_CONSUMPTION - в пищу людям MANUFACTURING_HUMAN_CONSUMPTION - для переработки с целью получения подконтрольных товаров, предназначенных в пищу людям DECONTAMINATION_HUMAN_CONSUMPTION - для переработки с обеззараживанием с целью получения подконтрольных товаров, предназначенных в пищу людям ANIMAL_FEED - в корм животным MANUFACTURING_ANIMAL_FEED - для переработки с целью получения подконтрольных товаров, предназначенных в корм животным MEDICAL_USE - для медицинских целей MANUFACTURING_MEDICAL_USE - для переработки с целью получения подконтрольных товаров, предназначенных для медицинских целей SCIENTIFIC_PURPOSES - для биологических, ветеринарных и биотехнологических целей MANUFACTURING_SCIENTIFIC_PURPOSES - для переработки с целью получения подконтрольных товаров, предназначенных для биологических, ветеринарных и биотехнологических целей LABORATORY_TESTS - для диагностических и иных лабораторных исследований TECHNICAL_PURPOSES - для технических целей DISPOSAL - для утилизации DESTRUCTION - для уничтожения EXAMINATION - для проведения ветеринарно-санитарной экспертизы
075	···············<dt:className>?</dt:className>	bs:Text	[1..1]	Наименование значения атрибута Текстовое представление значения classCode: В пищу людям Для переработки с целью получения подконтрольных товаров, предназначенных в пищу людям Для переработки с обеззараживанием с целью получения подконтрольных товаров, предназначенных в пищу людям В корм животным Для переработки с целью получения подконтрольных товаров, предназначенных в корм животным Для медицинских целей Для переработки с целью получения подконтрольных товаров, предназначенных для медицинских целей Для биологических, ветеринарных и биотехнологических целей Для переработки с целью получения подконтрольных товаров, предназначенных для биологических, ветеринарных и биотехнологических целей Для диагностических и иных лабораторных исследований Для технических целей Для утилизации Для уничтожения Для проведения ветеринарно-санитарной экспертизы
076	············</dt:classification>
077	············<dt:attribute>	dt:MeasuredAttribute	[0..1]	Дополнительный атрибут продукции
078	···············<dt:attrCode>MILK_FAT_MASS_FRACTION</dt:attrCode>	dt:CodeType	[1..1]	Код атрибута - Массовая доля жира
079	···············<dt:attrName>Массовая доля жира</dt:attrName>	bs:Ntext	[1..1]	Наименование атрибута
080	···············<dt:attrValue>	dt:ComplexMeasure	[1..1]	Значение атрибута Значение атрибута должно быть задано одним из следующих способов: указано value - точное значение атрибута указано minValue и maxValue - интервал значений атрибута указано minValue - нижнее предельное значение (не ниже) указано maxValue - верхнее предельное значение (не выше)
081	··················<dt:value>?</dt:value>	bs:Decimal	[0..1]	Точное значение точность до 3-х знаков после запятой
082	··················<dt:minValue>?</dt:minValue>	bs:Decimal	[0..1]	Минимальное значение точность до 3-х знаков после запятой
083	··················<dt:maxValue>?</dt:maxValue>	bs:Decimal	[0..1]	Максимальное значение точность до 3-х знаков после запятой
084	··················<dt:unit>	dt:Unit	[0..1]	Единица измерения значения атрибута значение массовой доли жира указывается в процентах (%)
085	·····················<bs:uuid>?</bs:uuid>	bs:UUID	[1..1]	Идентификатор версии единицы измерения
086	·····················<bs:guid>?</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор единицы измерения
087	·····················<dt:name>?</dt:name>	bs:String255	[1..1]	Наименование единицы измерения
088	··················</dt:unit>
089	···············</dt:attrValue>
090	············</dt:attribute>
091	············<dt:attribute>	dt:MeasuredAttribute	[0..1]	Дополнительный атрибут продукции
092	···············<dt:attrCode>MILK_PROTEIN_MASS_FRACTION</dt:attrCode>	dt:CodeType	[1..1]	Код атрибута - Массовая доля белка
093	···············<dt:attrName>Массовая доля белка</dt:attrName>	bs:Ntext	[1..1]	Наименование атрибута
094	···············<dt:attrValue>	dt:ComplexMeasure	[1..1]	Значение атрибута Значение атрибута должно быть задано одним из следующих способов: указано value - точное значение атрибута указано minValue и maxValue - интервал значений атрибута указано minValue - нижнее предельное значение (не ниже) указано maxValue - верхнее предельное значение (не выше)
095	··················<dt:value>?</dt:value>	bs:Decimal	[0..1]	Точное значение точность до 3-х знаков после запятой
096	··················<dt:minValue>?</dt:minValue>	bs:Decimal	[0..1]	Минимальное значение точность до 3-х знаков после запятой
097	··················<dt:maxValue>?</dt:maxValue>	bs:Decimal	[0..1]	Максимальное значение точность до 3-х знаков после запятой
098	··················<dt:unit>	dt:Unit	[0..1]	Единица измерения значения атрибута значение массовой доли белка указывается в процентах (%)
099	·····················<bs:uuid>?</bs:uuid>	bs:UUID	[1..1]	Идентификатор версии единицы измерения
100	·····················<bs:guid>?</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор единицы измерения
101	·····················<dt:name>?</dt:name>	bs:String255	[1..1]	Наименование единицы измерения
102	··················</dt:unit>
103	···············</dt:attrValue>
104	············</dt:attribute>
105	············<dt:attribute>	dt:MeasuredAttribute	[0..1]	Дополнительный атрибут продукции
106	···············<dt:attrCode>DENSITY</dt:attrCode>	dt:CodeType	[1..1]	Код атрибута - Плотность
107	···············<dt:attrName>Плотность</dt:attrName>	bs:Ntext	[1..1]	Наименование атрибута
108	···············<dt:attrValue>	dt:ComplexMeasure	[1..1]	Значение атрибута Значение атрибута должно быть задано одним из следующих способов: указано value - точное значение атрибута указано minValue и maxValue - интервал значений атрибута
109	··················<dt:value>?</dt:value>	bs:Decimal	[0..1]	Точное значение точность до 3-х знаков после запятой
110	··················<dt:minValue>?</dt:minValue>	bs:Decimal	[0..1]	Минимальное значение точность до 3-х знаков после запятой
111	··················<dt:maxValue>?</dt:maxValue>	bs:Decimal	[0..1]	Максимальное значение точность до 3-х знаков после запятой
112	··················<dt:unit>	dt:Unit	[0..1]	Единица измерения значения атрибута значение плотности указывается в граммах на кубический сантиметр (г/см3)
113	·····················<bs:uuid>?</bs:uuid>	bs:UUID	[1..1]	Идентификатор версии единицы измерения
114	·····················<bs:guid>?</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор единицы измерения
115	·····················<dt:name>?</dt:name>	bs:String255	[1..1]	Наименование единицы измерения
116	··················</dt:unit>
117	···············</dt:attrValue>
118	············</dt:attribute>
119	·········</dt:additionalCharacteristics>
120	······</dt:productItem>
121	···</dt:productItemList>
122	<ws:getProductItemListResponse>

Классификатор справочников и перечислений Codelist

Описание классификатора и назначения опциональных атрибутов типа dt:CodeType (@listID, @listAgencyID, @listName, @listVersionID, @name) приведено на странице: MercuryG2B:Codelist:v2.4r1

Дополнительные сведения об операции

Подробнее о категориях продукции и качественных характеристиках молока и молочной продукции на странице операции ведения справочника номенклатуры: MercuryG2B:ModifyProducerStockList:v3.0

Примеры запросов

TODO

См. также

Вернуться к началу ↑
Вернуться на страницу профиля API MercuryG2B:Services:v3.0