Действия по списку документов

Для выполнения действий по документам в Диадоке коннектор использует текстовые файлы (в формате PlainText, с переносом строк, с разделителями «;», кодировка UTF8), содержащие данные по документам.

Данные в текстовом файле указываются для одного или нескольких документов в строго определенном формате:

 

Данные в TXT файле

Строка 1-N. Данные

Строк может быть несколько

[BoxId];[MessageId];[EntityId];[Action];[CertificateThumbprint];[Comment];[BuyerTitleAcceptanceDate];[CustomData];

Если в строке после всех полей будет указана другая дополнительная информация, то она будет проигнорирована.

Файл со списком документов автоматически перемещается в папку обработанных файлов после успешной загрузки на сервер.

N

Значение

Мнемоника

Обязательность

Формат

1

Идентификатор ящика, в котором осуществляется подписание документов

BoxId

Да

Текст

2

Диадоковский идентификатор сообщения

MessageId

Да

Текст

3

Диадоковский идентификатор сущности

EntityId

Да

Текст

4

Действие, которое требуется выполнить с документом

Action

Да

Принимает одно из значений:

  • Sign — подписать. Если документ подписывается сертификатом физлица, выполните настройки по работе с доверенностями.
  • Reject — отказать в подписи.
  • GenerateReceipt — сгенерировать и отправить все возможные извещения о получении (ИОП) по документу.
  • RequestCorrection — запросить уточнение (корректировку).
  • RequestRevocation — запросить аннулирование.
  • ApproveRevocation — подтвердить аннулирование (аннулировать документ).
  • RejectRevocation — отказать в аннулировании.
  • Approve — согласовать.
  • Decline — отказать в согласовании.
  • SetCustomData — добавить новый или изменить существующий тег
5 Отпечаток сертификата, которым будет подписан документ CertificateThumbprint Нет Текст

6

Комментарий к действию

Comment

Нет

Текст. Может содержать символ перевода строки « \n», в этом случае при вставке комментария в документ Диадока строки должны быть перенесены с учетом символа переноса строки

7 Дата приемки BuyerTitleAcceptanceDate Нет

ДД.ММ.ГГГГ.

Часовой пояс мск.

Используется в сценариях подписания документов:

  • Дата не указывается для всех документов — произойдет подписание текущей датой.
  • Дата указывается для всех документов — произойдет подписание указанной датой.
  • Дата указывается для части документов — произойдет подписание указанной датой для части документов, остальные подпишутся текущей датой.

В один момент времени может работать только один из сценариев подписания. Чтобы изменить свой сценарий подписания, обратитесь в техническую поддержку

8 Название и значение тега CustomData Нет

Название:Значение или «Название:Значение».

Необходимо указывать для действия SetCustomData

Пример текстового файла для отказа в подписи по одному документу, подписи одного документа с датой приемки 11.12.2019 и согласования двух документов:

69d6af34-8f6d-4616-a2f9-80d3d9ee979f;1dd46218-919c-4e57-9b7a-a5f2599fd37d;c06ba495-eb97-480c-8444-46bbf08439c4;Reject;D67FB76C7F134AFD4D9B9BD3B898DA376F35258F;Ошибка в КПП покупателя;;; 69d6af34-8f6d-4616-a2f9-80d3d9ee979f;0c1b6f8e-50ce-4ab2-aa55-5e9р890b26890;1bcd5dbd-d06c-4e84-be12-1cd590006732;Sign;D67FB76C7F134AFD4D9B9BD3B898DA376F35258F;;11.12.2019;; 69d6af34-8f6d-4616-a2f9-80d3d9ee979f;551b6f8e-50ce-4ab2-aa55-5e9р890b26890;55cd5dbd-d06c-4e84-be12-1cd590006732;Approve;;;;; 69d6af34-8f6d-4616-a2f9-80d3d9ee979f;661b6f8e-50ce-4ab2-aa55-5e9р890b26890;66cd5dbd-d06c-4e84-be12-1cd590006732;Approve;;;;;

База знаний