вгору

Як потрапляють дані до SAF-T UA: API, Excel і ручне введення

20.08.2025

SAF-T UA

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

– Ну от, – зітхнула вона. – Такий собі початок.

Тихо рипнули двері і на порозі з’явився Сафтій з двома горнятками кави в руках:

– Я тобі кави приніс, – усміхнувся він.

Очі Звітлани засяяли.

– Ти саме вчасно. Сафтію, я от розбираюся… Як в M.E.Doc API SAF-T UA взагалі потрапляють дані? Як воно все з різних місць збирається докупи?

– Все доволі просто. Існує три способи, як «накопичити» дані. Перший спосіб – через REST API. Це фаворит ІТ-шників, адже усе автоматично. Другий – імпорт з Excel-файлів. Тут уже знайомий багатьом підхід: завантажити, перевірити і можна працювати далі. Кажуть, бухгалтерам цей варіант найближчий. І, нарешті, третій – заповнення вручну. Це вже для сміливців, які не шукають легких шляхів.

– API – це той варіант, де дані можна підтягнути з облікової? – з надією уточнила Звітлана.

– Так, саме він. REST API – це, грубо кажучи, місток, по якому дані переходять з облікової системи прямо в M.E.Doc API SAF-T UA. О, ти навіть роздрукувала специфікацію API? Звітлана, то не твоя турбота… Просто передай специфікацію ІТ-фахівцям і скажи, які дані тобі потрібні. Далі вже їхня зона відповідальності.

– А вони самі розберуться?

– Розберуться, але без питань не обійдеться. Типу: звідки брати DocumentNumber, чому Amount з комою, а не крапкою, і чи є перевірки за типом. Але вони точно впораються.

– Ти так думаєш?

– Навіть не сумнівайся. І найприємніше – тобі не доведеться вручну готувати дані. Просто працюєш у своїй ERP системі, а вона вже передасть дані в M.E.Doc API SAF-T UA, де, своєю чергою, ти сформуєш файл за той період, який тобі потрібен.

– А якщо у мене не вся інформація ведеться в ERP системі, є щось в Excel, або зовсім не ведеться?

– Тоді тобі можна також автоматизуватися через Excel. Для кожного розділу файлу SAF-T UA є свій шаблон. Макросом заповнила, завантажила і дані вже в системі.

– А якщо я хочу щось заповнити вручну? Ну, як у старі добрі часи.

– Можна без проблем: заповнюєш, видаляєш — твій файл, тож ти ним керуєш.
– Окей, тоді інше питання. Як мені зрозуміти, що вже завантажено, а що ще ні?

– Гарне питання. У M.E.Doc API SAF-T UA є візуалізація джерел даних. Там видно: ось це підтягнулось через API, це – імпорт з Excel. Дані передані через API або Excel можна переглянути у розділі «Перегляд даних». Памʼятаєш, я минулого разу тобі про нього розповідав?

– А якщо щось пішло не так, можна перезалити?

– Можна все: оновити, доповнити, видалити. Головне – дотримуватися структури шаблонів або запитів.

– Сафтій, ми з тобою, як студенти на парі: разом вчимо, розбираємось... Можеш навчити мене працювати з API?

За вікном дощ лив, як із відра, а Звітлана і Сафтій весело й з азартом розбиралися з Postman.

Висновки:

Дані потрапляють у M.E.Doc API SAF-T UA через API, Excel або заповнюються вручну.

API – надійний і найстабільніший варіант.

Excel – додає гнучкості .

Усі дані можна перевіряти, редагувати і навіть вводити вручну (якщо дуже хочеться).

Далі буде...

«Файл без секретів: що таке XML, XSD, розмір і формат подачі». Поговоримо про технічні межі SAF-T UA, помилки, і як не загубитися у великому файлі на маленькому ноутбуці.