Para garantir a captura automática e o compliance fiscal no pilar de Gestão de Documentos Fiscais, a Qive realiza a integração direta com municípios brasileiros por meio do módulo NFSe Connect. Em cidades que ainda não operam integralmente no Portal Nacional ou que exigem validação local, é obrigatório registrar a Inscrição Municipal e, quando solicitado, o login e a senha cadastrados no portal da prefeitura para liberar o tráfego de dados.
Pré-requisitos para a configuração
A disponibilização das notas fiscais de serviço está sob a responsabilidade de cada administração municipal, que utiliza provedores de tecnologia específicos (como Nota do Milhão, Betha, Fiorilli, Ginfes ou sistemas próprios). Por possuírem condições próprias de segurança, os requisitos variam de acordo com a localização do prestador ou do tomador do serviço e podem incluir:
Certificado digital A1: Arquivo digital (extensões
.pfxou.p12) de modelo e-CNPJ obrigatoriamente associado à conta Qive. Certificados A3 (mídias físicas) não são compatíveis com este canal automatizado.Inscrição municipal (IM): Sequência numérica que identifica a empresa no cadastro tributário municipal, localizada no alvará de funcionamento da organização.
Credenciais de acesso: Usuário (login) e senha definidos previamente no portal tributário do próprio município.
Acessos especiais ou tokens: Chaves de autenticação de webservice específicas para determinados provedores, como o Sistema Tributos ou Conam.
Passo 1: Como cadastrar a inscrição municipal (IM) na Qive
O cadastro da Inscrição Municipal é a identidade da empresa para a cobrança do ISS (Imposto sobre Serviços de Qualquer Natureza) e autoriza a plataforma a segmentar corretamente as listagens de notas tomadas e prestadas.
No menu superior direito da plataforma Qive, clique no seu Perfil de usuário (ícone com as iniciais do seu nome).
Selecione a opção Detalhes da conta.
Nota de Permissão: Esta seção e as configurações subsequentes estão disponíveis exclusivamente para usuários Administradores ou colaboradores com nível de acesso de Gerente.
Na aba Detalhes da conta, role a página até a seção inferior denominada EMPRESAS DA CONTA.
Localize na listagem o CNPJ para o qual deseja incluir a informação. A coluna IM indicará se o campo está preenchido ou Vazio.
Passe o cursor do mouse sobre a linha da empresa e clique no botão Editar.
Na página de edição, localize o campo Inscrição Municipal, clique sobre a descrição e insira a sequência numérica correta do alvará.
Clique no botão de confirmação (✓) para salvar o registro.
Passo 2: Como realizar o cadastro prévio nos portais das Prefeituras
Certas prefeituras bloqueiam consultas externas via robôs ou webservices se o CNPJ não tiver uma conta de acesso configurada diretamente no ambiente municipal. Sem essa etapa, o motor da Qive não conseguirá extrair os documentos fiscais.
Cenário A: Cadastro via site direto do município
Acesse o portal oficial da prefeitura onde sua empresa ou seus prestadores emitem as notas de serviço.
Localize a área de "Acesso ao Contribuinte", "Nota Fiscal de Serviço Eletrônica" ou "ISS" e realize a criação da conta digital da empresa.
Defina um usuário (geralmente o CNPJ ou CPF do responsável) e uma senha forte.
Certifique-se de realizar um login de teste no site do governo para validar se as credenciais estão ativas e se o alvará eletrônico não possui pendências.
Cenário B: Cidades com provedor Saatri (Solicitação via e-mail)
Para municípios integrados que utilizam o provedor Saatri, a liberação de acessos não ocorre via formulário web, exigindo uma solicitação formal de desenvolvimento.
Envie um e-mail para
suporte.dev@saatri.com.br.No corpo do e-mail, informe obrigatoriamente a Razão Social, o CNPJ e a lista de todas as cidades nas quais deseja habilitar a captura automática.
Aguarde o retorno com a confirmação de liberação do ambiente antes de prosseguir para a etapa final na plataforma Qive.
Cenário C: Cidades com sistema Tributos (Geração de Token)
Se o município desejado utiliza o software Tributos (comum em cidades listadas em nossa tabela de requisitos de Pernambuco, Alagoas, Bahia, Paraíba, Rio Grande do Norte e Sergipe), você precisará extrair uma chave de segurança digital (TokenAuth).
Acesse a plataforma Connect do sistema Tributos (
https://www.tributosmunicipais.com.br/connect/).Realize o login ou clique em Solicitar acesso preenchendo os dados do CNPJ.
No menu superior, siga em Cadastros > Cadastrar contribuintes e salve as informações da sua empresa.
Em seguida, acesse Cadastros > Consultar contribuintes e clique na opção Gerenciar acesso localizada ao lado do CNPJ correspondente.
Na seção Ambiente de Produção, clique em Gerar acesso.
O sistema gerará uma URL na tela. Copie integralmente o código localizado logo após o termo
tokenAuth=. Essa chave será colada no painel da Qive.
Passo 3: Como ativar a consulta automática de NFS-e na Qive
Após garantir o preenchimento da Inscrição Municipal e possuir as credenciais da prefeitura em mãos, finalize a ativação diretamente no painel fiscal.
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.
Tratamento de erros e monitoramento
Se a integração apresentar qualquer interrupção, o sistema moverá o registro para a aba Cidades configuradas com erro. Ao cliecar em "Configurar Consulta", verifique o status atual de cada cidade configurada e as mensagens de erro comuns e como solucioná-las de forma autônoma:
Usuário e/ou senha incorretos: Indica divergência nas credenciais locais do governo. Acesse a aba de erros, exclua a configuração da cidade, valide os acessos diretamente no site da prefeitura e refaça o processo de ativação na Qive inserindo os dados corrigidos.
Erro ao realizar consulta, tentaremos novamente: Significa instabilidade momentânea ou manutenção nos servidores do município. A plataforma possui rotinas programadas para reexecutar as tentativas de captura automaticamente a cada 12 horas, dispensando ações manuais do usuário.
Credenciamento de tomador necessário: Algumas administrações municipais exigem uma autorização prévia por escrito ou ativação de perfil eletrônico para liberar o tráfego via webservice. Regularize a situação cadastral diretamente com o setor de posturas fiscais da prefeitura e reative a cidade na Qive.
Consulta em andamento...Aguardando resposta da prefeitura: A prefeitura ainda não retornou nenhuma nota desde a configuração da cidade, os preenchimentos estão corretos, nesses casos recomendamos aguardar até que novas notas sejam emitidas e disponibilizadas, assim o status mudará automaticamente.
Se uma cidade alterar estruturalmente seu provedor de tecnologia sem aviso prévio ou encerrar convênios de distribuição automatizada, as capturas podem ser afetadas. Caso note ausência de notas mesmo com os parâmetros corretos, acione nosso time de especialistas em Sucesso do Cliente pelo chat interno ou reporte a ocorrência enviando um e-mail para suporte@qive.com.br.