вгору

Medoc API SAF-T UA: як передавати облікові дані автоматично

19.11.2026

фінансова звітність, САФТ, SAF-T, Медок

Medoc API SAF-T UA – це рішення, яке об’єднує кабінет користувача, REST API для інтеграції з обліковими системами, Excel-шаблони для підготовки та завантаження даних, а також інструменти для роботи з XML-файлами SAF-T UA. Завантажені дані зберігаються в системі та використовуються для формування файлу за потрібний звітний період.  

Не встигли прочитати попередню статтю? Переходьте за посиланням.  

У цьому матеріалі зупинимося на роботі API Medoc. Розповімо, які дані можна передавати, яких технічних вимог необхідно дотримуватися, що слід перевірити перед налаштуванням інтеграції та на які моменти варто звернути увагу як бухгалтеру, так і ІТ-фахівцю. 

Що таке API Medoc для SAF-T UA і як воно працює? 

API – це інтерфейс взаємодії програмних систем.  

Уявімо, що підприємство веде облік в різних програмах, а файл SAF-T UA готує в Medoc API SAF-T UA. Звичайно переносити всі необхідні дані вручну - така собі перспектива, доцільно між цими системами налаштувати обмін через API.  

Тоді інформація передаватиметься безпосередньо з облікової системи до Medoc API SAF-T UA – автоматично або за командою користувача. 

Переглянути дані, передані через API, можна в розділі «Перегляд даних». Відрізнити їх можна за позначкою «API», як показано на зображенні: 

фінансова звітність, САФТ, SAF-T, Медок

Простіше кажучи, API допомагає передати дані з однієї системи в іншу без зайвої ручної роботи.   

За допомогою API можна передавати інформацію, необхідну для формування файлу SAF-T UA, зокрема:    

  • довідникові дані;    
  • бухгалтерські операції та журнали;    
  • дані про рахунки, обороти й сальдо;    
  • інформацію про контрагентів;    
  • відомості про запаси та необоротні активи;    
  • рахунки-фактури, платежі та інші документи;    
  • інші дані, передбачені структурою SAF-T UA.   

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

Як передати дані до SAF-T UA за допомогою API? 

Для передачі облікових даних із системи підприємства до Medoc API SAF-T UA необхідно налаштувати інтеграцію згідно зі специфікацією API. 

Для цього потрібно послідовно пройти кілька етапів:  

  • Підготувати дані 

Спочатку з’ясуйте, які дані необхідні для формування SAF-T UA та які з них уже є в обліковій системі підприємства. Далі потрібно зіставити наявні дані з вимогами SAF-T UA та специфікацією Medoc API. Це дасть змогу визначити, які дані можна передати безпосередньо, що потрібно підготувати додатково та яких обов’язкових реквізитів бракує. Щоб отримати специфікацію, перейдіть за посиланням та залиште свої контактні дані у формі «Отримати консультацію». Також ви можете надіслати відповідний запит на нашу електронну пошту [email protected]. 

  • Налаштувати авторизацію 

Передача облікових даних починається з авторизації через метод /api/auth. Для цього використовують ключі, отримані під час налаштування API.  

фінансова звітність, САФТ, SAF-T, Медок 

Після успішної авторизації система отримує JWT-токен, необхідний для подальших запитів до API. Його потрібно передавати згідно з вимогами специфікації. 

  • Організувати їх передачу 

Обмін даними здійснюється через захищене HTTPS-з’єднання за допомогою HTTP-запитів типу POST у форматі JSON. Для передачі кожного набору даних використовують відповідний метод API та дотримуються визначеної для нього структури запиту.  

Наприклад, запит для передачі бухгалтерських операцій має містити передбачені методом дані: необхідні ідентифікатори, реквізити та значення полів.  

Точні URL-адреси методів, обов’язкові поля, формат даних і заголовки запитів визначає специфікація Medoc API. Тому під час налаштування інтеграції важливо керуватися актуальною технічною документацією. 

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

  • Використати передані дані для формування SAF-T UA 

Після передачі та збереження даних  в Medoc API SAF-T UA уже можна розпочинати формування та подальшу роботу з відповідними розділами файлу, перевірки інформації та формування XML-файлу за потрібний звітний період.  

Отже, передача даних через API складається з кількох послідовних етапів: підготовка запиту → авторизація →  передача даних →  використання даних для формування SAF-T UA. 

Технічне налаштування запитів виконує ІТ-фахівець. Бухгалтер визначає, які облікові дані необхідні для формування SAF-T UA, перевіряє їхню повноту та контролює результати підготовки файлу. 

Ми не заглиблювалися в технічні нюанси передачі даних, а зосередилися на розумінні того, що API – це гнучкий інструмент, який можна інтегрувати з різними обліковими системами для отримання повного набору необхідних даних.  

Наприклад, одні методи використовуються для заповнення довідників з CRM, інші – для отримання даних про бухгалтерські операції з ERP. У результаті формується цілісна інформаційна база, необхідна для створення файлу SAF-T UA. 

Як імпортувати готовий XML-файл SAF-T UA? 

Якщо облікова система підприємства вже формує XML-файл SAF-T UA версії 2.0, його можна імпортувати до Medoc API SAF-T UA за допомогою відповідного API-методу.   

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

Отже, API дає змогу працювати двома способами: передавати окремі набори облікових даних або завантажувати вже сформований XML-файл. 

Які переваги дає використання API? 

API забезпечує повну автоматизацію роботи з даними.  

Основні переваги:  

  • Відсутність ручної роботи. Налаштувавши один раз, надалі все відбувається автоматично. Не потрібно вручну переносити великі обсяги облікової інформації. 
  • Правдивість даних. Оригінальна інформація передається безпосередньо з облікової системи користувача до Medoc API SAF-T UA.  
  • Перевірка перед збереженням. Система перевіряє дані на рівні API, виявляє помилки, відхиляє некоректні дані до їх збереження та повідомляє про це. 
  • Гнучкість роботи. Гнучкість полягає в тому, що АРІ можна підключити до різних систем. Можна передавати окремі довідники з  CRM, дані для розділу «Бухгалтерські операції» та підрозділи розділу «Документальне забезпечення» - з ERP системи, а також імпортувати готовий XML-файл SAF-T UA.  

Особливо корисним API може бути для підприємств, які працюють із великими обсягами облікової інформації або використовують кілька облікових систем.  

Наприклад, компанія N використовує три облікові системи: ERP – для ведення бухгалтерських операцій, CRM – для зберігання інформації про клієнтів і контрагентів, а MES/ERPJS – для виробничого обліку. Завдяки налаштуванню API-обміну з Medoc API SAF-T UA та регулярному оновленню інформації компанія отримає всі необхідні дані для безперешкодного формування файлу SAF-T UA. 

Зверніть увагу! API не виправляє автоматично помилки в бухгалтерському обліку, а контролює передачу елементів у повному обсязі згідно зі структурою.  

Висновок  

API Medoc забезпечує обмін даними між обліковими системами підприємства та Medoc API SAF-T UA, автоматизуючи до 90% роботи з підготовки даних для формування файлу SAF-T UA. 

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

І на останок. 

API може здаватися складною темою, адже потребує технічних знань, тому не всі бухгалтери готові одразу розбиратися в нюансах його підключення. Проте ми рекомендуємо не обирати лише найпростіший шлях, а розглянути можливість повноцінної автоматизації. Безумовно, на початковому етапі реалізація такого рішення може потребувати додаткового часу та залучення технічних фахівців. Водночас у довгостроковій перспективі ці інвестиції сприятимуть оптимізації робочих процесів і скороченню часу на підготовку файлу SAF-T UA. 

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

У наступних публікаціях розповімо, як працювати з Excel для підготовки та завантаження даних. Стежте за нашими матеріалами, щоб не пропустити корисні поради!