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.
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.
Portal cacional (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.
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.
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
vPISevCOFINSdeixaram de ser retenções e tornaram-se apenas informativos (débitos do prestador). Agora, o valor total das retenções federais é consolidado no campovRetCSLL.Mapeamento para ERPs (SAP/TOTVS): Para garantir que sua apuração não fique zerada, a Qive direciona o total do campo
vRetCSLLpara o campoValorCsllno 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:
Acesse o menu NFS-e na aba Geral.
Clique em Configurar consulta.
Selecione o CNPJ que deseja configurar.
Atenção! Não é possível configurar cidades em lote. O processo é manual e individual, visto que muitas cidades tem requisitos próprios.
Selecione o escolha o papel que sua empresa tem nas notas da cidade que deseja consultas, tomadas ou prestadas.
Clique em Nova cidade
Selecione Estado e Cidade que deseja configurar e clique em continuar.
Preencha os requisitos da cidade, se houver, selecione a declaração de leitura e compreensão e clique em Continuar.
O sistema alertará os requisitos necessários para seguir com a configuração da cidade. Sem o preenchimento não é possível continuar.
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 são baseados fielmente no XML disponibilizado pelo órgão emissor. Caso note divergências entre o XML da prefeitura e o da Nacional, lembre-se que a Qive prioriza a prefeitura se ela estiver cadastrada no NFSe Connect.
Monitoramento de Adesão: Verifique o status de adesão ao Portal Nacional de cada cidade no Monitoramento Oficial de Adesão à NFS-e.