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	[0..1]	Наименование продукции
020	·········</dt:product>
021	·········<dt:subProduct>	dt:SubProduct	[1..1]	Вид продукции третий уровень иерархического справочника продукции ИС Меркурий
022	············<bs:uuid>?</bs:uuid>	bs:UUID	[1..1]	Идентификатор версии записи
023	············<bs:guid>?</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор записи
024	············<dt:name>?</dt:name>	bs:String255	[0..1]	Наименование вида продукции
025	·········</dt:subProduct>
026	·········<dt:correspondsToGost>?</dt:correspondsToGost>	xs:boolean	[1..1]	Соответствие ГОСТ
027	·········<dt:gost>?</dt:gost>	bs:String255	[0..1]	ГОСТ
028	·········<dt:producer>	dt:BusinessEntity	[0..1]	Хозяйствующий субъект (ХС) производитель продукции
029	············<bs:uuid>?</bs:uuid>	bs:UUID	[1..1]	Идентификатор версии ХС
030	············<bs:guid>?</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор ХС
031	············<dt:name>?</dt:name>	bs:String255	[0..1]	Наименование ХС
032	············<dt:fio>?</dt:fio>	bs:String255	[0..1]	ФИО ХС
033	·········</dt:producer>
034	·········<dt:tmOwner>	dt:BusinessEntity	[0..1]	ХС-собственник торговой марки
035	············<bs:uuid>?</bs:uuid>	bs:UUID	[1..1]	Идентификатор версии ХС
036	············<bs:guid>?</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор ХС
037	············<dt:name>?</dt:name>	bs:String255	[0..1]	Наименование ХС
038	············<dt:fio>?</dt:fio>	bs:String255	[0..1]	ФИО ХС
039	·········</dt:tmOwner>
040	·········<dt:producing>	dt:ProductItemProducing	[0..*]	Список площадок, на которых выпускается данная продукция
041	···········<dt:location>	dt:Enterprise	[1..1]	Площадка, осуществляющая выпуск продукции
042	···············<bs:uuid>?</bs:uuid>	bs:UUID	[1..1]	Идентификатор версии площадки
043	···············<bs:guid>?</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор площадки
044	···············<dt:name>?</dt:name>	bs:String255	[0..1]	Наименование площадки
045	············</dt:location>
046	·········</dt:producing>
047	·········<dt:packaging>	dt:Packaging	[0..1]	Фасовка
048	············<dt:packagingType>	dt:PackingType	[1..1]	Тип упаковки
049	···············<bs:uuid>?</bs:uuid>	bs:UUID	[1..1]	Идентификатор версии типа упаковки
050	···············<bs:guid>?</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор упаковки
051	···············<dt:globalID>?</dt:globalID>	dt:PackingCodeType	[1..1]	Уникальный идентификатор упаковки
052	···············<dt:name>?</dt:name>	bs:String255	[1..1]	Наименование упаковки
053	············</dt:packagingType>
054	············<dt:quantity>?</dt:quantity>	xs:integer	[0..1]	Количество единиц упаковки
055	············<dt:volume>?</dt:volume>	bs:Decimal	[0..1]	Объём единицы упаковки товара
056	············<dt:unit>	dt:Unit	[0..1]	Единица измерения объёма единицы упаковки товара
057	···············<bs:uuid>?</bs:uuid>	bs:UUID	[1..1]	Идентификатор версии единицы измерения
058	···············<bs:guid>?</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор единицы измерения
059	···············<dt:name>?</dt:name>	bs:String255	[1..1]	Наименование единицы измерения
060	············</dt:unit>
061	·········</dt:packaging>
062	·········<dt:additionalCharacteristics>	dt:ProductItemCharacterictics	[0..1]	Дополнительные характеристики продукции
063	············<dt:classification>	dt:ClassificationAttribute	[0..1]	Классификация продукции
064	···············<dt:attrCode listID="?" listAgencyID="?" listName="?" listVersionID="?" name="?">PRODUCT_CATEGORY</dt:attrCode>	dt:CodeType	[1..1]	Код атрибута - Категория продукции
065	···············<dt:attrName>Категория продукции</dt:attrName>	bs:Ntext	[1..1]	Наименование атрибута
066	···············<dt:classCode listID="?" listAgencyID="?" listName="?" listVersionID="?" name="?">?</dt:classCode>	dt:CodeType	[1..1]	Код значения атрибута "Категория продукции" Возможные значения: UNDEFINED - категория не определена UNCLASSIFIED – не классифицировано RAW – сырец, исходное сырьё INTERMEDIATE – полуфабрикат CONSUMER_PACKAGED – готовая продукция (в потреб. упаковке)
067	···············<dt:className>?</dt:className>	bs:Text	[1..1]	Наименование значения атрибута Текстовое представление значения classCode: Категория не определена Не классифицировано Сырец, исходное сырьё Полуфабрикат Готовая продукция (в потребительской упаковке)
068	············</dt:classification>
069	············<dt:classification>	dt:ClassificationAttribute	[0..1]	Классификация продукции
070	···············<dt:attrCode listID="?" listAgencyID="?" listName="?" listVersionID="?" name="?">INTENDED_USE</dt:attrCode>	dt:CodeType	[1..1]	Код атрибута - Предназначение партии подконтрольной продукции
071	···············<dt:attrName>Предназначение партии подконтрольной продукции</dt:attrName>	bs:Ntext	[1..1]	Наименование атрибута
072	···············<dt:classCode listID="?" listAgencyID="?" listName="?" listVersionID="?" name="?">?</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 - для проведения ветеринарно-санитарной экспертизы
073	···············<dt:className>?</dt:className>	bs:Text	[1..1]	Наименование значения атрибута Текстовое представление значения classCode: В пищу людям Для переработки с целью получения подконтрольных товаров, предназначенных в пищу людям Для переработки с обеззараживанием с целью получения подконтрольных товаров, предназначенных в пищу людям В корм животным Для переработки с целью получения подконтрольных товаров, предназначенных в корм животным Для медицинских целей Для переработки с целью получения подконтрольных товаров, предназначенных для медицинских целей Для биологических, ветеринарных и биотехнологических целей Для переработки с целью получения подконтрольных товаров, предназначенных для биологических, ветеринарных и биотехнологических целей Для диагностических и иных лабораторных исследований Для технических целей Для утилизации Для уничтожения Для проведения ветеринарно-санитарной экспертизы
074	············</dt:classification>
075	············<dt:attribute>	dt:MeasuredAttribute	[0..1]	Дополнительный атрибут продукции
076	···············<dt:attrCode listID="?" listAgencyID="?" listName="?" listVersionID="?" name="?">MILK_FAT_MASS_FRACTION</dt:attrCode>	dt:CodeType	[1..1]	Код атрибута - Массовая доля жира
077	···············<dt:attrName>Массовая доля жира</dt:attrName>	bs:Ntext	[1..1]	Наименование атрибута
078	···············<dt:attrValue>	dt:ComplexMeasure	[1..1]	Значение атрибута Значение атрибута должно быть задано одним из следующих способов: указано value - точное значение атрибута указано minValue и maxValue - интервал значений атрибута указано minValue - нижнее предельное значение (не ниже) указано maxValue - верхнее предельное значение (не выше)
079	··················<dt:value>?</dt:value>	bs:Decimal	[0..1]	Точное значение точность до 3-х знаков после запятой
080	··················<dt:minValue>?</dt:minValue>	bs:Decimal	[0..1]	Минимальное значение точность до 3-х знаков после запятой
081	··················<dt:maxValue>?</dt:maxValue>	bs:Decimal	[0..1]	Максимальное значение точность до 3-х знаков после запятой
082	··················<dt:unit>	dt:Unit	[0..1]	Единица измерения значения атрибута значение массовой доли жира указывается в процентах (%)
083	·····················<bs:uuid>?</bs:uuid>	bs:UUID	[1..1]	Идентификатор версии единицы измерения
084	·····················<bs:guid>?</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор единицы измерения
085	·····················<dt:name>?</dt:name>	bs:String255	[1..1]	Наименование единицы измерения
086	··················</dt:unit>
087	···············</dt:attrValue>
088	············</dt:attribute>
089	············<dt:attribute>	dt:MeasuredAttribute	[0..1]	Дополнительный атрибут продукции
090	···············<dt:attrCode listID="?" listAgencyID="?" listName="?" listVersionID="?" name="?">MILK_PROTEIN_MASS_FRACTION</dt:attrCode>	dt:CodeType	[1..1]	Код атрибута - Массовая доля белка
091	···············<dt:attrName>Массовая доля белка</dt:attrName>	bs:Ntext	[1..1]	Наименование атрибута
092	···············<dt:attrValue>	dt:ComplexMeasure	[1..1]	Значение атрибута Значение атрибута должно быть задано одним из следующих способов: указано value - точное значение атрибута указано minValue и maxValue - интервал значений атрибута указано minValue - нижнее предельное значение (не ниже) указано maxValue - верхнее предельное значение (не выше)
093	··················<dt:value>?</dt:value>	bs:Decimal	[0..1]	Точное значение точность до 3-х знаков после запятой
094	··················<dt:minValue>?</dt:minValue>	bs:Decimal	[0..1]	Минимальное значение точность до 3-х знаков после запятой
095	··················<dt:maxValue>?</dt:maxValue>	bs:Decimal	[0..1]	Максимальное значение точность до 3-х знаков после запятой
096	··················<dt:unit>	dt:Unit	[0..1]	Единица измерения значения атрибута значение массовой доли белка указывается в процентах (%)
097	·····················<bs:uuid>?</bs:uuid>	bs:UUID	[1..1]	Идентификатор версии единицы измерения
098	·····················<bs:guid>?</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор единицы измерения
099	·····················<dt:name>?</dt:name>	bs:String255	[1..1]	Наименование единицы измерения
100	··················</dt:unit>
101	···············</dt:attrValue>
102	············</dt:attribute>
103	············<dt:attribute>	dt:MeasuredAttribute	[0..1]	Дополнительный атрибут продукции
104	···············<dt:attrCode listID="?" listAgencyID="?" listName="?" listVersionID="?" name="?">DENSITY</dt:attrCode>	dt:CodeType	[1..1]	Код атрибута - Плотность
105	···············<dt:attrName>Плотность</dt:attrName>	bs:Ntext	[1..1]	Наименование атрибута
106	···············<dt:attrValue>	dt:ComplexMeasure	[1..1]	Значение атрибута Значение атрибута должно быть задано одним из следующих способов: указано value - точное значение атрибута указано minValue и maxValue - интервал значений атрибута
107	··················<dt:value>?</dt:value>	bs:Decimal	[0..1]	Точное значение точность до 3-х знаков после запятой
108	··················<dt:minValue>?</dt:minValue>	bs:Decimal	[0..1]	Минимальное значение точность до 3-х знаков после запятой
109	··················<dt:maxValue>?</dt:maxValue>	bs:Decimal	[0..1]	Максимальное значение точность до 3-х знаков после запятой
110	··················<dt:unit>	dt:Unit	[0..1]	Единица измерения значения атрибута значение плотности указывается в граммах на кубический сантиметр (г/см3)
111	·····················<bs:uuid>?</bs:uuid>	bs:UUID	[1..1]	Идентификатор версии единицы измерения
112	·····················<bs:guid>?</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор единицы измерения
113	·····················<dt:name>?</dt:name>	bs:String255	[1..1]	Наименование единицы измерения
114	··················</dt:unit>
115	···············</dt:attrValue>
116	············</dt:attribute>
117	·········</dt:additionalCharacteristics>
118	······</dt:productItem>
119	···</dt:productItemList>
120	</ws:getProductItemListResponse>

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

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

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

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

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

TODO

См. также

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