omie

TotalClaw 作者 totalclaw

通过 API 集成 Omie ERP。管理客户、产品、订单、发票 (NF-e)、财务（包含收据/pagar）和库存。当用户询问 Omie 的 ERP 数据、财务、订单、发票、库存或客户时使用。还处理实时事件的网络钩子。

安装 / 下载方式

TotalClaw CLI推荐

totalclaw install totalclaw:totalclaw~jamesbot-agnt-omie

cURL直接下载，无需登录

curl -fsSL https://skills.taituai.com/api/skills/totalclaw%3Atotalclaw~jamesbot-agnt-omie/file -o jamesbot-agnt-omie.md

## 概述（中文）

通过 API 集成 Omie ERP。管理客户、产品、订单、发票 (NF-e)、财务（包含收据/pagar）和库存。当用户询问 Omie 的 ERP 数据、财务、订单、发票、库存或客户时使用。还处理实时事件的网络钩子。

## 原文

# Omie ERP Skill

Integração com o Omie ERP via API REST.

## Setup

Requer variáveis de ambiente:
```bash
export OMIE_APP_KEY="your_app_key_here"
export OMIE_APP_SECRET="your_app_secret_here"
```

## API Client

Use o script Python para todas as operações:

```bash
python3 skills/omie/scripts/omie_client.py <command> [args]
```

### Comandos disponíveis

#### Clientes
```bash
python3 scripts/omie_client.py clientes_listar [pagina] [por_pagina]
python3 scripts/omie_client.py clientes_buscar cnpj_cpf=00.000.000/0001-00
python3 scripts/omie_client.py clientes_buscar codigo=1234567
python3 scripts/omie_client.py clientes_detalhar codigo=1234567
```

#### Produtos
```bash
python3 scripts/omie_client.py produtos_listar [pagina] [por_pagina]
python3 scripts/omie_client.py produtos_detalhar codigo=1234567
```

#### Pedidos de Venda
```bash
python3 scripts/omie_client.py pedidos_listar [pagina] [por_pagina]
python3 scripts/omie_client.py pedidos_detalhar numero=1234
python3 scripts/omie_client.py pedidos_status numero=1234
```

#### Financeiro
```bash
python3 scripts/omie_client.py contas_receber [pagina] [por_pagina]
python3 scripts/omie_client.py contas_pagar [pagina] [por_pagina]
python3 scripts/omie_client.py resumo_financeiro
```

#### Notas Fiscais
```bash
python3 scripts/omie_client.py nfe_listar [pagina] [por_pagina]
python3 scripts/omie_client.py nfe_detalhar numero=1234
```

#### Estoque
```bash
python3 scripts/omie_client.py estoque_posicao [pagina] [por_pagina]
python3 scripts/omie_client.py estoque_produto codigo=1234567
```

## Webhook

O Omie pode enviar eventos para um endpoint HTTP. Configurar em:
Omie → Configurações → Integrações → Webhooks

Eventos suportados:
- `pedido.incluido` / `pedido.alterado`
- `nfe.emitida` / `nfe.cancelada`
- `financas.recebido` / `financas.pago`
- `cliente.incluido` / `cliente.alterado`

Para iniciar o receptor de webhooks:
```bash
python3 scripts/omie_webhook.py --port 8089
```

## Limites da API
- **Rate limit:** 3 requisições/segundo por app
- **Paginação:** máximo 500 registros por página
- **Timeout:** 30 segundos