# Integração Omie ERP

![Integração Omie ERP](https://chat.simplesdesk.com.br/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBN2xsQmc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--3f4b38df1bef776c59bf3a5a011b39d624612469/simplesdesk-omie.png)

Conecte o **ERP Omie** ao SimplesDesk e leve o financeiro para dentro da conversa: o Agente de IA localiza o cliente, consulta cobranças em aberto, emite a 2ª via do boleto com linha digitável e acompanha pedidos de venda — e os fluxos automatizam o lembrete de vencimento com a fonte de contas a receber.

## Quando utilizar

- Seu financeiro e vendas rodam no Omie e o atendimento é pelo WhatsApp;
- Você quer **réguas de cobrança** (lembrete de boleto a vencer, aviso de atraso) sem trabalho manual;
- Autoatendimento com **Agente de IA**: o cliente pede a 2ª via e recebe o boleto na hora.

## Como conectar

1. Acesse **Configurações → Integrações** e clique no card **Omie**.
2. Preencha **App Key** e **App Secret** — gere em `developer.omie.com.br` (Minhas Aplicações). As chaves são por empresa do Omie.
3. Clique em **Testar e conectar** — a conexão é validada antes de salvar e fica ativa para toda a conta.

Com a conta conectada, três frentes ficam disponíveis: **Agente de IA**, **nós de fluxo** e **fonte de contatos para disparos agendados**.

---

## Agente de IA

Nas configurações do assistente (**Central IA → seu assistente → Integrações**), ative o **Omie**. A IA passa a fazer:

| Grupo | O que a IA passa a fazer |
| --- | --- |
| **Cliente** | Localizar o cliente no Omie pelo CPF/CNPJ ou e-mail — sempre o primeiro passo antes das consultas |
| **Financeiro** | Listar as cobranças (contas a receber) com status, vencimento e valor, e emitir a 2ª via do boleto com link do PDF e linha digitável |
| **Vendas** | Acompanhar os pedidos de venda do cliente: número, etapa, valor total e previsão |

> 💡 A IA usa o código do título retornado na consulta de cobranças para emitir a 2ª via do boleto correto — sem pedir números ao cliente.

---

## Nós de fluxo

No editor de fluxos, a paleta ganha a categoria **Omie (ERP)** com três nós que se encadeiam:

- **Omie: Localizar cliente** — busca por CNPJ/CPF (campo aceita `{{variables.cnpj}}`); vazio, tenta o e-mail do contato. Salva `{{variables.omie_cliente_id}}`, `{{variables.omie_cliente_nome}}`, `{{variables.omie_cliente_documento}}` e `{{variables.omie_cliente_email}}`, e vincula o código ao contato para os próximos nós. Saída verde = encontrado, amarela = não encontrado.
- **Omie: Contas a receber** — lista os títulos do cliente localizado (ou de um **ID do cliente Omie** informado), com opção **Somente títulos em aberto**. Salva `{{variables.omie_titulos_count}}`, `{{variables.omie_titulos_resumo}}` (pronto para mensagem) e o primeiro título em aberto: `{{variables.omie_titulo_id}}`, `{{variables.omie_titulo_valor}}`, `{{variables.omie_titulo_vencimento}}`, `{{variables.omie_titulo_status}}`. Verde = encontrou, amarela = nada.
- **Omie: 2ª via do boleto** — emite a 2ª via de um título (**ID do título**; vazio, usa `{{variables.omie_titulo_id}}` do nó anterior). Salva `{{variables.omie_boleto_link}}` (PDF), `{{variables.omie_boleto_linha_digitavel}}` e `{{variables.omie_boleto_emissao}}`. Verde = emitido, amarela = indisponível.

Em caso de erro do Omie, a mensagem fica em `{{variables.omie_erro}}` para você tratar num caminho alternativo.

---

## Fonte de contatos: contas a receber por vencimento

No gatilho **Disparo agendado**, a fonte **"Omie — Contas a receber"** busca os títulos em aberto pelo vencimento e dispara o fluxo para cada cliente. Configure:

- **Modo** — "a vencer" ou "vencidas";
- **Dias** — a vencer EM n dias / vencidas HÁ n dias (padrão 1).

Cada disparo chega com as variáveis prontas: `{{variables.omie_cliente_nome}}` · `{{variables.omie_valor}}` · `{{variables.omie_vencimento}}` · `{{variables.omie_numero_documento}}` · `{{variables.omie_parcela}}` · `{{variables.omie_codigo_titulo}}`.

### Exemplo: lembrete de boleto a vencer

1. Gatilho **Disparo agendado** (diário) + fonte **Omie — Contas a receber**, modo **a vencer**, 2 dias;
2. Nó **Omie: 2ª via do boleto** com **ID do título** = {{variables.omie_codigo_titulo}} — gera o link do PDF e a linha digitável;
3. **Enviar Mensagem**: "Olá {{variables.omie_cliente_nome}}, seu boleto de R$ {{variables.omie_valor}} vence em {{variables.omie_vencimento}}. 2ª via: {{variables.omie_boleto_link}}" — e envie a linha digitável em seguida para facilitar o copia-e-cola.

> 📗 Para dominar o editor, veja os tutoriais da categoria **Fluxos** — do primeiro fluxo ao gatilho de disparo agendado.

> 📘 Precisa de ajuda? Fale com nosso suporte pelo chat — é só chamar.