1.1.5

v1.1.5 - Correções no Módulo de Assinaturas

O que há de novo

Esta versão traz uma auditoria completa e refatoração do módulo de Assinaturas, corrigindo problemas críticos de compatibilidade com a API Hotmart.

🐛 Correções de Bugs

• Erro 400 ao Listar Assinaturas
• Removidos 9 campos inválidos que não existem na API GET /subscriptions:
• subscriber_name, billing_type, subscription_status, recurrency_status, purchase_status, transaction_date, end_transaction_date, offer_code, purchase_payment_type

Conversão de Datas

• Datas agora são corretamente convertidas de ISO string para timestamp em milissegundos, conforme exigido pela API Hotmart

Paginação Automática

• Implementado loop de paginação usando page_token quando "Retornar Todos" está ativado
• Agora retorna todos os registros, não apenas a primeira página (~50 itens)
• Defaults Problemáticos
• Campos como status, trial, product_id não enviam mais valores default quando não selecionados
• Campo trial convertido corretamente de string para boolean

##✨ Melhorias

• Mensagens de erro mais detalhadas: Agora incluem informações específicas retornadas pela API Hotmart
• Interface simplificada: Apenas os campos válidos da API são exibidos nos filtros
• Separação de filtros por operação: Cada operação mostra apenas os filtros relevantes

📋 Histórico de Versões (desde 1.1.1)

Versão & Mudanças

• 1.1.5 Melhor tratamento de erros e conversão do campo trial
• 1.1.4 Auditoria completa - remoção de 9 campos inválidos
• 1.1.3 Limpeza de filtros vazios antes de enviar à API
• 1.1.2 Conversão de datas para milissegundos + paginação automática

📖 Como Usar

Atualize o node em Settings → Community Nodes
Configure "Listar Assinaturas":
Status: Ativa (opcional)
Data de Adesão (Início): Ex: 2020-01-01 (para buscar histórico completo)
Retornar Todos: ✅ Ativado
Dica: Se não especificar "Data de Adesão (Início)", a API Hotmart filtra automaticamente apenas os últimos 30 dias.

🔗 Links
npm package
Documentação da API Hotmart

1.1.1

Novidades de AI!

⚠️ Importante para Usuários com Docker (Scaling Mode)

Se você usa containers separados (editor, worker, webhook), adicione esta variável em TODOS os containers:

environment:
  - N8N_REINSTALL_MISSING_PACKAGES=true

🤖 Otimizado para AI Agents e retry em Rate Limit(v1.1.1)

Metadados de Paginação: Ative a opção "Incluir Metadados de Paginação" para receber _metadata com has_more, page_token e items_returned - perfeito para agentes de IA que precisam navegar por grandes volumes de dados.

Rate Limit Inteligente: Retry automático com backoff exponencial (1s → 2s → 4s) quando a API da Hotmart retorna erro 429.

Mensagens de Erro Melhoradas: Orientações claras quando ocorrem erros de rate limit.

1.1.0

📦 Novas Features:

Path Customizado: Agora você pode trocar o /webhook para qualquer coisa (ex: /minha-loja).

Toggle "Personalizar Nomes das Saídas": Ao ativar essa opção, campos de texto aparecem para você renomear as saídas (ex: Mudar "Compra Única" para "Ebook"). Funciona tanto no modo Flow quanto no Super Flow.

UI Corrigida: Com a mudança interna de strings para objetos, o bug da altura deve desaparecer e os nomes (padrão ou customizados) vão aparecer corretamente nas linhas.

1.0.0

🎉 v1.0.0 - A Versão Definitiva: Paridade Total com API v2, Eventos & Triggers Inteligentes

Este release marca um grande marco para o n8n-nodes-hotmart-api. Atingimos 100% de paridade com a documentação oficial da API v2 da Hotmart, introduzindo novos recursos, corrigindo comportamentos legados e lançando a engine de Triggers mais avançada para Community Nodes.

🚀 Destaques Principais

🧠 Trigger Inteligente (Flow & Super Flow)

Agora o node Hotmart Trigger não é apenas um webhook passivo. Ele entende o contexto:

Modo Flow: Roteamento automático para 13 saídas baseadas no tipo técnico (Approved, Canceled, Switch Plan, etc).
Modo Super Flow: Roteamento para 6 saídas baseadas em lógica de negócio (ex: distingue "Nova Assinatura" de "Renovação" e "Compra Única").
Auto-Parser: Extração automática de dados aninhados (subscriber, affiliates, plans, commissions) diretamente para a raiz do JSON. Sem mais Code Nodes para limpar dados!

🎟️ Novo Recurso: Eventos

Gestão completa de ingressos e eventos presenciais/online:

Listar Participantes: Filtre por QR Code, Lote, Status de Check-in e muito mais.
Info do Evento: Detalhes completos do evento configurado.

💳 Negociação de Parcelas

Automação para recuperação de vendas:

Gerar Negociação: Crie links de pagamento (PIX/Boleto) para parcelas em atraso diretamente pelo n8n.

🛠️ Changelog Completo

🌟 Novos Recursos

Eventos: Adicionado recurso completo (getInfo, getParticipants).
Produtos: Novas operações getOffers (Ofertas) e getPlans (Planos).
Vendas: Novas operações refund (Reembolsar) e getUsers (Participantes).
Assinaturas: Novas operações para ações em massa cancelBatch e reactivateBatch.

⚡ Melhorias & Correções

Autenticação: Suporte nativo a Modo SaaS (Token Dinâmico) e Modo Pessoal (Credenciais).
Vendas: Adicionados filtros de commission_as, payment_type, offer_code e correção do sales_source.
Assinaturas: Correção das URLs de changeBillingDate e lógica de parâmetros de cancelamento/reativação.
Área de Membros: Correção de URL em getPages e novos filtros em getModules.

📦 Webhooks Suportados (Trigger)

Validação e parseamento completo para:

PURCHASE_* (Todos os eventos de pedidos)
SUBSCRIPTION_CANCELLATION
SWITCH_PLAN
UPDATE_SUBSCRIPTION_CHARGE_DATE
CLUB_FIRST_ACCESS & CLUB_MODULE_COMPLETED
PURCHASE_OUT_OF_SHOPPING_CART

Atualize agora e automatize sua operação Hotmart como um profissional! 💜

Mantido pela comunidade. Se este node ajuda seu negócio, considere apoiar o projeto via Pix no README, obrigado!

0.4.1

Publicado v0.4.1!

✅ README atualizado
✅ Comentários padronizados em português
✅ Banners de comentários removidos

0.4.0

✅ Correção da URL base de produção
✅ Módulo de Cupons (criar, listar, excluir)
✅ Módulo de Negociação de Parcelas (gerar PIX/Boleto para inadimplentes)
✅ Sistema completo de refresh(modulo exclusivo de renovação)
✅ Buffer de renovação aumentado.
✅ Pequenas melhorias de qualidade de vida e usabilidade.
✅ Correções de filtros de parâmetros adicionais.

0.1.4

Renovação automática do Acess Token
Tradução completa para Pt-Br
Unificação do Trigger + Webhook
Incluído Buffer de 5 minutos de renovação do Acess Token, mesmo para credenciais dinâmicas, aumentado de 60s > 5min.

Bug Fix:

Correção no erro 401 quando ocorria falhar de renovação automática do Token.

0.1.0

First version(Beta)