MercuryG2B:GetProductItemByUuid:v3.0

Материал из Справочная система Россельхознадзора
Перейти к навигации Перейти к поиску

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

  1. Операция GetProductItemByUuid предназначена для получения записи номенклатуры по уникальному идентификатору версии записи.
  2. Запись может быть не последней и/или не актуальной (last = false, active = false).
  3. Добавить, изменить или удалить записи номенклатуры можно с помощью операции 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 [1..1] Наименование продукции
020 ·········<dt:code>?</dt:code> 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 [1..1] Наименование вида продукции
026 ·········<dt:code>?</dt:code> bs:String255 [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:attrValue>
085 ·········</dt:attribute>
086 ·········<dt:attribute> dt:MeasuredAttribute [0..1] Дополнительный атрибут продукции
087 ············<dt:attrCode>MILK_PROTEIN_MASS_FRACTION</dt:attrCode> dt:CodeType [1..1] Код атрибута - Массовая доля белка
088 ············<dt:attrName>Массовая доля белка</dt:attrName> bs:Ntext [1..1] Наименование атрибута
089 ············<dt:attrValue> dt:ComplexMeasure [1..1]

Значение атрибута

  • Значение атрибута должно быть задано одним из следующих способов:
    • указано value - точное значение атрибута
    • указано minValue и maxValue - интервал значений атрибута
    • указано minValue - нижнее предельное значение (не ниже)
    • указано maxValue - верхнее предельное значение (не выше)
090 ···············<dt:value>?</dt:value> bs:Decimal [0..1]

Точное значение (%)

  • точность до 3-х знаков после запятой
091 ···············<dt:minValue>?</dt:minValue> bs:Decimal [0..1]

Минимальное значение (%)

  • точность до 3-х знаков после запятой
092 ···············<dt:maxValue>?</dt:maxValue> bs:Decimal [0..1]

Максимальное значение (%)

  • точность до 3-х знаков после запятой
093 ············</dt:attrValue>
094 ·········</dt:attribute>
095 ·········<dt:attribute> dt:MeasuredAttribute [0..1] Дополнительный атрибут продукции
096 ············<dt:attrCode>DENSITY</dt:attrCode> dt:CodeType [1..1] Код атрибута - Плотность
097 ············<dt:attrName>Плотность</dt:attrName> bs:Ntext [1..1] Наименование атрибута
098 ············<dt:attrValue> dt:ComplexMeasure [1..1]

Значение атрибута

  • Значение атрибута должно быть задано одним из следующих способов:
    • указано value - точное значение атрибута
    • указано minValue и maxValue - интервал значений атрибута
099 ···············<dt:value>?</dt:value> bs:Decimal [0..1]

Точное значение (г/см3)

  • точность до 3-х знаков после запятой
100 ···············<dt:minValue>?</dt:minValue> bs:Decimal [0..1]

Минимальное значение (г/см3)

  • точность до 3-х знаков после запятой
101 ···············<dt:maxValue>?</dt:maxValue> bs:Decimal [0..1]

Максимальное значение (г/см3)

  • точность до 3-х знаков после запятой
102 ············</dt:attrValue>
103 ·········</dt:attribute>
104 ······</dt:additionalCharacteristics>
105 ···</dt:productItem>
106 </ws:getProductItemByUuidResponse>

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

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

См. также

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

Источник — http://help.vetrf.ru/index.php?title=MercuryG2B:GetProductItemByUuid:v3.0&oldid=38609