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

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

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

Операция GetProductItemByUuid предназначена для получения записи номенклатуры по уникальному идентификатору версии записи.
Запись может быть не последней и/или не актуальной (last = false, active = false).
Добавить, изменить или удалить записи номенклатуры можно с помощью операции MercuryG2B:ModifyProducerStockList:v3.0 - при изменении глобальный идентификатор GUID останется прежним, а идентификатор версии записи UUID изменится.

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

#	Название XML-элемента	Тип	Обязат.	Описание (нажмите [...] для отображения дополнительного описания)
001	<ws:getProductItemByUuidRequest>
002	···<bs:uuid>?</bs:uuid>	bs:UUID	[1..1]	Идентификатор версии номенклатуры
003	</ws:getProductItemByUuidRequest>

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

#	Название XML-элемента	Тип	Обязат.	Описание (нажмите [...] для отображения дополнительного описания)
001	<ws:getProductItemByUuidResponse>
002	···<dt:productItem>	dt:ProductItem	[1..1]	Сведения о наименовании продукции (номенклатуре)
003	······<bs:uuid>?</bs:uuid>	bs:UUID	[1..1]	Идентификатор версии записи
004	······<bs:guid>?</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор записи
005	······<bs:active>?</bs:active>	xs:boolean	[1..1]	Флаг активности записи true - запись активна; false - запись не активна.
006	······<bs:last>?</bs:last>	xs:boolean	[1..1]	Флаг, указывающий на то, что запись является последней в истории true - да; false - нет.
007	······<bs:status>?</bs:status>	bs:VersionStatus	[1..1]	Статус записи
008	······<bs:createDate>?</bs:createDate>	xs:DateTime	[1..1]	Дата создания записи
009	······<bs:updateDate>?</bs:updateDate>	xs:DateTime	[1..1]	Дата последнего изменения записи
010	······<bs:previous>?</bs:previous>	bs:UUID	[0..1]	Идентификатор предыдущей версии записи
011	······<bs:next>?</bs:next>	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	</ws:getProductItemByUuidResponse>

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

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

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

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

См. также

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