QuickBooks

QuickBooks

Интеграция с API QuickBooks Online с использованием управляемой OAuth-аутентификации. Позволяет работать с клиентами, поставщиками, счетами, платежами и формировать финансовые отчёты. Этот инструмент используется, когда необходимо взаимодействовать с бухгалтерскими данными QuickBooks. :

Быстрый старт

# Получение списка клиентов
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/quickbooks/v3/company/:realmId/query?query=SELECT%20*%20FROM%20Customer%20MAXRESULTS%20100')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Базовый URL

https://gateway.maton.ai/quickbooks/{native-api-path}

Замените {native-api-path} на соответствующий путь API QuickBooks. Шлюз автоматически проксирует запросы к официальному API QuickBooks Online. Параметр :realmId подставляется автоматически из конфигурации подключения вашей компании. :

Аутентификация

Каждый запрос требует передачи API-ключа Maton в заголовке авторизации:

Authorization: Bearer $MATON_API_KEY

Установите переменную окружения:

export MATON_API_KEY="YOUR_API_KEY"

Получение API-ключа

• Зарегистрируйтесь или войдите в аккаунт на maton.ai
• Перейдите в настройки аккаунта
• Скопируйте ваш API-ключ

Управление подключениями

Управление OAuth-подключениями QuickBooks осуществляется через сервис:

https://ctrl.maton.ai

Список подключений

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections?app=quickbooks&status=ACTIVE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Создание подключения

python <<'EOF'
import urllib.request, os, json
data = json.dumps({'app': 'quickbooks'}).encode()
req = urllib.request.Request('https://ctrl.maton.ai/connections', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Возможности и сценарии использования

• Получение и анализ данных о клиентах, счетах, платежах и поставщиках
• Создание и обновление счетов и карточек клиентов
• Учёт и синхронизация платежей
• Формирование отчётов (Profit & Loss, Balance Sheet)
• Пакетные операции и запросы для оптимизации работы с данными

Решение ориентировано на полноценную работу с бухгалтерскими процессами и может использоваться в автоматизации биллинга, CRM-системах и аналитических дашбордах. :

Ключевые преимущества

• Управляемый OAuth — без необходимости вручную обрабатывать токены
• Единый шлюз доступа к API QuickBooks
• Широкое покрытие функциональности (клиенты, счета, отчёты и др.)
• Поддержка SQL-подобных запросов
• Примеры и документация для быстрого старта