TransportOperationForVetControl

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

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

Операция TransportOperationForVetControl предназначена для оформления в системе Меркурий транспортной партии. На вход системы передаются следующие сведения:

  • информация об одной или нескольких партиях продукции, из которых будет сформирована транспортная партия;
  • сведения о получателе транспортной партии;
  • сведения о транспортном средстве и маршруте его следования;
  • дополнительные сведения необходимые для оформления ветеринарно-сопроводительного документа (ВСД), например, результат ветеринарно-санитарной экспертизы, сведения о ТТН, особые отметки и т.д.

Результатом выполнения данной операции является:

  • списание объема с одной или нескольких записей журнала продукции, которые были указаны в заявке;
  • гашение производственной сертификата, если был указан весь объем по данной записи журнала вырабатываемой продукции;
  • для каждого наименования продукции указанного в транспортной партии, система Меркурий формирует ветеринарно-сопроводительный документ (ВСД).

Возможные сценарии

При выполнении операции возможны следующие сценарии.

1. В транспортной партии используется ранее выработанная на данном предприятии партия продукции:
1.1. Выработанная продукция с указанной записи журнала была полностью израсходована (отгружена), т.е. объём продукции для записи журнала после списания стал равен нулю.
  • Происходит списание объёмов с одной или нескольких записей журнала.
  • Одна или несколько записей журнала вырабатываемой продукции, объем которых израсходован, переходит в категорию "оформленных".
  • Оформляется ВСД на каждое наименование отгружаемой продукции.
  • Происходит гашение производственных сертификатов, объем которых был израсходован.
1.2. Выработанная продукция с указанной записи журнала не была полностью израсходована, т.е. объём продукции для записи журнала после списания – больше нуля.
  • Происходит списание объёмов с одной или нескольких записей журнала.
  • Оформляется ВСД на каждое наименование отгружаемой продукции.
2. В транспортной партии используется одна или несколько партий продукции из входного журнала:
2.1. Входящая продукция с указанной записи журнала была полностью израсходована (отгружена), т.е. объём продукции для записи журнала после списания стал равен нулю.
  • Происходит списание объёмов с одной или нескольких записей журнала.
  • Одна или несколько записей журнала входной продукции объем которых израсходован переходит в категорию "оформленных".
  • Оформляется ВСД на каждое наименование отгружаемой продукции.
2.2. Входящая продукция с указанной записи журнала не была полностью израсходована, т.е. объём продукции для записи журнала после списания – больше нуля.
  • Происходит списание объёмов с одной или нескольких записей журнала.
  • Оформляется ВСД на каждое наименование отгружаемой продукции.

Используемые пространства имён и типы

Данные запроса

Структура данных запроса в формате ХML.

<merc:prepareOutcomingConsignmentRequest>
    <vet:deliveryDate>{xs:dateTime}</vet:deliveryDate>
    <vet:consignor>
        <ent:businessEntity>
            <base:guid>{bs:UUID}</base:guid>
        </ent:businessEntity>
        <ent:enterprise>
            <base:guid>{bs:UUID}</base:guid>
        </ent:enterprise>
    </vet:consignor>
    <vet:consignee>
        <ent:businessEntity>
            <base:guid>{bs:UUID}</base:guid>
        </ent:businessEntity>
        <ent:enterprise>
            <base:guid>{bs:UUID}</base:guid>
        </ent:enterprise>
    </vet:consignee>
    <vet:consignment>
        <vet:volume>{bs:Decimal}</vet:volume>
        <vet:unit>
            <base:uuid>{bs:UUID}</base:uuid>
        </vet:unit>
        <vet:packingList>
            <com:packingForm>
                <base:uuid>{bs:UUID}</base:uuid>
            </com:packingForm>
        </vet:packingList>
        <vet:packingAmount>{xs:int}</vet:packingAmount>
        <vet:sourceStockEntry>
            <base:uuid>{bs:UUID}</base:uuid>
        </vet:sourceStockEntry>
    </vet:consignment>
    <vet:accompanyingForms>
        <vet:waybill>
            <shp:issueSeries>{bs:String255}</shp:issueSeries>
            <shp:issueNumber>{bs:String255}</shp:issueNumber>
            <shp:issueDate>{xs:date}</shp:issueDate>
            <shp:type>{shp:WaybillType}</shp:type>
            <shp:broker>
                <base:guid>{bs:UUID}</base:guid>
            </shp:broker>
            <shp:transportInfo>
                <shp:transportType>{shp:TransportType}</shp:transportType>
                <shp:transportNumber>
                    <shp:vehicleNumber>{bs:String255}</shp:vehicleNumber>
                </shp:transportNumber>
            </shp:transportInfo>
            <shp:transportStorageType>{shp:TransportationStorageType}</shp:transportStorageType>
            <shp:cargoReloadingPointList>
                <shp:cargoReloadingPoint>
                    <shp:name>{bs:String255}</shp:name>
                    <shp:nextTransport>
                        <shp:transportType>{shp:TransportType}</shp:transportType>
                        <shp:transportNumber>
                            <shp:vehicleNumber>{bs:String255}</shp:vehicleNumber>
                        </shp:transportNumber>
                    </shp:nextTransport>
                </shp:cargoReloadingPoint>
            </shp:cargoReloadingPointList>
        </vet:waybill>
        <vet:vetCertificate>
            <vet:purpose>
                <base:guid>{bs:UUID}</base:guid>
            </vet:purpose>
            <vet:broker>
                <base:guid>{bs:UUID}</base:guid>
            </vet:broker>
            <vet:transportInfo>
                <shp:transportType>{shp:TransportType}</shp:transportType>
                <shp:transportNumber>
                    <shp:vehicleNumber>{bs:String255}</shp:vehicleNumber>
                </shp:transportNumber>
            </vet:transportInfo>
            <vet:transportStorageType>{shp:TransportationStorageType}</vet:transportStorageType>
            <vet:cargoReloadingPointList>
                <shp:cargoReloadingPoint>
                    <shp:name>{bs:String255}</shp:name>
                    <shp:nextTransport>
                        <shp:transportType>{shp:TransportType}</shp:transportType>
                        <shp:transportNumber>
                            <shp:vehicleNumber>{bs:String255}</shp:vehicleNumber>
                        </shp:transportNumber>
                    </shp:nextTransport>
                </shp:cargoReloadingPoint>
            </vet:cargoReloadingPointList>
            <vet:cargoInspected>{xs:boolean}</vet:cargoInspected>
            <vet:cargoExpertized>{xs:boolean}</vet:cargoExpertized>
            <vet:expertiseInfo>{bs:String255}</vet:expertiseInfo>
            <vet:confirmedBy>
                <com:fio>{bs:String255}</com:fio>
                <com:post>{bs:String255}</com:post>
            </vet:confirmedBy>
            <vet:locationProsperity>{bs:String255}</vet:locationProsperity>
            <vet:animalSpentPeriod>{vetd:AnimalSpentPeriod}</vet:animalSpentPeriod>
            <vet:monthsSpent>{bs:String255}</vet:monthsSpent>
            <vet:quarantinePlace>{bs:String255}</vet:quarantinePlace>
            <vet:quarantineDays>{xs:int}</vet:quarantineDays>
            <vet:immunizationInfo>{bs:String255}</vet:immunizationInfo>
            <vet:precedingVetDocuments>{bs:String255}</vet:precedingVetDocuments>
            <vet:transferPermit>
                <com:issueNumber>{bs:String255}</com:issueNumber>
                <com:issueDate>{xs:date}</com:issueDate>
            </vet:transferPermit>
            <vet:specialMarks>{bs:String255}</vet:specialMarks>
        </vet:vetCertificate>
    </vet:accompanyingForms>
</merc:prepareOutcomingConsignmentRequest>

Объект prepareOutcomingConsignmentRequest

Корневой элемент содержимого заявки. Определяет тип заявки и соответствие с описанием в библиотеке типов.

Поле Описание Тип Обязательность
localTransactionId Идентификатор заявки в клиентской системе. xs:NCName 1
initiator Пользователь, зарегистрированный в системе Меркурий и инициирующий запрос к шлюзу. Ответственный за выполнение бизнес-операции. Должен быть указан или идентификатор, или логин пользователя в системе Меркурий. argc:User 1
delivery Сведения для оформления транспортного ВСД. vetd:Delivery 1

Объект ..Request/initiator

Содержит сведения о пользователе, зарегистрированном в системе Меркурий и инициирующим запрос к шлюзу.

Поле Описание Тип Обязательность
UUID Идентификатор пользователя, зарегистрированного в системе Меркурий. bs:UUID 0..1
login Логин пользователя, зарегистрированного в системе Меркурий. Обязательно указывать один из параметров. В случае, если указаны оба, приоритет будет за UUID xs:NCName 0..1

Объект ..Request/delivery

Объект содержит сведения, необходимые для оформления транспортной партии.

Поле Описание Тип Обязательность
deliveryDate Дата оформления транспортной партии. xs:dateTime 1
consignor Сведения об отправителе (владельце). Содержит сведения о хозяйствующем субъекте-владельце продукции и предприятии-отправителе.
  • При оформлении транспортной партии сведения об отправителе (хозяйствующем субъекте-владельце продукции и предприятии-отправителе) должны совпадать со сведениями о хозяйствующем субъекте-инициаторе запроса и предприятии, инициировавшим запрос.
ent:BusinessMember 1
consignee Сведения о получателе продукции (хозяйствующем субъекте-получателе продукции и предприятии-получателе).
  • В случае если перевозка осуществляется без смены владельца продукции, то хозяйствующих субъект-владелец остается таким же, как и в поле consignor.
  • Предприятие-получатель может отсутствовать в случае, если выбрана транзакция типа "смена владельца без перевозки".
ent:BusinessMember 1
consignment Сведения о транспортной партии. vetd:Consignment 1..*
accompanyingForms Дополнительные сведения, необходимые для оформления ветеринарно-сопроводительного документа. vetd:ConsignmentDocumentList 1

Объект ..Request/delivery/consignor

Объект содержит сведения об отправителе (владельце) продукции.

Поле Описание Тип Обязательность
businessEntity Информация о хозяйствующем субъекте-отправителе транспортной партии. ent:BusinessEntity 1
enterprise Информация о предприятии-отправителе транспортной партии. ent:Enterprise 1

Объект ..Request/delivery/consignor/businessEntity

Объект содержит сведения о хозяйствующем субъекте.

Поле Описание Тип Обязательность
UUID Идентификатор версии хозяйствующего субъекта. bs:UUID 1 - обязательно должно быть заполнено хотя бы одно из полей, либо UUID, либо GUID.

При указании обоих полей, приоритет у UUID.

GUID Глобальный идентификатор хозяйствующего субъекта. bs:UUID

Объект ..Request/delivery/consignor/enterprise

Объект содержит сведения о площадке (поднадзорном объекте).

Поле Описание Тип Обязательность
UUID Идентификатор версии предприятия. bs:UUID 1 - обязательно должно быть заполнено хотя бы одно из полей, либо UUID, либо GUID.

При указании обоих полей, приоритет у UUID.

GUID Глобальный идентификатор предприятия. bs:UUID

Объект ..Request/delivery/consignee

Объект содержит сведения о получателе транспортной партии.

Поле Описание Тип Обязательность
businessEntity Информация о хозяйствующем субъекте-получателе транспортной партии. Хозяйствующий субъект-получатель может быть не указан. Тогда считается, что перевозка осуществляется без смены владельца. В этом случае обязательно должно быть указано предприятие-получатель, поле enterprise. ent:businessEntity 0..1
enterprise Информация о предприятии-получателе транспортной партии. Предприятие-получатель может быть не указано. Тогда считается, что, происходит смена владельца без перевозки. В этом случае обязательно должно быть указан хозяйствующий субъект-получатель, поле businessEntity. ent:Enterprise 0..1

Объект ..Request/delivery/consignee/businessEntity

Объект содержит сведения о хозяйствующем субъекте.

Поле Описание Тип Обязательность
UUID Идентификатор версии хозяйствующего субъекта. bs:UUID 1 - обязательно должно быть заполнено хотя бы одно из полей, либо UUID, либо GUID.

При указании обоих полей, приоритет у UUID.

GUID Глобальный идентификатор хозяйствующего субъекта. bs:UUID

Объект ..Request/delivery/consignee/enterprise

Объект содержит сведения о площадке (поднадзорном объекте).

Поле Описание Тип Обязательность
UUID Идентификатор версии предприятия. bs:UUID 1 - обязательно должно быть заполнено хотя бы одно из полей, либо UUID, либо GUID.

При указании обоих полей, приоритет у UUID.

GUID Глобальный идентификатор предприятия. bs:UUID

Объект ..Request/delivery/consignment

Объект содержит сведения о транспортной партии.

Поле Описание Тип Обязательность
volume Объём отгружаемой продукции.
  • Указанное значение должно быть больше нуля.
  • Указанное значение не должно превышать объём продукции в записи складского журнала продукции.
bs:Decimal 1
unit Единица измерения объема отгружаемой продукции.
  • Соответствующая версия единицы измерения в ИС Меркурий должна быть актуальной и неудалённой.
argc:Unit 1
packingList Список видов упаковки, которые используются для отгружаемой партии. argc:PackingFormList 0..1
packingAmount Количество единиц упаковки для отгружаемой партии.
  • Указанное значение должно быть больше, либо равно нулю и не превышать количество единиц упаковки, указанное в записи складского журнала продукции.
xs:int 0..1
sourceStockEntry Позиция в складском журнале системы Меркурий. С указанной позиции будет списан объем отгружаемой продукции для данной транспортной партии. Представляет собой идентификатор версии записи (uuid) или идентификатор записи (guid) в ИС Меркурий.
  • Указанная версия записи (uuid) складского журнала продукции в ИС Меркурий должна быть актуальной, неаннулированной и неудалённой.
  • Объём продукции по этой позиции должен быть больше нуля.
vetd:StockEntry 1

Объект ..Request/delivery/consignment/unit

Объект содержит сведения о единице измерения объема продукции.

Поле Описание Тип Обязательность
UUID Идентификатор версии записи справочника единиц измерения. bs:UUID 1 - обязательно должно быть заполнено хотя бы одно из полей, либо UUID, либо GUID.

При указании обоих полей, приоритет у UUID.

GUID Глобальный идентификатор записи справочника единиц измерения. bs:UUID

Объект ..Request/delivery/consignment/packingList

Объект содержит сведения о cписке видов упаковки, которые используются для транспортной партии.

Поле Описание Тип Обязательность
packingForm Вид упаковки.
  • Соответствующая версия упаковки в ИС Меркурий должна быть актуальной и неудалённой.
argc:PackingForm 0..1

Объект ..Request/delivery/consignment/packingList/packingForm

Объект содержит сведения о виде упаковки, которая используются для транспортной партии.

Поле Описание Тип Обязательность
UUID Идентификатор упаковки. bs:UUID 1
name Наименование конкретного вида упаковки. bs:String255 0..1

Объект ..Request/delivery/consignment/sourceStockEntry

Объект содержит сведения о позиции продукции в складском журнале системы Меркурий.

Поле Описание Тип Обязательность
UUID Идентификатор записи журнала продукции, с которой будет списан объем для формирования транспортной партии. bs:UUID 1 - обязательно должно быть заполнено хотя бы одно из полей, либо UUID, либо GUID.

При указании обоих полей, приоритет у UUID.

GUID Глобальный идентификатор записи журнала продукции, с которой будет списан объем для формирования транспортной партии. bs:UUID

Объект ..Request/delivery/accompanyingForms

Объект содержит дополнительные сведения о транспортной партии, необходимые для оформления ВСД.

Поле Описание Тип Обязательность
waybill Сведения о транспортировке партии. shp:Waybill 1
vetCertificate Дополнительные сведения для оформления ВСД. vetd:VetDocument 1..*

Объект ..Request/delivery/accompanyingForms/waybill

Объект содержит сведения о транспортировке партии продукции.

Поле Описание Тип Обязательность
issueSeries Серия товарно-транспортной накладной. bs:String255 0..1
issueNumber Номер товарно-транспортной накладной. bs:String255 0..1
issueDate Дата товарно-транспортной накладной. xs:date 0..1
type Тип товарно-транспортной накладной:
  • 1 - товарно-транспортная накладная;
  • 2 - конасамент (перевозчик становится владельцем груза);
  • 3 - CMR (международная ТТН);
  • 4 - авианакладная.
shp:WaybillType 1
broker Фирма-посредник (перевозчик продукции). ent:BusinessEntity 0..1
transportInfo Информация о транспорте, в котором будет перемещаться партия продукции. shp:TransportInfo 1
transportStorageType Способ хранения продукции при перевозке.
  • замороженные (FROZEN);
  • охлажденные (CHILLED);
  • охлаждаемые (COOLED);
  • вентилируемые (VENTILATED).
shp:TransportationStorageType 1
cargoReloadingPointList Список пунктов перегрузки транспортной партии. shp:ShipmentRoute 0..1

Объект ..Request/delivery/accompanyingForms/waybill/broker

Поле Описание Тип Обязательность
UUID Идентификатор версии хозяйствующего субъекта - перевозчика продукции (посредника). bs:UUID 1 - обязательно должно быть заполнено хотя бы одно из полей, либо UUID, либо GUID.

При указании обоих полей, приоритет у UUID.

GUID Глобальный идентификатор хозяйствующего субъекта - перевозчика продукции (посредника). bs:UUID

Объект ..Request/delivery/accompanyingForms/waybill/transportInfo

Объект содержит информацию о транспорте в котором будет перемещаться партия продукции.

Поле Описание Тип Обязательность
transportType Тип транспортного средства:
  • автомобильный;
  • железнодорожный;
  • авиатранспорт
  • морской (контейнерная партия);
  • морской (трюмная партия).
shp:TransportType 1
transportNumber Номер транспортного средства. shp:TransportNumber 1

Объект ..Request/delivery/accompanyingForms/waybill/cargoReloadingPointList

Объект содержит информацию о списке пунктов перегрузки.

Поле Описание Тип Обязательность
cargoReloadingPoint Пункт перегрузки транспортной партии в другое транспортное средство. shp:CargoReloadingPoint 0..*

Объект ..Request/delivery/accompanyingForms/waybill/cargoReloadingPointList/cargoReloadingPoint

Объект содержит информацию о пункте перегрузки.

Поле Описание Тип Обязательность
name Название пункта перегрузки. bs:String255 1
nextTransport Сведения о дальнейшем транспорте. shp:TransportInfo 1

Объект ..Request/accompanyingForms/waybill/cargoReloadingPointList/cargoReloadingPoint/nextTransport

Объект содержит сведения о транспорте, которым далее последует транспортная партия.

Поле Описание Тип Обязательность
transportType Тип транспортного средства. shp:TransportType 1
transportNumber Номер транспортного средства. shp:TransportNumber 1

Объект ..Request/delivery/accompanyingForms/vetCertificate

Объект содержит сведения о дополнительной информации, необходимой для оформления ВСД.

Поле Описание Тип Обязательность
purpose Цель перемещения транспортной партии. argc:Purpose 1
broker Фирма-посредник (перевозчик продукции). ent:BusinessEntity 0..1
transportInfo Информация о транспорте, в котором будет перемещаться партия продукции. shp:TransportInfo 1
transportStorageType Способ хранения продукции при перевозке. shp:TransportationStorageType 1
cargoReloadingPointList Список пунктов перегрузки транспортной партии. shp:ShipmentRoute 0..1
cargoInspected Осуществлен контроль гос.ветврачом на соответствие требованиям. xs:boolean 1
cargoExpertized Осуществлена ветеринарно-санитарная экспертиза продукции. xs:boolean 1
expertiseInfo Сведения о ветеринарно-санитарной экспертизе. bs:String255 1
confirmedBy Сведения о ветеринарном враче, оформляющим ВСД. argc:User 1
locationProsperity Благополучие местности. bs:String255 1
animalSpentPeriod Период нахождения животных на территории ТС
  • Данное поле указывается только для типа продукции "Живые животные".
vetd:AnimalSpentPeriod 0..1
monthsSpent Кол-во месяцев нахождения животных на территории ТС
  • Данное поле указывается только для типа продукции "Живые животные".
bs:String255 0..1
quarantinePlace Место проведения карантинирования
  • Данное поле указывается только для типа продукции "Живые животные".
bs:String255 0..1
quarantineDays Количество дней карантинирования
  • Данное поле указывается только для типа продукции "Живые животные".
xs:int 0..1
immunizationInfo Сведения о проведенной иммунизации
  • Данное поле указывается только для типа продукции "Живые животные".
bs:String255 0..1
precedingVetDocuments Сведения о предыдущих ветеринарных сопроводительных документах. bs:String255 0..1
transferPermit Сведения о разрешении на вывоз. argc:Document 0..1
specialMarks Особые отметки для ветеринарно-сопроводительного документа. bs:String255 0..1

Объект ..Request/delivery/accompanyingForms/vetCertificate/purpose

Объект содержит сведения о цели перемещения транспортной партии.

Поле Описание Тип Обязательность
UUID Идентификатор версии записи в справочнике целей. bs:UUID 1 - обязательно должно быть заполнено хотя бы одно из полей, либо UUID, либо GUID.

При указании обоих полей, приоритет у UUID.

GUID Глобальный идентификатор записи в справочнике целей. bs:UUID

Объект ..Request/accompanyingForms/vetCertificate/broker

Объект содержит сведения о хозяйствующем субъекте-посреднике (перевозчик продукции).

Поле Описание Тип Обязательность
UUID Идентификатор версии хозяйствующего субъекта - перевозчика продукции (посредника). bs:UUID 1 - обязательно должно быть заполнено хотя бы одно из полей, либо UUID, либо GUID.

При указании обоих полей, приоритет у UUID.

GUID Глобальный идентификатор хозяйствующего субъекта - перевозчика продукции (посредника). bs:UUID

Объект ..Request/delivery/accompanyingForms/vetCertificate/transportInfo

Объект содержит информацию о транспорте в котором будет перемещаться партия продукции.

Поле Описание Тип Обязательность
transportType Тип транспортного средства:
  • автомобильный;
  • железнодорожный;
  • авиатранспорт
  • морской (контейнерная партия);
  • морской (трюмная партия).
shp:TransportType 1
transportNumber Номер транспортного средства. bs:String255 1

Объект ..Request/delivery/accompanyingForms/vetCertificate/cargoReloadingPointList

Объект содержит информацию о списке пунктов перегрузки.

Поле Описание Тип Обязательность
cargoReloadingPoint Пункт перегрузки транспортной партии в другое транспортное средство. shp:CargoReloadingPoint 0..*

Объект ..Request/delivery/accompanyingForms/vetCertificate/cargoReloadingPointList/cargoReloadingPoint

Объект содержит информацию о пункте перегрузки.

Поле Описание Тип Обязательность
name Название пункта перегрузки. bs:String255 1
nextTransport Сведения о дальнейшем транспорте. shp:TransportInfo 1

Объект ..Request/delivery/accompanyingForms/vetCertificate/cargoReloadingPointList/cargoReloadingPoint/nextTransport

Объект содержит сведения о транспорте, которым далее последует транспортная партия.

Поле Описание Тип Обязательность
transportType Тип транспортного средства. shp:TransportType 1
transportNumber Номер транспортного средства. shp:TransportNumber 1

Объект ..Request/delivery/accompanyingForms/vetCertificate/confirmedBy

Объект содержит сведения о ветеринарном враче, оформившим ВСД.

Поле Описание Тип Обязательность
fio ФИО врача, оформившего ВСД. bs:String255 1
post Должность врача, оформившего ВСД. bs:String255 1

Объект ..Request/delivery/accompanyingForms/vetCertificate/transferPermit

Объект содержит сведения о разрешении на вывоз.

Поле Описание Тип Обязательность
issueNumber Номер разрешения на вывоз. bs:String255 1
issueDate Дата разрешения на вывоз. bs:String255 1