MercuryG2B:MergeStockEntries:v3.0

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

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

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

# Название XML-элемента Тип Обязат. Описание (нажмите [...] для отображения дополнительного описания)
001 <merc:mergeStockEntriesRequest>
002 ···<merc:localTransactionId>?<merc:localTransactionId> xs:NCName [1..1] Идентификатор заявки в клиентской системе
003 ···<merc:initiator> vd:User [1..1]

Пользователь, зарегистрированный в системе Меркурий и инициирующий запрос

  • Является ответственным за выполнение бизнес-операции.
  • Здесь потребуется логин ветврача или пользователя ХС. Логин для базовой аутентификации не подойдёт.
004 ······<vd:login>?</vd:login> xs:NCName [1..1] Логин пользователя
005 ···</merc:initiator>
006 ···<merc:enterprise> dt:Enterprise [1..1]

Площадка, на которой проводится операция

  • Указывается из списка мест осуществления деятельности для хозяйствующего субъекта.
  • Идентификатор предприятия, которое связано с хозяйствующим субъектом, инициировавшим запрос должен совпадать с идентификатором обслуживаемого вет. управлением предприятия, указанного в записи складского журнала участвующего в инвентаризации.
  • Обязательно указывать один из идентификаторов: uuid или guid; при указании обоих приоритет у uuid.
007 ······<bs:uuid>?</bs:uuid> bs:UUID [0..1] Идентификатор версии площадки
008 ······<bs:guid>?</bs:guid> bs:UUID [0..1] Глобальный идентификатор площадки
009 ···</merc:enterprise>
010 ···<merc:mergeOperation> vd:MergeStockEntriesOperation [1..1] Сведения, необходимые для объединения нескольких записей журнала
011 ······<vd:type>?</vd:type> bs:RegisterModificationType [0..1]

Тип операции (поддерживается два типа: MERGE и ATTACH)

  • Если элемент не указан, по умолчанию значение принимается равным MERGE.
  • В случае присоединения записей (ATTACH) главной записью журнала (к которой осуществляется присоединение), будет считаться первая запись sourceStockEntry из списка.
  • В случае присоединения элемент resultStockEntry не указывается, результирующая запись журнала будет иметь то же наименование продукции, что и главная.
  • Объём и количество упаковок будет просуммировано, вид упаковки, номера партий логически объединены в список.
012 ······<vd:sourceStockEntry> vd:StockEntry [2..*]

Позиции в складском журнале системы Меркурий (не менее двух)

  • Указанные позиции будут объединены в одну. Представляют собой идентификаторы версии записи (uuid) в ИС Меркурий.
013 ·········<bs:uuid>?</bs:uuid> bs:UUID [0..1] Идентификатор версии записи журнала
014 ······</vd:sourceStockEntry>
015 ······<vd:resultStockEntry> vd:StockEntry [0..1] Сведения, которые будут содержаться в объединенной записи журнала.
  • Не указывается в случае выбора операции присоединения (ATTACH)
016 ·········<vd:batch> vd:Batch [1..1] Сведения о партии продукции
017 ············<vd:subProduct> dt:SubProduct [1..1]

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

  • Обязательно должен быть указан один из идентификаторов: uuid или guid. При указании обоих приоритет у uuid.
018 ···············<bs:uuid>?</bs:uuid> bs:UUID [0..1] Идентификатор версии вида продукции
019 ···············<bs:guid>?</bs:guid> bs:UUID [0..1] Глобальный идентификатор вида продукции
020 ············</vd:subProduct>
021 ············<vd:productItem> dt:ProductItem [1..1]

Наименование продукции (номенклатура)

  • Если продукция задается из справочника (указывается один из идентификаторов uuid или guid), то остальные поля запроса игнорируются и могут быть не указаны.
  • Если продукция задается не из справочника, то обязательно должно быть указано наименование продукции (name) и опционально могут быть заданы артикул, GTIN, фасовка.
022 ···············<bs:uuid>?</bs:uuid> bs:UUID [0..1] Идентификатор версии номенклатуры
023 ···············<bs:guid>?</bs:guid> bs:UUID [0..1] Глобальный идентификатор номенклатуры
024 ···············<dt:globalID>?</dt:globalID> dt:GTINType [0..1] Trade Identification Number (GTIN)
025 ···············<dt:name>?</dt:name> bs:String255 [0..1] Наименование продукции
026 ···············<dt:code>?</dt:code> bs:String255 [0..1] Артикул (код) продукции в соответствии с внутренним кодификатором производителя
027 ···············<dt:packaging> dt:Packaging [0..1] Фасовка
028 ··················<dt:packagingType> dt:PackingType [1..1]

Тип упаковки

  • Упаковку может идентифицировать один из идентификаторов: uuid, guid или globalID - достаточно указать один из них.
  • При указании нескольких идентификаторов приоритет у uuid, потом у guid и globalID
  • Список сопоставлений uuid/guid/globalId находится тут - dt:PackingType
029 ·····················<bs:uuid>?</bs:uuid> bs:UUID [0..1] Идентификатор версии типа упаковки
030 ·····················<bs:guid>?</bs:guid> bs:UUID [0..1] Глобальный идентификатор упаковки
031 ·····················<dt:globalID>?</dt:globalID> dt:PackingCodeType [0..1] Уникальный идентификатор упаковки
032 ··················</dt:packagingType>
033 ··················<dt:quantity>?</dt:quantity> xs:integer [0..1] Количество единиц упаковки
034 ··················<dt:volume>?</dt:volume> bs:Decimal [0..1] Объём единицы упаковки
035 ··················<dt:unit> dt:Unit [0..1]

Единица измерения объёма единицы упаковки

  • Обязательно должен быть указан один из идентификаторов: uuid или guid. При указании обоих приоритет у uuid.
036 ·····················<bs:uuid>?</bs:uuid> bs:UUID [0..1] Идентификатор версии единицы измерения
037 ·····················<bs:guid>?</bs:guid> bs:UUID [0..1] Глобальный идентификатор единицы измерения
038 ··················</dt:unit>
039 ···············</dt:packaging>
040 ············</vd:productItem>
041 ············<vd:applicableClassifications> vd:BatchExtraInfo [0..1] Дополнительные характеристики партии
042 ···············<vd:classification> dt:ClassificationAttribute [0..1] Классификация продукции
043 ··················<dt:attrCode>INTENDED_USE</dt:attrCode> dt:CodeType [1..1] Код атрибута - Предназначение партии подконтрольной продукции
044 ··················<dt:attrName>Предназначение партии подконтрольной продукции</dt:attrName> bs:Ntext [0..1] Наименование атрибута
045 ··················<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 - для проведения ветеринарно-санитарной экспертизы
046 ··················<dt:className>?</dt:className> bs:Text [0..1]

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

  • Текстовое представление значения classCode:
    • В пищу людям
    • Для переработки с целью получения подконтрольных товаров, предназначенных в пищу людям
    • Для переработки с обеззараживанием с целью получения подконтрольных товаров, предназначенных в пищу людям
    • В корм животным
    • Для переработки с целью получения подконтрольных товаров, предназначенных в корм животным
    • Для медицинских целей
    • Для переработки с целью получения подконтрольных товаров, предназначенных для медицинских целей
    • Для биологических, ветеринарных и биотехнологических целей
    • Для переработки с целью получения подконтрольных товаров, предназначенных для биологических, ветеринарных и биотехнологических целей
    • Для диагностических и иных лабораторных исследований
    • Для технических целей
    • Для утилизации
    • Для уничтожения
    • Для проведения ветеринарно-санитарной экспертизы
047 ···············</vd:classification>
048 ···············<vd:attribute> dt:MeasuredAttribute [0..1] Дополнительный атрибут продукции
049 ··················<dt:attrCode>MILK_FAT_MASS_FRACTION</dt:attrCode> dt:CodeType [1..1]

Код атрибута - Массовая доля жира

  • атрибут может быть указан только для молока и молочной продукции
050 ··················<dt:attrName>Массовая доля жира</dt:attrName> bs:Ntext [0..1] Наименование атрибута
051 ··················<dt:attrValue> dt:ComplexMeasure [1..1]

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

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

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

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

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

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

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

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

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

  • в явном виде единица измерения может не указываться, так как на данный момент значение массовой доли жира может быть задано только в процентах (%)
056 ························<bs:uuid>?</bs:uuid> bs:UUID [0..1] Идентификатор версии единицы измерения
057 ························<bs:guid>?</bs:guid> bs:UUID [0..1] Глобальный идентификатор единицы измерения
058 ·····················</dt:unit>
059 ··················</dt:attrValue>
060 ···············</vd:attribute>
061 ···············<vd:attribute> dt:MeasuredAttribute [0..1] Дополнительный атрибут продукции
062 ··················<dt:attrCode>MILK_PROTEIN_MASS_FRACTION</dt:attrCode> dt:CodeType [1..1]

Код атрибута - Массовая доля белка

  • атрибут может быть указан только для молока и молочной продукции
063 ··················<dt:attrName>Массовая доля белка</dt:attrName> bs:Ntext [0..1] Наименование атрибута
064 ··················<dt:attrValue> dt:ComplexMeasure [1..1]

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

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

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

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

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

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

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

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

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

  • в явном виде единица измерения может не указываться, так как на данный момент значение массовой доли белка может быть задано только в процентах (%)
069 ························<bs:uuid>?</bs:uuid> bs:UUID [0..1] Идентификатор версии единицы измерения
070 ························<bs:guid>?</bs:guid> bs:UUID [0..1] Глобальный идентификатор единицы измерения
071 ·····················</dt:unit>
072 ··················</dt:attrValue>
073 ···············</vd:attribute>
074 ···············<vd:attribute> dt:MeasuredAttribute [0..1] Дополнительный атрибут продукции
075 ··················<dt:attrCode>DENSITY</dt:attrCode> dt:CodeType [1..1]

Код атрибута - Плотность

  • атрибут может быть указан только для молока и молочной продукции
076 ··················<dt:attrName>Плотность</dt:attrName> bs:Ntext [0..1] Наименование атрибута
077 ··················<dt:attrValue> dt:ComplexMeasure [1..1]

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

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

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

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

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

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

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

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

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

  • в явном виде единица измерения может не указываться, так как на данный момент значение плотности может быть задано только в граммах на сантиметр кубический (г/см3)
082 ························<bs:uuid>?</bs:uuid> bs:UUID [0..1] Идентификатор версии единицы измерения
083 ························<bs:guid>?</bs:guid> bs:UUID [0..1] Глобальный идентификатор единицы измерения
084 ·····················</dt:unit>
085 ··················</dt:attrValue>
086 ···············</vd:attribute>
087 ············</vd:applicableClassifications>
088 ·········</vd:batch>
089 ·········<vd:purpose> dt:Purpose [0..1]

Направление партии продукции

  • Обязательно должен быть указан один из идентификаторов: UUID или GUID. При указании обоих приоритет у UUID.
090 ············<bs:uuid>?</bs:uuid> bs:UUID [0..1] Идентификатор версии направления
091 ············<bs:guid>?</bs:guid> bs:UUID [0..1] Глобальный идентификатор направления
092 ·········</vd:purpose>
093 ······</vd:resultStockEntry>
094 ···</merc:mergeOperation>
095 </merc:mergeStockEntriesRequest>

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

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

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

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

TODO

См. также

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

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