核心用法
本技能通过 Maton 网关代理访问 Zoho Inventory API，采用托管 OAuth 认证模式，用户无需自行处理复杂的 Zoho OAuth 授权流程。使用时需先在 ctrl.maton.ai 创建连接并完成 OAuth 授权，获取 connection_id 后即可通过统一网关地址调用 API。
典型调用流程：
1. 设置 MATON_API_KEY 环境变量
2. 在控制台创建 Zoho Inventory 连接并授权
3. 通过 gateway.maton.ai/zoho-inventory/inventory/v1/{endpoint} 访问 API
4. 可选指定 Maton-Connection 头部选择多组织场景下的特定连接
支持 8 大核心模块：商品（Items）、商品组（Item Groups）、联系人（Contacts）、销售订单（Sales Orders）、发票（Invoices）、采购订单（Purchase Orders）、账单（Bills）、发货单（Shipment Orders），均提供完整的增删改查及状态管理能力。
显著优点
认证简化：托管 OAuth 模式免除开发者自行维护 refresh_token、处理 token 过期等繁琐工作，降低集成门槛。
模块化覆盖全面：涵盖库存管理全生命周期，从商品主数据到采购-销售-财务闭环，单技能即可满足多数 ERP 集成需求。
多连接管理：通过 ctrl.maton.ai 可集中管理多个 Zoho Inventory 组织的连接，支持按连接 ID 路由请求，适配代运营、多子公司等场景。
RESTful 标准设计：API 遵循标准 HTTP 方法与 JSON 格式，配合分页、筛选、排序等机制，易于与现有系统集成。
潜在缺点与局限性
速率限制严格：每分钟 100 请求、每日 1,000-10,000 请求（视套餐而定），高频同步场景需设计队列或缓存机制。
网关依赖风险：所有流量经 Maton 网关转发，若网关服务中断将直接影响业务连续性；同时数据流经第三方基础设施，存在合规考量。
功能边界约束：不支持 Zoho Inventory 的全部功能（如高级报表、多仓库调拨细节），复杂业务可能需直接调用原生 API。
自动编号限制：销售订单号、采购订单号默认自动生成，若客户要求自定义编号规则，需先在 Zoho 后台关闭自动编号，操作不够灵活。
适合人群
- 中小企业技术团队需要快速对接 Zoho Inventory 实现库存/订单自动化
- SaaS 产品开发者构建垂直行业 ERP 集成方案
- 代运营服务商管理多客户 Zoho Inventory 实例
- 财务/运营团队通过低代码方式实现数据同步
常规风险
认证安全风险：API Key 泄露将导致账户完全失控，需严格管控 MATON_API_KEY 的存储与传输（建议使用密钥管理系统）。
数据操作风险：DELETE 操作不可逆，生产环境执行前务必确认资源 ID；状态变更（如 Void 发票）可能影响财务数据一致性。
合规与审计风险：库存、财务数据涉及敏感商业信息，需确认 Maton 网关的数据处理协议是否符合 GDPR、SOX 等监管要求。
速率超限风险：突发流量易触发 429 限流，建议实施指数退避重试策略，避免硬编码高频轮询逻辑。