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.
  • Возврат с мультимодальными перевозками не может быть выполнен.

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

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

Справочная система Россельхознадзора
Личные инструменты
Пространства имён

Варианты
Действия
Навигация
Печать/экспорт