# Налаштування модуля обробки документів сервісу 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) через меню Сервіс і Налаштування -&gt; Файл -&gt; Відкрити (Зображення 1).

[![Запуск модуля EDIN-IDP](https://wiki-v2.edin.ua/uploads/images/gallery/2025-12/akefiLaRFuqTTilw-open-file.png)](https://wiki-v2.edin.ua/uploads/images/gallery/2025-12/akefiLaRFuqTTilw-open-file.png)<sub>*Зображення 1 - Запуск модуля BAS IDP*</sub>

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

[![Початкова сторінка модуля EDIN-IDP](https://wiki-v2.edin.ua/uploads/images/gallery/2025-12/scaled-1680-/uzFE7GIB2VgUTwZ8-idp-home-page.png)](https://wiki-v2.edin.ua/uploads/images/gallery/2025-12/uzFE7GIB2VgUTwZ8-idp-home-page.png)<sub>*Зображення 2 - Початкова сторінка модуля EDIN-IDP*</sub>

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

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

[![Settings IDP.png](https://wiki-v2.edin.ua/uploads/images/gallery/2025-12/3tEzcOFeK0KDYQhL-settings-idp.png)](https://wiki-v2.edin.ua/uploads/images/gallery/2025-12/WmASfRbQjcMNLktu-settings-idp.png)<sub>*Зображення 3 - Налаштування модуля EDIN-IDP. Вкладка «Підключення»*</sub>

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

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

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

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

- **Основний каталог** – шлях до місця розташування файлу модуля.
- **Сервер обміну** – URL адреса платформи електронного документообігу EDIN (на цю адресу будуть надсилатись запити).
- Панель із переліком користувачів - можливо додати / видалити користувачів за допомогою відповідних кнопок панелі.

<p class="callout info">У полі **«Сервер обміну»** потрібно задати наступну URL адресу: [https://idp.edin.ua/](https://idp.edin.ua/)</p>

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

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

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

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

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

[![Налаштування модуля EDIN-IDP](https://wiki-v2.edin.ua/uploads/images/gallery/2025-12/scaled-1680-/EdIQ1k9JcZ23z7b9-idp-doc-settings.png)](https://wiki-v2.edin.ua/uploads/images/gallery/2025-12/EdIQ1k9JcZ23z7b9-idp-doc-settings.png)<sub>*Зображення 4 - Налаштування модуля EDIN-IDP. Вкладка «Налаштування»*</sub>

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

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

[![Додавання налаштувань для нового документа](https://wiki-v2.edin.ua/uploads/images/gallery/2025-12/scaled-1680-/zz14tN46v4MwvUiT-idp-add-doc-settings.png)](https://wiki-v2.edin.ua/uploads/images/gallery/2025-12/zz14tN46v4MwvUiT-idp-add-doc-settings.png)<sub>*Зображення 5 - Додавання налаштувань для нового документа*</sub>

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

[![Налаштування ID документа](https://wiki-v2.edin.ua/uploads/images/gallery/2025-12/dz4KEkSECFmhgRB4-idp-doc-mapping-1.png)](https://wiki-v2.edin.ua/uploads/images/gallery/2025-12/dz4KEkSECFmhgRB4-idp-doc-mapping-1.png "Налаштування ID документа")<sub>*Зображення 6 - Налаштування ID документа*</sub>

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

[![Налаштування мапи відповідності полів документа](https://wiki-v2.edin.ua/uploads/images/gallery/2025-12/scaled-1680-/fbm8GEeUhYCA1Z3K-idp-doc-mapping-2.png)](https://wiki-v2.edin.ua/uploads/images/gallery/2025-12/fbm8GEeUhYCA1Z3K-idp-doc-mapping-2.png)<sub>*Зображення 7 - Налаштування мапи відповідності полів документів*</sub>

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

Можливо задати <span style="text-decoration: underline;">3 типи формули відповідності</span>:

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

[![Налаштування формули CONSTANTA](https://wiki-v2.edin.ua/uploads/images/gallery/2025-12/scaled-1680-/15aPcnJIOTE4yisz-idp-doc-mapping-4.png)](https://wiki-v2.edin.ua/uploads/images/gallery/2025-12/15aPcnJIOTE4yisz-idp-doc-mapping-4.png)<sub>*Зображення 8 - Налаштування формули CONSTANTA*</sub>

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

[![Формули заповнення реквізита](https://wiki-v2.edin.ua/uploads/images/gallery/2025-12/scaled-1680-/DlHcfDCWoqRjuQ4b-idp-doc-mapping-3.png)](https://wiki-v2.edin.ua/uploads/images/gallery/2025-12/DlHcfDCWoqRjuQ4b-idp-doc-mapping-3.png)<sub>*Зображення 9 - Формули заповнення реквізита*</sub>

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

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