UpdateTransportMovementDetailsOperation v2

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

Операция UpdateTransportMovementDetailsOperation предназначена для внесения номера транспортного средства в пункте перегрузке в уже оформленный ВСД, в случае если перемещение осуществлялось с использованием нескольких транспортных средств и отправителю на момент оформления ВСД неизвестны номера ТС на всем маршруте следования (мультимодальная перевозка). Вносить сведения о номере транспортного средства в пункте перегрузки может как отправитель, так и получатель партии, при наличии роли позволяющей гасить ВСД. ВСД, где не указаны номера всех транспортных средств во всех точках перегрузки не могут быть погашены получателем.

При выполнении операции UpdateTransportMovementDetailsOperation на вход системы передаются следующие сведения:

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

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

• Список транспортных ВСД с измененными сведениями о транспортных средствах.

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

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

1. Внесение сведений о номере ТС в оформленный ВСД.

1.1. Запрос успешно обработан. Пользователю вернулся ВСД с измененным маршрутом.

1.2. Произошла ошибка при обработке запроса.

• Некорректный запрос.

• Внутренняя ошибка системы.

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

#	Название XML-элемента	Тип	Кардинальность	Описание	Пример
1	<merc:updateTransportMovementDetailsRequest>
2	···<merc:localTransactionId>	xs:NCName	[1..1]	Идентификатор заявки в клиентской системе.	<bs:guid>A00001</bs:guid>
3	···<merc:initiator>	dt:User	[1..1]	Пользователь, зарегистрированный в системе Меркурий и инициирующий запрос к шлюзу. Является ответственным за выполнение бизнес-операции. Здесь потребуется логин ветврача или пользователя ХС. Логин для базовой аутентификации не подойдёт.
4	······<:login>	xs:NCName	[1..1]	Логин пользователя, зарегистрированного в системе Меркурий. Обязательно указывать один из параметров.	<:login>user_ab_150101</dt:login>
5	···</merc:initiator>
6	···<vd:deliveryParticipant>	dt:BusinessMember	[1..1]	Грузополучатель или грузоотправитель, осуществляющий изменение параметров маршрута.
7	······<:businessEntity>	dt:BusinessEntity	[1..1]	Информация о хозяйствующем субъекте.
8	·········<bs:uuid>	bs:UUID	[0..1]	Идентификатор версии хозяйствующего субъекта.	<bs:uuid>9b7082e2-2d20-4182-be1a-c93974f8b8c6</bs:uuid>
9	·········<bs:guid>	bs:UUID	[0..1]	Глобальный идентификатор хозяйствующего субъекта.	<bs:guid>6956009e-0e30-4427-8623-91ddebf47471</bs:guid>
10	······</dt:businessEntity>
11	······<:enterprise>	dt:Enterprise	[1..1]	Информация о предприятии-отправителе транспортной партии. Обязательно должно быть заполнено хотя бы одно из полей, либо UUID, либо GUID. При указании обоих полей, приоритет у UUID.
12	·········<bs:uuid>	bs:UUID	[0..1]	Идентификатор версии предприятия.	<bs:uuid>9c706614-b995-4bdd-bda3-8fa9de70803a</bs:uuid>
13	·········<bs:guid>	bs:UUID	[0..1]	Глобальный идентификатор предприятия.	<bs:guid>12f04ea3-e236-4b71-b427-e04d41b26de4</bs:guid>
14	······</dt:enterprise>
15	···</vd:deliveryParticipant>
16	···<vd:vetDocumentUuid>	bs:UUID	[0..1]	Идентификатор ветеринарного документа, для которого будет осуществляется перегрузка.	<bs:uuid>851cf860-e9a3-4981-b83e-3dc6cb06cf07</bs:uuid>
17	···<vd:shipmentRoute>	vd:ShipmentRoute	[0..1]	Сведения о маршруте следования (пунктах перегрузки).
18	······<vd:routePoint>	vd:ShipmentRoutePoint	[0..*]	Сведения о точке маршрута.
19	·········<bs:uuid>	bs:UUID	[0..1]	Идентификатор торчки маршрута.	<bs:uuid>851cf860-e9a3-4981-b83e-3dc6cb06cf07</bs:uuid>
20	·········<vd:nextTransport>	dt:TransportInfo	[0..1]	Сведения о дальнейшем транспорте.
21	············<vd:transportType>	dt:TransportType	[1..1]	Тип транспортного средства.	<vd:transportType>2</vd:transportType>
22	············<vd:transportNumber>	dt:TransportNumber	[1..1]	Номер транспортного средства.
23	···············<vd:containerNumber>	bs:String255	[0..1]	Номер контейнера (при автомобильной перевозке).	<vd:containerNumber>п962но65</vd:containerNumber>
24	···············<vd:wagonNumber>	bs:String255	[0..1]	Номер вагона.	<vd:wagonNumber>72543291</vd:wagonNumber>
25	···············<vd:vehicleNumber>	bs:String255	[0..1]	Номер автомобиля.	<vd:vehicleNumber>а514ко33</vd:vehicleNumber>
26	···············<vd:trailerNumber>	bs:String255	[0..1]	Номер прицепа (полуприцепа).	<vd:trailerNumber>о721ен24</vd:trailerNumber>
27	···············<vd:shipName>	bs:String255	[0..1]	Название судна (или номер контейнера).	<vd:shipName>AMTU4003372</vd:shipName>
28	···············<vd:flightNumber>	bs:String255	[0..1]	Номер авиарейса.	<vd:flightNumber>YC-464</vd:flightNumber>
29	············</vd:transportNumber>
30	·········</vd:nextTransport>
31	······</vd:routePoint>
32	···</vd:shipmentRoute>
33	</merc:updateTransportMovementDetailsRequest>

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

Внесение сведений о номере ТС в оформленный ВСД

Коды ошибок

Вернуться к началу ↑