Central de Ajuda › Conectar sua loja
Importar vendas por planilha
Colunas obrigatórias, o que é a chave de idempotência e por que vendas anteriores ao contrato não geram repasse.
Use quando a loja ainda não está integrada, para migrar o histórico ou como plano B se a integração cair. Cada linha da planilha vira um pedido e libera o livro na biblioteca do comprador.
Monte a planilha
Três colunas são obrigatórias. As outras melhoram o registro, mas não impedem a importação.
Coluna Obrigatória O que é numeroSim Número do pedido na sua loja emailSim E-mail do comprador — é por ele que a conta é criada skuSim Código do produto, já mapeado para um livro valorNão Base do repasse. Sem ele, a venda entra com valor zero nomeNão Personaliza o convite de acesso dataNão Data original da venda. Ausente = hoje numero;email;sku;valor;nome;data PED-2026-0192;maria@exemplo.com;SKU-DIR-CIV-1;59.90;Maria Silva;2026-07-15 PED-2026-0193;joao@exemplo.com;SKU-DIR-CIV-2;79.00;João Souza;2026-07-16Confira a prévia antes de confirmar
O Folhear mostra linha a linha o que vai acontecer: quais criam leitor novo, quais já existem e quais têm problema. Nada é gravado enquanto você não confirmar.
Resolva as linhas com erro
As que falharem ficam na fila de eventos, em Integrações, e podem ser reprocessadas depois da correção — sem precisar montar a planilha de novo.
O erro mais comum é “Produto sem mapeamento”. Significa que aquele código ainda não está ligado a nenhum livro. Cadastre em Integrações › Mapeamento de produtos e clique em reprocessar.
Importe o histórico sem custo retroativo
Vendas com
dataanterior ao início do seu contrato liberam o livro normalmente, mas não geram repasse. É o que permite migrar anos de vendas sem cobrança sobre elas — o resumo da importação mostra quantas linhas caíram nessa condição.
Reimportar o mesmo arquivo é seguro
Cada linha carrega uma chave única. Se o mesmo pedido chegar duas vezes — porque você reimportou por engano, porque a rede caiu no meio —, o segundo é reconhecido e ignorado. Ninguém recebe o livro em dobro e nada é cobrado duas vezes.