WebService da NFS-e de Goiânia: como habilitar, desvincular e usar um emissor de terceiros

O emissor de terceiros recebe os dados da operação e os transmite ao ambiente fiscal conforme a integração disponível. Ele não substitui o CAE, não escolhe sozinho a tributação e não transforma um serviço incorretamente cadastrado em operação válida. A responsabilidade pelos dados continua existindo.

Antes de contratar ou ativar o emissor, confirme com o fornecedor qual padrão ele atende, quais credenciais utiliza e quais informações precisam estar liberadas no ambiente fiscal. Compare isso com a situação da empresa. A página municipal de Notas Fiscais Eletrônicas deve ser uma das referências para o ambiente oficial vigente.

Faça uma matriz simples: cadastro municipal, autorização, certificado ou credencial, serviço, tomador, transmissão e retorno. Quando algo falhar, essa matriz permite localizar a camada em vez de reinstalar tudo.

Anote qual emissor está ativo, quem possui acesso, certificado e validade, última nota autorizada, último RPS quando houver, série ou referências utilizadas, atividades configuradas e mensagens de erro recentes. Exporte relatórios que possam ser necessários para conciliar o período.

Esse inventário é a sua contingência. Se a nova implantação falhar, você sabe qual era o último estado funcional e consegue separar um problema novo de uma pendência antiga. Sem essa fotografia, duas equipes podem alterar parâmetros diferentes e destruir a evidência do que funcionava.

Avise quem emite e quem fecha a contabilidade sobre a janela de troca. Durante a migração, uma nota enviada pelo fluxo antigo e novamente pelo novo pode criar duplicidade que só será percebida no fechamento.

A habilitação deve estar vinculada ao contribuinte correto e aos acessos autorizados. Confira CNPJ, CAE e situação cadastral antes de investigar integração. O serviço municipal do CAE mostra que localização e atividades fazem parte do cadastro que precisa permanecer atualizado.

Telas, nomes de menus e formas de autorização podem mudar. Por isso, este guia não transforma uma sequência de cliques em regra permanente. No momento da implantação, confronte a documentação do emissor com o ambiente oficial da Prefeitura de Goiânia e registre o procedimento efetivamente usado.

Depois da habilitação, envie um teste controlado e confira o documento autorizado. “Conectado” no painel do fornecedor não prova que a NFS-e foi aceita com os dados esperados.

Antes de revogar, substituir ou encerrar a autorização anterior, confirme que não existem documentos pendentes de retorno e registre o último documento válido. A nomenclatura usada pelo ambiente pode mudar; procure o mecanismo vigente de autorização ou vínculo, não necessariamente um botão literal chamado “desvincular”.

Não apague certificado, usuário ou procuração sem verificar se esses elementos também são usados em outra obrigação. Da mesma forma, não mantenha dois emissores operando simultaneamente sem regra clara sobre qual deles pode transmitir.

Se o ambiente não mostrar com clareza como substituir a autorização, reúna CNPJ, CAE, emissor atual, novo emissor e mensagem de erro e consulte o suporte oficial e o fornecedor. É melhor documentar uma confirmação atual do que publicar cliques precisos para uma tela que pode mudar.

Leia primeiro o código e a mensagem retornada. Classifique a falha: autenticação ou certificado; cadastro do prestador; dados do tomador; atividade ou serviço; conteúdo da nota; autorização; indisponibilidade. Só depois faça a primeira alteração.

Compare a rejeitada com uma nota que foi autorizada: mesmo CNPJ? mesmo serviço? mesmo tomador? certificado ainda válido? houve alteração no CAE? Esse contraste reduz o universo do problema. Registre cada teste, horário, alteração e resultado.

Erro cadastral não é corrigido gerando outro certificado. Erro de certificado não é resolvido trocando o código do serviço. Quando cada tentativa mexe em uma camada diferente, o diagnóstico vira loteria.

Quando o fluxo utiliza RPS ou outra referência intermediária, documente como o emissor controla sequência, conversão e retorno. Uma transmissão que ficou sem resposta não deve ser reenviada cegamente antes de verificar se o documento foi autorizado. Esse é um caminho clássico para duplicidade.

Teste também consulta e recuperação do documento, não apenas envio. A empresa precisa conseguir provar qual nota corresponde a qual operação e qual retorno encerrou a transmissão.

No fechamento, compare documentos autorizados com o relatório do emissor e com as cobranças. Se a migração ocorreu no meio do mês, identifique explicitamente quais documentos pertencem a cada fluxo.

Defina quem será acionado quando a integração parar, onde consultar o status oficial, quais evidências guardar e qual procedimento alternativo é permitido naquele cenário. Não improvise emissão paralela sem controlar o que já foi transmitido.

Uma boa contingência também inclui vencimento de certificado, troca de responsável e perda de acesso. Mantenha responsáveis e datas documentados. Se a empresa depende de uma única pessoa que conhece a configuração, existe um risco operacional independente da qualidade do software.

Depois de estabilizar o novo emissor, acompanhe as primeiras competências com mais atenção. O objetivo não é apenas “emitir sem erro”, mas fazer com que nota, cobrança, recebimento e contabilidade continuem conciliados.

Considere a migração concluída quando a empresa consegue emitir uma operação real, consultar o retorno, recuperar a NFS-e, identificar uma rejeição, corrigir o problema e entregar os documentos corretos ao fechamento. Um único teste positivo não cobre esse ciclo.

Documente a configuração final e arquive o que foi substituído. Se houver nova troca no futuro, essa documentação reduz horas de investigação.

Para a rotina fiscal depois da implantação, volte ao guia completo da NFS-e de Goiânia. A integração é apenas uma parte do processo de emissão.