Інтеграція сервісу WhiteDoc з обліковими системами 1C | BAS

Написано Анатолій
Оновлено 6 місяців тому

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

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

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

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

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

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

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

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

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

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

Обрати та скопіювати потрібний Вам ідентифікатор можливо після авторизації на сторінці сервісу (https://edo.whitedoc.ua/login):

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

Важливо!
У користувача повинні бути повні права на каталог, в якому знаходиться файл модуля

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


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

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

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

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

  • ЕЦП

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


Підключення 

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

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

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

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

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

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

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

Важливо!
Після внесення всіх змін потрібно обов’язково натиснути кнопку «Зберегти налаштування» (в правій нижній частині вікна)

ЕЦП 

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

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

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

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

Пароль вказується один раз за сесію, наприклад, при підписанні першого документа (підписання інших документів протягом поточної сесії не потребує введення пароля).

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

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

Важливо!
Після внесення всіх змін потрібно обов’язково натиснути кнопку «Зберегти налаштування» (в правій нижній частині вікна)

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

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

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

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

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


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

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

В сервісі WhiteDoc можливо обмінюватись двома типами документів (зовнішні та структуровані) однак інтеграційний модуль на цей час підтримує роботу лише з зовнішніми документами!
Зовнішній документ допускає додавання файлу-вкладення в форматі pdf, doc, docx, xls, xlsx, xml, dbf, txt, rtf, png, jpg, jpeg, zip не більше 50 МБ (загальний розмір конверта при цьому не повинен перевищувати 50 МБ).

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

Важливо!
В якості форм друку для вивантаження модуля використовуються зовнішні друковані форми, для вибору яких потрібно попередньо їх долучити до Вашої системи 1С | BAS (рекомендоване залучення спеціаліста 1С):

Важливо!
Після внесення всіх змін потрібно обов’язково натиснути кнопку «Зберегти налаштування» (в правій нижній частині вікна).

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

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

Надіслані конверти через інтеграційний модуль WhiteDoc автоматично потрапляють до основного мейлбокса отримувача, а сповіщення про вхідні конверти відправляються всім, хто має доступ до основного мейлбокса отримувача (згідно з налаштуваннями).

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

Важливо!
Після внесення всіх змін потрібно обов’язково натиснути кнопку «Зберегти налаштування» (в правій нижній частині вікна).

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

Чи була наша стаття корисною?