Стаття містить декілька розділів. Для зручності можна одразу перейти у потрібний:

1. Перший запуск і налаштування модуля
2. Налаштування
3. Підключення
4. ЕЦП
5. Облікова система
6. Форми друку документів ОС
7. Контакти контрагентів

Скорочення та терміни:

• ОС — облікова система.
• ЕЦП — електронно-цифровий підпис/печатка.
• API (application programming interface) — набір визначених методів для взаємодії програмного модуля з сервісом WhiteDoc.
• Акаунт — обліковий запис, у якому зберігається різна інформація, що відноситься до користувача (налаштування та інша інформація).
• Мейлбокс (mailbox) — сутність, що є вхідною/вихідною точкою документообігу в сервісі. Може бути особистим або спільним для кількох користувачів на рівні одного акаунта.
• Конверт — основна одиниця документообігу в сервісі, що вміщує один чи кілька документів та формується згідно визначеним шаблоном.
• Шаблон — сукупність визначених користувачем правил формування документів, їх структури та порядку обробки, згідно з якими формується конверт.

Перший запуск і налаштування модуля 

Інтеграційний модуль сервісу WhiteDoc дозволяє працювати з обліковими системами 1С | BAS: Підприємство 8.Х на звичайних формах (надалі 1С | BAS) на базі операційної системи Windows.

Для роботи з модулем (за умови активної підписки на сервіс WhiteDoc) користувачеві потрібні логін, пароль та ідентифікатор мейлбокса:

• email — логін користувача;

• password — пароль користувача в сервісі WhiteDoc;

• ідентифікатор мейлбокса — унікальний на рівні сервісу ідентифікатор мейлбокса.

Для запуску модуля в обліковій системі 1С | BAS необхідно відкрити файл запуску модуля (передається користувачеві співробітниками WhiteDoc):

При першому запуску (відсутній config.txt) автоматично відкривається розділ «Налаштування» для введення всіх необхідних даних (надалі при запуску буде відкриватись розділ «Скринька»).

Налаштування 

При першому запуску інтеграційного модуля сервісу WhiteDoc автоматично відкривається розділ «Налаштування»:

Розділ містить 3 вкладки:

• Підключення

• ЕЦП

• Облікова система

Підключення 

Основний каталог — шлях до місця розташування файлу модуля та його конфігурації (вказується шлях за замовчуванням).

Каталог архівів — шлях до місця розташування, виділеного під архіви, що можуть бути сформовані користувачем під час роботи з модулем (якщо шлях не буде заповнений, то модуль при зберіганні архіву попросить його вказати).

Сервер обміну — адреса платформи електронного документообігу (на цю адресу надсилаються запити модуля): https://api.whitedoc.ua/

За допомогою зеленої круглої кнопки «+» потрібно додати користувача, при цьому вказуються Логін користувача API (email), Пароль користувача API та mailbox_uuid (ідентифікатор мейлбокса).
Токен сесії генерується при успішній авторизації автоматично.

Після того, як дані користувача були введені можливо здійснити перевірку введених даних кнопкою «Перевірити підключення користувачів», попередньо встановивши відмітку в колонці «Вибрати»:

В результаті перевірки отриманий Токен свідчить про коректно заповнені дані, пройдену авторизацію на платформі електронного документообігу. Також модуль відображає статусні повідомлення про успішність чи помилки, що можуть виникнути у користувача при роботі з модулем.

ЕЦП 

Розділ налаштувань електронно-цифрового підпису і печатки (ЕЦП).

Кнопка «Скачати технологічні сертифікати» дозволяє завантажити сертифікати ДФС (налаштування криптографії).
За допомогою зеленої круглої кнопки «+» потрібно вказати шлях до «Ключа підписанта», що буде використовуватись для підписання документів.

Опціонально: за потреби та наявності можливо також додати Ваш ключ печатки аналогічним способом:

При вивантаженні юридично значущих документів паролі можна вносити або до таблиці, або обробка відобразить вікно для їх внесення перед початком підписання.
Кнопка «Перевірити ЕЦП» дозволяє перевірити коректність введених даних ключів і паролів перед початком підписання.

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

При кожній перевірці ключа у вікні повідомлень відображається опис результату виконаної перевірки.

Облікова система 

Для подальшої роботи з електронним документообігом необхідно провести синхронізацію модуля та облікової системи (ОС).

Вікно вкладки налаштувань «Облікової системи» складається з наступних блоків:

• Форми друку документів ОС

• Контакти контрагентів

Форми друку документів ОС 

Потрібно додати та обрати типи документів з Вашої облікової системи, які будуть підтягуватись для подальшого електронного документообігу (колонка «Тип документа ОС»):

Далі потрібно для кожного обраного типу документа ОС обрати «Форму друку для вивантаження» (зовнішні друковані форми), що буде використовуватись для формування документа сервісу WhiteDoc:

Контакти контрагентів 

В інтеграційному модулі WhiteDoc, на відміну від web-версії, основним ідентифікатором контрагента в системі є адреса електронної пошти, а не мейлбокс.

В блоці «Контактів контрагентів» через кнопку «+Додати» можливо вказати електронні адреси (email) Ваших контрагентів:

Тепер Ви знаєте більше 😉
WhiteDoc