n8n Nodes - Seta Digital API

Nodes do n8n para integração com a API Linx Seta Digital, permitindo automatizar operações de ERP diretamente no n8n.

🚀 Instalação

Via n8n Community Nodes

1. Acesse as configurações do n8n
2. Vá para "Community Nodes"
3. Clique em "Install a community node"
4. Digite: n8n-nodes-seta-digital
5. Clique em "Install"

Via npm (Desenvolvimento)

npm install n8n-nodes-seta-digital

📦 Nodes Disponíveis

🔐 Credenciais

• Seta Digital API: Configuração de autenticação com a API

🔧 Nodes Principais

• Seta Digital: Node principal com todas as operações
• Seta Digital - Produtos: Operações específicas de produtos
• Seta Digital - Estoque: Consultas de estoque
• Seta Digital - Vendas: Gerenciamento de vendas
• Seta Digital - Pessoas: Gestão de pessoas/clientes
• Seta Digital - Notas Fiscais: Consultas de notas fiscais

🎯 Funcionalidades

✅ Produtos

• Buscar todos os produtos
• Buscar por SKU, código, marca, referência, EAN
• Filtrar por status no e-commerce
• Buscar produtos alterados por período
• Ordenação personalizada

✅ Estoque

• Consultar todo o estoque
• Filtrar por empresa, SKU, produto, EAN
• Buscar produtos ativos/inativos no e-commerce
• Consultar movimentações por período
• Ordenação por quantidade, preço, etc.

✅ Vendas

• Buscar todas as vendas
• Filtrar por código, código externo, período
• Criar novas vendas
• Gerenciar itens da venda
• Ordenação por data, valor, código

✅ Pessoas

• Buscar clientes, fornecedores, funcionários
• Filtrar por CPF/CNPJ, nome, código
• Consultar detalhes de pessoas

✅ Notas Fiscais

• Buscar notas fiscais
• Filtrar por empresa, número, venda, período
• Consultar por chave NFe

🔧 Configuração

1. Configurar Credenciais

1. Adicione o node "Seta Digital API" nas credenciais
2. Configure:
   • Base URL: URL da sua API Seta Digital
   • API Key: Sua chave de API
   • Timeout: Timeout para requisições (opcional)

2. Usar os Nodes

1. Arraste o node desejado para o workflow
2. Configure a operação
3. Defina os parâmetros necessários
4. Execute o workflow

📋 Exemplos de Uso

Buscar Produtos Ativos no E-commerce

{
  "operation": "buscarAtivosEcommerce",
  "page": 1,
  "size": 100,
  "sort": "descricao:asc"
}

Consultar Estoque por Empresa

{
  "operation": "buscarPorEmpresa",
  "empresa": "03",
  "page": 1,
  "size": 50
}

Criar Nova Venda

{
  "operation": "criarVenda",
  "codigoExternoVenda": "PED-2024-001",
  "pessoaCodigo": "000001",
  "observacoes": "Pedido criado via n8n",
  "itens": [
    {
      "produtoCodigo": "PROD001",
      "quantidade": 2,
      "precoUnitario": 50.00,
      "desconto": 0
    }
  ]
}

Buscar Vendas por Período

{
  "operation": "buscarPorPeriodo",
  "dataInicial": "2024-01-01T00:00:00Z",
  "dataFinal": "2024-12-31T23:59:59Z",
  "page": 1,
  "size": 100
}

🔄 Workflows Sugeridos

1. Sincronização de Produtos

• Trigger: Cron (diário)
• Ação: Buscar produtos alterados
• Processar: Atualizar sistema externo

2. Monitoramento de Estoque

• Trigger: Webhook
• Ação: Verificar estoque baixo
• Notificação: Enviar alerta

3. Criação Automática de Vendas

• Trigger: Webhook de pedido
• Ação: Criar venda na API
• Processar: Atualizar status

4. Relatório de Vendas

• Trigger: Cron (semanal)
• Ação: Buscar vendas do período
• Processar: Gerar relatório

🛠️ Desenvolvimento

Estrutura do Projeto

src/
├── credentials/
│   └── SetaDigitalApi.credentials.ts
├── nodes/
│   ├── SetaDigital/
│   ├── SetaDigitalProdutos/
│   ├── SetaDigitalEstoque/
│   ├── SetaDigitalVendas/
│   ├── SetaDigitalPessoas/
│   └── SetaDigitalNotasFiscais/

Scripts Disponíveis

npm run build      # Compilar TypeScript
npm run dev        # Compilar em modo watch
npm run lint       # Verificar código
npm run lint:fix   # Corrigir problemas de lint

📚 Documentação da API

Para mais informações sobre a API Seta Digital:

• Documentação: https://api-docs.seta-digital.com
• Pacote npm: https://www.npmjs.com/package/seta-digital-api-client

🤝 Contribuição

1. Fork o projeto
2. Crie uma branch para sua feature
3. Commit suas mudanças
4. Push para a branch
5. Abra um Pull Request

📞 Suporte

• Email: suporte@makertec.com.br
• Telefone: (45) 9859 0373
• Issues: GitHub Issues

📄 Licença

MIT - veja o arquivo LICENSE para detalhes.

---

Desenvolvido com ❤️ para a comunidade n8n