Estrutura de Dados no n8n - Guia Completo

No n8n, todos os dados trafegam entre os nós como um array de objetos. Cada objeto representa um item de dados processado pelo workflow, podendo conter informações em formato JSON e/ou binário.

Estrutura Padrão de Item

Cada item do array possui, no mínimo, a chave

json

. Se houver arquivos ou dados binários, a chave

binary

também estará presente.

[
  {
    "json": {
      "nome": "João",
      "idade": 30,
      "ativo": true
    },
    "binary": {
      "meuarquivo": {
        "data": "base64...",
        "mimeType": "image/png",
        "fileExtension": "png",
        "fileName": "foto-perfil.png"
      }
    }
  }
]

Explicação dos Campos

Campo

json

Objeto com dados estruturados (campos, valores, objetos aninhados).

Campo

binary

(opcional)

Objeto presente apenas quando há arquivos ou dados binários:

data: Conteúdo do arquivo em base64
mimeType: Tipo MIME do arquivo (ex:
```
image/png
```
,
```
application/pdf
```
)
fileExtension: Extensão do arquivo (ex:
```
png
```
,
```
pdf
```
)
fileName: Nome do arquivo original

Boas Práticas

Sempre defina

mimeType

,
fileExtension
e
fileName
ao manipular dados binários. Isso garante compatibilidade entre nós e facilita o download ou visualização dos arquivos.

Estruture o objeto
json
de forma clara, utilizando nomes de campos descritivos e, se necessário, objetos aninhados para dados complexos
Lembre-se: mesmo que um nó processe apenas um item, o dado será sempre um array de objetos

Exemplo Prático

Imagine um workflow que recebe dados de um formulário e um upload de imagem:

[
  {
    "json": {
      "nome": "Maria",
      "email": "maria@exemplo.com"
    },
    "binary": {
      "foto": {
        "data": "base64...",
        "mimeType": "image/jpeg",
        "fileExtension": "jpg",
        "fileName": "maria.jpg"
      }
    }
  }
]

Exemplo Nacional - Anexos Contratuais

Em automações jurídicas ou empresariais no Brasil, é comum trafegar contratos digitais em PDF junto com os dados do cliente ou empresa. Veja como ficaria um item típico:

[
  {
    "json": {
      "empresa": "Empresa ABC",
      "cnpj": "98.765.432/0001-11",
      "contrato_id": "C-2024-001"
    },
    "binary": {
      "contrato": {
        "data": "base64...",
        "mimeType": "application/pdf",
        "fileExtension": "pdf",
        "fileName": "contrato-empresa-abc.pdf"
      }
    }
  }
]

O campo
```
contrato_id
```
facilita rastreabilidade e integração com ERPs/CRMs
O PDF do contrato é armazenado em
```
binary.contrato
```
, pronto para assinatura digital, envio por e-mail ou arquivamento
Use sempre metadados corretos para garantir compatibilidade e conformidade jurídica

Próximos passos

Manipulação de Dados - Aprenda a trabalhar com arrays e objetos
Expressões JavaScript - Use expressões para manipular dados
Conexões entre Nodes - Entenda como os dados fluem

Agora você entende a estrutura de dados do n8n. Use essas técnicas para criar workflows eficientes e bem estruturados!

Dica Pro

Sempre valide a estrutura dos dados antes de processá-los para garantir que estejam no formato esperado.

Importante

Mantenha backups seguros dos dados binários, pois são arquivos importantes que podem ser perdidos.

Recurso Adicional

Use o Debug Helper para visualizar a estrutura completa dos dados que fluem entre os nodes.

Estrutura de Dados no n8n - Guia Completo