ProcessIncomingDelivery v2.1

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

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

Планируемая версия запуска в работу операции: 6.8

Функциональные правила операции пакетного гашения

1. Максимальное количество ВСД, которое может быть принято в запросе - 100.
2. Частный случай пакетного гашения - гашение одного ВСД без расхождений с полной приёмкой (или полным возвратом).
3. Пакетное гашение электронных ВСД (в т.ч. импортных) выполняется в рамках одной поставки. То есть для множества ВСД, следующих в одном транспортном средстве в адрес одного получателя.
4. Под "одной поставкой" понимается множество ВСД, в которых совпадают следующие сведения: отправитель ВСД (хозяйствующий субъект и площадка), получатель ВСД (хозяйствующий субъект и площадка), сведения о транспортном средстве (тип и номер ТС), перевозчик, режим хранения при перевозке, сведения о ТТН (серия, номер, дата, тип документа).
5. В случае если хотя бы в одном из переданных ВСД существуют данные, отличающиеся от передаваемых в запросе (например, передан ВСД из другой поставки), то будет произведён отказ в выполнении всего запроса. Все валидационные сообщения привязаны к конкретным ВСД и возвращаются сервисом с указанием идентификаторов ВСД, вызвавших ту или иную ошибку.
6. Если хотя бы один ВСД не соответствует бизнес-правилам операции гашения (например, не заполнены номера ТС), то запрос отклоняется полностью. Успешное выполнение операции гарантирует, что все переданные ВСД были погашены.
7. В рамках одного запроса может быть погашено любое количество (не превышающее максимальное) ВСД из одной поставки. Например, если в одной поставке было 10 ВСД, то в одном запросе могут быть погашены как все 10, так и 5 ВСД (а на другие 5 могут быть оформлены расхождения операцией ProcessIncomingConsignmentOperation или они могут быть погашены в следующем запросе).
8. Пакетное гашение может быть выполнено только в случае полной приёмки товара или полного возврата по всем ВСД в запросе. В рамках одного запроса не могут быть выполнены одновременно и гашение, и оформление возвратных ВСД.
9. Сведения о партии товара не передаются пользователем в запросе. При гашении ВСД и создании по ним записей журнала сервис использует данные партии из гасимых ВСД.
10. При пакетном гашении пользователь подтверждает, что при приёмке товара никаких расхождений выявлено не было. Акт о несоответствии в операции не используется.
11. Все элементы, которые не относятся к партии товара, указываются пользователем в запросе:
    1. отправитель (0..1) - отсутствует только для импортных сертификатов с СВХ;
    2. получатель (1..1);
    3. идентификатор ВСД (1..*);
    4. дата приёмки поставки (1..1);
    5. перевозчик (0..1);
    6. сведения о транспорте (0..1) - отсутствует только для типа транзакции "Смена владельца без перевозки";
    7. маршрут следования для мультимодальных перевозок (0..1) - кроме импортных сертификатов с СВХ;
    8. режим хранения при перевозке (0..1) - отсутствует только для типа транзакции "Смена владельца без перевозки";
    9. сведения о ТТН (0..1);
    10. тип ВСД - допускается только значение "электронный" (1..1);
    11. решение о приёме партий - допускаются только значения "принимается полностью" или "возвращается полностью" (1..1);
    12. соответствие сведений о фактических партиях со сведениями в ВСД - допускается только значение "соответствует" (1..1);
    13. соответствие сведений о партиях, указанных в документах, фактическим - допускается только значение "соответствует" (1..1).
12. Если хотя бы в одном ВСД отправитель, получатель, перевозчик, сведения о транспорте, режим хранения при перевозке, сведения о ТТН не совпадают с указанными в запросе, происходит отказ в выполнении запроса с указанием в сообщении об ошибке идентификатора ВСД, вызвавшего ошибку, с помощью атрибута qualifier. Каждая получаемая ошибка по каждому ВСД выводится отдельно с указанием идентификаторов ВСД.
13. Указание сведений для возвратных ВСД подчиняется тем же правилам, что и указание сведений для принимаемых ВСД.
14. Создание записей журнала происходит на основании сведений о партиях в гасимых ВСД. По каждому ВСД создаётся своя запись журнала. Автоматического присоединения не происходит. В ответах сервиса для каждой записи журнала в атрибуте qualifier возвращается идентификатор ВСД, по которому была создана каждая запись журнала.
15. Для импортных сертификатов с СВХ не доступно выполнение полного возврата.
16. Для ВСД, в которых присутствуют мультимодальные перевозки, действуют правила:
    1. Указание в запросе маршрута следования не является обязательным. При гашении ВСД проверяется заполнение всех номеров ТС, если хотя бы в одном ВСД нет номера ТС, происходит отказ в выполнении запроса с указанием в сообщении об ошибке идентификатора ВСД, вызвавшего ошибку, с помощью атрибута qualifier.
    2. Если в запросе был передан маршрут следования с точками перегрузки вместе с номерами ТС, то сведения о номерах ТС сохраняются во всех переданных в запросе ВСД аналогично операции UpdateTransportMovementDetailsOperation.
    3. Если номера ТС уже были указаны в ВСД, то они будут перезаписаны.
    4. Если хотя бы одна из указанных точек перегрузки отсутствует хотя бы в одном ВСД, происходит отказ в выполнении запроса с указанием в сообщении об ошибке идентификатора ВСД, вызвавшего ошибку, с помощью атрибута qualifier.
    5. Возврат при мультимодальных перевозках не может быть выполнен. В случае, если в запросе на оформление полного возврата указан хотя бы один ВСД с мультимодальной перевозкой, происходит отказ в выполнении запроса с указанием в сообщении об ошибке идентификатора ВСД, вызвавшего ошибку, с помощью атрибута qualifier.

Описание объектов, задающих сценарий операции

Название поля	Значение	Комментарий
delivery/deliveryDate	Дата	Указывается дата поступления груза.
delivery/consignor	UUID или GUID ХС и предприятия (площадки)	Указываются сведения об отправителе груза. При оформлении возврата отправителем становится получатель исходного ВСД.
delivery/consignee	UUID или GUID ХС и предприятия (площадки)	Указываются сведения о получателе груза. При оформлении возврата получателем становится отправитель исходного ВСД.
delivery/broker	UUID или GUID ХС	Указываются сведения о перевозчике (посреднике) в случае, если перевозчик указан в гасимых ВСД.
delivery/transportInfo	Тип и номер ТС	Указываются сведения о транспортном средстве, в котором осуществлялась поставка гасимых ВСД. Для мультимодальных перевозок указываются сведения о транспортном средстве на последнем плече.
delivery/transportStorageType	Способ хранения при перевозке	Указываются сведения о способе хранения при перевозке, заданных в гасимых ВСД.
delivery/shipmentRoute	Маршрут следования с точками перегрузки	В случае мультимодальных перевозок сведения о точках перегрузки необходимо указывать, если для ВСД не были заполнены все номера ТС. Если номера уже внесены во все ВСД, то маршрут следования может не задаваться в запросе.
delivery/accompanyingForms/waybill	Сведения о ТТН.	Указываются серия/номер/дата ТТН, по которому осуществляется поставка всех ВСД.
delivery/accompanyingForms/vetCertificate	Идентификаторы электронных документов.	Список ВСД одной поставки, которые необходимо погасить/вернуть. MIN = 1, MAX = 100.
deliveryFacts/vetCertificatePresence	ELECTRONIC	Указывается вид ветеринарного сертификата: электронный.
deliveryFacts/docInspection/result	CORRESPONDS	Соответствуют ли сведения о партии, указанные в документе, фактическим: соответствуют.
deliveryFacts/vetInspection/result	CORRESPONDS	Осуществлён ли контроль груза вет.врачом на соответствие ветеринарным требованиям: груз соответствует.
deliveryFacts/decision	ACCEPT_ALL/RETURN_ALL	Принятое решение о дальнейшей судьбе партии: принимается/возвращается полностью.
returnedDelivery	Данные возвратного сертификата.	Заполняется в случае оформления полного возврата по тем же правилам, что и блок delivery. Возврат с мультимодальными перевозками не может быть выполнен.