Automações

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.

Workflows > editor > ERP palette Figura 1: Nós de ERP na paleta do editor de workflow

Nós disponíveis

NóO que fazDocumentação
Tiny ERPPedidos, produtos, clientes, NF-e e contas a receber via Tiny API v2Nó Tiny ERP
BlingPedidos de venda, produtos, contatos, estoque e NF-e via Bling API v3 (OAuth)Nó Bling
OmieClientes, pedidos, produtos e financeiro via Omie RPC-style APINó Omie
GranatumLançamentos financeiros, centros de custo e contas bancárias via Granatum REST APINó 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 authOnde configurar
Tiny ERPAPI token (tiny_api_token)Configurações → API Keys
BlingOAuth access token (bling_access_token)Configurações → API Keys → Connected services — conecte o Bling e selecione o serviço no nó
OmieApp key + secret (omie_app_key, omie_app_secret)Configurações → API Keys
GranatumBearer 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

  1. Trigger — Webhook (novo pedido da loja), Schedule (sync noturno) ou Manual para teste
  2. Nó de ERP — buscar dados de pedido, cliente ou nota fiscal
  3. Logic — Condition ou JavaScript para filtrar status, valor ou data
  4. Action — Send WhatsApp, atualização de CRM card ou Set variable para etapa downstream
  5. 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

Este artigo foi útil?

Precisa de mais ajuda? Falar com suporte

Central de Ajuda