摘要
通过 API v1 管理 Cin7 Omni (go.cin7.com) 的库存和订单：销售订单、报价、采购订单、信用票据、联系人、产品、每个分支的库存、分支、支付（只读）、库存调整、分支转移和用户。创建订单、采购订单、联系人和转移。API 用户名和密钥。
引导式设置
2 分钟将 Cin7 Omni 连接到 Claude、ChatGPT 或 Copilot
开始 AnythingMCP Cloud 免费试用，在引导式设置中连接 Cin7 Omni，再把你的 MCP URL 添加到你的 AI 助手。无需代码，也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
Cin7 Omni 的示例提示
点击任意提示即可复制，然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中，在该连接器上运行。
Claude 是 AI，可能会出错。请核对回答。
💡 没有安装？直接使用 cloud.anythingmcp.com。 登录，点击 Connectors → Cin7 Omni，粘贴你的凭据，生成一个 MCP API 密钥，完成。无需 Docker，无需
git clone，无需本地服务器。
Cin7 Omni
通过 API v1 管理 Cin7 Omni (go.cin7.com) 的库存和订单：销售订单、报价、采购订单、信用票据、联系人、产品、每个分支的库存、分支、支付（只读）、库存调整、分支转移和用户。创建订单、采购订单、联系人和转移。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 和账户 ID 及应用密钥：使用 Cin7 Core 连接器。这两个 API 及其凭据不可互换。
- 在 Cin7 Omni 打开用户菜单，然后 Settings → Integrations & API → API v1。
- 将页面顶部显示的 API Username 复制到
CIN7_OMNI_API_USERNAME。 - 点击 Add New API Connection，给它命名并将其 API key 复制到
CIN7_OMNI_API_KEY。Regenerate Key 用于替换丢失的密钥。 - 在 Permissions 下勾选 AI 应该看到的每个资源的 Read 权限，以及写工具需要的资源的 Create 或 Update 权限，然后点击 Save。没有权限的资源会返回 403。
- 安装连接器。运行
cin7_omni_list_branches检查连接：它会列出你的分支及其 ID。
云端和自托管的工作方式相同：凭据相同，且无需设置重定向 URL。连接器将用户名和密钥作为 HTTP Basic 身份验证发送。
从哪里开始：cin7_omni_list_branches 获取分支 ID，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 过滤器比多个小调用更有效地使用预算。
值：订单 status 为 DRAFT、APPROVED 或 VOID，stage 为自由文本工作流阶段（新、待付款、处理中、暂停、已发货）。库存 available 为在手库存减去未完成销售。联系人 type 为客户、供应商或内部。写入时使用订单货币的金额；读取时返回基准货币值及汇率。新用户可能需要最多 2 小时才能出现在 cin7_omni_list_users 中。
常见错误：403 表示 API 连接对该资源没有权限：在 Permissions 下勾选并保存。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、reference、status（DRAFT、APPROVED、VOID）、stage、customer（memberId、company、email）、branchId、dates… |
cin7_omni_get_sales_order | 读取一个销售订单及其行项目、地址、总额、阶段、状态、发票和发货日期 |
cin7_omni_list_quotes | 列出销售报价，包括客户、分支、总额、阶段和行项目 |
cin7_omni_list_purchase_orders | 列出采购订单，最新的在前：id、reference、supplier（memberId、company）、branchId、status、stage、estimatedArrivalDate… |
cin7_omni_get_purchase_order | 读取一个采购订单及其行项目、供应商、日期和总额 |
cin7_omni_list_credit_notes | 列出信用票据：id、reference、salesReference（其信用的销售订单）、customer、总额、状态和行项目（负数量） |
cin7_omni_get_credit_note | 读取一个信用票据及其行项目和总额 |
cin7_omni_list_payments | 列出记录在订单上的支付：id、orderId、orderRef、paymentDate、amount、method、direction（1 收到，-1 支出或退款）… |
cin7_omni_list_contacts | 列出联系人（客户、供应商、内部）：id、type、company、first 和 last name、email、phone、addresses、accountNumber… |
cin7_omni_get_contact | 读取一个联系人及其地址、次要联系人、定价和账户详情 |
cin7_omni_list_products | 列出产品（样式）：id、name、styleCode、status、brand、category ids、description、stockControl 及其 productOptions（变体） |
cin7_omni_get_product | 读取一个产品及其所有选项、价格和尺寸 |
cin7_omni_list_product_options | 列出产品选项（可销售的变体、SKU）：id、productId、code、barcode、option1-3、retail、wholesale 和 special prices、price… |
cin7_omni_list_product_categories | 列出产品类别：id、name、parentId（0 = 顶级）、sort |
cin7_omni_list_stock | 每个产品选项和分支的库存：productId、productOptionId、code、barcode、branchId、branchName、available（在手库存减去未完成… |
cin7_omni_list_branches | 列出分支（仓库、商店）：id、company、branchType、isActive、address 和 bin locations |
cin7_omni_list_adjustments | 列出库存调整：id、reference、branchId、isApproved、completedDate、adjustmentReason 和行项目（code、qty、unitCost） |
cin7_omni_list_branch_transfers | 列出分支之间的库存转移：id、reference、sourceBranchId、destinationBranchId、stage、isApproved、dispatchedDate、receivedDate… |
cin7_omni_list_users | 列出 Cin7 Omni 账户的用户：id、firstName、lastName、jobTitle、email、isActive |
cin7_omni_create_sales_order | 创建一个销售订单 |
cin7_omni_update_sales_order | 更新一个销售订单的头部字段：stage、tracking code、customer order number、estimated delivery date、delivery instructions… |
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 protected] 的客户并显示他们的欠款余额。"
- "创建一份将 20 个 TSHIRT-BLK-M 从主仓库转移到市区商店的草稿转移。"
下一步
这份指南对你有帮助吗?