Рейтинг@Mail.ru

Для разработчиков

Публичный API программы Почтовый агент

Программный интерфейс (API) Почтового агента позволяет интегрировать функционал электронного обмена документами с различными информационными системами и СЭД: Directum, 1С, и другими.

API позволяет организовать обмен с информационными системами так же легко, как и с конкретными людьми.

Программный интерфейс дает возможность транспортного взаимодействия между отправителем и получателем электронных документов как используя простую электронную почту, так защищенный документооборот — сервис Деловая и служебная переписка.

api001

При защищенном документообороте обеспечивается юридическая значимость как передаваемого документа, так и самого процесса доставки. 

Что это означает:

  1. Все основные этапы обмена документами квитируются. То есть отправителю и/или получателю отправляются электронные документы, подтверждающие, что отправленный документ прошел очередную стадию документооборота. Например, документ получен на сервере оператора связи, доставлен получателю и т.д.
  2. Данные защищены от несанкционированного доступа. Это достигается при помощи шифрования на сертификате получателя.
  3. Информация подписывается электронной подписью на ключе (с использованием сертификата) отправителя.
    Этим достигается следующее:

    1. однозначное определение (аутентификация) отправителя.
    2. гарантируется неизменность передаваемых данных. Т.е. получатель имеет именно ту информацию, которую передал отправитель.

Примечание: средства шифрования и подписи (средства криптографической защиты информации — СКЗИ) сертифицированы ФСБ России.

Программный интерфейс (API) Почтового агента дает следующие возможности:

Схема работы

Рассмотрим пример использования API Почтового агента при работе на сервере информационной системы:

Получение входящей корреспонденции и передача их в ИС.

На сервере ИС устанавливаются библиотеки Почтового агента и сертификат учетной записи Почтового агента, используемой для отправки / получения сообщений в системе. Адрес используемого почтового ящика данной учетной записи храниться в ИС в виде системной константы, так же как и информация о почтовом ящике корреспондента.

По расписанию на сервере запускается сценарий ИС, который, используя API Почтового Агента, получает письма абонента, при этом код первого получаемого письма берется из соответствующей системной константы (после каждого получения писем, значение константы обновляется – код последнего полученного письма LetterId + 1).

Далее, для каждого поступившего сообщения из Почтового агента, вложения из сообщения сохраняются в ИС как электронные документы с типом карточки электронного документа Документ Деловой сети.

Отправка исходящей корреспонденции из ИС посредством API Почтовый Агент.

Пользователь ИС на карточке исходящего документа нажимает на кнопку Отправить исходящий через ПА.  При этом запускается сценарий создания почтового сообщения.

Формирование текста сообщения: пользователю предлагается сформированный по шаблону (из реквизитов документа) текст электронного письма на редактирование, а так же перечень документов, привязанных к данному документу для выбора прикрепляемых к сообщению файлов вложений.

После выполнения пользователем всех действий, связанных с редактированием сообщения и прикреплением вложений, система создает запись специализированного справочника Корреспонденция Деловая Сеть, в котором сохраняется текст письма, ID прикрепляемых к письму вложений, а так же статус данного почтового сообщения Новое письмо(ForSend).

Далее, сценарий, запускаемый по расписанию на сервере ИС, просматривает справочник Корреспонденция Деловая Сеть, отфильтрованный по статусу сообщений (для обработки выбираются все письма, находящихся статусе Новое письмо(ForSend). Для них происходит отправка посредством использования API Почтового агента

Для сообщений с другими статусами происходит их обновление (статусов). Статусы писем доступны пользователю для просмотра, посредством нажатия гиперссылки Статусы письма на карточке документа.

Полное описание функцинала API к программе Почтовый агент.

This is a unique website which will require a more modern browser to work! Please upgrade today!