Інтеграція із сервісом EDIN-IDP

• Налаштування модуля обробки документів сервісу EDIN-IDP
• Інструкція користувача модуля обробки документів сервісу EDIN-IDP

Налаштування модуля обробки документів сервісу EDIN-IDP

Скорочення

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

Запуск модуля обробки документів сервісу EDIN-IDP

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

Для роботи з модулем EDIN-IDP у користувача повинна бути підключена послуга для роботи з API. Для роботи з програмою користувачеві надаються логін та пароль.

Для запуску модуля EDIN-IDP в обліковій системі 1С | BAS відкрийте файл запуску програми (передається користувачеві співробітниками EDIN) через меню Сервіс і Налаштування -> Файл -> Відкрити (Зображення 1).

_{Зображення 1 - Запуск модуля BAS IDP}

Після підтвердження вибору потрібного файлу відкриється початкова сторінка модуля EDIN-IDP (Зображення 2).

_{Зображення 2 - Початкова сторінка модуля EDIN-IDP}

Налаштування модуля EDIN-IDP

Для подальшої роботи необхідно провести синхронізацію EDIN-IDP та 1С | BAS. Для цього натисніть кнопку  «Налаштування» (Зображення 3).

_{Зображення 3 - Налаштування модуля EDIN-IDP. Вкладка «Підключення»}

В «Налаштуваннях» є 2 вкдадки

• Підключення
• Налаштування

Вкладка «Підключення»

На вкладці «Підключення» (Зображення 3) відображаються налаштування підключення модуля:

• Основний каталог – шлях до місця розташування файлу модуля.

• Сервер обміну – URL адреса платформи електронного документообігу EDIN (на цю адресу будуть надсилатись запити).

• Панель із переліком користувачів - можливо додати / видалити користувачів за допомогою відповідних кнопок панелі.

У полі «Сервер обміну» потрібно задати наступну URL адресу: https://idp.edin.ua/

Налаштування користувачів зберігаються в файлі config_idp:

• для керованих форм в базі даних BAS,
• для звичайних  форм - у каталозі розміщення обробки.

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

Вкладка «Налаштування»

На вкладці «Налаштування» задається мапа відповідності документів та їх полів в системах EDIN і 1С | BAS (Зображення 4).

_{Зображення 4 - Налаштування модуля EDIN-IDP. Вкладка «Налаштування»}

Для додавання мапи відповідності для нового документа виконайте наступні кроки:

1. Натисніть кнопку «Додати» зверху вкладки. 
2. В таблиці з'явиться нова порожня строка. Заповніть по черзі значення у всіх комірках цієї строки (найменування комірок задані в шапці таблиці). Для цього встановіть курсор в потрібну комірку та натисніть кнопку з трьома крапками (Зображення 5). 

_{Зображення 5 - Додавання налаштувань для нового документа}

• • Для комірок «Документ» та «Документ ОС» оберіть потрібне значення з випадаючого списку (Зображення 5).
  • Для комірки «ID документу» заповніть місце зберігання ідентифікатора (uuid) задачі розпізнання документа IDP в ОС клієнта на Формі налаштувань відповідності даних документу IDP (Зображення 6).

_{Зображення 6 - Налаштування ID документа}

• • Для комірки «EDIN налаштування документу» потрібно задати мапу відповідності полів обраного документа EDIN полям документа в ОС 1С | BAS (Зображення 7). На лівій панелі форми відображається перелік полів обраного документа 1С | BAS. На правій панелі форми відображається перелік полів обраного документа платформи EDIN з можливістю обрати формулу заповнення реквізитів.

_{Зображення 7 - Налаштування мапи відповідності полів документів}

Оберіть на лівій панелі реквізит документа ОС, для якого потрібно задати формулу відповідності, та встановіть курсор в комірці «Формула заповнення реквізита». Далі потрібно обрати відповідність тегу / тегам IDP на правій панелі.

Можливо задати 3 типи формули відповідності:

1. Пряма відповідність реквізита ОС 1С | BAS безпосередньо з файла IDP. Для цього потрібно обрати подвійним кліком потрібний тег в розділі «Дані файлу» правої панелі.
2. Відповідність реквізита ОС 1С | BAS тегу / тегам документа IDP за алгоритмом. Для цього потрібно обрати подвійним кліком потрібний тег або кілька тегів по черзі з розділу «Алгоритми» правої панелі. Зверніть увагу: Тут важлива послідовність полів у формулі!
   
3. Відповідність реквізита ОС 1С | BAS константі. Наприклад, в реквізиті «Валюта» завжди має бути значення «грн». Для цього оберіть подвійним кліком тег «CONSTANTA» на правій панелі (Зображення 8). Натисніть кнопку з трьома крапками. Оберіть з випадаючого переліку потрібний тип даних і натисніть кнопку «ОК». Після цього у вікні «CONSTANTA» з'явиться випадаючий список значень відповідного типу. Оберіть потрібне значення і натисніть кнопку «ОК».

_{Зображення 8 - Налаштування формули CONSTANTA}

Створені формули відповідності відобразяться на лівій панелі у стовбці «Формула заповнення реквізита» (Зображення 9).

_{Зображення 9 - Формули заповнення реквізита}

Після налаштування всіх формул натисніть кнопку «Зберегти».

Тепер документи даного типу можуть опрацьовуватись сервісом EDIN-IDP.

Інструкція користувача модуля обробки документів сервісу EDIN-IDP

Скорочення

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

Вступ

Дана інструкція описує роботу інтеграційного модуля обробки документів сервісу EDIN-IDP (далі - модуль EDIN-IDP) для облікової системи 1С | BAS (далі - ОС). Модуль являє собою зовнішню обробку для інтеграції електронного документообігу між ОС користувача та платформою EDIN 2.0. Модуль EDIN-IDP призначений для перетворення PDF-файлів та зображень на структуровані документи. Функціонал модуля певною мірою повторює роботу з сервісом EDIN-IDP .

Вкладка «Файли»

На вкладці «Файли» відображається перелік файлів, завантажених в систему за допомогою модуля EDIN-IDP (Зображення 1).

_{Зображення 1 - Вкладка «Файли». Додати документ}

Черговість дій для опрацювання документів:

1. Додати документ IDP.
2. Підв'язати завантажений документ IDP до існуючого документа ОС або створити новий документ у ОС.

1. Додавання документа IDP

Щоб додати документ в систему, натисніть кнопку «Додати документ» (Зображення 1, Покажчик 1). Далі у стандартному вікні «Відкриття файлу» оберіть потрібний файл та натисніть кнопку «Відкрити».

Дозволені для завантаження типи файлів: *.png; *.jfif; *.pjpeg; *.jpeg; *.pjp; *.pdf.

Після цього в нижній частині панелі з'явиться повідомлення про успішне додавання документа в чергу на розпізнавання (Зображення 2).

_{Зображення 2 - Підтвердження додавання документа в чергу на розпізнавання}

Після успішного закінчення процесу обробки даний документ з'явиться в таблиці зі статусом «Розпізнані» (Зображення 3).

_{Зображення 3 - Відображення розпізнаного документа в таблиці}

Якщо документ не з'явився в таблиці після закінчення процесу розпізнавання, перевірте фільтри вкладки. Можливо, налаштування фільтрів не дозволяє документу відобразитися.

Якщо система в процесі обробки не розпізнала завантажений документ, він відобразиться в таблиці зі статусом «Помилки».

2. Підв'язання документа IDP до документа ОС

Щоб підв'язати завантажений документ IDP до існуючого документа ОС, оберіть потрібний документ в таблиці, натисніть кнопку «Підв'язати» та оберіть з випадаючого списку опцію «Підв'язати» (Зображення 4).

_{Зображення 4 - Підв'язання документа IDP до документа ОС}

З'явиться вікно з переліком документів ОС обраного типу (Зображення 5). Оберіть документ ОС, який потрібно зв'язати із завантаженим документом IDP, та натисніть кнопку «Вибрати». 

_{Зображення 5 - Вибір документа ОС для підв'язання до документа IDP}

Після успішного підв'язання обраного документа IDP назва документа ОС з'явиться в таблиці в останній колонці «Документ ОС» (Зображення 6).

_{Зображення 6 - Документ IDP успішно прив'язаний до обраного документа ОС}

3. Відв'язання документа IDP від документа ОС

Якщо створений документ ОС є помилковим, потрібно відв'язати його від завантаженого документа IDP. Для цього оберіть потрібний документ IDP в таблиці, натисніть кнопку «Підв'язати» та оберіть з випадаючого списку опцію «Відв'язати» (Зображення 7).

_{Зображення 7 - Відв'язання створеного документа ОС від завантаженого документу IDP}

Обраний документ IDP буде відв'язано від відповідного документа ОС, зникне прив'язка в колонці «Документ ОС».

4. Створення документа в ОС

Для створення документа / документів в ОС відмітьте галочками потрібні документи IDP в колонці «Вибрати» таблиці (доступний множинний вибір) та натисніть кнопку «Створити документ у ОС» (Зображення 8).

_{Зображення 8 - Створення документів у ОС}

Для обраних документів IDP будуть створені та відповідно прив'язані документи ОС. В нижній частині панелі відобразиться повідомлення про успішне створення документа / документів ОС (Зображення 9). Прив'язка документів IDP до відповідних документів ОС відобразиться в колонці «Документ ОС» таблиці (Зображення 6), статус документа в колонці «Статус» зміниться на «Опрацьовані».

_{Зображення 9 - Підтвердження створення документів ОС}

4. Інші дії з документом IDP

Переглянути документ у форматі JSON

Щоб переглянути структурований документ у форматі JSON оберіть потрібний документ в таблиці та натисніть на кнопку «JSON» (Зображення 10). Після чого відкриється права бокова панель із відображенням обраного документа у форматі JSON. Для закриття панелі JSON знову натисніть на кнопку «JSON».

_{Зображення 10 - Перегляд документа у форматі JSON}

Відкрити оригінал документа

Щоб відкрити оригінал завантаженого файла, оберіть потрібний документ в таблиці та натисніть кнопку «Відкрити документ» (Зображення 11). Обраний документ відкриється за допомогою переглядача файлів відповідного типу, встановленого на Вашому комп'ютері, або за допомогою браузера.

_{Зображення 11 - Відкриття завантаженого документа}

Відкрити форму перегляду документа

При подвійному кліку на довільну комірку рядка документа відкриється форма попереднього перегляду документа IDP (Зображення 12). Відповідно до вказаних налаштувань відображаються знайдені дані, що будуть заповнюватися у документ ОС. Поля форми доступні для редагування. На підставі внесених значень буде створюватись документ ОС.

_{Зображення 12 - Форма перегляду документа IDP}

Особливості полів та колонок форми перегляду документа IDP (покажчики на Зображенні 12):

1. Документ ОС, який буде створюватися.
2. Реквізити документа ОС.
3. Значення, що буде записуватися у відповідний реквізит документа.
4. Опис налаштування, по якому йде пошук значень.
5. Опис значень документа IDP, які були використані для пошуку значень для документа ОС відповідно до налаштувань. Це необхідно, щоб бачити дані, на підставі яких знайдено / не знайдено значення для документа ОС.
6. Табличні частини документа ОС.
7. Якщо у табличній частині є колонки з назвами «Номенклатура» або «Одиниця виміру», біля них створюються додаткові колонки відповідно «Номенклатура IDP» та «Одиниця виміру IDP», у яких відображаються налаштування пошуку і значення, на підставі яких відбувався пошук. Це необхідно, щоб бачити дані, на підставі яких знайдено / не знайдено значення для документа ОС (аналогічно, як і колонки «Налаштування» та «Значення пошуку» в табличній частині вище).

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

При наведенні курсора на комірки у колонці «Контрагенти» з'являється спливаюча підказка з переліком всіх сторін, що були знайдені в обраному документі IDP (Зображення 13).

_{Зображення 13 - Перелік контрагентів по обраному документу IDP.}

Відкрити прив'язаний документ ОС в окремій вкладці

З колонки «Документ ОС» можна відкрити відповідний документ ОС в окремій вкладці (Зображення 14). Для цього зробіть подвійний клік на комірці потрібного документа в колонці «Документ ОС». 

_{Зображення 14 - Відкриття документа ОС в окремій вкладці}

Якщо до документа IDP прив'язано кілька документів ОС, після подвійного кліка на комірці обраного документа IDP в колонці «Документ ОС» відкриється випадаючий список для вибору потрібного документа ОС для відкриття в окремій вкладці (Зображення 15). 

_{Зображення 15 - Перелік прив'язаних документів ОС до обраного документа IDP}

Вкладка «Документи ОС»

На вкладці «Документи ОС» відображається перелік документів ОС, які прив'язані до завантажених документів IDP (Зображення 16).

_{Зображення 16 - Вкладка «Документи ОС»}

Можливі дії з документами:

1. Відкрити файл. Для цього оберіть потрібний документ ОС та натисніть кнопку «Відкрити файл» (Зображення 16, Покажчик 2). Обраний документ відкриється за допомогою переглядача файлів відповідного типу, встановленого на Вашому комп'ютері, або за допомогою браузера.
2. Відв'язати від документа IDP, якщо створений документ ОС є помилковим. Для цього оберіть потрібний документ ОС та натисніть кнопку «Відв'язати» (Зображення 16, Покажчик 3). Обраний документ буде відв'язано від відповідного документа IDP, він зникне з таблиці та зникне прив'язка у відповідного документа IDP на вкладці «Файли» в колонці «Документ ОС».
3. Відкрити документ в ОС. Для цього зробіть подвійний клік на потрібному документі. Обраний документ відкриється в окремій вкладці ОС (Зображення 14).