Что это
Xero Accounting API связывает финансовую систему Xero с вашим приложением. Через него можно читать учетные данные и выполнять разрешенные операции с документами. Для подключения нужно согласие пользователя, подходящие права и правильная организация.
API сам не является бухгалтером или языковой моделью. Сверку, объяснение расхождений и черновик рекомендации готовит ваша программа или отдельно подключенный ИИ. Вывод модели не следует превращать в проведенный документ или платеж без проверки.
Начните с демокомпании и чтения сведений об организации. Это помогает проверить подключение до работы со счетами и персональными данными. Возможность читать ресурс не означает разрешения его изменять.
Ключевые параметры
- Категория: Операционные задачи
- Сложность: Для разработчика
- Запуск: Около 30 минут
- Open-source: Нет
- Данные: Не известно
- Чувствительные данные: Только с настройками
Сильные стороны
- Структурированные ресурсы удобны для сверки и отчетности без ручных выгрузок.
- OAuth позволяет подключать организацию с согласия ее пользователя.
- Права на чтение помогают отделить отчет от операций записи.
- Демокомпания дает учебные данные без использования рабочей бухгалтерии.
Ограничения
- Нужны разрешенные scopes и права пользователя в выбранной организации.
- Тариф разработчика, число подключений и лимиты API нужно учитывать отдельно от подписки Xero.
- Токены требуют безопасного хранения и обновления.
- Значение финансовых данных и применимость к местному учету проверяет специалист, не API.
Как использовать
1. Подготовка. Включите Xero Demo Company и выберите чтение ее настроек. Запишите ожидаемое имя и валюту; рабочие счета и платежи для первого теста не нужны.
2. Настройка. Зарегистрируйте отдельное OAuth-приложение и настройте Authorization Code для серверного подключения по официальному руководству. Запросите accounting.settings.read, проверяйте state, держите Client Secret на сервере. offline_access нужен только если требуется обновлять доступ без повторного входа.
3. Первый результат. После согласия пользователя прочитайте GET https://api.xero.com/connections с Bearer-токеном и выберите tenantId именно демокомпании. Выполните GET https://api.xero.com/api.xro/2.0/Organisation с Authorization: Bearer <токен>, xero-tenant-id: <tenantId> и Accept: application/json. Получите имя, BaseCurrency и IsDemoCompany.
4. Проверка. Сверьте организацию и валюту в Xero, убедитесь, что IsDemoCompany=true. Не выбирайте первый tenant без проверки. Ошибку прав или истекший токен не считайте пустыми данными. Для дальнейшего чтения счетов добавляйте права конкретного ресурса; широкие старые scopes не переносите в новую интеграцию автоматически.
Примеры сценариев
- Проверить правильную организацию перед отчетом.
- Составить очередь расхождений для бухгалтера.
- Подготовить черновик сводки без записи документов.
Доступ и оплата
- Модель оплаты: Платно
- Бесплатный тариф: Нет
- Работа в РФ: Нужно проверять
- VPN: Не известно
- Русский интерфейс: Не известно
- Русский язык: Не известно
У Xero есть подписка учетной системы и отдельные условия платформы разработчика. В таблице разработчика Starter не имеет ежемесячной платы и ограничен пятью подключениями; это не бесплатная рабочая бухгалтерия или неограниченный API. Остальные уровни и объем выгрузки могут оплачиваться. Доступность и оплата из России здесь не подтверждены.
Когда не подходит
- Заменить российский регламентированный учет одним API
- Проводить документы по непроверенному тексту модели
- Подключать все клиентские организации ради теста
Альтернативы
QuickBooks Online API работает с QuickBooks, 1C OData - с опубликованной базой 1С, Odoo External API - с Odoo. Это варианты для соответствующих учетных систем, а не способы прочитать Xero без разрешения.
