Como Emitir Notas Fiscais da Kiwify de Forma Automática para Infoprodutos

A Kiwify é uma das maiores plataformas de infoprodutos do Brasil. E não importa se você está começando a vender ou se vende milhões na plataforma, emitir notas fiscais é uma obrigação e pode ser muito trabalhoso – Caso você não automatize.

Nota Fiscal Kiwify

Neste artigo, você vai entender:

  • Passo a passo detalhado da integração Spedy-Kiwify
  • 4 modelos diferentes de emissão automática de notas
  • Configurações personalizáveis para período de garantia
  • Opções de retroatividade para vendas anteriores
  • Sistema de cancelamento automático em reembolsos
  • Gestão automática de emails para clientes

A emissão automática de notas fiscais é como ter um assistente trabalhando 24 horas por dia, garantindo que cada venda tenha sua documentação fiscal adequada. Lembro de um cliente que gastava 4 horas todos os sábados emitindo notas manualmente – após implementar a automação, esse tempo foi reduzido a zero.

Definição de nota fiscal eletrônica (NF-e)

A nota fiscal eletrônica é um documento digital obrigatório que registra e valida suas transações comerciais. Para infoprodutos, geralmente utilizamos a NFS-e (Nota Fiscal de Serviços eletrônica), adequada para cursos e produtos digitais.

Processo de emissão automática na prática

Vou te guiar pelo processo completo de integração entre Kiwify e Spedy. Primeiro, você precisa ter uma conta ativa em ambas as plataformas. Vamos ao passo a passo:

  1. Acesso inicial e configuração na Spedy:
    • Entre em sua conta Spedy
    • No menu lateral, localize e clique em “Apps”
    • Procure o card da Kiwify
    • Clique em “Desabilitado” ou use o botão de três pontos para selecionar “+ Nova Integração”

Tela inicial da Spedy mostrando o card da Kiwify

  1. Configuração do modelo de nota fiscal:
    • Na nova tela, o botão “Habilitar integração” já estará ativo
    • Escolha o modelo de nota fiscal padrão
    • Esta configuração pode ser alterada posteriormente por produto

Tela de configuração do modelo de nota fiscal

  1. Definição do momento de emissão:
    Aqui você tem quatro opções principais:

    • Na geração da venda: emissão imediata após a criação da venda
    • Após período de garantia: aguarda o prazo de garantia terminar
    • Quando o pagamento for aprovado: emite após confirmação do pagamento
    • Não emitir automaticamente: controle manual das emissões

Uma dica valiosa que aprendi após anos de experiência: sempre comece com “Não emitir automaticamente” para fazer testes. Já vi casos onde a configuração incorreta gerou centenas de notas que precisaram ser canceladas.

  1. Configuração na Kiwify:
    • Acesse o Dashboard da Kiwify
    • Vá para Apps > API
    • Clique em “Criar API Key”
    • Configure os seguintes campos:
      • Nome: Spedy
      • Endpoints necessários: Relatórios, Vendas, Reembolsar vendas e Webhooks

Configuração da API na Kiwify

  1. Integração das plataformas:
    • Copie o Client ID, Client Secret e Account ID da Kiwify
    • Cole esses dados nos campos correspondentes na Spedy
    • Informe o mesmo email usado na Kiwify
    • Configure a data de início da integração

Tela de configuração das credenciais

Tela final de configuração

Funcionalidades especiais que você precisa conhecer

  1. Gestão de emails automáticos:

    • Configure se as notas serão enviadas automaticamente aos clientes
    • Personalize o processo de envio
    • Mantenha seus clientes informados sem trabalho manual
  2. Sistema de reembolsos:

    • Ative o cancelamento automático de notas em caso de reembolso
    • Evite problemas fiscais com vendas canceladas
    • Mantenha sua documentação sempre em ordem
  3. Gestão de juros:

    • Decida se os juros de parcelamento serão incluídos no valor da nota
    • Configure de acordo com sua estratégia de precificação
    • Mantenha conformidade com suas políticas financeiras

Importação de vendas antigas

Uma funcionalidade que poucos conhecem é a possibilidade de importar vendas retroativas. Por exemplo:

  • Se você está configurando a integração em 10/05/2024
  • Mas tem vendas desde 01/05/2024
  • Configure a data de início como 01/05/2024 para importar todas as vendas

Configuração do período de garantia

Se você trabalha com período de garantia, configure:

  • Quantidade exata de dias de garantia
  • Sistema calculará automaticamente a data de emissão
  • Notas serão emitidas apenas após esse período

Dicas práticas que aprendi na prática

  1. Teste inicial:

    • Comece com emissão manual
    • Faça testes com algumas vendas
    • Verifique se todos os dados estão corretos
  2. Monitoramento:

    • Verifique regularmente as notas emitidas
    • Confirme se os valores estão corretos
    • Monitore os emails enviados aos clientes
  3. Backup e segurança:

    • Mantenha um registro das configurações
    • Faça backup regular dos dados
    • Documente todas as alterações

Solução de problemas comuns

Em minha experiência, os problemas mais comuns são:

  1. Divergência de emails:

    • Certifique-se de usar o mesmo email nas duas plataformas
    • Verifique a grafia dos emails cadastrados
    • Confirme se o email está ativo
  2. Configuração de datas:

    • Atenção à data de início da integração
    • Verifique o fuso horário das plataformas
    • Confirme os períodos de garantia
  3. Problemas de integração:

    • Verifique as credenciais API
    • Confirme as permissões configuradas
    • Teste a conexão entre as plataformas

Melhores práticas para diferentes modelos de negócio

  1. Para cursos online:

    • Configure emissão após período de garantia
    • Defina prazo adequado ao seu modelo
    • Configure emails automáticos
  2. Para produtos sem garantia:

    • Emita notas na aprovação do pagamento
    • Configure envio imediato aos clientes
    • Monitore aprovações de pagamento
  3. Para produtos com alto índice de reembolso:

    • Ative cancelamento automático
    • Configure alertas de reembolso
    • Mantenha registro de cancelamentos

Conclusão e próximos passos

A automação de notas fiscais é um investimento em profissionalização e eficiência. Com a integração Kiwify-Spedy corretamente configurada, você:

  • Economiza tempo valioso
  • Reduz erros humanos
  • Mantém conformidade fiscal
  • Melhora a experiência do cliente

Lembre-se: o sucesso está nos detalhes. Dedique tempo para configurar corretamente e testar cada funcionalidade. Se surgir alguma dúvida específica, tanto o suporte da Spedy quanto da Kiwify são excelentes recursos.

Comece hoje mesmo sua jornada de automação fiscal e transforme horas de trabalho manual em minutos de configuração inteligente. Sua operação agradecerá, e você terá mais tempo para focar no que realmente importa: criar conteúdo excepcional para seus alunos.