Passar para o conteúdo principal

Consulta de NFS-e: Padrão Nacional, configurações e regras 2026

Agora, o Portal Nacional (PN) é a fonte prioritária de dados, unificando as informações de prestadores e prefeituras em um padrão federal obrigatório para todas as empresas do país.

Escrito por Camila S.

A gestão de Notas Fiscais de Serviço eletrônicas (NFS-e) na Qive passou por uma transformação estrutural em janeiro de 2026 para se adequar ao novo padrão obrigatório nacional. Agora, sua empresa conta com um sistema de inteligência fiscal que prioriza a captura federal, mas preserva a precisão dos dados municipais, garantindo segurança total no seu pilar de Gestão de Documentos Fiscais.


Como a consulta funciona: A hierarquia de origem

Desde 01/2026, a Qive adota uma política de origem mais forte para proteger sua escrituração contra instabilidades de sincronização entre o governo federal e as prefeituras.

  1. NFSe Connect (Prefeitura) - PRIORIDADE: Se você possui uma cidade configurada manualmente via NFSe Connect, a Qive prioriza o dado vindo direto da prefeitura. Ele é considerado a origem mais estável para valores líquidos e retenções.

  2. Portal Nacional (Receita Federal): Funciona como a fonte prioritária para empresas e cidades que já migraram integralmente para o padrão nacional. A consulta é automática utilizando seu certificado digital A1.

  3. Proteção contra divergências: Caso o Portal Nacional e a prefeitura apresentem dados diferentes (comum em cidades como São Paulo), a Qive preservará o dado municipal para evitar erros no seu valor líquido e garantir a integridade dos dados enviados ao ERP.


Regras de negócio e sincronização

Diferente das notas de produtos (NF-e), a consulta de NFS-e possui limitações técnicas dos portais governamentais que exigem regras fixas:

  • Periodicidade automática: As consultas ocorrem 2 vezes ao dia (a cada 12 horas). Não existe botão de "consulta manual" para NFS-e, pois os portais não permitem requisições em tempo real.

  • Tempo de disponibilidade: Um documento emitido pode levar até 48 horas para ser processado pelos órgãos públicos e aparecer na plataforma Qive.

  • Certificado obrigatório: A automação do Portal Nacional exige um certificado A1 (e-CNPJ ou e-CPF) associado. Certificados modelo A3 (token/cartão) não são compatíveis neste canal, e nos casos de prefeituras podem haver pré-requisitos distintos, conforme consta na listagem de municipios e requisitos da Qive.

  • Notas retroativas: O sistema captura documentos a partir da data em que a empresa (ou a cidade, em casos manuais) foi ativada na Qive.


NFS-e não apareceu na Qive? Verifique a data de ativação e o prazo de processamento

A Qive captura NFS-e somente a partir da data em que sua empresa foi ativada na plataforma. Para cidades configuradas manualmente (NFSe Connect), a captura começa na data em que a cidade foi configurada. Notas emitidas antes dessa data não entram pela consulta automática.

Além disso, uma NFS-e emitida pode levar até 48 horas para ser processada pelos órgãos públicos e aparecer na Qive. As consultas automáticas acontecem 2 vezes ao dia (a cada 12 horas), e não há opção de consulta manual.

Para identificar o motivo, compare a data de emissão da nota com a data de ativação da empresa ou de configuração da cidade:

  • Nota emitida antes da data de ativação ou configuração: ela não será capturada automaticamente. Para NFS-e do Padrão Nacional (chave de acesso com 50 caracteres), você pode buscá-la pela opção Recuperar notas. É necessário ter um certificado digital A1 associado ao CNPJ ou CPF.

  • Nota emitida depois da data de ativação, há menos de 48 horas: aguarde o processamento dos órgãos públicos e as próximas consultas automáticas.

  • Nota emitida depois da data de ativação, há mais de 48 horas: fale com o time de especialistas pelo chat da plataforma informando o CNPJ e a chave de acesso da nota (50 caracteres). Nesse caso, a nota precisa ser analisada pelo time.


Comunicado técnico: Nota Técnica 007/2026 (Retenções federais)

No dia 09/02/2026, a Receita Federal alterou a interpretação dos tributos federais (PIS, COFINS e CSLL) no XML nacional. A Qive implementou travas automáticas para absorver essa mudança:

  • Aglutinação no campo vRetCSLL: Os campos individuais vPIS e vCOFINS deixaram de ser retenções e tornaram-se apenas informativos (débitos do prestador). Agora, o valor total das retenções federais é consolidado no campo vRetCSLL.

  • Mapeamento para ERPs (SAP/TOTVS): Para garantir que sua apuração não fique zerada, a Qive direciona o total do campo vRetCSLL para o campo ValorCsll no padrão ABRASF.

  • Identificação na discriminação: O valor total de tributos federais é concatenado automaticamente no campo discriminação (ex: "Serviços prestados. Tributos Federais: 10,99"), permitindo uma conferência visual rápida no PDF e no XML.


Configuração de cidades (casos residuais)

Utilize a configuração manual apenas para municípios que ainda não operam 100% no Portal Nacional ou se você precisa visualizar o layout original da prefeitura.

Para configurar um cidade de consulta você precisará de um perfil de acesso administrador ou gerente, com isso siga os passos abaixo:

  1. Acesse o menu NFS-e na aba Geral.

  2. Clique em Configurar consulta.

  3. Selecione o CNPJ que deseja configurar.

    1. Atenção! A configuração vale somente para o CNPJ selecionado. As demais empresas da conta não são alteradas. Para configurar a mesma cidade em outra empresa, repita o processo para cada CNPJ. Não é possível configurar cidades em lote

  4. Selecione o papel que sua empresa tem nas notas da cidade que deseja consultas, tomadas ou prestadas.

  5. Clique em Nova cidade

  6. Selecione Estado e Cidade que deseja configurar e clique em continuar.

  7. Preencha os requisitos da cidade, se houver, selecione a declaração de leitura e compreensão e clique em Continuar.

    1. O sistema alertará os requisitos necessários para seguir com a configuração da cidade. Sem o preenchimento não é possível continuar.

  8. A mensagem de conclusão de configuração aparecerá no final da página, a partir daqui é só aguardar a entrada de novas notas conforme forem emitidas.

O motor de inteligência fiscal validará as informações junto à prefeitura. Em até 24 horas, ou conforme o tempo de processamento dos servidores governamentais, os documentos fiscais convertidos no padrão único ABRASF começarão a ser exibidos retroativamente e em tempo real na listagem oficial.


Informações Adicionais e resolução de problemas

  • Divergência entre XML e PDF: Os PDFs gerados pela Qive seguem fielmente o XML disponibilizado pelo órgão emissor. Se você notar divergências entre o XML da prefeitura e o do Portal Nacional, lembre-se de que a Qive prioriza a prefeitura quando ela está cadastrada no NFSe Connect.

  • Monitoramento de Adesão: Verifique o status de adesão de cada cidade ao Portal Nacional no Monitoramento Oficial de Adesão à NFS-e.


Data de geração e data de emissão: por que a data da Qive é diferente do Portal Nacional?

Ao consultar uma NFS-e no Portal Nacional, você verá duas datas em blocos diferentes da tela:

  • Identificação da NFS-e → Data de geração: é a data em que a NFS-e foi de fato gerada no Portal Nacional. Esta é a data que a Qive exibe como Data de Emissão.

  • Identificação do DPS → Data de emissão: é a data de emissão da DPS (Declaração de Prestação de Serviço), e não da NFS-e.

Por que as datas podem ser diferentes? A DPS e a NFS-e são documentos distintos. A DPS é preenchida e enviada para validação antes de existir a NFS-e autorizada. Por isso, a DPS pode ter uma data e a NFS-e ser gerada dias depois.

Exemplo prático:

  • Data de emissão da DPS no Portal Nacional: 14/10/2026

  • Data de geração da NFS-e no Portal Nacional: 26/10/2026

  • Data de Emissão exibida na Qive: 26/10/2026 ✅

Datas disponíveis na Qive:

  • Data de Emissão: data de geração da NFS-e no Portal Nacional.

  • Data de Criação: data em que a nota entrou na plataforma Qive.

A data de emissão da DPS não fica disponível na Qive, nem na listagem nem nos relatórios. Os relatórios trazem apenas a Data de Emissão e a Data de Criação.

Notas consultadas pela prefeitura (NFSe Connect): em geral, essas notas não têm DPS. Quando houver, vale a mesma regra: a Qive exibe a data da NFS-e, não a da DPS.

Para entender melhor a diferença entre DPS e NFS-e, consulte o conteúdo oficial da Receita Federal sobre DPS.

Respondeu à sua pergunta?