Погляд усередину
Цей безпечний перегляд показує, для чого потрібен інструмент, не виконуючи дій, що потребують акаунта.
Що вміє REST API та експорт DATEV
Хто серйозно працює з рахунками, рано чи пізно хоче вирватися з ручного клацання. Цифри мають самі потрапляти у власне програмне забезпечення, податковий консультант має отримувати проводки без передруковування, а інші системи мають дізнаватися, що рахунок оплачено. Саме для цього інструмент поєднує три складники: REST API, вихідні вебхуки та експорт DATEV.
REST API працює з обмеженими правами (scoped), тобто з тонко розподіленими дозволами. Ти створюєш ключі API і видаєш точкові права: «Читання продажів» (sales:read) для отримання рахунків, клієнтів, товарів і платежів, «Запис продажів» (sales:write) для створення чернеток, фіксації рахунків і проведення платежів, а також «Керування вебхуками» (webhooks:manage) для підписок на вебхуки. Кожен ключ показує свій префікс і час останнього використання та його можна відкликати будь-коли. Так ключ інтеграції для бухгалтерської програми обмежений рівно тими правами, які їй потрібні.
Вихідні вебхуки доставляють події в реальному часі на твою власну URL-адресу. Коли рахунок фіксується або платіж реєструється, система надсилає підписане повідомлення на твою кінцеву точку. Підпис HMAC дає змогу перевірити справжність кожної доставки, тож ніхто не підсуне підроблені події. Так ти автоматично реагуєш на господарські операції, замість того щоб постійно опитувати систему.
Експорт DATEV це серце співпраці з податковим консультантом. З твоїх рахунків за період інструмент формує сумісний з DATEV пакет проводок (Buchungsstapel) у форматі EXTF, який твоя контора (Kanzlei) може імпортувати прямо в DATEV Kanzlei-Rechnungswesen. Ти вказуєш номер консультанта (сім цифр), номер клієнта (п'ять цифр), початок господарського року та план рахунків (Kontenrahmen) SKR03 або SKR04, а експорт зіставляє рахунки доходів і дебіторів за канонічними правилами.
Перевірка сувора, бо DATEV суворий. Номери консультанта й клієнта мають мати точну кількість цифр, дата завершення має бути після дати початку. Дрібні помилки у форматі пізніше призводять до проблем з імпортом у конторі, тож краще, щоб інструмент одразу їх ловив і видавав зрозумілі повідомлення замість загадкових помилок DATEV.
Цей інструмент для всіх, хто хоче масштабувати свою бухгалтерію: фрилансерів з багатьма рахунками, малих підприємств із власними інструментами і всіх, хто хоче зробити свого податкового консультанта щасливим. Разом із API-Spielplatz для випробування кінцевих точок і скриптами для подальшої обробки виходить ланцюжок автоматизації, який помітно зменшує ручну бухгалтерську роботу.
Функції
Ключі API з обмеженими правами
Видавай точкові права: читання продажів, запис продажів або керування вебхуками. Окремо для кожного ключа, з можливістю відкликання будь-коли.
Дані рахунків через REST
Отримуй рахунки, клієнтів, товари й платежі програмно або створюй і фіксуй чернетки.
Вебхуки з підписом HMAC
Події приходять на твою URL-адресу в реальному часі з підписом HMAC, щоб можна було перевірити справжність кожної доставки.
Пакет проводок DATEV
Створюй сумісний з DATEV експорт у форматі EXTF для прямого імпорту в DATEV Kanzlei-Rechnungswesen.
SKR03 і SKR04
Обери свій план рахунків, і експорт зіставить рахунки доходів і дебіторів за канонічними правилами.
Сувора перевірка
Номери консультанта й клієнта та період перевіряються заздалегідь, щоб імпорт у конторі не провалився.
Як це працює
- 1
Створи ключ API
Створи ключ і видай лише ті права, які справді потрібні твоїй інтеграції.
- 2
Звертайся до кінцевих точок
Використовуй ключ, щоб отримувати або створювати рахунки й платежі через REST. Для тестів допоможе API-Spielplatz.
- 3
Налаштуй вебхуки
Зареєструй свою URL-адресу і перевіряй підпис HMAC кожного вхідного повідомлення, щоб реагувати на події.
- 4
Створи експорт DATEV
Впиши номер консультанта, номер клієнта, господарський рік і план рахунків, обери період і завантаж пакет проводок.
Кому це потрібно
Поширені запитання
Що таке пакет проводок DATEV?
Стандартизований файл у форматі EXTF, який твій податковий консультант може імпортувати прямо в DATEV Kanzlei-Rechnungswesen. Замість того щоб проводити кожен рахунок вручну, він передає весь пакет за один раз. Це економить час і запобігає помилкам перенесення.
SKR03 чи SKR04: що обрати?
Це залежить від плану рахунків твоєї бухгалтерії. Якщо сумніваєшся, запитай свого податкового консультанта, який із них вам підходить, і постав його в експорті. Інструмент зіставляє рахунки доходів і дебіторів відповідно до обраного плану.
Як захистити свої ключі API?
Видавай для кожного ключа лише потрібні права (scopes), наприклад лише читання для інструмента звітності. Якщо ключ використовують підозріло або пристрій скомпрометовано, відклич ключ негайно. Час останнього використання допомагає знайти ключі, які не використовуються.
Чому вебхуки підписані?
Щоб не було сумнівів, що вхідна подія справді від нас. Підпис HMAC обчислюється за твоїм секретним ключем. Якщо перевіряєш його на своєму боці, ніхто не зможе надсилати підроблені події на твою кінцеву точку.
Чому перевірка номерів така сувора?
Бо DATEV суворий. Номер консультанта має містити рівно сім цифр, номер клієнта рівно п'ять. Якщо формат не збігається, DATEV відхиляє імпорт. Інструмент перевіряє дані заздалегідь і повідомляє про помилки зрозумілою мовою, щоб пакет у конторі пройшов чисто.
Схожі інструменти
Майданчик для API
Тестуй HTTP-запити, керуй колекціями та змінними середовища.
Сервер mock
Створюй вигадані відповіді API й тестуй їх в інструменті: статус, заголовки, тіло та затримка.
Скрипти
Виконуй власний JavaScript в ізольованій пісочниці на сервері: для обчислень, перетворення да…
Калькулятор податку на доходи
Розрахуй свій Einkommensteuer (податок на доходи фізичних осіб) за § 32a EStG. Grundtarif і S…
Форматувальник JSON
Форматуй, перевіряй і мінімізуй JSON з підсвічуванням синтаксису та виявленням помилок. Безко…
Починаємо з REST API та експорт DATEV?
Без встановлення. Входить від Pro. Відкривається прямо в браузері.
Відкрити зараз