Что это
Zoho Inventory API связывает складской учет с другими программами. Через разрешенные методы можно получать сведения о товарах, заказах и других ресурсах своей организации, чтобы не переносить их вручную.
У Zoho бывают разные организации и центры обработки данных. Поэтому действующего токена недостаточно: запрос должен идти в правильный региональный API, а organization_id должен принадлежать нужной компании. Ошибка здесь способна дать отчет не по тому складу.
Это обычный учетный API, а не модель прогнозирования спроса. Анализ, рекомендации по закупкам и текстовые пояснения выполняются отдельным процессом. Первый запуск лучше ограничить проверкой организации и чтением небольшого списка товаров.
Ключевые параметры
- Категория: Операционные задачи
- Сложность: Для разработчика
- Запуск: Около 30 минут
- Open-source: Нет
- Данные: Не известно
- Чувствительные данные: Только с настройками
Сильные стороны
- Ресурсы учета доступны по документированным REST-методам.
- OAuth scopes позволяют отдельно разрешить чтение настроек и товаров.
- organization_id явно задает компанию для последующих запросов.
- Можно начать на бесплатном плане, учитывая его функциональные и API-лимиты.
Ограничения
- Региональные домены авторизации и API должны соответствовать аккаунту.
- Нужны права пользователя и scopes конкретных ресурсов.
- Есть поминутные и суточные квоты на организацию, зависящие от плана.
- API не проверяет за вас полноту выгрузки и правильность бизнес-выводов.
Как использовать
1. Подготовка. Получите доступ к своей организации Zoho Inventory и определите ее дата-центр. Выберите только чтение организации и товаров; подготовьте известный учебный товар для сверки.
2. Настройка. Создайте OAuth client и получите токен по официальному процессу для своего региона со scopes ZohoInventory.settings.READ и ZohoInventory.items.READ. Используйте Authorization: Zoho-oauthtoken <access_token>, не Bearer. Храните секреты на сервере.
3. Первый результат. Для аккаунта в .com выполните GET https://www.zohoapis.com/inventory/v1/organizations; для другого дата-центра замените домен по документации. Найдите свою организацию по названию, сохраните ее organization_id. Затем выполните GET /inventory/v1/items?organization_id=<organization_id> на том же API-домене.
4. Проверка. Сверьте организацию и известный товар в интерфейсе Zoho. Проверьте пагинацию метода, прежде чем считать список полным. При 401 проверьте токен и регион, при отказе доступа - scopes и права; при 429 ограничьте опрос. Первый тест не должен создавать документы или изменять остатки.
Примеры сценариев
- Сверить организацию перед загрузкой товарного справочника.
- Получить список товаров для внутренней проверки.
- Подготовить источник учетных данных для отчета без записи в склад.
Доступ и оплата
- Модель оплаты: Бесплатный тариф + платные возможности
- Бесплатный тариф: Да
- Пробный доступ: Да
- Работа в РФ: Нужно проверять
- VPN: Не известно
- Русский интерфейс: Не известно
- Русский язык: Не известно
У Zoho Inventory есть бесплатный план и платные варианты, а также 14-дневный пробный период. API имеет лимит 100 запросов в минуту на организацию и суточную квоту по плану; для бесплатного плана указано 1000 запросов в день. Бесплатный доступ не означает неограниченный склад или API. Российские способы оплаты здесь не подтверждены.
Когда не подходит
- Автоматически корректировать остатки по предположению модели
- Смешивать токен одного дата-центра с API другого
- Считать первую страницу полной выгрузкой склада
Альтернативы
Odoo External API подходит для данных Odoo, Shopify Inventory API - для запасов Shopify, 1C OData - для опубликованных ресурсов своей базы 1С. Это альтернативные учетные системы, а не способы получить данные Zoho без подключения Zoho.
