Importação de NFSe (Padrão Nacional)
Esta tela importa, em lote, arquivos XML de NFS-e no Padrão Nacional (documento <NFSe> da SEFIN Nacional). Como a maioria dos municípios está aderindo a esse padrão único, um mesmo XML padronizado pode ser importado sem adaptação por prefeitura.
O que faz: permite importar tanto as NFS-e prestadas (emitidas em outro sistema ou no portal nacional) quanto as tomadas (serviços adquiridos, para registro e controle financeiro). A tela detecta automaticamente o sentido de cada arquivo e usa a Operação para definir e validar o lançamento.
Onde encontrar
Conceito: prestada × tomada
A tela sempre grava a nota do ponto de vista da sua empresa (o emitente do sistema):
| Sentido | Quando | Operação | Financeiro | Contraparte (parceiro) |
|---|---|---|---|---|
| Prestada | Sua empresa é o prestador no XML (você emitiu o serviço em outro sistema/portal) | Saída | Conta a receber | Tomador (cliente) |
| Tomada | Sua empresa é o tomador no XML (você contratou o serviço) | Entrada | Conta a pagar | Prestador (fornecedor) |
A identificação é feita comparando o CNPJ/CPF do prestador e do tomador do XML com os emitentes cadastrados no sistema. Quem for a sua empresa define o sentido.
Pré-requisitos
- Emitente cadastrado com o CNPJ que aparece no XML (prestador nas prestadas, tomador nas tomadas).
-
Operação de serviço configurada para cada sentido que você for importar:
- Marcada como serviço / emite NFS-e;
- Saída para prestadas, Entrada para tomadas;
- Se quiser gerar o financeiro, a operação deve estar marcada para gerar Fatura e ter a Receita/Despesa padrão definida.
Se a operação estiver marcada para gerar Fatura mas não houver Receita/Despesa resolvida, a nota é importada apenas na parte fiscal (sem o financeiro). Configure a Receita/Despesa padrão da operação para gerar a fatura.
Passo a passo
1. Selecionar a(s) Operação(ões)
No topo da tela há duas seleções:
- Operação (Prestadas) — usada nos arquivos em que sua empresa é o prestador;
- Operação (Tomadas) — usada nos arquivos em que sua empresa é o tomador.
Preencha a(s) operação(ões) correspondente(s) ao que você vai importar. Você pode preencher apenas uma, se for importar só um sentido.
Agiliza: se existir apenas uma operação cadastrada para o sentido, ela já vem selecionada automaticamente.

2. Selecionar os arquivos XML
- Clique em Selecionar Arquivos XML;
- Selecione um ou vários arquivos
.xmlde NFS-e nacional; - A tela lê e valida cada arquivo, exibindo o resultado na lista.
Arquivos que não sejam NFS-e do Padrão Nacional (ex.: NF-e, CT-e, NFS-e municipal) são recusados com aviso e não atrapalham os demais do lote.
3. Conferir a lista
Cada linha mostra o resultado da validação:
- Verde = arquivo válido, pronto para importar;
- Vermelho = arquivo inválido — a coluna Status explica o motivo.
As colunas trazem Sentido (Prestada/Tomada), Número, Série, Emissão, Prestador, Tomador, Valor e a Operação aplicada. Expanda a linha (+) para ver a grid de conferência do serviço com descrição, valor, ISS (base/alíquota/valor/retido), retenções (PIS/COFINS/IR/INSS/CSLL), IBS/CBS e valor líquido.
%%INSIRA PRINT DA LISTA COM UMA LINHA EXPANDIDA MOSTRANDO O SERVIÇO%%
4. Marcar o que importar
Use a coluna de seleção (checkbox) para escolher quais notas gravar. Os arquivos válidos já entram marcados; o checkbox no cabeçalho marca/desmarca todos.
5. Conferir/editar a Fatura (opcional)
Quando a operação gera financeiro, clique no botão Fatura da linha para revisar valores, Receita/Despesa, Forma e Condição de Pagamento e as parcelas antes de gravar. As alterações feitas aqui são mantidas e gravadas junto com a nota.
O XML nacional não traz parcelamento, então a fatura nasce com parcela única. Use o editor da Fatura para desdobrar em parcelas, se necessário.
%%INSIRA PRINT DO BOTÃO FATURA E DA TELA DE EDIÇÃO DA FATURA%%
6. Gravar
Clique em Gravar importação (F5). Cada nota é gravada individualmente; se alguma falhar, as demais continuam e a linha com erro fica em vermelho com a mensagem do banco na coluna Status. Para sair sem gravar, use Cancelar (ESC).
Nada é gravado no banco enquanto você apenas carrega e confere os arquivos. O parceiro e a nota só são criados ao abrir a Fatura ou ao Gravar.
Nº Lote
O campo Nº Lote agrupa as faturas geradas nesta importação. Ele vem preenchido com o próximo número disponível e é atualizado automaticamente após cada gravação.
Caso especial: prestador e tomador são a mesma empresa (intercompany)
Quando uma filial emite NFS-e para outra filial da mesma empresa, ambos os CNPJs são emitentes cadastrados. Nesse caso:
- Com as duas operações selecionadas, a tela importa primeiro como prestada (prioridade do prestador). Ao carregar o mesmo arquivo novamente (após gravar), ele entra como tomada — permitindo registrar os dois lados do mesmo documento.
- Se quiser forçar um sentido específico, selecione apenas a operação daquele sentido (deixe a outra em branco).
O que é gravado
A NFS-e importada é gravada como uma Nota Fiscal de serviço padrão do sistema (mesma estrutura da emissão de NFS-e nacional):
- Padrão NACIONAL, status autorizado e motivo "Importada" — a nota não é transmitida novamente ao fisco (é apenas registro);
- Nas tomadas, a nota é marcada como entrada;
- O XML original é guardado junto à nota;
- São importados os valores e tributos completos: ISS (base, alíquota, valor, retido), retenções (PIS/COFINS/IR/INSS/CSLL), indicador de operação e os campos da Reforma Tributária IBS/CBS/IS;
- O parceiro da contraparte é criado automaticamente a partir do XML, quando ainda não existir.
Mensagens comuns (Status) e o que fazer
| Mensagem | Significado / ação |
|---|---|
| Nem o prestador nem o tomador do XML correspondem a um emitente cadastrado. | Nenhum dos CNPJs do XML é uma empresa sua. Cadastre o emitente ou confira se o arquivo é da sua empresa. |
| NFS-e prestada (sua empresa é o prestador): selecione a Operação de Prestadas. | Falta selecionar a operação do sentido correspondente no topo da tela. |
| NFS-e tomada (sua empresa é o tomador): selecione a Operação de Tomadas. | Idem, para o sentido de entrada. |
| NFS-e já lançada no sistema para este emitente (mesma chave de acesso). | Essa nota já existe para esse emitente. (A mesma chave pode existir uma vez para o prestador e outra para o tomador, quando são emitentes distintos.) |
| XML sem CPF/CNPJ do tomador / prestador (necessário para a contraparte). | O XML não traz o documento da contraparte, necessário para criar o parceiro. |
| O arquivo não é uma NFS-e do Padrão Nacional. | O arquivo selecionado é de outro tipo/padrão. Só XML de NFS-e nacional é aceito. |
| Erro ao gravar: (mensagem do banco) | Falha ao salvar aquela nota específica; o texto traz o motivo real. As demais notas do lote seguem normalmente. |
Observações e limitações
- Parcela única: o XML nacional não carrega duplicatas; ajuste as parcelas no editor da Fatura quando precisar.
- Nota importada não é retransmitida: entra como registro (autorizada/"Importada").
- Ambiente: apenas XMLs de produção são considerados nos arquivos do contador.
Relacionado: as NFS-e nacionais importadas entram normalmente na Consulta de NFS-e e nos arquivos gerados para o contador (XML e espelho DANFSe).
Glossário
| Termo | Significado |
|---|---|
| Prestada | NFS-e em que a sua empresa prestou o serviço (saída). |
| Tomada | NFS-e em que a sua empresa contratou o serviço (entrada/aquisição). |
| Prestador | Quem executa o serviço (emitente da NFS-e). |
| Tomador | Quem contrata/recebe o serviço. |
| Padrão Nacional | Layout único de NFS-e da SEFIN Nacional adotado pelos municípios. |
| IBS/CBS/IS | Tributos da Reforma Tributária importados do XML quando presentes. |