Особенности генерации

Общий порядок генерации титула описан в разделе Генерация формализованного документа.

Заполнение данных участников документооборота

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

  • укажите идентификатор ящика участника в атрибуте BoxId в блоке OrganizationReference;

  • заполните вручную реквизиты и адрес участника в блоке OrganizationDetails.

Оба способа доступны только в том случае, если в UserDataXsd титула для участника есть блоки OrganizationReference и OrganizationDetails. Если этих блоков нет, передайте данные участника в элементах, которые указаны в UserDataXsd: состав и требования к ним зависят от типа документа. Получить UserDataXsd можно с помощью метода GetDocumentTypes (V3) — инструкция на странице Получение информации о типе документа.

Если вы заполняете OrganizationReference, Диадок автоматически подставит реквизиты и адрес. Контакты и остальные данные участника передайте в этом же блоке вместе с BoxId.

Как Диадок заполняет адрес

В сгенерированном документе адрес может быть указан в атрибутах АдрРФ, АдрИнф или АдрГАР — в зависимости от указанного в ящике адреса и формата документа. Например, если в ящике указан адрес в формате ГАР (государственного адресного реестра), то в итоговом документе Диадок заполнит атрибут АдрГАР.

Адрес считается полным, если выполнено хотя бы одно условие:

  • заполнены поля Город, Улица, НаселПункт и Дом;

  • заполнено поле ИныеСвед.

Примечание

Для поручения экспедитору (ПЭ) и экспедиторской расписки (ЭР) обязательным требованием является полнота адреса. Поэтому при генерации Диадок проверяет заполнение атрибута ИныеСвед, если не указано хотя бы одно из полей Город, Улица, НаселПункт или Дом.

Если адрес в ПЭ или ЭР неполный, то в итоговом документе будет заполнен атрибут АдрИнф вместо АдрРФ: так Диадок сохраняет заполненные части адреса и формирует XML-файл, который соответствует формату документа. В атрибуте АдрИнф сохраняются только заполненные части адреса — пустые поля не добавляются, а перед названием города добавляется «г.».

Для других формализованных документов Диадок не проверяет полноту адреса: требования к итоговому XML-файлу и допустимый вид адреса определяются форматом документа. Если Диадок заполняет атрибут АдрРФ, то в него добавляются только заполненные поля. Если формат документа требует поле, которого нет в адресе, метод генерации GenerateTitleXml вернет ошибку.

Кроме этого Диадок проверяет, помещаются ли значения полей в атрибут АдрРФ с учетом ограничений формата. Если значения не помещаются, сервис формирует АдрИнф с текстовым адресом. Для ПЭ и ЭР эта проверка не зависит от проверки полноты адреса.

Если у ящика не заполнен адрес организации, то метод генерации GenerateTitleXml не сформирует элемент адреса. При этом если адрес обязателен по формату, то метод генерации вернет ошибку.