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

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

Заполнение реквизитов организации

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

  • укажите реквизиты организации в блоке OrganizationDetails;

  • укажите идентификатор организации в атрибуте BoxId в блоке OrganizationReference.

Если в OrganizationReference указан BoxId, то Диадок автоматически заполнит реквизиты организации, в том числе адрес, данными ящика из Диадока.

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

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

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

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

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

Примечание

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

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

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

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

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