A importação por CSV permite emitir várias Notas Fiscais de Serviço Eletrônicas (NFS-e) de uma só vez por meio de uma planilha.
Cada linha da planilha representa uma NFS-e, e cada coluna corresponde a uma informação da emissão, como os dados do tomador, a descrição e o valor do serviço.
Para realizar a emissão por CSV, é necessário:
utilizar o modelo de planilha correspondente à sua emissão;
possuir uma classe de imposto NFS-e previamente cadastrada no painel da Webmania;
preencher o arquivo seguindo os formatos e regras aplicáveis à operação.
Neste artigo, você encontrará os modelos disponíveis, as orientações de preenchimento e o passo a passo para importar o arquivo no painel.
1. Escolha o tipo de planilha
O modelo da planilha varia conforme o sistema utilizado pelo município para emissão da NFS-e. Escolha o modelo compatível com a emissão da sua empresa:
Modelo | Quando utilizar |
Para empresas cuja emissão de NFS-e é realizada pelo Padrão Nacional. | |
Para empresas cuja emissão ocorre por outro provedor municipal integrado à Webmania. |
Utilize sempre o modelo correspondente à sua emissão e mantenha os nomes dos cabeçalhos apresentados na planilha.
Alguns campos podem variar conforme o município, o provedor ou a operação realizada. Quando um campo não se aplicar ao seu cenário, siga a orientação indicada no próprio modelo ou na documentação antes de removê-lo.
Não sabe qual modelo utilizar? Entre em contato com o suporte informando o CNPJ, município e UF da empresa prestadora.
2. Cadastre a classe de imposto
Para emitir NFS-e por CSV, é necessário possuir uma classe de imposto NFS-e previamente cadastrada no painel.
A classe reúne as configurações fiscais utilizadas na emissão e permite reutilizar essas informações nas notas da planilha.
No painel da Webmania, acesse Impostos → Novo Imposto NFS-e, preencha as informações correspondentes à sua operação e salve o cadastro.
Após o cadastro, localize a referência da classe de imposto. Conforme print abaixo:
Essa referência deverá ser informada na coluna Serviço - Classe Imposto da planilha. Exemplo: REF000001
Informe a referência da sua própria classe de imposto, e não o nome ou a descrição do cadastro. Os códigos apresentados nos modelos e exemplos são apenas ilustrativos e devem ser substituídos pelos dados da sua empresa.
A classe centraliza as configurações fiscais, mas os dados específicos de cada emissão continuam sendo preenchidos na planilha, como tomador, valor do serviço, discriminação e demais informações aplicáveis à operação.
3. Entenda as regras de preenchimento
Os dados enviados pela planilha passam por validações, por isso, os valores informados devem respeitar os formatos, limites e condições previstos para cada campo.
Mantenha os nomes das colunas: A primeira linha da planilha contém os cabeçalhos utilizados pelo sistema para identificar cada informação. Não renomeie os cabeçalhos por nomes de sua preferência. Alterações nos cabeçalhos podem impedir que o sistema identifique corretamente as informações enviadas.
Preencha uma nota por linha: Cada linha abaixo do cabeçalho corresponde a uma NFS-e. Exemplo:
Tomador - Nome Completo | Serviço - Valor Serviços | Serviço - Discriminação | Serviço - Classe Imposto |
Maria Oliveira | 150.00 | Consultoria referente ao mês de outubro/2026 | REF000001 |
João Pereira | 320.50 | Manutenção de sistema referente ao mês de outubro/2026 | REF000001 |
Os dados acima são apenas exemplos. Substitua nomes, documentos, valores, descrições e referências pelos dados reais da sua operação.
4. Preencha os dados do tomador
CPF ou CNPJ: O tomador é a pessoa física ou jurídica que recebeu o serviço.
Informe apenas o documento correspondente ao tomador: para pessoa física, utilize o campo de CPF. Para pessoa jurídica, utilize o campo de CNPJ.
Atenção: não preencha CPF e CNPJ simultaneamente para o mesmo tomador.
Endereço do tomador: A necessidade de preenchimento dos dados de endereço pode variar conforme o município, o provedor e as características da emissão.
Quando os campos forem exigidos para a operação, informe todos os dados necessários de forma completa.
Preencha os campos correspondentes de acordo com o modelo da planilha e com as informações da operação.
Campo | Como preencher |
Tomador - CPF | CPF do tomador pessoa física. Informe somente quando o tomador possuir CPF. |
Tomador - CNPJ | CNPJ do tomador pessoa jurídica. Informe somente quando o tomador possuir CNPJ. |
Tomador - Nome Completo | Nome completo ou razão social do tomador. |
Tomador - Endereço | Logradouro do tomador, quando aplicável. |
Tomador - Número | Número do endereço, quando aplicável. |
Tomador - Complemento | Complemento do endereço, quando houver. |
Tomador - Bairro | Bairro do tomador, quando aplicável. |
Tomador - CEP | CEP do tomador. |
Tomador - Cidade | Município do tomador. |
Tomador - UF | Sigla da unidade federativa. Exemplo: PR. |
Tomador - Telefone | DDD e telefone, quando informado. |
Tomador - Email | E-mail do tomador, quando informado. |
5. Preencha os dados do serviço
Os principais dados do serviço são:
Valor dos serviços: Informe o valor correspondente àquela NFS-e utilizando ponto para separar as casas decimais. Exemplos:
Valor | Como informar |
R$ 150,00 | 150.00 |
R$ 320,50 | 320.50 |
R$ 1.250,75 | 1250.75 |
Discriminação: Informe a descrição do serviço que será apresentada na NFS-e.
O campo aceita de 1 a 2.000 caracteres. Exemplo:
Consultoria referente aos serviços prestados no mês de outubro de 2026. |
Classe de imposto: Informe a referência da classe cadastrada no painel. Exemplo:
REF000001 |
Importante: a referência utilizada nos exemplos não deve ser copiada para sua emissão. Utilize sempre a referência da classe de imposto cadastrada para a sua empresa e operação.
Campo | Como preencher |
Serviço - Valor Serviços | Valor total do serviço prestado. Utilize ponto como separador decimal. Exemplo: 150.00. |
Serviço - Discriminação | Descrição do serviço prestado. |
Serviço - Classe Imposto | Referência da classe de imposto previamente cadastrada no painel. Exemplo: REF000001. |
6. Observe os campos adicionais do seu modelo
Além dos campos principais, a planilha pode conter outras informações necessárias para a emissão.
Esses campos podem variar conforme o Padrão Nacional, o provedor municipal, o município e as características da operação.
Por isso: não remova, altere ou preencha campos adicionais com valores genéricos sem verificar se eles se aplicam à sua emissão.
Quando houver dúvida sobre qual informação fiscal deve ser utilizada, valide os dados com o responsável contábil da sua empresa.
Para dúvidas sobre como informar o dado na planilha, entre em contato com o suporte da Webmania.
⚠️ Evite erros na importação da planilha
Antes de salvar o arquivo, faça uma última conferência e revise a formatação dos dados:
Não inclua pontuações que não façam parte do valor aceito pelo campo: CPF, CEP e telefone devem ser informados sem pontos, hífens ou parênteses.
Preserve os zeros à esquerda: alguns sistemas podem interpretar documentos e códigos como números e remover os zeros iniciais. Para evitar isso, formate essas colunas como Texto antes de digitar ou colar os dados.
Valores e alíquotas: Quando houver casas decimais, utilize ponto como separador decimal.
Não utilize valores genéricos para preencher campos vazios: Não preencha automaticamente campos desconhecidos com 0, -, N/A ou outras informações apenas para completar a planilha. Se o campo não se aplicar à operação, ele deve permanecer vazio.
Antes da importação, remova linhas de exemplo, subtotais, observações ou qualquer outro conteúdo que não represente uma NFS-e a ser emitida.
Respeite os limites do arquivo: cada CSV pode conter até 5.000 NFS-e, no máximo 2 MB e uma NFS-e por linha.
💻 Salve a planilha no formato CSV
Após preencher e revisar os dados, salve o arquivo no formato CSV separado por vírgulas e codificado em UTF-8.
1. Google Planilhas
Após finalizar o preenchimento:
Arquivo → Fazer download → Valores separados por vírgulas (.csv)
2. Microsoft Excel
Acesse:
Arquivo → Salvar como → CSV UTF-8 (Delimitado por vírgulas) (.csv)
Atenção: dependendo das configurações regionais do computador, o Excel pode utilizar outro delimitador ao gerar o CSV. O arquivo utilizado na importação deve estar separado por vírgulas.
⬆️ Importe a planilha no painel da Webmania
Com o arquivo preparado, acesse o painel da Webmania.
Entre no módulo Nota Fiscal e clique em Emitir Nota.
Na tela de emissão:
selecione o modelo NFS-e;
em Emissão, selecione Importar CSV.
Em seguida, clique em Escolher arquivo CSV e selecione o arquivo salvo no computador.
Após o envio, o painel apresentará um resumo da importação, incluindo a quantidade de documentos, os valores totais e o tempo estimado para processamento.
Confira essas informações antes de prosseguir.
As NFS-e são processadas em segundo plano. Portanto, não é necessário permanecer na mesma tela enquanto todas as emissões são processadas.
Você pode continuar utilizando outras funcionalidades do painel.
Durante ou após a conclusão da importação, utilize a opção de acompanhamento para consultar o status das notas.
A tela de acompanhamento apresenta individualmente as notas da planilha, permitindo consultar os documentos:
Emitidos;
Pendentes;
Reprovados.
Importante: a conclusão da importação da planilha não significa, necessariamente, que todas as NFS-e foram autorizadas. Consulte o status individual dos documentos.
🤔 O que fazer quando uma nota for reprovada?
As notas da planilha são processadas individualmente. Caso uma emissão apresente alguma inconsistência, as demais notas válidas continuam sendo processadas.
Consulte a mensagem apresentada para o documento reprovado e revise as informações correspondentes antes de realizar uma nova tentativa.
Não reenvie toda a planilha sem antes verificar quais documentos já foram emitidos. Isso evita solicitar novamente a emissão de notas que já foram processadas com sucesso.
Dúvidas frequentes
Por que minha planilha pode ser recusada? Entre os motivos estão:
arquivo com mais de 2 MB ou 5.000 registros;
cabeçalho incompatível com o modelo;
ausência de campos necessários;
formato inválido das informações;
modelo incompatível com a emissão;
classe de imposto inexistente ou referência informada incorretamente;
dados fiscais ou cadastrais que não atendam às validações da emissão;
campos adicionais exigidos pelo município ou provedor não preenchidos.
A mensagem apresentada durante a importação ou no processamento da nota pode ajudar a identificar qual informação precisa ser revisada.
Preciso ficar com a tela aberta até o processamento terminar? Não. O processamento ocorre em segundo plano e você pode continuar utilizando o painel normalmente.
Se uma nota for reprovada, todas as outras também serão? Não. As notas são processadas individualmente. Uma inconsistência em determinado registro não impede o processamento das demais notas válidas. Consulte o resultado de cada documento antes de realizar uma nova importação.