A importação de NFS-e de serviços prestados e tomados via arquivo permite registrar documentos fiscais no OneFlow quando a importação automática não estiver disponível ou quando for necessário realizar o procedimento manualmente.
O OneFlow aceita os seguintes formatos para importação:
XML no leiaute específico da Prefeitura;
XML no Padrão Nacional;
TXT no leiaute 4, exclusivamente para a Prefeitura de São Paulo.
Os arquivos podem ser importados individualmente ou em lote.
⚠️ Atenção
Para a Prefeitura de São Paulo, o OneFlow aceita arquivos TXT somente no Leiaute 4. Arquivos TXT em outros leiautes podem apresentar erro ao serem importados no OneFlow.
Arquivos TXT de outras Prefeituras não são aceitos para importação no OneFlow
Para verificar se a Prefeitura da empresa possui suporte à importação de arquivos XML, consulte a lista de cidades disponíveis neste artigo.
💡Recomendação Importante
Sempre que possível, priorize as opções de importação automática de NFS-e disponíveis no OneFlow. A automação reduz a necessidade de intervenções manuais e torna a rotina fiscal mais ágil.
Tópicos do Artigo:
Pré-requisitos para realizar a importação
A competência em que os documentos serão importados deve estar totalmente aberta no OneFlow. Caso exista alguma apuração finalizada, a importação ficará indisponível.
O OneFlow considera, preferencialmente, a data de competência informada no XML. Caso essa informação não esteja disponível no arquivo, será considerada a data de emissão da NFS-e. A competência correspondente deve estar aberta para que a importação seja realizada.
Caso os campos para importação estejam bloqueados, verifique se todas as apurações da competência estão abertas. Se necessário, reabra as apurações e tente realizar a importação novamente.
O XML deve estar vinculado à empresa em que a importação está sendo realizada. Para isso, o CNPJ informado no documento deve corresponder ao CNPJ da empresa selecionada no OneFlow. Caso os CNPJs sejam diferentes, o documento não será importado.
Regras para importação de NFS-e de serviços tomados
A possibilidade de importar uma NFS-e de serviço tomado via XML depende do padrão utilizado no arquivo e das cidades do prestador e do tomador.
XML no leiaute da Prefeitura: o arquivo poderá ser importado somente quando a cidade do prestador e a cidade do tomador forem a mesma.
XML no Padrão Nacional: o arquivo poderá ser importado mesmo quando a cidade do prestador e a cidade do tomador forem diferentes, desde que o documento esteja disponível nesse padrão.
Desde 01/2026, as Prefeituras passaram a ser obrigadas a aderir ao Portal Nacional. Com isso, os documentos podem ser obtidos no Padrão Nacional e importados no OneFlow sem depender exclusivamente do leiaute específico da Prefeitura.
💡 Caso a NFS-e não possa ser importada via XML, ela também poderá ser registrada no OneFlow por digitação ou importação via planilha.
Realizando a importação de NFS-e via XML
1) Abra o OneFlow, e acesse o Módulo Fiscal (1) e clique em "Abrir Fiscal" (2) da empresa que irá importar os documentos.
2) Para você realizar a importação manual dos arquivos XML de NFS-e, basta você acessar aba de Etapas dentro Fiscal (1), e depois selecionar a opção "Nova Importação" (2) disponível na parte inferior da coluna Importação:
3) Logo em seguida, clicar na opção "Importação de NFSe":
⚠️ Atenção!
Se os campos para importação estiverem bloqueados, verifique se todas as apurações da competência estão abertas.
4) Selecione a pasta em que os arquivos estão armazenados ou arraste e solte os arquivos na área indicada.
5) Após o processamento, será exibida uma mensagem informando que o arquivo foi importado com sucesso.
💡 Importação de arquivos em lote
Para realizar a importação dos XMLs em lote, basta você agrupar todos os arquivos em uma única pasta e realizar a compactação desta pasta.
Caso haja um grande volume de arquivos, recomendamos separar os documentos em pastas com até 5.000 arquivos cada. Em seguida, compacte cada pasta e realize as importações separadamente. Dessa forma, o processo de upload e processamento dos documentos será mais ágil.
Para enviar os documentos para uma pasta compactada, basta selecionar a pasta/documentos desejados, clicar com o botão direito do seu mouse sobre os mesmos, e selecionar as opções: Enviar Para (1), e Pasta Compactada (2):
Assim será criada uma pasta compactada com todos os arquivos para você poder realizar o upload no OneFlow.
6) Caso ocorra algum erro durante a importação, o sistema informará que existem linhas que não foram importadas e enviará um relatório de erros por e-mail, indicando os problemas que impediram a importação dessas linhas.
Conferindo as NFS-e importadas via XML
1) Após realizar a importação dos documentos, o sistema irá apresentar o card conforme o modelo importado na coluna “Importação”. Também serão apresentados os documentos escriturados na coluna "Escrituração"
2) Ao dar um duplo clique em algum dos cards de importação, o sistema irá trazer a tela do Painel de Documentos, filtrando os documentos importados do card selecionado. Sempre serão indicadas como origem "Importação Manual"
Perguntas frequentes
1) Minha NFS-e de serviço tomado não foi importada via XML. O que devo verificar?
1) Minha NFS-e de serviço tomado não foi importada via XML. O que devo verificar?
Para NFS-e de serviço tomado, verifique se a cidade do prestador e a cidade do tomador são a mesma. Quando o XML estiver no leiaute da Prefeitura, a importação somente será possível se os municípios forem iguais.
Caso o XML esteja no Padrão Nacional, a NFS-e poderá ser importada mesmo quando as cidades do prestador e do tomador forem diferentes.
Se o documento não puder ser importado por XML, ele também poderá ser registrado por digitação ou importação via planilha.
2) Minha NFS-e de serviço prestado não foi importada via XML. O que devo verificar?
2) Minha NFS-e de serviço prestado não foi importada via XML. O que devo verificar?
Verifique os seguintes pontos:
Cidade disponível para importação: Confirme se a cidade da empresa está entre as cidades disponíveis para importação de arquivos XML no OneFlow.
Clique aqui para verificar.
Competência da NFS-e: Verifique se a competência informada no arquivo XML corresponde à competência em que a importação está sendo realizada no OneFlow. O sistema considera, preferencialmente, a data de competência informada no XML. Caso essa informação não esteja disponível no arquivo, será considerada a data de emissão da NFS-e.
Formato do arquivo: Confirme se o arquivo está em um formato aceito pelo OneFlow:
XML no leiaute da Prefeitura;
XML no Padrão Nacional;
TXT no leiaute 4, exclusivamente para a Prefeitura de São Paulo.
💡 Para identificar o leiaute do TXT, verifique o código no início da primeira linha do arquivo:
1001 → Leiaute 01
1002 → Leiaute 02
1003 → Leiaute 03
1004 → Leiaute 04
Para a Prefeitura de São Paulo, o OneFlow aceita somente o Leiaute 04.
Se a cidade não estiver disponível para importação de XML, o documento poderá ser registrado no OneFlow por digitação ou importação via planilha.
Se a cidade estiver disponível e a competência da NFS-e estiver correta, mas a importação ainda não for realizada, entre em contato com o Suporte OneFlow para que o caso seja analisado.
3) Ao importar o XML é apresentada a seguinte mensagem: “Este documento não possui vínculo com esta empresa e não foi possível determinar o cliente deste documento”. O que devo verificar?
3) Ao importar o XML é apresentada a seguinte mensagem: “Este documento não possui vínculo com esta empresa e não foi possível determinar o cliente deste documento”. O que devo verificar?
Verifique se o CNPJ informado no XML corresponde ao CNPJ da empresa selecionada no OneFlow. Caso os CNPJs sejam diferentes, o documento não será importado.
Não é necessário que o cliente ou fornecedor esteja previamente cadastrado. Quando não houver cadastro, o OneFlow cria o cadastro durante a importação, utilizando o CNPJ informado no documento.
📚 Artigos Relacionados
