Интеграция.
Протокол.
Данные.
RESTful API для автоматизации обмена данными с РЕГОН. Подтягивайте транзакции, отправляйте акты сверки и управляйте отчетностью программно.
Введение в REST API
Единый интерфейс для интеграции ваших сервисов с нашей бухгалтерской платформой.
API РЕГОН построено на стандартах REST и возвращает данные в формате JSON. Базовый URL для всех запросов: https://api.regon.dev/v1/.
Мы поддерживаем методы GET, POST, PUT и DELETE. Все даты передаются в формате ISO 8601, а суммы — в рублях (целое число, копейки не указываются).
Авторизация и токены
Bearer Token
Передавайте ваш уникальный ключ в заголовке каждого запроса: Authorization: Bearer {YOUR_API_KEY}. Ключ генерируется в личном кабинете.
Ограничения (Scopes)
Настройте права доступа для токена: read:transactions, write:reports. Это защитит данные при компрометации ключа.
Rate Limiting
Лимит: 100 запросов в минуту на бесплатный тариф и 1000 на Enterprise. При превышении возвращается статус 429 Too Many Requests.
Эндпоинты для транзакций
Программный доступ к финансовой активности вашего бизнеса.
GET /transactions
Возвращает список операций с пагинацией. Поддерживает фильтры по дате (from, to), сумме и типу (income/expense).
POST /transactions
Ручной ввод транзакции. Принимает JSON с полями: amount, currency, description, category_id. Автоматически классифицирует операцию.
Эндпоинты для отчетов
Налоговые декларации
Метод GET /reports/tax формирует готовую декларацию (УСН, НПД). Результат возвращается в формате PDF или XML для загрузки в ЛК ФНС.
СЗВ-ТД и РСВ
Автоматический расчет взносов за сотрудников. Эндпоинт POST /reports/insurance генерирует файлы для сдачи в Соцстрах и ПФР.
Экспорт в 1С/Excel
Получите выгрузку за любой период в формате .xlsx или .xml (конфигурация 1С), используя GET /reports/export.
SDK и примеры кода
import regon_api
client = regon_api.Client(key="YOUR_KEY")
tx = client.transactions.list(date_from="2023-10-01")
Установите библиотеку через pip install regon-api. Документация на PyPI доступна по ссылке в футере.
const Regon = require('regon-sdk');
const client = new Regon({ apiKey: 'YOUR_KEY' });
const transactions = await client.getTransactions();
Полная асинхронная поддержка. Установите через npm i regon-sdk.
var client = new RegonClient("YOUR_KEY");
var response = await client.Transactions.GetAsync();
Доступно как NuGet пакет. Оптимизировано для интеграции с ASP.NET Core сервисами.
Начать интеграцию
Создайте тестовый ключ в панели разработчика и проверьте работу методов в песочнице (Sandbox).
Перейти в Sandbox