MercuryG2B:GetProductItemChangesList:v3.0: различия между версиями

Версия 07:03, 17 октября 2023

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

Операция GetProductItemChangesList предназначена для получения истории изменений справочника номенклатуры.
В список попадают записи, дата изменения которых попадает во временной интервал, указанный в запросе.
В ответе возвращаются все версии записей: последние и не последние (last = true, last = false), актуальные и не актуальные (active = true, active = false).
Поддерживается возможность постраничного вывода.
Добавить, изменить или удалить записи номенклатуры можно с помощью операции MercuryG2B:ModifyProducerStockList:v3.0.

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

#	Название XML-элемента	Тип	Обязат.	Описание (нажмите [...] для отображения дополнительного описания)
001	<ws:getProductItemChangesListRequest>
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	···<bs:updateDateInterval>	bs:DataInterval	[1..1]	Интервал времени обновления в список попадают все записи, дата обновлений которых попадает в указанный интервал.
007	······<bs:beginDate>?</bs:beginDate>	xs:dateTime	[1..1]	Начало временного интервала
008	······<bs:endDate>?</bs:endDate>	xs:dateTime	[0..1]	Конец временного интервала.
009	···</bs:updateDateInterval>
010	···<dt:businessEntity>	dt:BusinessEntity	[0..1]	Хозяйствующий субъект (владелец продукции)
011	······<bs:guid>?</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор хозяйствующего субъекта
012	···</dt:businessEntity>
013	···<dt:producer>	dt:BusinessMember	[0..1]	Производитель продукции
014	······<dt:businessEntity>	dt:BusinessEntity	[0..1]	Хозяйствующий субъект (производитель продукции)
015	·········<bs:guid>?</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор хозяйствующего субъекта
016	······</dt:businessEntity>
017	······<dt:enterprise>	dt:Enterprise	[0..1]	Предприятие-производитель продукции
018	·········<bs:guid>?</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор предприятия
019	······</dt:enterprise>
020	···</dt:producer>
021	···<dt:globalId>?</dt:globalId>	dt:GTINType	[0..1]	GTIN
022	</ws:getProductItemChangesListRequest>

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

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

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

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

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

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

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

TODO

См. также

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