n8n-nodes-varejoonline

Este é um node comunitário do n8n para integração completa com o ERP Varejo Online. Ele foi desenvolvido para facilitar automações complexas, cobrindo praticamente todos os módulos do sistema.

n8n é uma ferramenta de automação de fluxo de trabalho "fair-code", gratuita e aberta.

Nota: Este projeto não é afiliado oficialmente à Varejo Online. É mantido pela comunidade e seu desenvolvedor original @luccamrofc.

🚀 Funcionalidades Principais

O node suporta +150 operações distribuídas entre os principais módulos do ERP:

📦 Módulos Suportados

• Administrativo: Gestão de Terceiros (Clientes/Fornecedores), Empresas, Entidades e Usuários.
• Operacional:
  • Pedidos de Venda: Criação completa (incluindo E-commerce), listagem, alteração de status.
  • Produtos & Serviços: Cadastro, tabela de preços, estoque e ajustes.
• Financeiro: Contas a Pagar/Receber, Baixas, Boletos e Lançamentos.
• Fiscal: Consulta e emissão de NFe, NFCe, NFS-e, Manifestos e Devoluções.
• Compras: Gestão de Pedidos de Compra.
• Comercial: Comissões, Metas, Vouchers e Representantes.

✨ Diferenciais de UX

• Paginação Automática ("Return All"): Para listagens longas (ex: Notas Fiscais, Produtos), o node gerencia a paginação automaticamente, garantindo que você receba todos os dados sem precisar criar loops complexos no n8n.
• Enums Padronizados: Campos como Status de Pedido, Tipo de Documento e Modelo de Nota possuem listas de seleção pré-definidas para evitar erros, mas mantêm suporte a expressões dinâmicas.
• Filtros Inteligentes: Busca de terceiros por CPF/CNPJ, filtros de data compatíveis com o formato ISO do n8n e muito mais.
• Autenticação Híbrida (SaaS Ready): Suporte nativo para Multi-tenancy. Escolha entre usar credenciais salvas (modo pessoal) ou injetar um Token Dinâmico em tempo de execução (modo SaaS), ideal para construir seu próprio produto sobre a API.
• AI Agent Ready: Opção exclusiva para incluir metadados de paginação (_metadata) na resposta, permitindo que Agentes de IA (como LangChain ou AutoGPT) naveguem por grandes volumes de dados autonomamente.

🚀 Como Usar

A partir da versão 1.3.0, a interface do node foi redesenhada seguindo o padrão oficial do n8n:

1. Selecione o Recurso: Escolha o módulo principal (ex: Financeiro, Operacional, Administrativo).
2. Selecione a Operação: A lista de operações é filtrada automaticamente com base no recurso selecionado.
3. Preencha os Campos: Configure parâmetros específicos da operação escolhida.

Exemplo: Ao selecionar Financeiro, você verá apenas operações como Listar Contas a Pagar, Gerar Boleto, etc. Ao trocar para Operacional, verá Listar Pedidos, Criar Produto, etc.

🛠️ Instalação

Siga o guia oficial do n8n para instalar nodes comunitários:

1. No seu n8n, vá em Settings > Community Nodes.
2. Clique em Install.
3. Procure por n8n-nodes-varejoonline ou cole o nome do pacote.
4. Aceite os termos e instale.

🔑 Autenticação e Credenciais

Este node suporta dois modos de operação, configuráveis no parâmetro Modo de Autenticação:

1. Modo Pessoal (Credenciais Salvas)

Ideal para automações internas da sua própria conta.

1. No n8n, crie uma nova credencial do tipo Varejo Online API.
2. Insira seu Token fixo.
3. No node, mantenha a opção Credenciais (Uso Pessoal).

2. Modo SaaS (Token Dinâmico)

Ideal para criar produtos onde cada execução processa dados de um cliente diferente (Multi-tenant).

1. No node, altere para Token Dinâmico (Modo SaaS).
2. O campo Token de Acesso aparecerá.
3. Mapeie este campo com uma Expression (ex: {{ $json.userApiToken }}) vinda do seu banco de dados ou webhook.

☕ Apoie o Projeto

Este node é mantido pela comunidade e pelo autor @luccamrofc, forçado por necessidades reais de grandes operações. Se ele economizou horas do seu trabalho ou permitiu que você ganhasse dinheiro automatizando processos, considere apoiar:

Chave Pix: 2858d3fb-4256-4e31-a58c-84d6c3ffde25

Qualquer valor ajuda a manter as atualizações constantes e a paridade com a API oficial! 💜

📄 Licença

MIT