核心用法
Omie ERP Skill 提供与巴西主流企业资源计划系统 Omie 的完整 API 集成能力，采用 Python CLI 脚本作为统一入口。主要功能模块包括：
客户管理 (clientes_*): 支持列表查询、按 CNPJ/CPF 或内部编码检索、详情获取
产品管理 (produtos_*): 产品目录查询与单品详情
销售订单 (pedidos_*): 订单列表、详情查询及状态跟踪
财务模块 (contas_receber, contas_pagar, resumo_financeiro): 应收账款、应付账款及财务汇总
电子发票 (nfe_*): NF-e 发票列表与详情查询
库存管理 (estoque_*): 实时库存位置与单品库存查询
Webhook 支持: 实时接收订单、发票、财务、客户变更事件
技术特性
- RESTful API 通信，环境变量认证（OMIE_APP_KEY / OMIE_APP_SECRET）
- 分页机制（最大 500 条/页），速率限制 3 请求/秒
- 30 秒超时保护
显著优点
- 覆盖巴西企业核心财务业务流程（NF-e 合规、双轨记账）
- 实时 Webhook 推送减少轮询开销
- CLI 接口便于脚本自动化和 CI/CD 集成
潜在局限
- 地域限定：仅服务巴西市场，CNPJ/CPF 为强制字段
- 速率限制较严格（3 RPS），大规模同步需队列缓冲
- 无内置 OAuth，依赖静态密钥管理
适合人群
- 巴西本土企业的财务/运营团队
- 需集成巴西税务合规（NF-e）的跨境业务
- 已有 Omie 订阅且具备技术实施能力的组织
常规风险
- 密钥泄露：静态 App Key/Secret 需妥善保管，建议采用密钥管理服务
- 数据主权：财务数据存储于巴西境内，跨境传输需合规评估
- API 稳定性：依赖第三方 SaaS 可用性，需设计降级策略