APIs de gestão empresarial: Tiny ERP, Bling, Omie e Granatum.
ERP
Os nós de ERP conectam sistemas brasileiros de gestão empresarial — pedidos, produtos, notas fiscais (NF-e), estoque e financeiro — diretamente nas Automações. Cada nó encapsula a API oficial do provedor com operações pré-construídas e templates de autenticação para sincronizar dados, disparar notificações e automatizar tarefas de back-office sem configurar HTTP bruto a cada chamada.
Figura 1: Nós de ERP na paleta do editor de workflow
Nós disponíveis
| Nó | O que faz | Documentação |
|---|---|---|
| Tiny ERP | Pedidos, produtos, clientes, NF-e e contas a receber via Tiny API v2 | Nó Tiny ERP |
| Bling | Pedidos de venda, produtos, contatos, estoque e NF-e via Bling API v3 (OAuth) | Nó Bling |
| Omie | Clientes, pedidos, produtos e financeiro via Omie RPC-style API | Nó Omie |
| Granatum | Lançamentos financeiros, centros de custo e contas bancárias via Granatum REST API | Nó Granatum |
Todos os nós de ERP usam o HTTP request executor por baixo dos panos. Retornam status, data e headers em toda execução — referencie data em nós posteriores para enviar atualizações WhatsApp, atualizar cards do CRM ou ramificar com um nó Condition.
Quando usar nós de ERP
- Espelhar vendas no CRM — quando um pedido é aprovado ou uma NF-e é emitida, criar ou atualizar contato e notificar o cliente no WhatsApp
- Sincronizar estoque e financeiro — após eventos de e-commerce ou pagamento, ler níveis de estoque ou recebíveis em aberto do ERP
- Substituir exportações manuais — quando sua operação já roda em Tiny, Bling, Omie ou Granatum e você quer automação agendada ou orientada a eventos em vez de planilhas
- Combinar com outras paletas — encadear E-commerce → ERP → Send WhatsApp para fluxos de pedido ponta a ponta
Visão geral de credenciais
| Nó | Método de auth | Onde configurar |
|---|---|---|
| Tiny ERP | API token (tiny_api_token) | Configurações → API Keys |
| Bling | OAuth access token (bling_access_token) | Configurações → API Keys → Connected services — conecte o Bling e selecione o serviço no nó |
| Omie | App key + secret (omie_app_key, omie_app_secret) | Configurações → API Keys |
| Granatum | Bearer token (granatum_access_token) | Configurações → API Keys |
Nunca cole secrets diretamente no canvas. Use integration keys ou workflow variables para manter credenciais fora de exportações compartilhadas de workflow.
Bling é diferente: é o único nó de ERP que usa Connected services (OAuth). O engine de workflow injeta um access token fresco em runtime quando você seleciona a conta Bling conectada no nó.
Padrão de fluxo típico
- Trigger — Webhook (novo pedido da loja), Schedule (sync noturno) ou Manual para teste
- Nó de ERP — buscar dados de pedido, cliente ou nota fiscal
- Logic — Condition ou JavaScript para filtrar status, valor ou data
- Action — Send WhatsApp, atualização de CRM card ou Set variable para etapa downstream
- Confirmação opcional — workflow separado com Webhook trigger quando o ERP envia seu próprio evento (se configurado no lado do provedor)
Saídas do nó e variáveis
Referencie resultados do nó de ERP em etapas posteriores usando o node ID no canvas:
{{tiny_1.data}}
{{bling_1.data}}
{{omie_1.data}}
{{granatum_1.data}}
Inspecione o log de execução para ver o formato JSON exato retornado por cada operação — provedores usam formatos de resposta diferentes (Tiny encapsula payloads em um objeto retorno; Bling retorna arrays data; Omie retorna chaves específicas por method).
Consulte Variáveis no workflow para a sintaxe completa.
Operações pré-construídas vs chamadas customizadas
Cada nó de ERP inclui templates de operação (atalhos na configuração do nó) para tarefas comuns — listar pedidos, buscar produtos, criar clientes, emitir NF-e, etc. Você também pode sobrescrever URL, method, headers e body para chamar qualquer endpoint suportado pela API do provedor.
Para endpoints não cobertos por um template, copie o formato de requisição oficial do provedor nos campos do nó ou use o nó genérico HTTP com as mesmas auth variables.
Guias relacionados
- Nós de e-commerce — lojas e marketplaces
- Nós de pagamentos — gateways de cobrança
- Nós de dados — bancos de dados, planilhas, storage
- Nó HTTP — chamadas REST customizadas
- Webhooks recebidos — reagir a eventos externos
- Como testar e depurar um workflow
- Visão geral dos tipos de nós
Este artigo foi útil?
Precisa de mais ajuda? Falar com suporte