Короткий посібник з інтеграції сервісу EDIN «ETTN» з обліковими системи 1C на звичайних формах

Скорочення:

Е-ТТН – товарно-транспортна накладна в електронній формі

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

ЕЦП - електронно-цифровий підпис/печатка

GLN - (Global Location Number) глобальний номер місцезнаходження

НКІ - носій конфіденційної інформації

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

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

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

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

  • password - пароль користувача на платформі EDIN 2.0

  • api_key - пароль доступу до API

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

../_images/integration_guide_01.jpg

Важливо

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

При підключенні модуля облікова система 1С | BAS може вимагати від користувача дозвіл на виконання операцій з боку модуля (захист від небезпечних дій).

../_images/integration_guide_23.jpg

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

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

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

../_images/integration_guide_24.jpg

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

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

  • Об’єкти ОС

  • ЕЦП

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

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

Каталог архівів – місце збереження архівів та файлів.

Каталог вкладень – місце збереження вкладень документів.

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

Зберігати логи – при встановленій відмітці зберігається логи.

Каталог логів запитів з помилками – місце збереження запитів з помилками.

У цій вкладці додаються (зелена кругла кнопка «+») користувачі, для кожного вказуються свої Логін користувача API(email) / Пароль користувача API / API key / company_uuid (надається користувачеві співробітниками EDIN). У цій вкладці також здійснюється вибір користувачів, від імені яких будуть здійснюватися подальші дії, наприклад, запити на відображення Вхідних / Вихідних документів.

../_images/integration_guide_04.jpg

Примітка

Налаштування користувачів зберігаються в файлі UserSettings, який розміщується в підкаталозі (найменування = <користувач 1С | BAS>) на одному рівні з файлом запуску модуля.

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

2.2 Об’єкти ОС

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

../_images/integration_guide_25.jpg

EDIN Оновлення UUID – відмітка для оновлення UUID при помилково створених документах.

Спочатку потрібно додати та обрати електронні документи сервісу EDIN «ETTN», якими буде здійснюватись в подальшому електронний документообіг (колонка «Документ»):

../_images/integration_guide_06.jpg

Далі потрібно для кожного електроного документу обрати документ облікової системи (на підставі цього документу можливо буде створювати електронний документообіг) - колонка «Документ ОС»:

../_images/integration_guide_07.jpg

В колонках ID ТТН та ID заявки на транспортування вказуються налаштування місцерозташування uuid платформи цих двох основних документів сервісу (електронної «ТТН» та «Заявки на транспортування» відповідно). А в колонці «Сторона документообігу» обирається роль учасника документообігу , що дозволяє для кожної ролі вказувати різні налаштування для документів.

В колонці «EDIN Налаштування документу» вказуються загальні налаштування документів (маппінг для формування електронного документу з даних документів ОС). Для того аби відкрити форму налаштувань потрібно натиснути на кнопку «…»:

../_images/integration_guide_08.jpg

Відкрита форма налаштувань відповідності даних документа містить специфікацію тіла обраного електронного документа а також його табличної частини:

../_images/integration_guide_09.jpg

Для кожного із представлених тегів (полей) специфікації документу можливо обрати реквізити для заповнення: для цього потрібно обрати потрібний тег та в колонці «Опис налаштування» натиснути на кнопку «…»:

../_images/integration_guide_10.jpg

Після чого відкриється форма налаштувань відповідності даних електронного документу, в якій можливо обрати реквізит документа ОС для заповнення обраного тега електронного документу (кнопка «…»):

../_images/integration_guide_11.jpg

На формі в обраному реквізиті (умовно «1») можливо обрати підлеглий до нього інший реквізит (умовно «1.1»). Цю операцію вибору підлеглого реквізиту, що відноситься до вже обраного можливо продовжити («1.1»->»1.1.1»->»1.1.1.6»->»1.1.1.6.4»->»1.1.1.6.4.2» …) за допомогою кнопки:

../_images/integration_guide_12.jpg

Після вибору реквізиту стане доступним для редагування «Спосіб пошуку значень»:

../_images/integration_guide_13.jpg

«Спосіб пошуку значень»=»По значенню» свідчить, що для заповнення тегу електронного документу буде обрано значення реквізиту документу ОС. І для даного значення реквізиту, що наведений на зображенні вище не доступні «Додаткові властивості ОС». «Спосіб пошуку значень»=»Додаткові властивості ОС», які використовуються, коли потрібно обрати значення, що не зберігаються безпосередньо в об’єкті 1С | BAS:

../_images/integration_guide_14.jpg

Після чого можливо обрати назву додаткової відомості:

../_images/integration_guide_15.jpg

Для елементу довідника «Організація» доступно додатково обрати «Спосіб пошуку значень»=»Регістр відомостей» / «Контактна інформація: Юридична адреса» / «Контактна інформація: Фактична адреса», які використовуються, коли потрібно обрати значення, що не зберігаються безпосередньо в об’єкті 1С | BAS, дані яких потрібно взяти, для прикладу, з підлеглого регістра відомостей:

../_images/integration_guide_16.jpg ../_images/integration_guide_17.jpg ../_images/integration_guide_18.jpg

Також для елементу довідника «Контрагент» доступно обрати «Спосіб пошуку значень»=»По значенню» / «Додаткові властивості ОС» / «Контактна інформація: Юридична адреса» / «Контактна інформація: Фактична адреса»:

../_images/integration_guide_19.jpg

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

../_images/integration_guide_20.jpg

Таблиця 1 - Опис нетипових тегів для документу ТТН

N

Назва тега

Опис тега

Опис налаштування

29

EDIN_Price_Includes_VAT

Цена включает НДС

Вказує як ведеться облік ціни по НДС в межах документу

30

EDIN_TR_R03G10S

Номер договора с перевозчиком

Використовується при формуванні заявки на транспортування

31

EDIN_TR_R03G11S

Дата договора с перевозчиком

Використовується при формуванні заявки на транспортування

32

EDIN_TR_T4RXXXXG23S

Дата загрузки

Використовується при формуванні заявки на транспортування

33

EDIN_TR_T4RXXXXG24S

Время загрузки

Використовується при формуванні заявки на транспортування

34

EDIN_TR_T4RXXXXG25S

Контактная особа для загрузки

Використовується при формуванні заявки на транспортування

35

EDIN_TR_T4RXXXXG26S

Контактный телефон для загрузки

Використовується при формуванні заявки на транспортування

36

EDIN_TR_T4RXXXXG33S

Дата розгрузки

Використовується при формуванні заявки на транспортування

37

EDIN_TR_T4RXXXXG34S

Время розгрузки

Використовується при формуванні заявки на транспортування

38

EDIN_TR_T4RXXXXG35S

Контактная особа для розгрузки

Використовується при формуванні заявки на транспортування

39

EDIN_TR_T4RXXXXG36S

Контактный телефон для розгрузки

Використовується при формуванні заявки на транспортування

Таблична частина

10

EDIN_T1_Document_Quantity

Количество таб.части документа

Кількість позицій товару

11

EDIN_T1_Document_Price

Цена таб.части документа

Ціна в рядку, може бути з ПДВ або без ПДВ

12

EDIN_T1_Document_Amount

Сумма таб.части документа

Сума в рядку, може бути з ПДВ або без ПДВ

13

EDIN_T1_Document_Price_With_VAT

Цена с НДС таб.части документа

Значення обов’язково містить ціну позиції з ПДВ

14

EDIN_T1_Document_Amount_WithOut_VAT

Сумма без НДС таб.части документа

Значення обов’язково містить суму позиції без ПДВ

15

EDIN_T1_VAT_Amount

Сумма НДС

Сума ПДВ товару в рядку

16

EDIN_T1_VAT_Rate

Ставка НДС

Ставка ПДВ позицій товару

17

EDIN_T1_VAT_Percent

Процент НДС

Відсоток ПДВ позицій товару

2.3 ЕЦП

Розділ налаштувань електронно-цифрового підпису і печатки (ЕЦП), в якому зазначаються сертифікати ДФС (знаходяться у вільному доступі) і EDIN (надається співробітником компанії).

../_images/integration_guide_26.jpg

У таблицю через кнопку «+» можливо додати або шляхи до ключів підписанта, якими будуть підписуватись юридично значимі документи або вказати токен (НКІ). Якщо вказано шлях до файлу (ключа) і токену, то пріоритет надається файлу. Налаштування для токену («Тип пристрою» та «Пристрій» (серійний номер часто вказується на фізичному носії)) можливо вибрати зі списку або скористатись автоматичним підбором налаштувань.

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

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

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

../_images/integration_guide_22.jpg

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