Zoho Inventory

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

Обзор

Навык обеспечивает доступ к API Zoho Inventory через прокси-шлюз, автоматически обрабатывающий OAuth-токены. Это позволяет выполнять полный набор CRUD-операций для различных сущностей: товаров, заказов, счетов, поставщиков и других объектов складского учета. :

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

# Получить список товаров
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/zoho-inventory/inventory/v1/items')
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/zoho-inventory/inventory/v1/{endpoint}

Шлюз перенаправляет запросы к официальному API Zoho и автоматически добавляет OAuth-аутентификацию.

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

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

Authorization: Bearer $MATON_API_KEY

Перед началом работы необходимо задать переменную окружения:

export MATON_API_KEY="YOUR_API_KEY"

Получить ключ можно в личном кабинете Maton после регистрации.

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

OAuth-подключения управляются через специальный сервис. Вы можете создавать, просматривать и удалять подключения к Zoho Inventory.

# Получить список подключений
GET https://ctrl.maton.ai/connections?app=zoho-inventory&status=ACTIVE

После создания подключения необходимо открыть предоставленный URL и завершить авторизацию в браузере.

Работа с несколькими подключениями

Если используется несколько подключений, можно указать нужное через заголовок:

Maton-Connection: 

Если заголовок не задан, используется подключение по умолчанию.

API: основные модули

• Items — товары и услуги
• Item Groups — группы товаров
• Contacts — клиенты и поставщики
• Sales Orders — заказы на продажу
• Invoices — счета
• Purchase Orders — закупки
• Bills — расходы поставщиков
• Shipment Orders — отгрузки

Примеры операций

Получение списка товаров

GET /zoho-inventory/inventory/v1/items

Работа с заказами

GET /zoho-inventory/inventory/v1/salesorders
GET /zoho-inventory/inventory/v1/salesorders/{salesorder_id}

Работа со счетами

PUT /zoho-inventory/inventory/v1/invoices/{invoice_id}
DELETE /zoho-inventory/inventory/v1/invoices/{invoice_id}

Дополнительно доступны действия со статусами счетов, отправкой email, комментариями, платежами и кредитами.

Закупки

GET /zoho-inventory/inventory/v1/purchaseorders
PUT /zoho-inventory/inventory/v1/purchaseorders/{purchaseorder_id}
DELETE /zoho-inventory/inventory/v1/purchaseorders/{purchaseorder_id}

Заключение

Навык Zoho Inventory предоставляет полный контроль над складскими и финансовыми операциями через единый API. Благодаря поддержке OAuth и централизованному управлению подключениями, он подходит для автоматизации бизнес-процессов и интеграции с другими системами.