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.

7 min de leituraTela: Pedidos › Importar vendasPerfil: Admin da editora

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.

  1. Monte a planilha

    Três colunas são obrigatórias. As outras melhoram o registro, mas não impedem a importação.

    ColunaObrigatóriaO que é
    numeroSimNúmero do pedido na sua loja
    emailSimE-mail do comprador — é por ele que a conta é criada
    skuSimCódigo do produto, já mapeado para um livro
    valorNãoBase do repasse. Sem ele, a venda entra com valor zero
    nomeNãoPersonaliza o convite de acesso
    dataNãoData 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-16
  2. Confira 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.

  3. 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.

  4. Importe o histórico sem custo retroativo

    Vendas com data anterior 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.