[Importador de Vendas] Como funciona a importação de arquivo no eNotas?

Para garantir que suas vendas sejam importadas corretamente, é essencial entender o que deve ser preenchido em cada coluna do arquivo CSV padrão do eNotas.

Os dados preenchidos servirão para criar as vendas que, posteriormente, darão origem às suas notas fiscais. Nem todos os campos são obrigatórios, pois o sistema pode aproveitar informações já cadastradas na sua conta (dados municipais e produtos).

Dica: utilize o arquivo de exemplo em anexo neste tutorial para guiar seu preenchimento.

As colunas são organizadas por prefixos que indicam o tipo de informação:

• Cliente_: dados de quem está comprando (tomador da nota).
• Venda_: dados da transação financeira.
• Produto_: detalhes do item ou serviço vendido.
• NFe_: informações específicas para a emissão do documento fiscal.

Dados da venda e do cliente

Coluna A - ChaveUnica

• Preenchimento opcional.
• Você pode usar esse campo para vincular o ID da transação da sua plataforma de vendas à venda criada no eNotas.
• Depois da importação, será possível localizar essa venda usando esse identificador.

Coluna B - Cliente_NomeRazaoSocial

• Preenchimento obrigatório em todas as vendas.
• Limite de caracteres: 115.
• Informe o nome do cliente pessoa física ou a razão social da empresa para a qual a nota fiscal será emitida.

Coluna C - Cliente_NomeFantasia

• Preenchimento opcional.
• Limite de caracteres: 115.
• Use esse campo para informar o nome fantasia da empresa cliente.

Coluna D - Cliente_Documento

• Obrigatório para emissões de NF-e e em prefeituras que exigem documento para NFSe.
• Limite de caracteres: CPF com 11 dígitos ou CNPJ com 14 dígitos
• Informe o CPF ou CNPJ do cliente.
• Para notas de produto (NF-e), esse campo é obrigatório.

Coluna E - Cliente_Email

• Obrigatório para SEFAZ e para prefeituras que exigem esse dado.
• Limite de caracteres: 80.
• Informe o e-mail do cliente.
• Dependendo da configuração do ambiente, a eNotas poderá enviar a nota fiscal para esse endereço.

Coluna F - Cliente_EnderecoCidade

• Obrigatório para SEFAZ e para prefeituras que exigem endereço
• A cidade deve ser informada conforme o nome utilizado na tabela do IBGE.

Coluna G - Cliente_EnderecoUF

• Obrigatório para SEFAZ e para prefeituras que exigem endereço.
• Limite de caracteres: 2.
• Informe a UF com dois caracteres, como, por exemplo: MG, SP ou GO.

Coluna H - Cliente_EnderecoCEP

• Obrigatório para SEFAZ e para prefeituras que exigem endereço.
• Limite de caracteres: 8
• Informe o CEP com os 8 dígitos, inclusive quando começar com zero, ex: 00123456.
• Se o CEP for válido, a eNotas poderá buscar automaticamente o restante do endereço e preencher o número como 00, o que pode ajudar quando o endereço completo não estiver disponível.

Coluna I - Cliente_Endereco

• Obrigatório para SEFAZ e para prefeituras que exigem endereço.
• Limite de caracteres: 125.
• Informe apenas o logradouro do cliente.

Coluna J - Cliente_EnderecoNumero

• Obrigatório para SEFAZ e para prefeituras que exigem endereço.
• Limite de caracteres: 10.
• Esse campo aceita apenas números.

Coluna K - Cliente_EnderecoComplemento

• Preenchimento opcional.
• Limite de caracteres: 30.
• Não use caracteres especiais como /, ° ou *.

Coluna L - Cliente_EnderecoBairro

• Obrigatório para SEFAZ e para prefeituras que exigem endereço.
• Limite de caracteres: 30.
• Informe o bairro do cliente.

Coluna M - Cliente_EnderecoPais

• Obrigatório para SEFAZ e para prefeituras que exigem endereço.
• Informe o país em português, conforme a tabela do Bacen.

Coluna N - Cliente_Telefone

• Preenchimento opcional.
• Limite de caracteres: entre 10 e 11 dígitos.
• Se for informado um número fora desse padrão, a emissão da nota poderá ser negada.

Coluna O - Cliente_TipoPessoa

• Preenchimento opcional.
• Limite de caracteres: 2.
• Valores esperados: PF ou PJ.
• Esse campo pode ficar em branco, porque o sistema identifica automaticamente o tipo de pessoa com base no documento informado.

Coluna P - Cliente_InscricaoMunicipal

• Preenchimento opcional.
• Limite de caracteres: 15.
• Necessário apenas em alguns casos específicos para clientes pessoa jurídica.

Coluna Q - Cliente_InscricaoEstadual

• Preenchimento opcional.
• Limite de caracteres: 15.
• Necessário apenas em alguns casos específicos para clientes pessoa jurídica.

Dados do produto

Coluna R - Produto_Nome

• Preenchimento obrigatório em todas as vendas.
• Limite de caracteres: 255.
• Informe o nome do produto ou serviço vendido.

Coluna S - Produto_IDExterno

• Obrigatório se a venda for de um produto já cadastrado no eNotas.
• Limite de caracteres: 1000.
• Se o produto já existir no eNotas, informe o ID dele para evitar a criação de um novo cadastro duplicado.
• Esse ID pode ser consultado em Gerenciar > Produtos.

Coluna T - Produto_ValorTotal

• Preenchimento opcional.
• Esse campo não define o valor da venda emitida na nota.
• O valor efetivo da venda será considerado a partir da coluna U - Venda_ValorTotal.
• A coluna T serve apenas para definir um valor no cadastro do produto.

Dados da venda

Coluna U - Venda_ValorTotal

• Preenchimento obrigatório em todas as vendas.
• Informe o valor total do produto vendido ou do serviço prestado.
• Use apenas números e ponto para separar as casas decimais, ex: 10.00.

Coluna V - Venda_Data

• Preenchimento obrigatório em todas as vendas.
• Limite de caracteres: 10.
• Informe a data em que a venda foi realizada.
• Formato aceito: 15/06/2026.

Coluna W - Venda_MeioPagamento

• Preenchimento opcional.
• Esse campo aceita apenas os valores previstos no modelo da planilha.

Dados fiscais da nota

Coluna X - NFe_CNAE

• Na maioria dos casos, esse campo não é obrigatório.
• Se o produto já existir no eNotas, o sistema pode buscar essa informação automaticamente. Se for um novo produto ou serviço com CNAE diferente, será necessário preencher.

Coluna Y - NFe_CodigoServicoMunicipio

• Preenchimento opcional.
• Se o serviço vendido já estiver cadastrado na empresa, esse campo pode ficar em branco.
• Se for um serviço novo, será necessário informar esse código.
• Esse dado pode ser consultado em Empresa > Dados municipais.

Coluna Z - NFe_ItemListaServicoLC116

• Preenchimento opcional.
• Se a prefeitura exigir esse dado, o sistema poderá buscá-lo automaticamente no cadastro da empresa ou do produto.

Retenções e tributos

As colunas abaixo são usadas apenas quando houver retenções ou necessidade de informar percentuais específicos, sendo assim, são opcionais.

Coluna AA - NFe_ValorCOFINS

• Se o percentual de COFINS for informado na coluna AB, o valor poderá ser calculado automaticamente.

Coluna AB - NFe_PercentualCOFINS

• Preencha apenas quando houver retenção de COFINS.

Coluna AC - NFe_ValorPIS

• Se o percentual de PIS for informado na coluna AD, o valor poderá ser calculado automaticamente.

Coluna AD - NFe_PercentualPIS

• Preencha apenas quando houver retenção de PIS.

Coluna AE - NFe_ValorCSLL

• Se o percentual de CSLL for informado na coluna AF, o valor poderá ser calculado automaticamente.

Coluna AF - NFe_PercentualCSLL

• Preencha apenas quando houver retenção de CSLL.

Coluna AG - NFe_ValorINSS

• Se o percentual de INSS for informado na coluna AH, o valor poderá ser calculado automaticamente.

Coluna AH - NFe_PercentualNSS

• Preencha apenas quando houver retenção de INSS.

Coluna AI - NFe_ValorIR

• Se o percentual de IR for informado na coluna AJ, o valor poderá ser calculado automaticamente.

Coluna AJ - NFe_PercentualIR

• Preencha apenas quando houver retenção de IR.

Coluna AK - NFe_ValorISS

• O valor do ISS pode ser calculado automaticamente com base na alíquota informada na coluna AL.

Coluna AL - NFe_AliquotaISS

• Se esse campo não for preenchido, o sistema buscará a alíquota no cadastro da empresa ou do produto, conforme o cenário.

Coluna AM - NFe_ISSRetido

• Valores aceitos: SIM ou NAO.
• Use esse campo apenas quando houver retenção de ISS na fonte para emissão de NFSe.

Coluna AN - NFe_ValorDeducoes

• Preencha apenas quando houver deduções no valor do produto ou serviço.

Coluna AO - NFe_ValorDescontos

• Preencha apenas quando houver desconto no valor do produto ou serviço.

Datas e informações complementares da nota

Todos são preenchimentos opcionais.

Coluna AP - NFe_DataCompetencia

• Limite de caracteres: 10.
• Formato aceito: 15/06/2026.
• Durante a importação, o sistema poderá fazer perguntas relacionadas à data de competência.

Coluna AQ - NFe_MunicipioPrestacao

• Informe a cidade de prestação do serviço conforme o nome ou código do IBGE.
• Se for preencher, o mais recomendado é usar o código do IBGE para evitar erros.
• Esse campo é necessário apenas quando o serviço foi prestado em município diferente da sede da empresa.

Coluna AR - NFe_Discriminacao

• Limite de caracteres: 1000.
• Informe a descrição do que foi vendido.
• Se esse campo ficar vazio, o sistema poderá usar o valor informado em Produto_Nome.

Coluna AS - Venda_DataVencimento

• Use esse campo quando houver prazo de garantia ou vencimento relacionado à venda.
• Formato aceito: 15/06/2026.
• Na importação, você poderá optar por emitir as notas automaticamente após essa data.

Coluna AT - NFe_QuandoEmitir

• Esse campo também pode ser definido diretamente na tela de importação, então o preenchimento não é obrigatório.
• Use apenas os valores aceitos no modelo da planilha.

Coluna AU - NFe_EnviarNFeCliente

• Valores aceitos: SIM ou NAO.
• Essa opção também pode ser definida na tela de importação.

Coluna AV - NFe_ValorTotal

• Preencha esse campo apenas quando o valor da nota fiscal for diferente do valor da venda.
• Se ele ficar em branco, o sistema usará o valor da coluna Venda_ValorTotal.

Coluna AW - NFe_DescricaoServicoMunicipal

• Esse campo pode ser preenchido automaticamente com base no serviço cadastrado na empresa ou no produto.

Coluna AX - NFe_InformacaoAdicional

• Limite de caracteres: 300
• Use esse campo para incluir observações que devem aparecer na nota fiscal.
• A informação será exibida no campo de observações da venda.
• Não use ponto e vírgula neste campo.

Identificação por Tags

Toda importação gera automaticamente uma tag para facilitar a organização.

• Exemplo: #ImportacaoArquivo 12-06-2026 15h15m.
• Para filtrar vendas de uma importação específica, use o termo da tag sem o símbolo "#".

Sempre que uma importação de vendas é realizada no eNotas (seja via arquivo CSV ou via suporte por integração), o sistema gera automaticamente uma tag de identificação. Essa tag contém a data e o horário da ação, permitindo que você localize esse lote de vendas rapidamente.

1. Acesse o menu Vendas no seu painel eNotas.
2. No filtro de período, selecione a opção Todas as vendas (ou o período específico em que a importação ocorreu).
3. No filtro de status, certifique-se de que todas as opções estejam marcadas, incluindo as Canceladas, para garantir que nenhuma venda do lote fique de fora da visualização.
4. Clique no ícone de funil (Filtros avançados).
5. No campo Tag, digite o termo "ImportacaoArquivo" ou busque pela data/horário em que o processo foi realizado.
6. Selecione a tag correspondente à importação desejada (ex.: ImportacaoArquivo 19-06-2023 18h46m).
7. O painel atualizará automaticamente, exibindo apenas as vendas pertencentes àquele lote.

⚠️Importante: ao buscar pela tag no filtro, não é necessário utilizar o símbolo "#". Basta digitar o texto da tag conforme o exemplo acima.

Se suas vendas foram importadas com dados incompletos (como CPF/CNPJ ou endereço faltando) e apresentam o status "Necessita de atenção", você pode corrigi-las de uma só vez utilizando uma planilha, sem precisar editar cliente por cliente.

Passo a passo para correção

1. Acesse o menu Vendas e selecione o período desejado.
2. Clique no ícone de funil. No campo & NFe, selecione apenas o status "Necessita de atenção" e aplique o filtro.
3. Clique no botão de Exportar relatório (ícone de seta para baixo).
4. Acesse o ícone de sino (Notificações) e baixe o arquivo gerado.
5. Abra a planilha e preencha os dados que precisam de atualização (ex.: colunas de documento ou endereço).
6. Salve o arquivo e acesse Gerenciar > Apps > Importador de vendas.
7. Arraste o arquivo corrigido para a área de importação e siga as instruções na tela para concluir.

⚠️ Por que não gera duplicidade? Ao exportar o relatório do eNotas, cada venda possui um código na coluna ChaveUnica. Ao reimportar, o sistema reconhece esse código e apenas atualiza as informações da venda existente, em vez de criar uma nova. Por isso, o passo a passo deve ser seguido exatamente como descrito.

Após a reimportação, o sistema gerará uma nova tag (ex.: #ImportacaoArquivo) com a data e hora da atualização. Você pode usar essa tag para localizar o lote corrigido e solicitar a emissão das notas.

Se você realizou uma importação de vendas via arquivo CSV e precisa recuperar a planilha original utilizada no processo, o eNotas permite que você faça o download diretamente pelo histórico de notificações do seu painel.

1. No topo do seu painel eNotas, clique no ícone de sino (Notificações).
2. Clique na opção "Ver todas" para abrir o histórico completo.
3. Localize a notificação referente à importação desejada e clique no botão Resumo.
4. Na tela de resumo, localize o ícone de download no canto superior direito.

Clique no ícone para iniciar o download do arquivo CSV utilizado naquela operação.

💡 Dica: essa função é útil para conferir quais dados foram enviados caso o sistema tenha apontado algum erro em linhas específicas durante o processamento.

Se você acabou de adquirir uma conta no eNotas e precisa trazer vendas realizadas anteriormente para o sistema, o processo varia de acordo com a sua plataforma de vendas.

Antes de começar, verifique se o seu plano permite a importação de vendas retroativas consultando o nosso informativo de planos.

Como solicitar a importação

O procedimento depende de qual App de vendas você utiliza:

Hotmart, Kobana e Monetizze

1. Exporte a planilha de vendas da sua plataforma no formato CSV.
2. Não realize edições no arquivo após a exportação para evitar erros de leitura.
3. Envie o arquivo para o time de suporte do eNotas solicitando a importação.

Iugu, Eduzz, Stripe, PagSeguro, WooCommerce e outros

1. Entre em contato com o nosso suporte.
2. Informe a data inicial a partir da qual deseja importar as vendas.
3. O sistema buscará as vendas dessa data até o dia atual. Não se preocupe: o processo não gera duplicidade de vendas ou notas.

⚠️ Importante: algumas plataformas possuem limitações de tempo para exportação de dados. Nesses casos, o eNotas importará apenas o que a plataforma disponibilizar.

Toda importação gera uma tag automática para você localizar as vendas no painel:

• #ImportacaoArquivo: para vendas importadas via planilha CSV.
• #ImportacaoCanal: para vendas importadas diretamente via integração pelo suporte.

A importação das vendas em si não consome sua franquia. O consumo ocorre apenas no momento da emissão da nota fiscal.

⚠️ Fique atento: ao emitir notas de períodos antigos em massa, o volume pode superar a franquia mensal do seu plano atual. Caso precise de um upgrade ou queira entender sobre notas excedentes, entre em contato com nosso time técnico via e-mail ou WhatsApp.

Se você é um novo cliente eNotas e precisa trazer vendas realizadas antes da sua data de assinatura (vendas retroativas), é importante entender as condições e limites de cada plano.

O que são vendas antigas?

São todas as transações realizadas na sua plataforma de vendas antes da contratação do seu plano no eNotas.

Básico (Mensal/Anual)

• ❌ Não inclusa (serviço avulso).
• Taxa fixa de R$ 197,00 + R$ 0,97 por venda.

Plus (Mensal)

• ✔️ Inclusa até 300 vendas.
• Excedente: R$ 0,97 por venda.

Pro (Mensal)

• ✔️ Inclusa até 500 vendas.
• Excedente: R$ 0,97 por venda.

Plus e Pro (Anual)

• ✔️ Ilimitada.
• Sem cobrança adicional.

Business / Enterprise

• ✔️ Ilimitada.
• Sem cobrança adicional.

⚠️ Atenção à franquia de notas: a importação das vendas não consome seu plano imediatamente. O consumo da franquia ocorre apenas no momento da emissão da nota fiscal.

Ao emitir notas de vendas antigas em massa, o volume total (vendas retroativas + vendas atuais) pode superar a franquia mensal do seu plano. Caso perceba que precisará de um volume maior de notas, entre em contato com nosso time técnico via WhatsApp ou e-mail para orientações sobre upgrade ou notas excedentes.

Se você utiliza o plano Básico do eNotas e precisa trazer vendas realizadas antes da sua data de assinatura (vendas retroativas), saiba que essa funcionalidade não está inclusa nativamente neste plano, mas pode ser contratada de forma avulsa.

Como funciona a solicitação

Para realizar a importação no plano Básico, você deve entrar em contato com o nosso suporte via chat ou e-mail.

• Se você estiver em processo de Onboarding: siga as orientações diretamente com o agente responsável pelo seu atendimento.
• Plataformas Hotmart ou Monetizze: você precisará enviar o arquivo CSV original da plataforma para o suporte.
• Outras plataformas: não é necessário arquivo; basta informar ao suporte a data inicial desejada para a busca das vendas.

Custos e Pagamento

A importação avulsa para o plano Básico possui os seguintes valores:

• Taxa de serviço: R$ 197,00.
• Valor por venda: adicional de R$ 0,97 por cada venda importada.

Após a solicitação, nosso setor financeiro enviará um boleto com o valor total. A importação será realizada pelo time de suporte assim que o pagamento for confirmado.

⚠️ Importante: as notas fiscais dessas vendas só consumirão sua franquia quando forem efetivamente emitidas. Fique atento para que o volume de emissões retroativas não ultrapasse o limite mensal do seu plano atual.

São todas as vendas realizadas na sua plataforma (Hotmart, Stripe, etc.) antes da data de assinatura do seu plano no eNotas.

Sim! Mesmo que sua plataforma não esteja na nossa lista de integrações, você pode importar as vendas utilizando o nosso modelo de planilha padrão. Basta preencher os dados dos seus clientes e das vendas no arquivo CSV e fazer o upload.

Se você usar o nosso modelo de exportação (que contém a ChaveUnica), o sistema apenas atualizará os dados. Porém, se você criar uma planilha do zero e importar a mesma venda com dados diferentes, poderá haver duplicidade. Recomendamos sempre conferir se a venda já existe no painel antes de importar.

Uma vez que o processamento do arquivo começa, não é possível cancelar. Caso tenha importado dados incorretos, você deverá aguardar a conclusão e utilizar o método de correção em massa via planilha para ajustar as informações caso as notas já não tenham sido emitidas.

Atualmente, o eNotas não realiza a emissão de notas fiscais com múltiplos itens. Nesse cenário, orientamos vincular a venda a um único produto e utilizar o campo de observações da nota para detalhar os demais itens da venda. Como alternativa, também é possível cadastrar produtos do tipo "combo", contemplando os itens comercializados em conjunto.