TransportOperationForVetControl: различия между версиями
(Новая страница: «== Общие сведения == Операция '''TransportOperationForVetControl''' предназначена для оформления в системе …») |
|||
Строка 423: | Строка 423: | ||
|} | |} | ||
===Объект [[TransportOperationForVetControl#Объект prepareOutcomingConsignmentRequest|..Request]][[TransportOperationForVetControl#Объект ..Request/delivery|delivery]]/'''accompanyingForms'''=== | ===Объект [[TransportOperationForVetControl#Объект prepareOutcomingConsignmentRequest|..Request]]/[[TransportOperationForVetControl#Объект ..Request/delivery|delivery]]/'''accompanyingForms'''=== | ||
Объект содержит дополнительные сведения о транспортной партии, необходимые для оформления ВСД. | Объект содержит дополнительные сведения о транспортной партии, необходимые для оформления ВСД. | ||
{| class="wikitable" | {| class="wikitable" |
Версия 15:53, 13 мая 2016
Общие сведения
Операция TransportOperationForVetControl предназначена для оформления в системе Меркурий транспортной партии. На вход системы передаются следующие сведения:
- информация об одной или нескольких партиях продукции, из которых будет сформирована транспортная партия;
- сведения о получателе транспортной партии;
- сведения о транспортном средстве и маршруте его следования;
- дополнительные сведения необходимые для оформления ветеринарно-сопроводительного документа (ВСД), например, результат ветеринарно-санитарной экспертизы, сведения о ТТН, особые отметки и т.д.
Результатом выполнения данной операции является:
- списание объема с одной или нескольких записей журнала продукции, которые были указаны в заявке;
- гашение производственной сертификата, если был указан весь объем по данной записи журнала вырабатываемой продукции;
- для каждого наименования продукции указанного в транспортной партии, система Меркурий формирует ветеринарно-сопроводительный документ (ВСД).
Возможные сценарии
При выполнении операции возможны следующие сценарии.
- 1.1. Выработанная продукция с указанной записи журнала была полностью израсходована (отгружена), т.е. объём продукции для записи журнала после списания стал равен нулю.
- Происходит списание объёмов с одной или нескольких записей журнала.
- Одна или несколько записей журнала вырабатываемой продукции, объем которых израсходован, переходит в категорию "оформленных".
- Оформляется ВСД на каждое наименование отгружаемой продукции.
- Происходит гашение производственных сертификатов, объем которых был израсходован.
- 1.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 | Сведения о получателе продукции (хозяйствующем субъекте-получателе продукции и предприятии-получателе).
|
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) в ИС Меркурий.
|
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 | Тип товарно-транспортной накладной:
|
shp:WaybillType | 1 |
broker | Фирма-посредник (перевозчик продукции). | ent:BusinessEntity | 0..1 |
transportInfo | Информация о транспорте, в котором будет перемещаться партия продукции. | shp:TransportInfo | 1 |
transportStorageType | Способ хранения продукции при перевозке.
|
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 |