MercuryG2B:GetProductItemByGuid:v3.0

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

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

  1. Операция GetProductItemByGuid предназначена для получения последней актуальной (last = true, active = true) записи о номенклатуре по её глобальному идентификатору.
  2. Глобальный идентификатор присваивается номенклатуре при добавлении её в справочник с помощью операции MercuryG2B:ModifyProducerStockList:v3.0.

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

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

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

# Название XML-элемента Тип Обязат. Описание (нажмите [...] для отображения дополнительного описания)
001 <ws:getProductItemByGuidResponse>
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 ······<dt:globalID>?</dt:globalID> dt:GTINType [0..1]

Trade Identification Number (GTIN)

  • идентификационный номер продукции производителя
012 ······<dt:name>?</dt:name> bs:String255 [0..1] Наименование номенклатуры
013 ······<dt:code>?</dt:code> bs:String255 [0..1]

Артикул

  • код продукции в соответствии с внутренним кодификатором производителя
014 ······<dt:productType>?</dt:productType> dt:ProductType [1..1]

Тип продукции

  • первый уровень иерархического справочника продукции ИС Меркурий
015 ······<dt:product> dt:Product [1..1]

Продукция

  • второй уровень иерархического справочника продукции ИС Меркурий
016 ·········<bs:uuid>?</bs:uuid> bs:UUID [1..1] Идентификатор версии записи
017 ·········<bs:guid>?</bs:guid> bs:UUID [1..1] Глобальный идентификатор записи
018 ·········<dt:name>?</dt:name> bs:String255 [0..1] Наименование продукции
019 ······</dt:product>
020 ······<dt:subProduct> dt:SubProduct [1..1]

Вид продукции

  • третий уровень иерархического справочника продукции ИС Меркурий
021 ·········<bs:uuid>?</bs:uuid> bs:UUID [1..1] Идентификатор версии записи
022 ·········<bs:guid>?</bs:guid> bs:UUID [1..1] Глобальный идентификатор записи
023 ·········<dt:name>?</dt:name> bs:String255 [0..1] Наименование вида продукции
024 ······</dt:subProduct>
025 ······<dt:correspondsToGost>?</dt:correspondsToGost> xs:boolean [1..1] Соответствие ГОСТ
026 ······<dt:gost>?</dt:gost> bs:String255 [0..1] ГОСТ
027 ······<dt:producer> dt:BusinessEntity [0..1] Хозяйствующий субъект (ХС) производитель продукции
028 ·········<bs:uuid>?</bs:uuid> bs:UUID [1..1] Идентификатор версии ХС
029 ·········<bs:guid>?</bs:guid> bs:UUID [1..1] Глобальный идентификатор ХС
030 ·········<dt:name>?</dt:name> bs:String255 [0..1] Наименование ХС
031 ·········<dt:fio>?</dt:fio> bs:String255 [0..1] ФИО ХС
032 ······</dt:producer>
033 ······<dt:tmOwner> dt:BusinessEntity [0..1] ХС-собственник торговой марки
034 ·········<bs:uuid>?</bs:uuid> bs:UUID [1..1] Идентификатор версии ХС
035 ·········<bs:guid>?</bs:guid> bs:UUID [1..1] Глобальный идентификатор ХС
036 ·········<dt:name>?</dt:name> bs:String255 [0..1] Наименование ХС
037 ·········<dt:fio>?</dt:fio> bs:String255 [0..1] ФИО ХС
038 ······</dt:tmOwner>
039 ······<dt:producing> dt:ProductItemProducing [0..*] Список площадок, на которых выпускается данная продукция
040 ········<dt:location> dt:Enterprise [1..1] Площадка, осуществляющая выпуск продукции
041 ············<bs:uuid>?</bs:uuid> bs:UUID [1..1] Идентификатор версии площадки
042 ············<bs:guid>?</bs:guid> bs:UUID [1..1] Глобальный идентификатор площадки
043 ············<dt:name>?</dt:name> bs:String255 [0..1] Наименование площадки
044 ·········</dt:location>
045 ······</dt:producing>
046 ······<dt:packaging> dt:Packaging [0..1] Фасовка
047 ·········<dt:packagingType> dt:PackingType [1..1] Тип упаковки
048 ············<bs:uuid>?</bs:uuid> bs:UUID [1..1] Идентификатор версии типа упаковки
049 ············<bs:guid>?</bs:guid> bs:UUID [1..1] Глобальный идентификатор упаковки
050 ············<dt:globalID>?</dt:globalID> dt:PackingCodeType [1..1] Уникальный идентификатор упаковки
051 ············<dt:name>?</dt:name> bs:String255 [1..1] Наименование упаковки
052 ·········</dt:packagingType>
053 ·········<dt:quantity>?</dt:quantity> xs:integer [0..1] Количество единиц упаковки
054 ·········<dt:volume>?</dt:volume> bs:Decimal [0..1] Объём единицы упаковки товара
055 ·········<dt:unit> dt:Unit [0..1] Единица измерения объёма единицы упаковки товара
056 ············<bs:uuid>?</bs:uuid> bs:UUID [1..1] Идентификатор версии единицы измерения
057 ············<bs:guid>?</bs:guid> bs:UUID [1..1] Глобальный идентификатор единицы измерения
058 ············<dt:name>?</dt:name> bs:String255 [1..1] Наименование единицы измерения
059 ·········</dt:unit>
060 ······</dt:packaging>
061 ······<dt:additionalCharacteristics> dt:ProductItemCharacterictics [0..1] Дополнительные характеристики продукции
062 ·········<dt:classification> dt:ClassificationAttribute [0..1] Классификация продукции
063 ············<dt:attrCode listID="?" listAgencyID="?" listName="?" listVersionID="?" name="?">PRODUCT_CATEGORY</dt:attrCode> dt:CodeType [1..1] Код атрибута - Категория продукции
064 ············<dt:attrName>Категория продукции</dt:attrName> bs:Ntext [1..1] Наименование атрибута
065 ············<dt:classCode listID="?" listAgencyID="?" listName="?" listVersionID="?" name="?">?</dt:classCode> dt:CodeType [1..1]

Код значения атрибута "Категория продукции"

  • Возможные значения:
    • UNDEFINED - категория не определена
    • UNCLASSIFIED – не классифицировано
    • RAW – сырец, исходное сырьё
    • INTERMEDIATE – полуфабрикат
    • CONSUMER_PACKAGED – готовая продукция (в потреб. упаковке)
066 ············<dt:className>?</dt:className> bs:Text [1..1]

Наименование значения атрибута

  • Текстовое представление значения classCode:
    • Категория не определена
    • Не классифицировано
    • Сырец, исходное сырьё
    • Полуфабрикат
    • Готовая продукция (в потребительской упаковке)
067 ·········</dt:classification>
068 ·········<dt:attribute> dt:MeasuredAttribute [0..1] Дополнительный атрибут продукции
069 ············<dt:attrCode listID="?" listAgencyID="?" listName="?" listVersionID="?" name="?">MILK_FAT_MASS_FRACTION</dt:attrCode> dt:CodeType [1..1] Код атрибута - Массовая доля жира
070 ············<dt:attrName>Массовая доля жира</dt:attrName> bs:Ntext [1..1] Наименование атрибута
071 ············<dt:attrValue> dt:ComplexMeasure [1..1]

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

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

Точное значение

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

Минимальное значение

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

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

  • точность до 3-х знаков после запятой
075 ···············<dt:unit> dt:Unit [0..1]

Единица измерения значения атрибута

  • значение массовой доли жира указывается в процентах (%)
076 ··················<bs:uuid>?</bs:uuid> bs:UUID [1..1] Идентификатор версии единицы измерения
077 ··················<bs:guid>?</bs:guid> bs:UUID [1..1] Глобальный идентификатор единицы измерения
078 ··················<dt:name>?</dt:name> bs:String255 [1..1] Наименование единицы измерения
079 ···············</dt:unit>
080 ············</dt:attrValue>
081 ·········</dt:attribute>
082 ·········<dt:attribute> dt:MeasuredAttribute [0..1] Дополнительный атрибут продукции
083 ············<dt:attrCode listID="?" listAgencyID="?" listName="?" listVersionID="?" name="?">MILK_PROTEIN_MASS_FRACTION</dt:attrCode> dt:CodeType [1..1] Код атрибута - Массовая доля белка
084 ············<dt:attrName>Массовая доля белка</dt:attrName> bs:Ntext [1..1] Наименование атрибута
085 ············<dt:attrValue> dt:ComplexMeasure [1..1]

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

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

Точное значение

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

Минимальное значение

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

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

  • точность до 3-х знаков после запятой
089 ···············<dt:unit> dt:Unit [0..1]

Единица измерения значения атрибута

  • значение массовой доли белка указывается в процентах (%)
090 ··················<bs:uuid>?</bs:uuid> bs:UUID [1..1] Идентификатор версии единицы измерения
091 ··················<bs:guid>?</bs:guid> bs:UUID [1..1] Глобальный идентификатор единицы измерения
092 ··················<dt:name>?</dt:name> bs:String255 [1..1] Наименование единицы измерения
093 ···············</dt:unit>
094 ············</dt:attrValue>
095 ·········</dt:attribute>
096 ·········<dt:attribute> dt:MeasuredAttribute [0..1] Дополнительный атрибут продукции
097 ············<dt:attrCode listID="?" listAgencyID="?" listName="?" listVersionID="?" name="?">DENSITY</dt:attrCode> dt:CodeType [1..1] Код атрибута - Плотность
098 ············<dt:attrName>Плотность</dt:attrName> bs:Ntext [1..1] Наименование атрибута
099 ············<dt:attrValue> dt:ComplexMeasure [1..1]

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

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

Точное значение

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

Минимальное значение

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

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

  • точность до 3-х знаков после запятой
103 ···············<dt:unit> dt:Unit [0..1]

Единица измерения значения атрибута

  • значение плотности указывается в граммах на кубический сантиметр (г/см3)
104 ··················<bs:uuid>?</bs:uuid> bs:UUID [1..1] Идентификатор версии единицы измерения
105 ··················<bs:guid>?</bs:guid> bs:UUID [1..1] Глобальный идентификатор единицы измерения
106 ··················<dt:name>?</dt:name> bs:String255 [1..1] Наименование единицы измерения
107 ···············</dt:unit>
108 ············</dt:attrValue>
109 ·········</dt:attribute>
110 ······</dt:additionalCharacteristics>
111 ···</dt:productItem>
112 </ws:getProductItemByGuidResponse>
Источник — http://help.vetrf.ru/index.php?title=MercuryG2B:GetProductItemByGuid:v3.0&oldid=37877