Artigos de ajuda

Como exportar as vendas da Kiwify para o Excel ou Google Sheets

Manual e automático. Atualizado em 13 de outubro de 2026.

Existem quatro caminhos para ter as vendas da Kiwify numa planilha. Eles diferem em três coisas: se trazem o histórico, se atualizam sozinhos e se mantêm reembolsos e UTMs corretos com o tempo.

1. Exportar o CSV pelo painel da Kiwify

É o caminho grátis e o que quase todo produtor já usa. No painel, abra a tela de Vendas, filtre o período que você quer e use a opção de exportar. O nome exato dos botões pode mudar com atualizações do painel.

Abrir no Google Sheets sem estragar números e acentos

1. Antes de importar, confira a localidade da planilha em Arquivo > Configurações > Localidade: com Brasil, vírgula vira decimal e datas no formato dia/mês são entendidas corretamente.
2. Use Arquivo > Importar > Fazer upload e escolha o arquivo.
3. Em Local de importação, prefira Substituir página atual numa aba dedicada (por exemplo, Bruto). Explicamos o motivo abaixo.
4. Em Tipo de separador, deixe Detectar automaticamente. Se tudo cair numa coluna só, escolha vírgula ou ponto e vírgula manualmente.
5. Marque para converter texto em números e datas.

Abrir no Excel

Não dê dois cliques no arquivo: o Excel pode quebrar acentos e juntar colunas. Use Dados > Obter Dados > De Texto/CSV, escolha a origem 65001: Unicode (UTF-8) e confira o delimitador na pré-visualização antes de carregar.

As armadilhas do CSV

• Duplicidade. Se você anexa a exportação desta semana à da semana passada, qualquer sobreposição de datas duplica vendas. Exporte sempre o período inteiro e substitua a aba Bruto.
• Reembolsos atrasados. Uma venda de agosto reembolsada em outubro continua aprovada na exportação de agosto. Só uma nova exportação que cubra agosto corrige.
• Fórmulas que quebram. Se o layout do arquivo muda, fórmulas que apontam para letras de coluna passam a somar a coluna errada sem avisar. Deixe os cálculos numa aba separada e procure as colunas pelo nome do cabeçalho com CORRESP, por exemplo =ÍNDICE(Bruto!A:Z; 0; CORRESP("Status"; Bruto!1:1; 0)).
• Campos que faltam. Confira se o seu arquivo traz taxa, comissão de afiliado, coprodução e UTMs separados. Sem eles, não dá para calcular o lucro líquido real nem saber qual campanha vendeu.

2. Usar a API da Kiwify com um script próprio

A Kiwify tem uma API pública. Se você programa, dá para escrever um Google Apps Script que busca as vendas e grava na planilha. O que você vai precisar resolver:

• Credenciais. Em Apps > API, crie uma API Key. Ela fornece client_secret, client_id e account_id. O client_id e o client_secret são trocados por um token de acesso temporário em POST /v1/oauth/token, e o account_id vai num cabeçalho de cada consulta.
• Janela de 90 dias. A listagem de vendas (GET /v1/sales) aceita no máximo 90 dias por consulta, com paginação. Para o histórico completo, quebre o período em janelas e percorra todas as páginas.
• Limites. A API limita o número de consultas por minuto, e o Apps Script corta cada execução em 6 minutos. Históricos grandes precisam de um cursor salvo para continuar de onde parou.
• Atualização sem duplicar. Grave cada venda pelo ID e atualize a linha existente quando o status mudar (reembolso, chargeback). Anexar linhas no fim gera duplicidade.
• Segurança da chave. A mesma API Key pode permitir operações além de consulta, como reembolso e saque. Guarde as credenciais nas propriedades de usuário do script (nunca numa célula da planilha) e limite o seu código a rotas de leitura.

Funciona bem e não custa nada além do seu tempo. O custo real é a manutenção: quando a API muda ou o script falha às 3 da manhã, ninguém te avisa.

3. Webhook com Make ou Zapier

A Kiwify pode avisar um endereço a cada evento (venda aprovada, reembolso etc.). Ferramentas como Make e Zapier recebem esse aviso e adicionam uma linha na planilha. É simples de montar, mas tem limites:

• só pega o que acontecer depois de configurado, sem histórico;
• o reembolso chega como um evento novo, e você precisa montar a lógica para achar e atualizar a venda original;
• essas ferramentas cobram por operação, então o custo cresce com o volume de vendas;
• se o cenário falhar, a venda simplesmente não entra.

Bom para alertas em tempo real (por exemplo, avisar no WhatsApp a cada venda). Fraco como base para fechar o mês.

4. Sincronização automática com a Vendilha

A Vendilha é um add-on do Google Sheets que faz o caminho 2 por você, sem código:

1. Instale o add-on e abra Extensões > Vendilha > Abrir painel.
2. Na Kiwify, crie uma API Key em Apps > API e cole client_secret, client_id e account_id no painel (passo a passo).
3. Clique em Conectar e depois em Sincronizar agora.

A aba Vendas Kiwify recebe uma linha por venda, sempre nas mesmas colunas: datas de criação, aprovação e reembolso, status, forma de pagamento e parcelas, produto, valor cobrado, taxa da Kiwify, comissão e nome do afiliado, repasse de coprodução, líquido do produtor, utm_source, utm_medium, utm_campaign, utm_content, utm_term, src, sck e dados do comprador. Vendas reembolsadas são atualizadas no lugar, sem duplicar. A aba Resumo Kiwify soma tudo por mês, até o lucro líquido real.

A chave fica nas propriedades de usuário do add-on, na sua conta Google, e as vendas vão da Kiwify direto para a planilha, sem passar por servidor nosso. O código só faz consultas.

E se eu precisar no Excel?

Baixe a planilha em Arquivo > Fazer download > Microsoft Excel (.xlsx) quando quiser, ou conecte o Excel e o Power BI ao Google Sheets para ter os dados sempre atualizados.