🧪 Nova Experiência: Você está testando nossa nova documentação. Dê sua opinião
Prosoft

C2025 - Certificados e Credenciais – Credenciais do Receita Integra

C2025 - Certificados e Credenciais – Credenciais do Receita Integra

Neste artigo, você acompanhará o passo a passo para visualizar, gerenciar e vincular individualmente as credenciais de integração do Receita Integra (Client ID e Client Secret) no Prosoft para a transmissão da DeRE, a nova obrigação contábil.


O que é Client ID e Client Secret?


  • A Receita Federal (RFB) definiu um novo padrão de autenticação para as APIs da Reforma Tributária por meio do protocolo OAuth 2.0 (fluxo Client Credentials).

  • Com esse novo modelo, o contribuinte ou contador obtém o Client ID e o Client Secret diretamente no portal da RFB, passando a utilizar credenciais de acesso para a validação onde o Client ID (usuário) usa para identificar qual empresa está se conectando à Receita Federal, e o Client Secret (senha) confirme a autorização do acesso. Juntas, essas chaves permitem que o sistema troque dados com o governo de forma automatizada e segura 

Verificaremos a seguir como criar e como configurá-la no sistema Contábil:

Como gerar a credencial de acesso

1- Acesse o portal de  Portal de Tributação sobre Consumo;
Localizado no site >: https://consumo.tributos.gov.br/

https://ajuda.alterdata.com.br/download/attachments/390497165/image-2026-10-23_16-39-51.png?version=1&modificationDate=1792784390321&api=v2


2- No portal, Acesse a aba de ‘’Gerar Credencial de acesso para API’’


https://ajuda.alterdata.com.br/download/attachments/390497165/image-2026-10-23_16-39-51-1.png?version=1&modificationDate=1792784390639&api=v2


3- Informe os dados da conta gov para acesso:


image-20261023-200245.png


4- Após acessar no menu de ‘’nov credencial’’ acione o botão ‘’gerar Token’’ na opção ‘’Chaves Secretas’’


https://ajuda.alterdata.com.br/download/attachments/390497165/image-2026-10-23_16-39-51-3.png?version=1&modificationDate=1792784391246&api=v2


5- Ao acionado, deve preencher/confirmar as informações no formulário:

  • Nome da Credencial

  • Validade da Credencial

  • Termo de Consentimento

  • Serviços Autorizados

6- Após preencher esses campos e confirmar a criação, o portal exibirá em tela os dados da sua nova credencial: o Client ID e o Client Secret. 

https://ajuda.alterdata.com.br/download/attachments/390497165/image-2026-10-23_16-39-51-4.png?version=1&modificationDate=1792784391441&api=v2


 Importante: Guarde essas informações em local seguro, pois o Client Secret geralmente é exibido apenas uma vez no portal.

Agora que possui suas credenciais Acesse a rotina: Certificados e Credenciais onde a rotina pode ser acessada por meio dos seguintes caminhos no menu do sistema:

  • Fiscal > Cadastros > Certificados e Credenciais

  • Parâmetros Gerais > Cadastros > Certificados e Credenciais

Informação: Para visualizar e operar a rotina Certificados e Credenciais, o perfil do usuário logado deve possuir as devidas permissões de acesso. Caso o usuário não tenha permissão, a opção ficará oculta no menu ou os botões de ação estarão desabilitados. 


https://ajuda.alterdata.com.br/download/attachments/390497165/image-2026-10-23_16-39-51-5.png?version=1&modificationDate=1792784391675&api=v2


Estrutura da Tela e Dashboard de Indicadores

Ao acessar a aba Credenciais do Receita Integra, a tela exibe no topo um painel (dashboard) com indicadores em tempo real para acompanhar a carteira de clientes, respeitando as permissões do usuário:

  • Empresas Vinculadas: Exibe o total de empresas (matrizes e empresas únicas) que possuem credenciais ativas cadastradas. 

  • Empresas Sem Vínculo: Indica o número total de empresas que ainda não possuem credenciais configuradas no sistema.

https://ajuda.alterdata.com.br/download/attachments/390497165/image-2026-10-23_16-39-51-6.png?version=1&modificationDate=1792784391974&api=v2


  1. Área de Filtros e Busca de Empresas

Para facilitar a localização das empresas e otimizar a consulta em bases com grande volume de dados, a rotina disponibiliza recursos de filtragem posicionados acima da tabela principal: 

  • Filtros por Coluna (Grid): Permite filtrar em tempo real diretamente nos cabeçalhos das colunas por Código, Empresa / CNPJ ou Status.

  • Filtro de Status: Permite selecionar a visualização entre as opções Todos os status, Vinculadas ou Pendentes. 

  • Botão Limpar Filtros: Reseta as buscas aplicadas, retornando à exibição padrão de todos os registros. 


https://ajuda.alterdata.com.br/download/attachments/390497165/image-2026-10-23_16-39-51-7.png?version=1&modificationDate=1792784392143&api=v2


Como Cadastrar e Vincular Credenciais (Vínculo Individual)

O cadastro e associação das chaves de API (Client ID e Client Secret) é realizado individualmente por empresa através da tabela principal:

  1. Localize a empresa desejada na listagem (os CNPJs exibem a máscara de formatação XX.XXX.XXX).

  2. Na coluna Ações, identifique a situação do registro:

    • Empresas Pendentes: Clique na opção Vincular. 

    • Empresas Vinculadas: Clique na opção Editar para alterar as chaves existentes. 

https://ajuda.alterdata.com.br/download/attachments/390497165/image-2026-10-23_16-39-51-8.png?version=1&modificationDate=1792784392324&api=v2


Na janela exibida, o sistema apresentará diretamente o Nome e o Código da empresa à qual a credencial será vinculada.Informe o Client ID e o Client Secret fornecidos e confirme a operação para salvar.

https://ajuda.alterdata.com.br/download/attachments/390497165/image-2026-10-23_16-39-51-9.png?version=1&modificationDate=1792784392501&api=v2



Edição e Remoção de Credenciais

Para empresas que já possuem o status Vinculada, a coluna Ações disponibiliza duas operações: 

  • Editar: Permite alterar os valores do Client ID ou Client Secret vinculados à empresa (requer permissão de Alteração). 

  • Remover: Exibe modal de confirmação para desvincular as credenciais da empresa selecionada (requer permissão de Exclusão).


Certificados 

Parâmetros gerais >  Cadastros > Certificados e Credenciais 

1 - Acesse o menu Certificados e Credenciais  e clique em Cadastrar Novos Certificados : 


https://ajuda.alterdata.com.br/download/attachments/390497165/image-2026-10-23_16-39-51-10.png?version=1&modificationDate=1792784392642&api=v2


Passo a Passo para Validação:

  1. Identificação do Certificado: Localize o certificado digital a ser utilizado.

  2. Seleção do Modelo: Escolha o tipo de certificado digital correspondente (A1 ou A3).

  3. Definição da Procuração: Selecione a opção referente à Procuração Eletrônica.

  4. Autenticação: Insira a senha de acesso do certificado.

  5. Validação: Clique em Validar para concluir o procedimento.


https://ajuda.alterdata.com.br/download/attachments/390497165/image-2026-10-23_16-39-51-11.png?version=1&modificationDate=1792784392897&api=v2

Após a validação o usuário tem a opção de Vincular Empresas ou Salvar o certificado sem empresas.