核心功能
Omie Skill 提供与巴西 AH Brasil 旗下 Omie ERP 的完整 REST API 集成能力，覆盖企业运营核心模块：
- 客户管理：支持按 CNPJ/CPF 或内部编码检索客户档案
- 产品目录：查询产品详情及分页列表
- 销售订单：订单列表、详情查看及状态追踪
- 财务模块：应收/应付账款查询、财务汇总报告
- 电子发票（NF-e）：发票列表及详情获取
- 库存管理：实时库存位置及单品库存查询
Webhook 实时事件：支持订单、发票、财务、客户变动的实时推送，可启动本地 HTTP 服务器接收事件。
显著优势
1. 全模块覆盖：一站式对接 ERP 核心业务，无需多系统切换
2. 实时数据同步：Webhook 机制确保关键业务事件即时感知
3. 灵活的查询方式：支持编码、税号等多维度数据检索
4. 本地化支持：针对巴西税务及财务合规场景优化
潜在局限
- 严格的速率限制：3 req/s 的限制在高频场景下可能成为瓶颈
- 分页上限约束：单次最多 500 条记录，大数据量需多次请求
- 依赖环境配置：需妥善管理 APP_KEY/SECRET，存在密钥泄露风险
- 巴西市场限定：Omie ERP 主要服务于巴西企业，国际适用性受限
适用人群
- 巴西本地企业或跨境业务涉及巴西市场的财务/运营团队
- 需将 Omie ERP 数据同步至 BI 系统、电商平台或定制应用的技术团队
- 希望自动化发票处理、库存监控或客户管理的开发者
常规风险提示
- API 密钥安全：OMIE_APP_KEY 和 OMIE_APP_SECRET 需严格保密，建议通过环境变量或密钥管理服务注入
- Webhook 安全：接收端点需验证请求签名，防止伪造事件
- 合规注意：NF-e 及财务数据涉及税务合规，需确保数据处理符合巴西法规
- 稳定性依赖：API 限流可能导致高峰期请求失败，建议实现指数退避重试机制