configuração de credenciais

Cada credencial passa por este ciclo:

1. Adicionar — você informa a senha, token ou certificado para a plataforma.
2. Validar — o sistema testa automaticamente se a credencial funciona. O resultado aparece em segundos.
3. Atualizar — se a senha mudar no portal, você informa a nova senha aqui. O sistema valida de novo.
4. Limpar — se quiser remover a credencial, você envia uma senha vazia. A validação para de ser feita.

A validação acontece automaticamente sempre que você adiciona ou atualiza uma credencial. O status aparece na tela logo depois.

A plataforma guarda até três credenciais por entidade fiscal. Cada uma tem um propósito diferente:

Credencial	O que é	Obrigatória?	Usada para
Senha do Governo Digital	Senha da conta gov.br do MEI	Não	Diagnóstico MEI (DAS, CND, dívida ativa)
Credenciais do portal de notas	Usuário e senha (ou token) do portal de notas da prefeitura	Sim (se não tiver certificado)	Autenticar na emissão de notas fiscais
Certificado digital	Arquivo .pfx que assina notas eletronicamente	Sim (se não tiver portal de notas)	Autenticar na emissão de notas fiscais

Para emitir notas, você precisa de pelo menos uma entre portal de notas ou certificado digital. A senha do governo é opcional.

É a senha que o MEI usa para acessar o gov.br. A plataforma usa essa senha para consultar documentos fiscais oficiais em nome do MEI: o DAS (Documento de Arrecadação do Simples Nacional), a certidão negativa de débitos (CND) e a situação da dívida ativa.

Adicionar

Você informa a senha. A plataforma criptografa antes de salvar e testa automaticamente contra o gov.br.

Atualizar

Se a senha do gov.br mudar, informe a nova senha. O sistema criptografa, salva e testa de novo.

Limpar

Envie uma senha vazia para remover a credencial. A validação para de ser feita. Nenhuma funcionalidade de emissão é afetada — essa credencial serve apenas para diagnóstico.

Validação

O sistema testa a senha contra o gov.br. Se falhar, os motivos comuns são: senha trocada, conta gov.br com verificação em duas etapas ativada, ou o serviço do governo temporariamente fora do ar.

São as credenciais que a plataforma usa para acessar o sistema de notas fiscais em nome do profissional:

• Para MEI: o portal NFse da prefeitura.
• Para não-MEI: o portal da prefeitura onde ele emite notas.

Essa é uma das duas opções obrigatórias para emitir notas. Você precisa ter ou esta credencial ou o certificado digital.

Tipos de autenticação

O portal da sua prefeitura pode aceitar diferentes formas de autenticação:

• Apenas senha — um único segredo compartilhado por CNPJ. É o mais comum para MEIs.
• Token — um token de API, sem usuário. Comum em provedores modernos.
• Usuário e senha — login e senha como em qualquer portal.

Adicionar

Informe as credenciais (senha, token, ou usuário e senha). O sistema testa automaticamente se elas funcionam contra o portal.

Atualizar

Informe a nova senha ou token. O sistema testa de novo.

Limpar

Envie uma senha vazia para remover a credencial. A validação para. Atenção: se você tiver apenas esta credencial (sem certificado), a emissão de notas ficará bloqueada até que você adicione uma nova credencial ou o certificado.

Validação

O sistema testa a credencial contra o portal da prefeitura. Se falhar, os motivos comuns são: senha trocada, token expirado, ou o portal está fora do ar.

O certificado digital é um arquivo .pfx que assina as notas fiscais eletronicamente. É o método preferido para autenticar na emissão.

Essa é uma das duas opções obrigatórias para emitir notas. Você precisa ter ou o certificado ou as credenciais do portal de notas.

Adicionar

Faça upload do arquivo .pfx (máximo 5 MB) e informe a senha do certificado. O sistema valida automaticamente: testa a senha, verifica a data de validade, e rejeita certificados vencidos.

Atualizar

Quando o certificado vencer, faça upload do novo arquivo .pfx com a nova senha. O sistema valida o novo certificado.

Limpar

Envie um arquivo vazio (ou os dados do certificado em branco) para remover o certificado. Atenção: se você tiver apenas o certificado (sem portal de notas), a emissão de notas ficará bloqueada.

Validação

O sistema testa o certificado contra o portal da prefeitura. Se falhar, os motivos comuns são: certificado venceu, senha do certificado foi alterada, ou o certificado está vinculado a outro CNPJ. Diferente das outras credenciais, o certificado tem data de validade — quando vence, a emissão é bloqueada até que um novo seja enviado.

Quando a validação falha, o motivo mais comum é que a senha foi alterada no portal e você ainda não atualizou aqui. Outros motivos comuns:

• A conta gov.br pediu verificação em duas etapas.
• O certificado digital venceu.
• A senha do certificado digital foi alterada.
• O portal não reconheceu o certificado (pode estar vinculado a outro CNPJ).
• O serviço de validação está temporariamente fora do ar (neste caso, o sistema registra um aviso em vez de marcar como falha).

Quando o motivo é temporário, o sistema marca a validação como bem-sucedida com um aviso, para que você não perca a credencial salva por causa de uma instabilidade pontual.

O que fazer

1. Confirme que a senha está correta fazendo login no portal oficial (gov.br, portal da prefeitura, etc.).
2. Volte aqui e atualize a credencial com a senha corrigida.
3. O sistema vai testar a nova senha automaticamente.

Se a validação continuar falhando, entre em contato com o suporte.

Além da validação de credenciais (testar se a senha ou certificado está correto), existe a validação de emissão: o sistema emite uma nota fiscal de teste de R$ 0,10 para confirmar que a integração completa com a prefeitura funciona de ponta a ponta.

A validação de emissão não é automática — você precisa pedir explicitamente. Use o botão "testar emissão" na tela da entidade fiscal para disparar.

As duas validações são independentes: a de credencial testa a senha, a de emissão testa o fluxo inteiro.