Інструкція розробника. Первинні налаштування


Скорочення:

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

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

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

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


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

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

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

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

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

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

../../../_images/operator_instruction_011.jpg

Важливо

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

Примітка

Для 1С | BAS на керованих формах не потрібні права на каталог, в якому знаходиться обробка

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

../../../_images/operator_instruction_02.jpg

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

Примітка

Налаштування для 1С | BAS на керованих формах зберігаються у типовому довіднику 1С | BAS «Файли». Загальні налаштування зберігаються у елементі довіднику з назвою «EDIN_config», налаштування користувача зберігаються у елементі довідника із назвою «EDIN_UserSettings_» + Назва користувача інформаційної бази. При першому запуску (відсутній елемент довіднику «Файли» з назвою «EDIN_config» ) автоматично відкривається розділ «Налаштування» для введення всіх необхідних даних (надалі при запуску відкривається розділ «Вхідні»).

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

../../../_images/operator_instruction_0011.png

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

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

  • Об’єкти 1С | BAS

  • Користувач

  • ЕЦП

Підключення

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

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

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

../../../_images/operator_instruction_002.png

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

Примітка

Налаштування користувачів для 1С | BAS на керованих формах зберігаються у типовому довіднику 1С | BAS «Файли» у елементі довідника із назвою «EDIN_UserSettings_» + Назва користувача інформаційної бази.

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

Об’єкти 1С | BAS

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

../../../_images/operator_instruction_05n1.jpg

Вид конфігурації - поле заповнюється автоматично (модуль підставляє поточну версію конфігурації ОС 1С | BAS).

Важливо

Подивитися версію своєї 1С | BAS: Меню -> Довідка -> Про програму. У разі якщо облікова система 1С | BAS самописна або модифікована, то необхідно вибрати типову версію 1С | BAS, на підставі якої вона була написана/змінена. Неправильно обраний вид конфігурації може привести до проблем створення документів з 1С | BAS.

../../../_images/operator_instruction_061.jpg

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

Коди одиниць виміру - одиниці виміру, які повинні бути внесені в 1С | BAS (вказувати коди одиниць виміру необхідно в формі, яка відкривається при натисканні кнопки «Коди одиниць виміру»).

../../../_images/operator_instruction_20n1.jpg ../../../_images/operator_instruction_21n1.jpg

Номенклатура контрагентів – кнопка відкриття об’єкту 1C, в якому зберігаються артикули і штрихкоди номенклатури контрагентів. В залежності від виду конфігурації назва колонки і відповідно об’єкт 1С | BAS можуть змінюватися. Для всіх конфігурацій на звичайних формах і для конфігурації «Бухгаглерія» на керованих формах використовується регістр відомостей «Номенклатура контрагентів». Для інших конфігурацій на керованих використовується довідник «Номенклатура постачальників».

Мережі з особливою схемою роботи – налаштування для мереж в яких GLN контрагента співпадає з GLN точки доставки, тому потрібно вказати в якому полі знаходиться GLN контрагента для відправки документів.

../../../_images/operator_instruction_241.jpg

Після відкриття форми, для заповнення списку всіх мереж потрібно натиснути кнопку «Заповнити таблицю доступних мереж»:

../../../_images/operator_instruction_251.jpg

Далі у списку мереж потрібно відмітити ті які працюють по такій особливі схемі і вказати у якому полі платформи знаходиться GLN контрагента.

../../../_images/operator_instruction_261.jpg

Налаштування довідників

Важливо

Налаштування цього розділу рекомендовано виконувати володіючи знаннями досвідченного користувача або спільно з розробником 1С | BAS.

Для постачальників доступні 3 основні типи довідників (Організації, Контрагенти, Точки доставки), в які в ОС 1С | BAS будуть зберігатися власні дані користувача, дані контрагентів і їх точки доставки відповідно.

../../../_images/operator_instruction_231.jpg

У цьому розділі для кожного довідника проводиться налаштування «місця розташування» зберігання даних (GLN (обов’язково), Формат НН, Ціни з бази 1С | BAS…) всередині облікової системи 1С | BAS. Можливо заповнити всі табличні налаштування розділу «Довідники» за замовчуванням (кнопка «Заповнити за замовчуванням») або зробити всі налаштування вручну.

Принципи заповнення: «По замовчуванню» і «Ручний»

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

При ручному налаштуванні в колонці «Довідник 1С | BAS» відображаються списки доступних довідників, а в полях налаштувань (через double-click по необхідному полю) відкривається окрема форма заповнення налаштувань.

Важливо

У табличній частині налаштування «Довідник 1С | BAS» і «GLN» є обов’язковими до заповнення.

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

../../../_images/operator_instruction_081.jpg

При синхронізації з платформою електронного документообігу EDIN в ці довідники (Організації, Контрагенти, Точки доставки) автоматично підтягуються дані (перегляд/редагування через double-click). Організації наповнюються по користувацькому логіну (після успішної авторизації):

../../../_images/operator_instruction_10n1.jpg

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

../../../_images/operator_instruction_11n1.jpg

Довідник Точки доставки відрізняється від останнього наповненням колонок, відповідно до вимог EDI документообігу.

Відмітка «Точки доставки віртуально» призначена для тих, хто не веде точки доставки в базі 1С. Поставлена відмітка прибирає з налаштувань довідників налаштування по точках доставки. Створення документів та їх відправка буде використовувати ті точки доставки, які є на платформі.

../../../_images/operator_instruction_271.jpg

Налаштування документів

Важливо

Налаштування цього розділу рекомендовано виконувати володіючи знаннями досвідченного користувача або спільно з розробником 1С | BAS.

У цьому розділі для кожного типу документа проводиться налаштування «місця розташування» зберігання даних документів в УС 1С | BAS. Налаштування також можливо проводити По замовчуванню (кнопка «Заповнити за замовчуванням») та вручну через double-click. Принципи заповнення: «По замовчуванню» і «Ручний» табличної частини аналогічні налаштуванням довідників.

Створення документів в 1С | BAS залежить від виду конфігурації. 1С | BAS Бухгалтерія на звичайних і керованих формах дозволяє створювати «Рахунок на оплату покупця», «Реалізація товарів і послуг». Інші 1С | BAS (НЕ БУХГАЛТЕРІЯ) на звичайних формах дозволяють створити «Замовлення покупця», «Реалізація товарів і послуг». В 1С | BAS Управління невеликою фірмою і Управління середнім бізнесом на керованих формах можливо створити «Замовлення клієнта», «Видаткову накладну». Для 1С | BAS Управління торгівлею, Управління підприємством, Управління виробничим підприємством можливо створити «Замовлення клієнта» и «Реалізація товарів і послуг»:

../../../_images/operator_instruction_09n1.jpg

Користувач

Розділ в якому користувач може вибрати шлях локального сховища, в якому будуть зберігатися вхідні / вихідні ЮЗД документи, а також логи роботи модуля (аналіз документообігу). Поля Склад і Підрозділ також заповнюються для зручності користувача.

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

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

../../../_images/operator_instruction_131.jpg

Також у даному розділі можна зберігати налаштування користувача у файл для подальшого перенесення їх для іншого користувача.

../../../_images/operator_instruction_281.jpg

Кнопка «Зберегти налаштування» відповідає за збереження налаштувань користувача у файли config.txt та UserSettings.txt у вибраному каталозі; вікно вибору каталогу відкривається після натискання на кнопку.

Кнопка «Завантажити налаштування» відповідає за завантаження вище зазначених файлів, для налаштування поточного користувача. Після натискання на кнопку, відкриється вікно вибору файлу.

Увага

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

Проставлена відмітка в налаштуваннях «Розширений режим для оператора» додає на панель новий розділ «Оператор». Дана кнопка відповідає за розширений режим роботи (детальніше в Інструкції користувача):

../../../_images/operator_instruction_32.jpg

ЕЦП

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

../../../_images/operator_instruction_14n1.jpg

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

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

../../../_images/operator_instruction_291.jpg

Кнопка «Заповнити за замовчуванням» додає дві пусті рядки для налаштування ключів для основних типів документів.

../../../_images/operator_instruction_301.jpg

Примітка

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

За підпис документів без використання ключа печатки відповідає відмітка «Не використовувати печатку».

../../../_images/operator_instruction_311.jpg

Важливо

Деякі оператори АЦСК розділяють розділяють ЕЦП на «ключ печатки» та «ключ печатки для шифрування». В такому випадку потрібно вносити в налаштування три ключа. «Ключ печатки для шифрування» використовується лише при відправці «Податкової накладної».

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

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

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

../../../_images/operator_instruction_151.jpg

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