n8n - Enriquecer planilha + atribuir tags à empresas exportadas

Integração Econodata + n8n


Como criar no n8n o workflow "Enriquecimento de planilha + tags" da Econodata


Este guia mostra, do zero e em linguagem simples, como montar manualmente um fluxo (workflow) no n8n que:


  1. Recebe uma requisição de exportação.
  2. Consulta a API da Econodata para trazer os dados das empresas.
  3. Adiciona cada empresa em uma planilha do Google Sheets.
  4. Aplica a tag econodata-api-n8n nos leads exportados, dentro da plataforma Econodata.


Ao final, você terá o mesmo resultado do arquivo Econodata API - Enriquecimento de panilha + tags.json, porém construído à mão.


Download dos arquivos (Workflow + Planilha)

O workflow descrito pode ser baixado através deste link e importado no n8n.
A planilha Google Sheets pode ser baixada através deste link e importada no seu Google Drive.




Antes de começar


Você vai precisar de:


  • Uma conta no n8n (na nuvem ou instalada por conta própria).
  • Um token de acesso da API Econodata (peça ao responsável da sua conta, se ainda não tiver).
  • Uma conta Google com permissão para editar uma planilha do Google Sheets.
  • Saber gerar um UUID (você vai gerar um em uuidgenerator.net).




Visão geral do fluxo


O workflow tem 7 nós organizados assim:


[Webhook]
    │
    ▼
[HTTP Request: POST /companies]
    │
    ▼
[Switch]
    │
    ├──► [Split Out: empresas] ──► [Google Sheets: Append row]
    │
    └──► [Edit Fields: monta payload com tags] ──► [HTTP Request: POST /update-lead]


Após o Switch, o fluxo se divide em duas trilhas que são executadas em paralelo:


  • Trilha 1 (Enriquecimento de planilha): quebra o array empresas em itens individuais e adiciona uma linha por empresa na planilha.
  • Trilha 2 (Escrita de tags): monta o payload e aplica a tag econodata-api-n8n nos leads exportados.




Passo 1 — Criar as credenciais no n8n


Antes de arrastar os nós, deixe as credenciais prontas. Isso evita travar no meio do caminho.


1.1 — Credencial "Header Auth" (API da Econodata)


  1. No menu lateral do n8n, clique em Credentials > New.
  2. Procure por Header Auth e selecione.
  3. Preencha:
    • Name (do header): o nome do header de autenticação x-api-tokenexigido pela API Econodata, conforme definido na documentação da API.
    • Value: seu token de acesso da Econodata.
  5. Salve com um nome fácil de lembrar, como Token API Econodata.


Essa mesma credencial será usada nos dois nós HTTP Request do fluxo.


1.2 — Autenticação Google


  1. Autentique-se na sua conta Google.




Passo 2 — Criar um novo workflow


  1. No n8n, clique em Workflows > Add workflow.
  2. Dê um nome, por exemplo: Econodata API - Enriquecimento de planilha + tags.
  3. Salve o workflow vazio.




Passo 3 — Adicionar o nó Webhook (gatilho)


Esse é o nó que dispara todo o fluxo.


  1. Clique no botão + no canvas e procure por Webhook.
  2. Configure:
    • HTTP Method: POST
    • Path: cole aqui um UUID novo. Gere um em uuidgenerator.net e cole o valor no campo Path. Exemplo: 6d9a01a6-0852-4b5b-ae95-73cb95af66c5.
    • Demais opções: deixe o padrão.
  4. Salve.


💡 O body que será enviado para esse webhook precisa conter os filtros aceitos pelo endpoint /v3/companies da Econodata. Esse body será repassado adiante sem alteração.


Exemplo de body que o webhook deve receber:


[
    "17.948.237/0001-00",
    "00.000.000/0001-91",
    "00.360.305/0001-04",
    "34.028.316/0001-03"
]




Passo 4 — Adicionar o nó HTTP Request (consulta de empresas)


Esse nó chama a API Econodata para trazer os dados das empresas.


  1. Clique no + após o Webhook e procure por HTTP Request.
  2. Configure:
    • Method: POST
    • URL: https://api.econodata.com.br/ecdt-api/v3/companies
    • Authentication: Generic Credential Type
    • Generic Auth Type: Header Auth
    • Credential for Header Auth: selecione a credencial criada no Passo 1.1.
    • Send Body: ative.
    • Body Content Type: JSON
    • Specify Body: Using JSON
    • JSON: clique no ícone de expressão (fx) e cole:


      ={{ $json.body }}


  1. Salve.


Esse nó pega o body recebido pelo webhook e repassa para a API. A resposta esperada vai conter um array empresas com os dados retornados.


Exemplo de resposta esperada:


{
  "empresas": [
    {
      "cnpj": "00000000000000",
      "razaoSocial": "EMPRESA EXEMPLO LTDA",
      "nomeFantasia": "Exemplo",
      "tipoUnidade": "Matriz",
      "uf": "SP",
      "cidade": "São Paulo"
    }
  ],
  "erros": []
}




Passo 5 — Adicionar o nó Switch (ramificação do fluxo)


Esse nó serve para dividir o fluxo em duas trilhas paralelas.


  1. Após o nó HTTP Request, clique no + e procure por Switch.
  2. Você pode deixar a regra padrão (sem condição específica). O importante é que esse nó terá duas saídas — uma para cada trilha.
  3. Salve.


💡 Caso queira validar antes de prosseguir, configure uma condição como {{ $json.empresas.length > 0 }} para evitar chamadas desnecessárias quando não houver retorno.




Passo 6 — Trilha 1: Enriquecimento da planilha


Essa trilha pega cada empresa do array empresas e cria uma linha na planilha.


6.1 — Nó Split Out


  1. Conecte uma das saídas do Switch ao novo nó.
  2. Procure por Split Out e adicione.
  3. Configure:
    • Field To Split Out: empresas
  5. Salve.


Esse nó transforma o array empresas em vários itens, um por empresa. Sem isso, o Google Sheets gravaria apenas uma única linha (ou daria erro).


6.2 — Nó Google Sheets — Append row in sheet


  1. Conecte o Split Out a um novo nó.
  2. Procure por Google Sheets e selecione a operação Append row in sheet.
  3. Configure:
    • Authentication: Service Account
    • Credential: selecione a credencial do Passo 1.2.
    • Resource: Sheet Within Document
    • Operation: Append
    • Document: selecione a sua planilha (no exemplo do arquivo, é ecdt-crm).
    • Sheet: selecione a aba (no exemplo, leads-exportados).
    • Mapping Mode: Map Each Column Manually (Define Below).
  5. No mapeamento de colunas, preencha os campos com expressões:


Coluna na planilha

Valor (expressão)

cnpj

={{ $json.cnpj }}

razaoSocial

={{ $json.razaoSocial }}

nomeFantasia

={{ $json.nomeFantasia }}

tipoUnidade

={{ $json.tipoUnidade }}

uf

={{ $json.uf }}

cidade

={{ $json.cidade }}


  1. Salve.


⚠️ A planilha precisa ter, na primeira linha, esses mesmos nomes de coluna como cabeçalho: cnpj, razaoSocial, nomeFantasia, tipoUnidade, uf, cidade. Você pode incluir também colunas auxiliares como empresas e erros, caso queira guardar dados brutos.




Passo 7 — Trilha 2: Escrita de tags


Essa trilha aplica a tag econodata-api-n8n aos leads exportados.


7.1 — Nó Edit Fields (Set)


  1. Conecte a outra saída do Switch a um novo nó.
  2. Procure por Edit Fields (também chamado de Set) e adicione.
  3. Configure:
    • Mode: Raw
    • JSON Output: clique no fx e cole exatamente esta expressão:


      ={{
        {
          empresas: $json.empresas.map(e => ({ cnpj: e.cnpj, sinalizarGrupoEconomico: false })),
          tags: [ "econodata-api-n8n" ]
        }
      }}


  1. Salve.


Esse nó monta o body que a API update-lead espera, contendo o array de empresas (apenas com cnpj e sinalizarGrupoEconomico: false) e a lista de tags a aplicar.


7.2 — Nó HTTP Request (update-lead)


  1. Conecte o Edit Fields a um novo nó.
  2. Procure por HTTP Request e adicione.
  3. Configure:
    • Method: POST
    • URL: https://api.econodata.com.br/ecdt-api/v3/update-lead
    • Authentication: Generic Credential Type
    • Generic Auth Type: Header Auth
    • Credential for Header Auth: mesma credencial usada no Passo 4.
    • Send Body: ative.
    • Body Content Type: JSON
    • Specify Body: Using JSON
    • JSON: clique no fx e cole:


      ={{ $json }}


  1. Salve.




Passo 8 — Conferir todas as conexões


Confirme que o fluxo ficou ligado assim:


  • Webhook → HTTP Request (companies)
  • HTTP Request → Switch
  • Switch (saída 1) → Split Out → Append row in sheet
  • Switch (saída 2) → Edit Fields → HTTP Request1 (update-lead)




Passo 9 — Ativar e testar


  1. No topo do workflow, ative o toggle Active (ele fica verde quando ativo).
  2. Clique no nó Webhook e copie a Production URL.
  3. Cole essa URL no campo Webhook na tela de Integrações da Plataforma Econodata.
  4. Faça uma exportação de empresas para a integração n8n configurada
  5. Verifique os resultados:
    • Google Sheets: novas linhas adicionadas com os dados das empresas exportadas.
    • Plataforma Econodata: leads exportados aparecem com a tag econodata-api-n8n.




Dicas e melhorias recomendadas


  • Tags dinâmicas: em vez da tag fixa econodata-api-n8n, use a sua própria tag.
  • Volume alto: se a exportação trouxer muitas empresas, considere processar em lotes.




Endpoints utilizados (resumo)



Ambos exigem autenticação via Header Auth com o token da API Econodata.

Actualizado em: 07/05/2026

Esse artigo foi útil?

Partilhe o seu feedback

Cancelar

Obrigado!