ООО "Софт-Сервис" партнер АО "ПФ "СКБ Контур"
8-800-555-06-40

Интеграция

Полнофункциональный API

Программный интерфейс Диадока (API) позволяет очень просто интегрировать функциональность электронного документооборота в любую современную учетную систему (1С, SAP, Oracle, Microsoft Dynamics AX/NAV и др.).

API Диадока позволяет выполнять все те же основные операции, что и веб-приложение: отправлять документы и отслеживать обновления их статусов, получать документы, создавать счета-фактуры, запросы на корректировку счета-фактуры, акты, накладные, а также распознавать печатные формы счетов-фактур, подготовленные в любой бухгалтерской программе.

API Диадока позволяет выполнять все те же операции, что и в веб-интерфейсе:

  • создание документов в утвержденном xml формате (счета-фактуры, запросы на корректировку счета-фактуры, акты, накладные);
  • осуществлять все операции по получению и отправке документов непосредственно из ИС;
  • автоматически подписывать документы КЭП как из ИС;
  • отслеживать статусы документов;
  • работать со списком контрагентов (приглашения, проверка на предмет регистрации в Диадоке);
  • согласовывать документы;
  • строить выборки документов по различным критериям

Программный интерфейс

api диадок

Подробное описание функциональных возможностей API Диадока и информация об обновлениях расположена по адресу http://api-docs.diadoc.ru/ru/latest/ReleaseNotes.html.

Актуальную версию инструментария для разработчиков с описанием Diadoc API и примерами его использования можно скачать по ссылке.

Различные варианты построения интеграционных решений:

В зависимости от решаемых прикладных задач и от требований к клиентской части можно выбрать наиболее подходящий вид интеграции с API Диадока:

HTTP-based API

Для интеграции с произвольными учетными системами. Этот уровень интеграции является наиболее общим, и на нем, в частности, обеспечивается платформонезависимость для интеграционных решений.

Вариант подходит для работы с различными учетными системами, написанными на языке C# под платформу.NET и запускающиеся на машинах с ОС Microsoft Windows, или на Java/C++, запускающиеся на машинах под управлением ОС Linux.

Для интеграторов, ведущих разработку в стеке технологий Microsoft, доступна клиентская.NET/COM-библиотека DiadocApi.dll, которая берет на себя работу по преобразованию локальных обращений к свойствам и методам некоторых объектов в соответствующие HTTP-команды API Диадока.

Кроме того, DiadocApi.dll инкапсулирует детали работы с криптографией, так что прикладному разработчику не нужно разбираться с тонкостями обращений к CryptoAPI. Актуальная версия библиотеки DiadocApi.dll вместе с исходниками входит в состав SDK, который доступен для скачивания по ссылке.

Программная реализация API Диадока доступна для следующих языков (входит в состав SDK): Java и C++, а из языков Visual Basic for Applications и JavaScript возможна работа с Диадоком посредством COM-сервисов (примеры также доступны в составе SDK).

AddInDiadocAPI

Внешняя компонента, предназначенная для интеграции с учетными системами на платформе 1С. Данный способ позволяет максимально быстро решать типовые задачи, возникающие при интеграции 1С-решений с Диадоком. Компонента может запускаться на машинах с ОС Microsoft Windows, не требуя установки каких-либо дополнительных модулей.

Для разработчиков, занимающихся интеграцией Диадока с различными программными продуктами, построенными на платформе 1С, доступен специальный внешний компонент, который позволяет максимально быстро решать типовые задачи, возникающие при стыковке 1С-решений с Диадоком.

Этот компонент написан на языке C++ и не содержит лишних зависимостей, что позволяет использовать его на любой Windows-системе, не требуя установки каких-либо дополнительных модулей.

Коннектор — это интеграционный модуль, который позволяет получать и отправлять контрагентам файлы, сформированные в вашей учетной системе через API Диадока.

Диадок.Коннектор может подписывать документы сертификатом или размещать документы в черновики. Обмен документами происходит в xml, рекомендованном ФНС формате, а также любыми другими документами. Коннектор инициирует запрос на получение данных из источников файлов, получает их и обрабатывает, далее определяет получателя документов и доставляет документы в ящик Диадока.

Способен работать с почтовым сервером, файловой структурой, FTP сервером.

Основные характеристики Коннектора

Назначения типовых коннекторов:

  • Доставка пакетов формализованных и неформализованных документов в папки
  • Исходящие или Черновики ящика Диадока
  • Массовая выгрузка документов и определенных структур данных, относящихся к этим документам, из ящика Диадока
  • Массовое согласование документов, находящихся в ящике Диадока
  • Подписание документов, находящихся в ящике Диадока
  • Пересылка документов из ящика Диадока у Клиента в ящик Диадока Третьей стороны
  • Выгрузка пересланных документов из ящика Диадока
  • Разработка индивидуальных коннекторов для решения клиентских задач помимо вышеперечисленного включает преобразование форматов исходных файлов для передачи в Диадок

Варианты размещения коннектора

Самым распространённым вариантом является установка коннектора на сервер клиента.

коннектор диадок

Так же есть и другие варианты размещения коннектора:

  1. Источники файлов — на сервере клиента, Коннектор — на сервере СКБ Контур
  2. Коннектор и Источники файлов — на сервере СКБ Контур
  3. Источники файлов на сервере СКБ Контур, Коннектор — на сервере клиента

Требования к размещению коннектора на серверах клиента

Для работы программы требуется сервер или виртуальная машина с установленной операционной системой Windows, Net Framework 4.0, КриптоПро.

Для приложения должен быть открыт интернет до наших серверов API (46.17.200.0/21). Так же коннектору требуется доступ к почтовому серверу или файловой шаре, при работе через почту или файлы в качестве транспорта, соответственно.

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

При размещении коннектора на серверах клиента необходимо сохранить возможность доступа наших специалистов на площадку (возможно по согласованию с ИТ).

Основная предпосылка к размещению на площадке клиента — необходимость в автоматическом подписании документов.

КонтурДиадок. Интеграция с 1С. Электронный документооборот в 1С

Внешняя обработка для работы с электронными документами. Непосредственно в 1С вы можете:

Сформировать и отправить ТОРГ-12, счет-фактуру, акт и другие документы

Работать с УПД (универсальный передаточный документ)

Учитывать входящие документы сразу же в системе 1С

Сопоставлять входящие документы с документами 1С

Получить и подписать документы с помощью электронной подписи

Пригласить ваших контрагентов к работе в Диадоке

Совместимость с конфигурациями 1С

Платформа 1С 8.3 (управляемое приложение)
начиная с 8.3.4.465
Бухгалтерия предприятия, редакция 3.0 и 3.0 КОРП;
Управление торговлей, начиная с редакции 11.1.4;
1С:ERP Управление предприятием, редакция 2.0;
Комплексная автоматизация, редакция 2.0;
Бухгалтерия государственного учреждения 2.0;
Управление небольшой фирмой с 1.4.9.49, с 1.5.4.57, с 1.6.1.81 и старше.
Платформа 1С 8.2 и 8.3
Бухгалтерия предприятия, редакции 2.0 и 2.0 КОРП;
Управление производственным предприятием, редакция 1.3;
Управление торговлей, редакции 10.2 и 10.3;
Комплексная автоматизация, редакция 1.1;
Альфа-Авто: Автосалон+Автосервис+Автозапчасти, редакции 4.1 и 5.
Платформа 1С 8.2 и 8.3 (обычное и управляемое приложения)
Нестандартные и измененные конфигурации.
Платформа 1С 8.1
Управление производственным предприятием, редакция 1.2;
Управление торговлей 10.3;
Бухгалтерия предприятия, редакция 1.6. (Требуется доработка конфигурации. За подробностями обратитесь в техподдержку.)
Платформа 1С 7.7
Бухгалтерский учёт, редакция 4.5;
Комплексная конфигурация, редакция 4.5;
Торговля и склад, редакция 9.2;
Упрощенная система налогообложения, ред. 1.3.

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

Интеграционный комплекс Контур-ERP для SAP обеспечивает бесшовную интеграцию SAP ERP с Диадок для подписания, отправки и получения юридически значимых электронных документов.

Основные возможности

Интеграционный комплекс обеспечивает:

  • Создание, отправку и получение электронных формализованных и неформализованных документов непосредственно в SAP ERP, а также отслеживать их статус
  • Подписание документов электронной подписью непосредственно в SAP ERP
  • Регистрацию и связывание электронных документов со внутренними документами системы SAP ERP

Интеграционный комплекс поддерживает две основные конфигурации: с подписанием документов на сервере или рабочих местах.

1. Подписание документов на рабочих местах

интеграция sap

2. Подписание документов на сервере

интеграция sap сервер

КонтурДиадок решение для Oracle

Решение LegalDoc обеспечивает юридически значимый электронный документооборот с контрагентами.  Все действия по отправке и получению электронных документов производятся непосредственно из OeBS  Oracle E-Business Suite через сервис Контур.Диадок.

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

LegalDoc позволяет автоматизировать подключение контрагентов в интерфейсе OeBS, включая проверку контрагентов на предмет регистрации в Диадоке и отправку приглашений.

Основные возможности

Интеграционный комплекс обеспечивает:

  • Работу с пятью типами документов: счета-фактуры, товарные накладные (ТОРГ-12), акты выполненных работ, акты сверки, договоры;
  • Передачу дополнительной информации: дата и номер договоров, доп. соглашений, сведения о комиссионере;
  • Формирование комплектов документов: счет-фактура + ТОРГ-12, счет-фактура + ТОРГ-12 + акт выполненных работ и т д.;
  • Легкий доступ к внутренним и внешним нормативным документам.
  • Регламентированную работу пользователей с документами;

Этапы и сроки внедрения

Внедрение LegalDoc происходит в несколько этапов.

  1. Описание процессов документооборота.
  2. Формирование требований к работе системы для конкретного потребителя LegalDoc.
  3. Установка и тестирование решения у Заказчика.
  4. Обучение сотрудников работы в системе с новыми возможностями.

На срок внедрения влияют несколько факторов. К ним относятся:

  • тип документов, работа с которыми входит в задачи ЭДО;
  • объем дополнительной информации, которую нужно будет передавать;
  • изменения, которые нужно внести в OeBS при внедрении;
  • число пользователей, которым предстоит работать в системе.

КонтурДиадок решение для ПАРУС

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

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

К данному механизму интеграции могут прибегнуть пользователи «Парус-Бюджет 8», «Парус-Предприятие 8», промышленной версии системы 8.5.6.1.

Основные возможности

  • Оперативная отправка электронных документов контрагентам прямо из учетной системы
  • Отслеживание статуса отправленных документов: «получен», «подписан» и т д.
  • Импорт входящих электронных документов из Диадока в учетную систему
  • Быстрое удаленное согласование и подпись документов либо отклонение с указанием причины
  • Оперативный обмен документами между компаниями для корректировки
  • Массовая подпись и рассылка документов контрагентам

КонтурДиадок Universal Data Transporter (UDT)

Universal Data Transporter (UDT) – интеграционное решение для обмена данными между Диадоком и учетной системой компании. Умеет обрабатывать исходящие документы в формате pdf. Решение состоит из:

  • модуля обработки документов;
  • модуля отчетности и управления службой;
  • сервера, на котором хранится статистика и сведения об операциях, выполненных решением.

UDT подходит для интеграции с биллинговыми и другими системами, которые нежелательно модифицировать для работы с электронными документами.

Основные возможности

UDT автоматически:

  • загружает в Диадок документы из учетной системы (в форматах pdf, xls и других);
  • распознает содержание документов и формализованные переводит в формат xml;
  • проверяет корректность документов в соответствии с установленной логикой;
  • формирует пакеты по заданному признаку, например, ИНН, КПП, наименование;
  • оповещает пользователей об ошибках выгрузки;
  • сохраняет статистику обработанных документов и отображает ее по запросу пользователя.

Этапы и приблизительные сроки внедрения базовой конфигурации проекта

Со стороны заказчика:

  1. Проанализировать документооборот компании: определить необходимые и лишние этапы.
  2. Выстроить желаемую схему электронного документооборота.
  3. На ее основе сформировать требования к UDT.

Со стороны исполнителя:

  1. Установить решение у заказчика — три рабочих дня.
  2. Провести пилотный проект с несколькими контрагентами — пять рабочих дней.
  3. Обучить пользователей работать с решением — два рабочих дня.
  4. Запустить модуль в промышленную эксплуатацию — пять рабочих дней.

Обозначенные сроки являются усредненными и актуальны, если решение подходит клиенту без индивидуальных доработок.

КонтурДиадок для MS Dynamics

Для средних и крупных компаний, которые пользуются системой ERP — Microsoft Dynamics AX (ранее Microsoft Axapta) и в рамках своей деятельности обмениваются большим количеством документов с подрядчиками, клиентами, партнерами — мы предлагаем варианты готовых интеграционных решений с системой электронного документооборота (ЭДО) Контур.Диадок.

Основные пользователи решения: сотрудники, отвечающие за приемку и/или реализацию товаров/услуг, занимающиеся обработкой первичных документов и обладающие правом их подписи.

Интеграция MS Dynamics AX с системой ЭДО Диадок позволяет

  • Осуществлять все операции по обработке, регистрации и отправке документов непосредственно из системы.
  • Автоматически подписывать документы КЭП как из системы MS Dynamics AX, так и из интерфейса ЭДО Диадок.
  • Отслеживать статусы документов и обеспечивает получение по ним своевременных напоминаний/оповещений.
  • Отказаться от необходимости вести бумажный архив — вся документация хранится в электронном виде.
  • Осуществлять представление документов в ИФНС в электронном виде напрямую из учетной системы Microsoft Microsoft Dynamics AX на адрес электронной почты удобным доступом из учетной системы Microsoft Dynamics AX Dynamics AX в установленном формате.

КонтурДиадок для Архив ЭЛАР

Интеграционное решение «Элар» обеспечивает интеграцию системы электронного документооборота Контур.Диадок и хранилища «Элар Саперион». Решение успешно прошло испытания у заказчиков и сертифицировано компанией СКБ Контур.

Это комплексное интеграционное решение позволяет пользователю создавать и передавать не только формализованные документы в формате xml, но и работать со сканами, текстами, файлами в форме pdf и другими видами информации. При этом оно дает возможность разграничивать права доступа к этим сведениям.

Основные возможности

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

  • импорт/экспорт электронных документов из/в систему ЭДО;
  • оперативный обмен электронными документами с контрагентами;
  • автоматическая регистрация электронных документов;
  • согласование документов;
  • контроль этапов работы с электронными документами;
  • надежное и защищенное хранение электронных документов;
  • сквозной поиск как по внутренним ресурсам компании, так и по внешним источникам.

Варианты внедрения

«Элар Саперион» имеет модульную структуру, поэтому интеграционное решение предполагает различные варианты внедрения в зависимости от индивидуальных запросов и требований пользователя к системе.

КонтурДиадок для Архив EnSol

Коннектор EnDocs — это решение для быстрой интеграции информационных систем компаний с Диадоком.

EnDocs основан на программной платформе Microsoft SharePoint Server, и все действия по отправке и получению электронных документов производятся непосредственно в информационной системе Заказчика через сервис Контур.Диадок.

Основные возможности

Данное решение обеспечивает всю необходимую функциональность для бухгалтерских документов:

  • получение, автоматический импорт и регистрация входящих документов в учетной системе;
  • отправка контрагентам документов, сформированных в EnDocs;
  • подписание (в т. ч. автоматизированное) документов КЭП;
  • получение данных о статусе документов (подписан, получен, отказ в подписи и др.);
  • генерация печатных форм (в формате PDF) входящих документов и их отображение непосредственно в интерфейсе учетной системы;
  • формирование локального архива документов;
  • хранение истории обмена документами, включая полный протокол.

Результат внедрения

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

КонтурДиадок дляDirectum

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

Внедрение данного интеграционного коннектора позволяет:

  • автоматизировать процессы, что снизит процент ошибок; мгновенно доставлять документы адресату;
  • гарантировать целостность и конфиденциальность пересылаемых документов;
  • ускорить бизнес-процессы за счет оперативной подписи и оплаты;
  • сократить издержки на документооборот.

Основные возможности

После внедрения коннектора пользователи могут:

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

Решение

Коннектор разработан на платформе IS-Builder и основан на возможностях системы DIRECTUM, реализованных в модуле «Интеграция с системами обмена документами».

КонтурДиадок для Docsvision

Интеграционное решение для Docsvision 5 и системы ЭДО Контур.Диадок представляет собой дополнительный модуль, внедрение которого позволяет компаниям мгновенно обмениваться внешними и внутренними электронными документами, не выходя из системы Docsvision.

Все электронные документы, отправляемые и получаемые в Docsvision через Диадок, подписываются квалифицированной электронной подписью и обладают юридической силой, поэтому не требуют дублирования на бумаге.

Контрагентам, с которыми планируется обмен документами, достаточно иметь доступ к Диадоку через веб-клиент.

Основные возможности

  • Создание исходящих документов в Docsvision и их отправка через Диадок
  • Подписание в Docsvision документов с помощью квалифицированной электронной подписи (КЭП)
  • Получение в Docsvision ответной подписи контрагента
  • Получение в Docsvision входящих документов через Диадок и их автоматическая регистрация в Docsvision
  • Визирование входящего документа по запросу контрагента и отправка контрагенту из Docsvision
  • Отказ от запрошенной контрагентом ответной подписи с указанием причины
  • Поиск в Docsvision входящих и исходящих документов, переданных через Диадок, по различным реквизитам, а также их группировка по статусам («Подписан», «Отправлен», «Ожидает подписи» и др.)
  • Исправление и корректировка счетов-фактур
  • Отправка запроса на уточнение полученных счетов-фактур

Архитектура и компоненты

Модуль состоит из следующих компонентов:

  1. Библиотека DiadocApi.dll, содержащая API для взаимодействия с Диадоком;
  2. Библиотека EcmGroup.DiadocDvExtension.dll — серверное расширение Docsvision, через которое Docsvision взаимодействует с Диадоком;
  3. Клиентская библиотека EcmGroup.DiadicDvLib.dll для работы с карточками «Документ Диадок» в Docsvision;
  4. Библиотека EcmGroup.DiadicDvLib.SnapIn.dll — расширения консоли настройки сервера Docsvision для настройки соединения с Диадоком;
  5. Библиотека карточек «Интеграция с Диадоком», которая содержит схему карточек «Документ Диадок», основанную на схеме базовых карточек, и схему карточек событий Диадока;
  6. Бизнес-процесс, который производит загрузку событий из Диадока в Docsvision.

КонтурДиадок для Омега-Абакус WEB

Система Омега-Абакус WEB конвертирует и отправляет файлы документов в форматах pdf, doc, xls, txt и др. из учетной системы в систему ЭДО Контур.Диадок. Система представляет собой web-сервер, который через http API взаимодействует с сервером Диадока.

Омега-Абакус WEB имеет трехуровневую структуру, которая включает: систему управления базами данных (СУБД), сервер приложений и ПО клиента. Сервер приложений использует фреймворк Django для обработки web-запросов и формирования запросов к базам данных. Поэтому в качестве СУБД может выступать любой сервер баз данных, поддерживаемый Django (например, MySQL, Oracle, MS SQL и т.д.).

Сервер приложений включает:

  • web-сервер Apache;
  • диспетчер сессий (язык разработки ― Python);
  • сессии пользователей и дополнительных сервисов (Python), которые создает диспетчер.

В качестве операционной системы для сервера приложений можно использовать как сетевые версии Windows, так и Linux.

ПО клиента ― web-браузер на компьютере пользователя (требуется поддержка JavaScript).

Основные возможности

  • формирует справочные данные: идентификаторы получателя и отправителя, тип документа и т.д. ― для отправки в Контур.Диадок;
  • загружает файлы данных на web-сервер Абакус WEB;
  • конвертирует pdf, doc, xls, txt и др. файлы в формат документов системы Абакус WEB;
  • позволяет редактировать содержание в документах Абакус WEB до отправки в Диадок;
  • отправляет документы в Диадок;
  • отслеживает и фиксирует любые действия с документами в Диадоке, показывает их актуальные статусы;
  • формирует и отправляет на e-mail контрагентов извещения о том, что им отправлены документы;
  • имеет доступ к печатным формам документов в Диадоке;
  • формирует отчеты по отправленным документам;
  • позволяет настроить систему так, чтобы получать данные из учетных систем пользователя.

Схема работы

  1. Пользователь формирует справочник договоров, в котором идентификаторы контрагентов в учетной системе привязаны к идентификаторам в Диадоке. Он сохраняется в базе данных системы Омега-Абакус WEB. Пользователь может изменить данные через web-интерфейс.
  2. Пользователь загружает файлы документов на сервер Абакус WEB.
  3. Система извлекает данные из файлов, проверяет наличие ключевых полей, определяет идентификаторы, необходимые для передачи данных в Диадок, верифицирует документы.
  4. На основании извлеченных данных система формирует необходимые xml-файлы,  создает документы ЭДО и отправляет их в систему Диадок.

Все отправленные документы сохраняются в Абакус WEB. Статусы и история событий по ним обновляются по данным Диадока.

В web-интерфейсе Абакус WEB можно фильтровать (искать) документы по любым полям, формировать отчеты по отправкам, получать печатные формы документов, отправлять извещения контрагентам и т.д.

Подписывать документы можно как на сервере Диадока, так и в системе Абакус WEB.

Это сайт официального партнера Контура