MercuryG2B:UpdateVeterinaryEvents:v3.0

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

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

Код операции Описание операции
... Операция внесения сведений о ветеринарных мероприятиях (лабораторные исследования, иммунизация / обработка живых животных)

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

# Название XML-элемента Тип Обязат. Описание (нажмите [...] для отображения дополнительного описания)
001 <merc:updateVeterinaryEventsRequest>
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 ···<vd:stockEntry> dt:Enterprise [1..*] Сведения о записи журнала
011 ······<bs:guid>?</bs:guid> bs:UUID [1..1] Глобальный идентификатор записи журнала
012 ······<vd:vetEventList> vd:StockEntryEventList [0..1] Список ветеринарных мероприятий для партии продукции
013 ·········<vd:laboratoryResearch> vd:LaboratoryResearchEvent [0..*] Сведения о проведенных лабораторных исследованиях
014 ············<vd:ID>?</vd:ID> bs:Identifier [0..1]

Идентификатор события в разрезе записи складского журнала или вет.сертификата

  • Не задаётся пользователем в запросах (кроме запросов на редактирование), формируется системой автоматически.
  • Обновление возможно только для тех лабораторных исследований, для которых не было внесено результата.
015 ············<vd:actualDateTime>?</vd:actualDateTime> xs:DateTime [0..1]

Дата получения результата

  • Обязательно для заполнения в случае, если result = POSITIVE или NEGATIVE
016 ············<vd:operator> dt:Organization [1..1] Организация-оператор, осуществляющий мероприятие
017 ···············<dt:name>?</dt:name> dt:Organization [1..1] Название организации оператора
018 ············</vd:operator>
019 ············<vd:referencedDocument> vd:ReferencedDocument [0..*] Сведения о связанных документах
020 ···············<vd:issueNumber>?</vd:issueNumber> bs:String255 [0..1] Номер документа
021 ···············<vd:issueDate>?</vd:issueDate> xs:date [0..1] Дата оформления документа
022 ···············<vd:type>?</vd:type> dt:DocumentType [1..1] Тип документа = 9 (акт отбора проб)
023 ············</vd:referencedDocument>
024 ············<vd:notes>?</vd:notes> bs:Text [0..1] Дополнительные сведения
025 ············<vd:expertiseID>?</vd:expertiseID> bs:String255 [1..1] Номер экспертизы
026 ············<vd:indicator> bs:String255 [0..1]

Показатель безопасности (если не задано поле disease)

  • Использование элементов indicator и disease для передачи поля "Показатель" (в веб-интерфейсе) в запросах равнозначно.
  • Рекомендуется использовать поле indicator, так как возможность указывать поле disease было сохранено для совместимости с предыдущими версиями.
  • Задание в запросе обоих полей (indicator и disease) сразу приведёт к ошибке валидации по XSD-схеме.
027 ···············<dt:name>?</dt:name> bs:String255 [1..1] Название показателя
028 ············</vd:indicator>
029 ············<vd:disease> bs:String255 [0..1]

Болезнь (наименование показателя, если не задано поле indicator)

  • Использование элементов indicator и disease для передачи поля "Показатель" (в веб-интерфейсе) в запросах равнозначно.
  • Рекомендуется использовать поле indicator, так как возможность указывать поле disease было сохранено для совместимости с предыдущими версиями.
  • Задание в запросе обоих полей (indicator и disease) сразу приведёт к ошибке валидации по XSD-схеме.
030 ···············<dt:name>?</dt:name> bs:String255 [1..1] Наименование болезни (показателя)
031 ············</vd:disease>
032 ············<vd:method> dt:ResearchMethod [0..1]
033 ···············<dt:name>?</dt:name> bs:String255 [1..1] Название метода исследования
034 ············</vd:method>
035 ············<vd:result>?</vd:result> dt:ResearchResult [0..1]

Результат исследования

  • Допустимые значения: UNKNOWN, POSITIVE, NEGATIVE
036 ············<vd:conclusion>?</vd:conclusion> bs:Text [0..1]

Заключение

  • Обязательно для заполнения в случае, если result = POSITIVE или NEGATIVE
037 ·········</vd:laboratoryResearch>
038 ·········<vd:immunization> vd:AnimalMedicationEvent [0..*] Сведения о проведенной обработке/иммунизации животных
039 ············<vd:ID>?</vd:ID> bs:Identifier [0..1] Идентификатор события в разрезе записи складского журнала или вет.сертификата
040 ············<vd:actualDateTime>?</vd:actualDateTime> xs:DateTime [1..1] Дата события
041 ············<vd:notes>?</vd:notes> bs:Text [0..1] Дополнительные сведения
042 ············<vd:disease> dt:AnimalDisease [1..1] Заболевание
043 ···············<dt:name>?</dt:name> bs:String255 [1..1] Название заболевания
044 ············</vd:disease>
045 ············<vd:medicinalDrug> dt:MedicinalDrug [0..1] Препарат
046 ···············<dt:name>?</dt:name> bs:String255 [1..1] Название препарата
047 ···············<dt:series>?</dt:series> bs:String255 [1..1] Номер серии препарата/вакцины
048 ············</vd:medicinalDrug>
049 ············<vd:effectiveBeforeDate>?</vd:effectiveBeforeDate> xs:DateTime [0..1] Срок действия препарата/вакцины
050 ·········</vd:immunization>
051 ······</vd:vetEventList>
052 ···</vd:stockEntry>
053 </merc:updateVeterinaryEventsRequest>

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

# Название XML-элемента Тип Обязат. Описание (нажмите [...] для отображения дополнительного описания)
001 <merc:updateVeterinaryEventsResponse>
002 ···<vd:stockEntry> dt:StockEntry [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 ······<vd:entryNumber>?</vd:entryNumber> vd:StockEntryNumber [1..1] Номер записи журнала, доступный через веб-интерфейс
013 ······<vd:batch> vd:Batch [1..1] Сведения о партии продукции
014 ·········<vd:productType>?</vd:productType> dt:ProductType [1..1] Тип продукции. Первый уровень иерархического справочника продукции ИС Меркурий
015 ·········<vd:product> dt:Product [1..1] Продукция. Второй уровень иерархического справочника продукции ИС Меркурий
016 ············<bs:uuid>?</bs:uuid> bs:UUID [1..1] Идентификатор версии продукции
017 ············<bs:guid>?</bs:guid> bs:UUID [1..1] Глобальный идентификатор продукции
018 ·········</vd:product>
019 ·········<vd:subProduct> dt:SubProduct [1..1] Вид продукции. Третий уровень иерархического справочника продукции ИС Меркурий
020 ············<bs:uuid>?</bs:uuid> bs:UUID [1..1] Идентификатор версии вида продукции
021 ············<bs:guid>?</bs:guid> bs:UUID [1..1] Глобальный идентификатор вида продукции
022 ·········</vd:subProduct>
023 ·········<vd:productItem> dt:ProductItem [1..1] Наименование продукции в номенклатуре производителя
024 ············<bs:uuid>?</bs:uuid> bs:UUID [0..1] Идентификатор версии номенклатуры
025 ············<bs:guid>?</bs:guid> bs:UUID [0..1] Глобальный идентификатор номенклатуры
026 ············<dt:globalID>?</dt:globalID> dt:GTINType [0..1] Trade Identification Number (GTIN) - идентификационный номер продукции производителя
027 ············<dt:name>?</dt:name> bs:String255 [1..1] Наименование продукции
028 ············<dt:code>?</dt:code> bs:String255 [0..1] Артикул (код) продукции в соответствии с внутренним кодификатором производителя
029 ············<dt:packaging>?</dt:packaging> dt:Packaging [0..1] Фасовка
030 ············<dt:packagingType> dt:PackingType [1..1] Тип упаковки
031 ··················<bs:uuid>?</bs:uuid> bs:UUID [1..1] Идентификатор версии типа упаковки
032 ··················<bs:guid>?</bs:guid> bs:UUID [1..1] Глобальный идентификатор упаковки
033 ··················<dt:globalID>?</dt:globalID> dt:PackingCodeType [1..1] Уникальный идентификатор упаковки
034 ··················<dt:name>?</dt:name> bs:String255 [1..1] Наименование упаковки
035 ············</dt:packagingType>
036 ··················<dt:quantity>?</dt:quantity> xs:int [0..1] Количество единиц упаковки
037 ··················<dt:volume>?</dt:volume> bs:Decimal [0..1] Объём единицы упаковки товара
038 ···············<dt:unit> dt:Unit [0..1] Единица измерения объёма единицы упаковки товара
039 ··················<bs:uuid>?</bs:uuid> bs:UUID [1..1] Идентификатор версии единицы измерения
040 ··················<bs:guid>?</bs:guid> bs:UUID [1..1] Глобальный идентификатор единицы измерения
041 ··················<dt:name>?</dt:name> bs:String255 [1..1] Наименование единицы измерения
042 ···············</dt:unit>
043 ············</dt:packaging>
044 ·········</vd:productItem>
045 ·········<vd:volume>?</vd:volume> bs:Decimal [1..1] Объем продукции
046 ·········<vd:unit> dt:Unit [1..1] Единица измерения объема партии продукции
047 ············<bs:uuid>?</bs:uuid> bs:UUID [1..1] Идентификатор версии единицы измерения
048 ············<bs:guid>?</bs:guid> bs:UUID [1..1] Глобальный идентификатор единицы измерения
049 ·········</vd:unit>
050 ·········<vd:dateOfProduction> vd:GoodsDate [1..1] Дата выработки продукции
051 ············<vd:firstDate> dt:ComplexDate [0..1] Начальная дата в интервале, либо единичная дата
052 ···············<dt:year>?</dt:year> dt:Year [1..1] Год
053 ···············<dt:month>?</dtmonth> dt:Month [0..1] Месяц
054 ···············<dt:day>?</dt:day> dt:Day [0..1] День
055 ···············<dt:hour>?</dt:hour> dt:Hour [0..1] Час
056 ············</vd:firstDate>
057 ············<vd:secondDate> dt:ComplexDate [0..1] Конечная дата в интервале
058 ···············<dt:year>?</dt:year> dt:Year [1..1] Год
059 ···············<dt:month>?</dtmonth> dt:Month [0..1] Месяц
060 ···············<dt:day>?</dt:day> dt:Day [0..1] День
061 ···············<dt:hour>?</dt:hour> dt:Hour [0..1] Час
062 ············</vd:secondDate>
063 ············<vd:informalDate>?</vd:informalDate> bs:String255 [0..1] Текстовое значение даты
064 ·········<vd:dateOfProduction>
065 ·········<vd:expiryDate> vd:GoodsDate [0..1] Дата окончания срока годности продукции (кроме типа продукции "Живые животные")
066 ············<vd:firstDate> dt:ComplexDate [0..1] Начальная дата в интервале, либо единичная дата
067 ···············<dt:year>?</dt:year> dt:Year [1..1] Год
068 ···············<dt:month>?</dtmonth> dt:Month [0..1] Месяц
069 ···············<dt:day>?</dt:day> dt:Day [0..1] День
070 ···············<dt:hour>?</dt:hour> dt:Hour [0..1] Час
071 ············</vd:firstDate>
072 ············<vd:secondDate> dt:ComplexDate [0..1] Конечная дата в интервале
073 ···············<dt:year>?</dt:year> dt:Year [1..1] Год
074 ···············<dt:month>?</dtmonth> dt:Month [0..1] Месяц
075 ···············<dt:day>?</dt:day> dt:Day [0..1] День
076 ···············<dt:hour>?</dt:hour> dt:Hour [0..1] Час
077 ············</vd:secondDate>
078 ············<vd:informalDate>?</vd:informalDate> bs:String255 [0..1] Текстовое значение даты
079 ·········<vd:expiryDate>
080 ·········<vd:batchID>?</vd:batchID> bs:String255 [0..*] Уникальный идентификатор производственной партии продукции
081 ·········<vd:perishable>?</vd:perishable> xs:boolean [1..1]

Описывает, является ли продукция скоропортящейся

  • true – скоропортящаяся
  • false – не скоропортящаяся
082 ·········<vd:origin> vd:BatchOrigin [0..1] Сведения о происхождении продукции
083 ············<vd:productItem> dt:ProductItem [1..1]

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

  • Номенклатура производителя, с которой была выпущена продукция
  • В некоторых случаях может отсутствовать в зависимости от истории появления/изменения записи журнала (например, после объединения записей журнала с разной номенклатурой разных производителей)
084 ···············<bs:uuid>?</bs:uuid> bs:UUID [0..1] Идентификатор версии номенклатуры
085 ···············<bs:guid>?</bs:guid> bs:UUID [0..1] Глобальный идентификатор номенклатуры
086 ···············<dt:globalID>?</dt:globalID> dt:GTINType [0..1] Trade Identification Number (GTIN) - идентификационный номер продукции производителя
087 ···············<dt:name>?</dt:name> bs:String255 [1..1] Наименование продукции
088 ···············<dt:code>?</dt:code> bs:String255 [0..1] Артикул (код) продукции в соответствии с внутренним кодификатором производителя
089 ············</dt:productItem
090 ············<vd:country> dt:Country [1..1] Страна происхождения партии продукции
091 ···············<bs:uuid>?</bs:uuid> bs:UUID [1..1] Идентификатор версии страны
092 ···············<bs:guid>?</bs:guid> bs:UUID [1..1] Глобальный идентификатор страны
093 ···············<dt:name>?</dt:name> bs:String255 [1..1] Наименование производителя
094 ············</vd:country>
095 ············<vd:producer> dt:Producer [1..*] Производитель продукции
096 ···············<dt:enterprise> dt:Enterprise [1..1]

Информация о предприятии-производителе продукции

  • Если производитель в записи журнала существовал не из справочника (например, для импортного сертификата), то может быть возвращено поле name с отсутствием uuid/guid
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 [0..1] Наименование производителя
100 ···············</dt:enterprise>
101 ··················<dt:role>?</dt:role> dt:EnterpriseRole [1..1] Роль предприятия-производителя продукции
102 ············</vd:producer>
103 ·········</vd:origin>
104 ·········<vd:lowGradeCargo>?</vd:lowGradeCargo> xs:boolean [1..1]

Флаг: является ли груз некачественным

  • true – груз некачественный
  • false – груз качественный
105 ·········<vdpackageList> dt:PackageList [0..1] Список физической упаковки
106 ············<vd:package> dt:Package [1..*]

Описание упаковки

  • Поддерживается указание многоуровневой упаковки и маркировки партии продукции
  • Всего предусмотрено шесть уровней упаковки (см. тип dt:PackageLevelType)
  • Количество единиц упаковки и маркировка партии указывается для каждой упаковки конкретного уровня отдельно
  • На каждом уровне может быть произвольное количество типов упаковки, в том числе и ни одного, т.е. какого-то уровня упаковки в описании партии продукции может не быть
107 ···············<dt:level>?</dt:level> dt:PackageLevelType [1..1]

Уровень упаковки

  • Список возможных значений находится тут - dt:PackageLevelType
108 ···············<dt:packingType> dt:PackingType [1..1]

Тип упаковки

  • Список сопоставлений uuid/guid/globalId находится тут - dt:PackingType
109 ··················<bs:uuid>?</bs:uuid> bs:UUID [1..1] Идентификатор версии упаковки
110 ··················<bs:guid>?</bs:guid> bs:UUID [1..1] Глобальный идентификатор упаковки
111 ··················<dt:globalID>?</dt:globalID> dt:PackingCodeTyp [1..1]

Идентификатор упаковки по классификатору ЕК 013-2010 (ред.1)

  • Идентификатор упаковки по классификатору ЕК 013-2010 (ред.1)
112 ··················<dt:name>?</dt:name> bs:String255 [1..1] Наименование упаковки
113 ···············</dt:packingType>
114 ···············<dt:quantity>?</dt:quantity> xs:int [0..1] Количество единиц упаковки
115 ···············<dt:productMarks class="BN">?</dt:productMarks> dt:ProductMarks [0..*]

Маркировка партии продукции

116 ············</dt:package>
117 ·········</vd:packageList>
118 ·········<vd:owner> dt:BusinessEntity [1..1] Фирма-владелец продукции
119 ············<bs:uuid>?</bs:uuid> bs:UUID [1..1] Идентификатор версии хозяйствующего субъекта-владельца
120 ············<bs:guid>?</bs:guid> bs:UUID [1..1] Глобальный идентификатор хозяйствующего субъекта-владельца
121 ·········</vd:owner>
122 ······</vd:batch>
123 ······<vd:vetDocument> vd:VetDocument [0..*]
124 ·········<bs:uuid>?</bs:uuid> bs:UUID [1..1] Идентификатор связанного с записью журнала ВСД
125 ······</vd:vetDocument>
126 ······<vd:vetEventList> vd:StockEntryEventList [0..1] Список ветеринарных мероприятий для партии продукции
127 ·········<vd:laboratoryResearch> vd:LaboratoryResearchEvent [0..*] Сведения о проведенных лабораторных исследованиях
128 ············<vd:ID>?</vd:ID> bs:Identifier [0..1] Идентификатор события в разрезе записи складского журнала или вет.сертификата
129 ············<vd:type>?</vd:type> vd:VeterinaryEventType [1..1] Тип мероприятия
130 ············<vd:actualDateTime>?</vd:actualDateTime> xs:DateTime [1..1] Дата события
131 ············<vd:operator> dt:Organization [1..1] Организация-оператор, осуществляющий мероприятие
132 ···············<dt:name>?</dt:name> bs:String255 [1..1] Название организации оператора
133 ············</vd:operator>
134 ············<vd:referencedDocument> vd:ReferencedDocument [1..*] Сведения о связанных документах
135 ···············<vd:issueNumber>?</vd:issueNumber> bs:String255 [0..1] Номер документа
136 ···············<vd:issueDate>?</vd:issueDate> xs:date [0..1] Дата оформления документа
137 ···············<vd:type>?</vd:type> dt:DocumentType [1..1] Тип документа = 9 (акт отбора проб)
138 ············</vd:referencedDocument>
139 ············<vd:notes>?</vd:notes> bs:Text [0..1] Дополнительные сведения
140 ············<vd:expertiseID>?</vd:expertiseID> bs:String255 [1..1] Номер экспертизыя
141 ············<vd:indicator> bs:String255 [0..1] Показатель безопасности
142 ···············<dt:name>?</dt:name> bs:String255 [1..1] Название показателя
143 ············</vd:indicator>
144 ············<vd:method> dt:ResearchMethod [0..1] Метод исследования
145 ···············<dt:name>?</dt:name> bs:String255 [1..1] Название метода исследования
146 ············</vd:method>
147 ············<vd:result>?</vd:result> dt:ResearchResult [0..1] Результат исследования
148 ············<vd:conclusion>?</vd:conclusion> bs:Text [0..1] Заключение
149 ·········</vd:laboratoryResearch>
150 ·········<dt:immunization> vd:AnimalMedicationEvent [0..*] Сведения о проведенной обработке/иммунизации животных
151 ············<vd:ID>?</vd:ID> bs:Identifier [0..1] Идентификатор события в разрезе записи складского журнала или вет.сертификата
152 ············<vd:type>?</vd:type> vd:VeterinaryEventType [1..1] Тип мероприятия
153 ············<vd:actualDateTime>?</vd:actualDateTime> xs:DateTime [1..1] Дата события
154 ············<vd:notes>?</vd:notes> bs:Text [0..1] Дополнительные сведения
155 ············<vd:disease> dt:AnimalDisease [1..1] Заболевание
156 ···············<dt:name>?</dt:name> bs:String255 [1..1] Название заболевания
157 ············</vd:disease>
158 ············<vd:medicinalDrug> dt:AnimalDisease [0..1] Заболевание
159 ···············<dt:name>?</dt:name> bs:String255 [1..1] Название препарата
160 ···············<dt:series>?</dt:series> bs:String255 [1..1] Номер серии препарата/вакцины
161 ············</vd:medicinalDrug>
162 ············<vd:effectiveBeforeDate>?</vd:effectiveBeforeDate> xs:DateTime [0..1] Срок действия препарата/вакцины
163 ·········</vd:immunization>
164 ······</vd:vetEventList>
165 ···</vd:stockEntry>
166 </merc:updateVeterinaryEventsResponse>

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

TODO

См. также

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

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