Кратко
Управление запасами и заказами Cin7 Omni (go.cin7.com) через API v1: заказы на продажу, котировки, заказы на покупку, кредитные ноты, контакты, продукты, запасы по филиалам, филиалы, платежи (только для чтения), корректировки запасов, переводы между филиалами и пользователи. Создавай заказы, заказы на покупку, контакты и переводы. Имя пользователя и ключ API.
Пошаговая настройка
Подключи Cin7 Omni к Claude, ChatGPT или Copilot за 2 минуты
Начни бесплатный пробный период в AnythingMCP Cloud, подключи Cin7 Omni в пошаговой настройке и добавь свой MCP URL в своего ИИ-ассистента. Без кода и без собственного сервера.
Без банковской карты · 7 дней пробного периода · Есть вариант self-host
Попробуй спросить
Примеры промптов для Cin7 Omni
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Нет установки? Используй cloud.anythingmcp.com напрямую. Войди в систему, нажми Connectors → Cin7 Omni, вставь свои учетные данные, создай ключ API MCP, и всё готово. Никакого Docker, никакого
git clone, никакого локального сервера.
Cin7 Omni
Управление запасами и заказами Cin7 Omni (go.cin7.com) через API v1: заказы на продажу, котировки, заказы на покупку, кредитные ноты, контакты, продукты, запасы по филиалам, филиалы, платежи (только для чтения), корректировки запасов, переводы между филиалами и пользователи. Создавай заказы, заказы на покупку, контакты и переводы. Имя пользователя и ключ API.
Настройка
Настройка занимает около 3 минут. Тебе нужна учетная запись Cin7 Omni (вход по адресу go.cin7.com) и администратор, который может добавить соединение API v1. Коннектору нужны имя пользователя API и ключ API.
Omni или Core? Cin7 продает два разных продукта. Cin7 Omni (этот коннектор) входит на go.cin7.com и имеет API v1 с именем пользователя API и ключом. Cin7 Core (ранее DEAR Inventory) входит на inventory.dearsystems.com и имеет свой собственный API с идентификатором учетной записи и ключом приложения: используй коннектор Cin7 Core для этого. Эти два API и их учетные данные не взаимозаменяемы.
- В Cin7 Omni открой меню пользователя, затем Настройки → Интеграции и API → API v1.
- Скопируй Имя пользователя API, показанное в верхней части страницы, в
CIN7_OMNI_API_USERNAME. - Нажми Добавить новое API-соединение, дай ему имя и скопируй его ключ API в
CIN7_OMNI_API_KEY. Сгенерировать ключ заменяет утерянный ключ. - В разделе Разрешения отметь "Чтение" для каждого ресурса, который AI должен видеть, и "Создание" или "Обновление" для ресурсов, которые нужны инструментам записи, затем нажми Сохранить. Ресурс без разрешения отвечает 403.
- Установи коннектор. Запусти
cin7_omni_list_branches, чтобы проверить соединение: он перечисляет твои филиалы с их идентификаторами.
Облачные и локальные установки работают одинаково: учетные данные одинаковы, и нет URL для перенаправления, который нужно установить. Коннектор отправляет имя пользователя и ключ в качестве HTTP Basic аутентификации.
С чего начать: cin7_omni_list_branches для идентификаторов филиалов, cin7_omni_list_sales_orders для последних заказов, cin7_omni_list_stock для запасов по филиалам и cin7_omni_list_contacts для поиска клиента или поставщика.
Что он читает: заказы на продажу, котировки и кредитные ноты с их строками; платежи, зарегистрированные по заказам; заказы на покупку; продукты, их опции (продаваемые SKU) с ценами и категориями; запасы по опции продукта и филиалу (доступные, на складе, открытые продажи, поступления); корректировки запасов и переводы между филиалами; контакты и пользователи.
Что он записывает: cin7_omni_create_sales_order, cin7_omni_update_sales_order (только заголовочные поля, такие как стадия, код отслеживания и инструкции по доставке), cin7_omni_create_purchase_order, cin7_omni_create_contact, cin7_omni_update_contact и cin7_omni_create_branch_transfer включены. Новый заказ на продажу одобряется, если AI не создает его как черновик; заказы на покупку и переводы сохраняются как черновики, если не одобрены. Отгрузка и получение переводов происходят в Cin7.
Отключено при установке: cin7_omni_create_adjustment (создание корректировки запасов в одном филиале). Одобренная корректировка изменяет запасы на складе и стоимость запасов одновременно. Включи это на странице коннектора, если AI должен использовать его; AI попросит тебя подтвердить каждое изменение.
Проверь ответ на каждую запись: Cin7 отвечает HTTP 200 с списком {index, success, id, code, errors}, даже когда он отказал в записи. AI проверяет success и errors, прежде чем сообщить, что запись завершена.
Платежи только для чтения: коннектор никогда не регистрирует, не изменяет и не удаляет платежи, и он не отправляет, не выставляет счета или не аннулирует заказы.
Фильтрация: where принимает условия в стиле SQL по полям записи, а не по ее строкам. Строки и даты заключаются в одинарные кавычки, числа остаются без кавычек: modifiedDate>='2026-01-01T00:00:00Z' AND branchId=3, reference LIKE 'SO-10%', id IN (21,24). Даты в UTC, yyyy-MM-ddTHH:mm:ssZ. fields сокращает ответ (id,reference,total,lineItems(code,qty)), что помогает с заказами, потому что они большие.
Пагинация: page начинается с 1, а rows максимум 250 (по умолчанию 50, 25 в списках заказов). AI запрашивает следующую страницу, пока одна не вернется пустой.
Лимиты частоты: Cin7 Omni позволяет 3 вызова в секунду, 60 в минуту и 5,000 в день на учетную запись; за пределами этого он отвечает 429 с Retry-After. Большие rows с узкими фильтрами where используют бюджет лучше, чем множество мелких вызовов.
Значения: статус заказа — DRAFT, APPROVED или VOID, а стадия — это свободный текст стадии рабочего процесса (Новый, Ожидает платежа, Обработка, На удержании, Отправлено). Запас available — это запасы на складе минус открытые продажи. Тип контакта — Клиент, Поставщик или Внутренний. Записи принимают суммы в валюте заказа; чтения возвращают значения в базовой валюте с курсом обмена. Новые пользователи могут появляться в cin7_omni_list_users до 2 часов.
Распространенные ошибки: 403 означает, что API-соединение не имеет разрешения на этот ресурс: отметь его в разделе Разрешения и сохрани. 429 — это лимит частоты: подожди время Retry-After.
Предварительные условия: CIN7_OMNI_API_USERNAME, CIN7_OMNI_API_KEY
Установи коннектор локально
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Открой http://localhost:3000/connectors/store, выбери Cin7 Omni и вставь переменные окружения, указанные в предварительных условиях.
Доступные инструменты
| Инструмент | Что он делает |
|---|---|
cin7_omni_list_sales_orders | Список заказов на продажу, новейшие первыми: id, ссылка, статус (DRAFT, APPROVED, VOID), стадия, клиент (memberId, компания, email), branchId, даты… |
cin7_omni_get_sales_order | Чтение одного заказа на продажу с его строками, адресами, итогами, стадией, статусом, датами счета и отгрузки |
cin7_omni_list_quotes | Список котировок на продажу с клиентом, филиалом, итогами, стадией и строками |
cin7_omni_list_purchase_orders | Список заказов на покупку, новейшие первыми: id, ссылка, поставщик (memberId, компания), branchId, статус, стадия, estimatedArrivalDate… |
cin7_omni_get_purchase_order | Чтение одного заказа на покупку с его строками, поставщиком, датами и итогами |
cin7_omni_list_credit_notes | Список кредитных нот: id, ссылка, salesReference (заказ на продажу, который он кредитует), клиент, итоги, статус и строки (отрицательные количества) |
cin7_omni_get_credit_note | Чтение одной кредитной ноты с ее строками и итогами |
cin7_omni_list_payments | Список платежей, зарегистрированных по заказам: id, orderId, orderRef, paymentDate, amount, method, direction (1 получен, -1 выплачен или возвращен)… |
cin7_omni_list_contacts | Список контактов (клиенты, поставщики, внутренние): id, тип, компания, имя и фамилия, email, телефон, адреса, accountNumber… |
cin7_omni_get_contact | Чтение одного контакта с адресами, вторичными контактами, ценами и деталями учетной записи |
cin7_omni_list_products | Список продуктов (стили): id, имя, styleCode, статус, бренд, идентификаторы категорий, описание, контроль запасов и их productOptions (варианты с… |
cin7_omni_get_product | Чтение одного продукта со всеми его опциями, ценами и размерами |
cin7_omni_list_product_options | Список опций продукта (продаваемые варианты, SKU): id, productId, code, barcode, option1-3, розничная, оптовая и специальные цены, цена… |
cin7_omni_list_product_categories | Список категорий продуктов: id, имя, parentId (0 = верхний уровень), сортировка |
cin7_omni_list_stock | Запасы по опции продукта и филиалу: productId, productOptionId, code, barcode, branchId, branchName, available (запасы на складе минус открытые… |
cin7_omni_list_branches | Список филиалов (склады, магазины): id, компания, branchType, isActive, адрес и местоположения ящиков |
cin7_omni_list_adjustments | Список корректировок запасов: id, ссылка, branchId, isApproved, completedDate, adjustmentReason и строки (code, qty, unitCost) |
cin7_omni_list_branch_transfers | Список переводов запасов между филиалами: id, ссылка, sourceBranchId, destinationBranchId, стадия, isApproved, dispatchedDate, receivedDate… |
cin7_omni_list_users | Список пользователей учетной записи Cin7 Omni: id, имя, фамилия, должность, email, isActive |
cin7_omni_create_sales_order | Создание одного заказа на продажу |
cin7_omni_update_sales_order | Обновление заголовочных полей одного заказа на продажу: стадия, код отслеживания, номер заказа клиента, предполагаемая дата доставки, инструкции по доставке… |
cin7_omni_create_purchase_order | Создание одного заказа на покупку у поставщика (member_id контакта поставщика) |
cin7_omni_create_contact | Создание одного контакта (клиента или поставщика) |
cin7_omni_update_contact | Обновление одного контакта; изменяются только указанные поля |
cin7_omni_create_branch_transfer | Создание перевода запасов между двумя филиалами |
cin7_omni_create_adjustment | Создание корректировки запасов в одном филиале (положительное количество добавляет запасы, отрицательное удаляет их) |
Примеры запросов
- "Какие заказы на продажу были одобрены на этой неделе и еще не отправлены?"
- "Сколько запасов SKU TSHIRT-BLK-M доступно в каждом филиале?"
- "Какие заказы на покупку должны поступить в этом месяце и от каких поставщиков?"
- "Найди клиента с email [email protected] и покажи его задолженность."
- "Создай черновик перевода 20 единиц TSHIRT-BLK-M из главного склада в городской магазин."
Следующие шаги
Это руководство помогло?