Полнофункциональный API
Программный интерфейс Диадока (API) позволяет очень просто интегрировать функциональность электронного документооборота в любую современную учетную систему (1С, SAP, Oracle, Microsoft Dynamics AX/NAV и др.).
API Диадока позволяет выполнять все те же основные операции, что и веб-приложение: отправлять документы и отслеживать обновления их статусов, получать документы, создавать счета-фактуры, запросы на корректировку счета-фактуры, акты, накладные, а также распознавать печатные формы счетов-фактур, подготовленные в любой бухгалтерской программе.
API Диадока позволяет выполнять все те же операции, что и в веб-интерфейсе:
- создание документов в утвержденном xml формате (счета-фактуры, запросы на корректировку счета-фактуры, акты, накладные);
- осуществлять все операции по получению и отправке документов непосредственно из ИС;
- автоматически подписывать документы КЭП как из ИС;
- отслеживать статусы документов;
- работать со списком контрагентов (приглашения, проверка на предмет регистрации в Диадоке);
- согласовывать документы;
- строить выборки документов по различным критериям
Подробное описание функциональных возможностей 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 сервером.
Основные характеристики Коннектора
Назначения типовых коннекторов:
- Доставка пакетов формализованных и неформализованных документов в папки
- Исходящие или Черновики ящика Диадока
- Массовая выгрузка документов и определенных структур данных, относящихся к этим документам, из ящика Диадока
- Массовое согласование документов, находящихся в ящике Диадока
- Подписание документов, находящихся в ящике Диадока
- Пересылка документов из ящика Диадока у Клиента в ящик Диадока Третьей стороны
- Выгрузка пересланных документов из ящика Диадока
- Разработка индивидуальных коннекторов для решения клиентских задач помимо вышеперечисленного включает преобразование форматов исходных файлов для передачи в Диадок
Варианты размещения коннектора
Самым распространённым вариантом является установка коннектора на сервер клиента.
Так же есть и другие варианты размещения коннектора:
- Источники файлов — на сервере клиента, Коннектор — на сервере СКБ Контур
- Коннектор и Источники файлов — на сервере СКБ Контур
- Источники файлов на сервере СКБ Контур, Коннектор — на сервере клиента
Требования к размещению коннектора на серверах клиента
Для работы программы требуется сервер или виртуальная машина с установленной операционной системой Windows, Net Framework 4.0, КриптоПро.
Для приложения должен быть открыт интернет до наших серверов API (46.17.200.0/21). Так же коннектору требуется доступ к почтовому серверу или файловой шаре, при работе через почту или файлы в качестве транспорта, соответственно.
Само приложение запускается стандартным Windows планировщиком, с указанием ключей запуска и ссылки на конфигурацию (подробнее в инструкции по настройке).
При размещении коннектора на серверах клиента необходимо сохранить возможность доступа наших специалистов на площадку (возможно по согласованию с ИТ).
Основная предпосылка к размещению на площадке клиента — необходимость в автоматическом подписании документов.
КонтурДиадок. Интеграция с 1С. Электронный документооборот в 1С
Сформировать и отправить ТОРГ-12, счет-фактуру, акт и другие документы
Работать с УПД (универсальный передаточный документ)
Учитывать входящие документы сразу же в системе 1С
Сопоставлять входящие документы с документами 1С
Получить и подписать документы с помощью электронной подписи
Пригласить ваших контрагентов к работе в Диадоке
Совместимость с конфигурациями 1С
начиная с 8.3.4.465
Модуль Диадока совместим со всеми версиями поддерживаемых конфигураций, выпущенными не ранее чем за 1 год до последнего обновления для них.
Интеграционный комплекс Контур-ERP для SAP обеспечивает бесшовную интеграцию SAP ERP с Диадок для подписания, отправки и получения юридически значимых электронных документов.
Основные возможности
Интеграционный комплекс обеспечивает:
- Создание, отправку и получение электронных формализованных и неформализованных документов непосредственно в SAP ERP, а также отслеживать их статус
- Подписание документов электронной подписью непосредственно в SAP ERP
- Регистрацию и связывание электронных документов со внутренними документами системы SAP ERP
Интеграционный комплекс поддерживает две основные конфигурации: с подписанием документов на сервере или рабочих местах.
КонтурДиадок решение для Oracle
Решение LegalDoc обеспечивает юридически значимый электронный документооборот с контрагентами. Все действия по отправке и получению электронных документов производятся непосредственно из OeBS Oracle E-Business Suite через сервис Контур.Диадок.
При этом пользователь формирует исходящие документы в автоматическом режиме, используя справочники OeBS. Входящие документы автоматически обрабатываются и вносятся в систему.
LegalDoc позволяет автоматизировать подключение контрагентов в интерфейсе OeBS, включая проверку контрагентов на предмет регистрации в Диадоке и отправку приглашений.
Основные возможности
Интеграционный комплекс обеспечивает:
- Работу с пятью типами документов: счета-фактуры, товарные накладные (ТОРГ-12), акты выполненных работ, акты сверки, договоры;
- Передачу дополнительной информации: дата и номер договоров, доп. соглашений, сведения о комиссионере;
- Формирование комплектов документов: счет-фактура + ТОРГ-12, счет-фактура + ТОРГ-12 + акт выполненных работ и т д.;
- Легкий доступ к внутренним и внешним нормативным документам.
- Регламентированную работу пользователей с документами;
Этапы и сроки внедрения
Внедрение LegalDoc происходит в несколько этапов.
- Описание процессов документооборота.
- Формирование требований к работе системы для конкретного потребителя LegalDoc.
- Установка и тестирование решения у Заказчика.
- Обучение сотрудников работы в системе с новыми возможностями.
На срок внедрения влияют несколько факторов. К ним относятся:
- тип документов, работа с которыми входит в задачи ЭДО;
- объем дополнительной информации, которую нужно будет передавать;
- изменения, которые нужно внести в OeBS при внедрении;
- число пользователей, которым предстоит работать в системе.
КонтурДиадок решение для ПАРУС
В результате интеграции пользователи «Паруса» формируют документы в привычной для себя программе, используя ее справочники и данные. При этом они получают возможность прямо из нее отправлять документы своим контрагентам, более того — отслеживать их прохождение.
Входящие документы из Диадока автоматически загружаются в учетную систему. Таким образом, из документооборота исключается этап ручного ввода данных.
К данному механизму интеграции могут прибегнуть пользователи «Парус-Бюджет 8», «Парус-Предприятие 8», промышленной версии системы 8.5.6.1.
Основные возможности
- Оперативная отправка электронных документов контрагентам прямо из учетной системы
- Отслеживание статуса отправленных документов: «получен», «подписан» и т д.
- Импорт входящих электронных документов из Диадока в учетную систему
- Быстрое удаленное согласование и подпись документов либо отклонение с указанием причины
- Оперативный обмен документами между компаниями для корректировки
- Массовая подпись и рассылка документов контрагентам
КонтурДиадок Universal Data Transporter (UDT)
Universal Data Transporter (UDT) – интеграционное решение для обмена данными между Диадоком и учетной системой компании. Умеет обрабатывать исходящие документы в формате pdf. Решение состоит из:
- модуля обработки документов;
- модуля отчетности и управления службой;
- сервера, на котором хранится статистика и сведения об операциях, выполненных решением.
UDT подходит для интеграции с биллинговыми и другими системами, которые нежелательно модифицировать для работы с электронными документами.
Основные возможности
UDT автоматически:
- загружает в Диадок документы из учетной системы (в форматах pdf, xls и других);
- распознает содержание документов и формализованные переводит в формат xml;
- проверяет корректность документов в соответствии с установленной логикой;
- формирует пакеты по заданному признаку, например, ИНН, КПП, наименование;
- оповещает пользователей об ошибках выгрузки;
- сохраняет статистику обработанных документов и отображает ее по запросу пользователя.
Этапы и приблизительные сроки внедрения базовой конфигурации проекта
Со стороны заказчика:
- Проанализировать документооборот компании: определить необходимые и лишние этапы.
- Выстроить желаемую схему электронного документооборота.
- На ее основе сформировать требования к UDT.
Со стороны исполнителя:
- Установить решение у заказчика — три рабочих дня.
- Провести пилотный проект с несколькими контрагентами — пять рабочих дней.
- Обучить пользователей работать с решением — два рабочих дня.
- Запустить модуль в промышленную эксплуатацию — пять рабочих дней.
Обозначенные сроки являются усредненными и актуальны, если решение подходит клиенту без индивидуальных доработок.
КонтурДиадок для 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 входящих и исходящих документов, переданных через Диадок, по различным реквизитам, а также их группировка по статусам («Подписан», «Отправлен», «Ожидает подписи» и др.)
- Исправление и корректировка счетов-фактур
- Отправка запроса на уточнение полученных счетов-фактур
Архитектура и компоненты
Модуль состоит из следующих компонентов:
- Библиотека DiadocApi.dll, содержащая API для взаимодействия с Диадоком;
- Библиотека EcmGroup.DiadocDvExtension.dll — серверное расширение Docsvision, через которое Docsvision взаимодействует с Диадоком;
- Клиентская библиотека EcmGroup.DiadicDvLib.dll для работы с карточками «Документ Диадок» в Docsvision;
- Библиотека EcmGroup.DiadicDvLib.SnapIn.dll — расширения консоли настройки сервера Docsvision для настройки соединения с Диадоком;
- Библиотека карточек «Интеграция с Диадоком», которая содержит схему карточек «Документ Диадок», основанную на схеме базовых карточек, и схему карточек событий Диадока;
- Бизнес-процесс, который производит загрузку событий из Диадока в 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 контрагентов извещения о том, что им отправлены документы;
- имеет доступ к печатным формам документов в Диадоке;
- формирует отчеты по отправленным документам;
- позволяет настроить систему так, чтобы получать данные из учетных систем пользователя.
Схема работы
- Пользователь формирует справочник договоров, в котором идентификаторы контрагентов в учетной системе привязаны к идентификаторам в Диадоке. Он сохраняется в базе данных системы Омега-Абакус WEB. Пользователь может изменить данные через web-интерфейс.
- Пользователь загружает файлы документов на сервер Абакус WEB.
- Система извлекает данные из файлов, проверяет наличие ключевых полей, определяет идентификаторы, необходимые для передачи данных в Диадок, верифицирует документы.
- На основании извлеченных данных система формирует необходимые xml-файлы, создает документы ЭДО и отправляет их в систему Диадок.
Все отправленные документы сохраняются в Абакус WEB. Статусы и история событий по ним обновляются по данным Диадока.
В web-интерфейсе Абакус WEB можно фильтровать (искать) документы по любым полям, формировать отчеты по отправкам, получать печатные формы документов, отправлять извещения контрагентам и т.д.
Подписывать документы можно как на сервере Диадока, так и в системе Абакус WEB.