Что это
QuickBooks Online API - интерфейс учетной системы Intuit, а не отдельный AI-бухгалтер. Он позволяет получать данные о счетах, клиентах и других поддерживаемых объектах, а разрешенные изменения выполнять программно.
Для AI-сценария разумно начать с чтения: получить конкретный документ и передать только необходимые поля в отчет. Модель может помочь сформулировать пояснение, но суммы следует брать из учетных данных и проверять кодом.
Sandbox содержит учебную компанию и отдельные credentials Development. Рабочая компания и Production credentials - другой контур. Создание Invoice нельзя называть безопасным черновиком: оно меняет учет, а при определенных настройках может затронуть отправку клиенту.
Ключевые параметры
- Категория: Операционные задачи
- Сложность: Для разработчика
- Запуск: Около 30 минут
- Open-source: Нет
- Данные: Не известно
- Чувствительные данные: Только с настройками
Сильные стороны
- Документы имеют идентификаторы и поля сумм для воспроизводимой сверки.
- Sandbox позволяет проверять интеграцию на учебных данных отдельно от рабочей компании.
- Метод чтения одного объекта помогает начать без массовой выгрузки и записи.
- SyncToken помогает обнаруживать конфликт версии при изменении объекта.
Ограничения
- Нужны приложение Intuit, OAuth-подключение и доступ к соответствующей компании.
- Sandbox не повторяет все рабочие возможности, в частности подключение реального банковского счета.
- Методы имеют лимиты, а условия App Partner Program и платного доступа нужно проверять отдельно.
- Ошибочная запись влияет на учет; налоговые правила и региональные требования API за вас не проверяет.
Как использовать
1. Подготовка. В Intuit Developer используйте учебную Sandbox company с примером Invoice. Запишите realmId компании и Id существующего счета. Не берите номер DocNumber вместо внутреннего Id и не подключайте рабочую компанию для первого теста.
2. Настройка. Создайте приложение, используйте credentials Development и OAuth 2.0 Playground с Accounting scope. Авторизуйте именно Sandbox company. Сохраните access token вне кода; настройте обработчик только на нужные GET-запросы.
3. Первый результат. Отправьте GET https://sandbox-quickbooks.api.intuit.com/v3/company/{realmId}/invoice/{invoiceId} с Authorization: Bearer {access_token} и Accept: application/json. Из объекта Invoice возьмите Id, DocNumber, TotalAmt и Balance для учебной сверки.
4. Проверка. Сравните значения с тем же счетом в интерфейсе Sandbox, учитывая валюту компании или CurrencyRef. При ошибке разберите Fault, авторизацию и идентификаторы; 429 обрабатывайте ограниченными повторами. До перехода в Production отдельно согласуйте доступ, стоимость и запись. Первый сценарий не должен создавать, изменять или отправлять документы.
Примеры сценариев
- Сверить сумму одного учебного счета.
- Подготовить список счетов для дальнейшего контроля.
- Передать в AI-сводку агрегат, уже проверенный финансовым специалистом.
Доступ и оплата
- Модель оплаты: Платно
- Бесплатный тариф: Нет
- Пробный доступ: Да
- Работа в РФ: Нужно проверять
- VPN: Не известно
- Русский интерфейс: Не известно
- Русский язык: Не известно
Учебная среда не означает бесплатный рабочий QuickBooks. Production зависит от подписки компании и действующих условий API/App Partner Program. В официальном описании партнерской программы перечислены US, UK, Australia и Canada с оговоркой для Quebec; подключение и оплату из России здесь не подтверждаем.
Когда не подходит
- Заменять российский учет подключением зарубежного API
- Разрешать модели произвольную запись финансовых документов
- Считать получение Invoice проведением банковского платежа
Альтернативы
Xero Accounting API подходит пользователям Xero. 1С OData и Odoo External API работают с данными своих учетных систем. Выбирайте по используемой системе и требованиям учета: эти API не взаимозаменяемы и не выполняют автоматическую миграцию.
