n8n-nodes-capishop

Este é um custom node do n8n para integração completa com a API da Nuvemshop (Tiendanube).

🚀 Recursos

O CAPIShop oferece integração completa com os seguintes recursos da Nuvemshop:

• ✅ Products - Criar, listar, atualizar e deletar produtos
• ✅ Orders - Gerenciar pedidos da loja
• ✅ Customers - Gerenciar clientes
• ✅ Categories - Gerenciar categorias de produtos
• ✅ Variants - Listar variantes de produtos
• ✅ Images - Gerenciar imagens de produtos
• ✅ Coupons - Listar cupons de desconto
• ✅ Webhooks - Configurar webhooks
• ✅ Scripts - Listar scripts da loja
• ✅ Transactions - Listar transações
• ✅ Locations - Listar localizações
• ✅ Pages - Listar páginas da loja
• ✅ Abandoned Carts - Listar carrinhos abandonados
• ✅ Fulfillments - Listar fulfillments
• ✅ Metafields - Listar metafields

📦 Instalação

Instalação via npm

npm install n8n-nodes-capishop

Instalação via Community Nodes (n8n)

1. Acesse sua instância do n8n
2. Vá em Settings > Community Nodes
3. Clique em Install
4. Digite: n8n-nodes-capishop
5. Clique em Install

🔐 Credenciais

Para usar este node, você precisa configurar as credenciais da Nuvemshop:

1. Store ID - ID da sua loja Nuvemshop
2. Access Token - Token de acesso OAuth da API
3. User Agent - Identificação para as requisições (ex: "MeuApp ([email protected])")

Como obter as credenciais

1. Acesse o Painel de Administração da Nuvemshop
2. Vá em Aplicativos > Desenvolver aplicativos
3. Crie um novo aplicativo ou use um existente
4. Copie o Store ID e Access Token

💡 Exemplos de Uso

Listar todos os produtos

1. Adicione o node CAPIShop ao workflow
2. Selecione Resource: Product
3. Selecione Operation: Get All
4. Configure Return All: true (ou defina um limite)

Criar um novo produto

1. Adicione o node CAPIShop ao workflow
2. Selecione Resource: Product
3. Selecione Operation: Create
4. Preencha o campo Product Data (JSON) com os dados do produto:

{
  "name": {
    "pt": "Produto Exemplo"
  },
  "description": {
    "pt": "Descrição do produto"
  },
  "price": "99.90",
  "stock": 10,
  "published": true
}

Atualizar um pedido

1. Adicione o node CAPIShop ao workflow
2. Selecione Resource: Order
3. Selecione Operation: Update
4. Preencha Order ID com o ID do pedido
5. Preencha Update Data (JSON):

{
  "status": "closed",
  "note": "Pedido processado com sucesso"
}

Criar webhook para novos pedidos

1. Adicione o node CAPIShop ao workflow
2. Selecione Resource: Webhook
3. Selecione Operation: Create
4. Preencha Webhook Data (JSON):

{
  "url": "https://seu-dominio.com/webhook",
  "event": "order/created"
}

📊 Recursos Disponíveis

| Recurso | Create | Get | Get All | Update | Delete | |---------|--------|-----|---------|--------|--------| | Products | ✅ | ✅ | ✅ | ✅ | ✅ | | Orders | ❌ | ✅ | ✅ | ✅ | ❌ | | Customers | ✅ | ✅ | ✅ | ✅ | ✅ | | Categories | ✅ | ✅ | ✅ | ✅ | ✅ | | Variants | ❌ | ❌ | ✅ | ❌ | ❌ | | Images | ✅ | ❌ | ✅ | ❌ | ✅ | | Coupons | ❌ | ❌ | ✅ | ❌ | ❌ | | Webhooks | ✅ | ✅ | ✅ | ✅ | ✅ | | Scripts | ❌ | ❌ | ✅ | ❌ | ❌ | | Transactions | ❌ | ❌ | ✅ | ❌ | ❌ | | Locations | ❌ | ❌ | ✅ | ❌ | ❌ | | Pages | ❌ | ❌ | ✅ | ❌ | ❌ | | Abandoned Carts | ❌ | ❌ | ✅ | ❌ | ❌ | | Fulfillments | ❌ | ❌ | ✅ | ❌ | ❌ | | Metafields | ❌ | ❌ | ✅ | ❌ | ❌ |

🎨 Filtros e Opções Avançadas

Products - Get All

• Published - Filtrar por status de publicação
• Category ID - Filtrar por categoria
• Created At Min/Max - Filtrar por data de criação

Orders - Get All

• Status - open, closed, cancelled
• Payment Status - pending, authorized, paid, voided, refunded
• Shipping Status - unpacked, packed, fulfilled
• Created At Min/Max - Filtrar por data de criação

🛠️ Desenvolvimento

Pré-requisitos

• Node.js >= 18.x
• npm ou yarn
• n8n instalado localmente

Configuração do ambiente de desenvolvimento

# Clone o repositório
git clone https://github.com/ThawamMichels/n8n-nodes-capishop.git
cd n8n-nodes-capishop

# Instale as dependências
npm install

# Compile o projeto
npm run build

# Link localmente para testes
npm link

Testar localmente

# Em outra pasta com n8n instalado
npm link n8n-nodes-capishop

# Inicie o n8n
n8n start

📚 Documentação da API

Para mais informações sobre a API da Nuvemshop, consulte:

• Documentação Oficial da API Nuvemshop

🤝 Contribuindo

Contribuições são bem-vindas! Por favor:

1. Faça um fork do projeto
2. Crie uma branch para sua feature (git checkout -b feature/MinhaFeature)
3. Commit suas mudanças (git commit -m 'Adiciona MinhaFeature')
4. Push para a branch (git push origin feature/MinhaFeature)
5. Abra um Pull Request

📝 Changelog

v1.0.0 (2025-11-13)

• 🎉 Lançamento inicial
• ✨ 15 recursos da API Nuvemshop implementados
• ✨ CRUD completo para Products, Customers, Categories, Webhooks
• ✨ Campos dinâmicos
• ✨ Paginação automática
• ✨ Filtros avançados para Products e Orders
• ✨ Templates JSON pré-configurados

📄 Licença

Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

📧 Suporte

Para suporte e dúvidas:

• Abra uma issue no GitHub
• Email: [email protected]
• Linkedin: https://www.linkedin.com/in/thawammichels/

🙏 Agradecimentos

• n8n - Plataforma de automação de workflows
• Nuvemshop - Plataforma de e-commerce

⭐ Se este projeto foi útil, considere dar uma estrela no GitHub!