ERP - DERE - Como gerar as credenciais de acesso à API da Reforma Tributária para envio da DeRE (Client ID e o Client Secret)
Dúvida
Como gerar as credenciais de acesso (Client ID e Client Secret) à API da Reforma Tributária, necessárias para o envio dos eventos da DeRE à Receita Federal por meio do eDocsX?
Solução
As credenciais são geradas pelo próprio contribuinte (ou por seu procurador) no serviço Gerar Credencial de Acesso para API, disponível no Portal Nacional da Tributação de Bens e Serviços e no Portal Piloto da CBS. A Receita Federal informou que o serviço também será incluído no Portal Serviços da Receita Federal.
O Client ID e o Client Secret gerados são informados na solução Senior para que o eDocsX autentique e transmita os eventos da DeRE (D-1001, D-1011, balancetes e eventos).
Importante:
Em 24/08/2026, entre 8h e 11h, a Receita Federal atualizou a plataforma de controle de acesso às APIs dos ambientes piloto e beta da Reforma Tributária. Credenciais geradas antes dessa data deixaram de funcionar e precisam ser geradas novamente para as APIs abaixo:
Consultar débitos de CBS;
[Produção Restrita] Consultar débitos de CBS;
[Produção Restrita] Enviar eventos da DeRE;
[Produção Restrita] Enviar eventos de ReOps.
Com a nova versão, uma mesma credencial pode ser utilizada para acessar todas as APIs, respeitadas as regras de autorização de cada serviço.
Pré-requisitos
Antes de gerar a credencial, verifique se:
O usuário possui conta gov.br nível ouro ou prata, exigida para login no Portal Nacional da Tributação de Bens e Serviços;
O usuário é o representante legal da empresa ou um procurador digital previamente habilitado para representá-la no portal;
As parametrizações da DeRE no ERP XT e no Senior X já foram realizadas (Tenant, processo automático 184 - Replicação XT Senior X e cadastro da empresa no Senior X), conforme o artigo ERP - DERE - Como está o cronograma da DERE para 2026 e quais as parametrizações necessárias.
Passo a passo para gerar a credencial
Para gerar o Client ID e o Client Secret, realize os passos a seguir:
1. Acesse o Portal Nacional da Tributação de Bens e Serviços (ou o Portal Piloto da CBS, para empresas participantes do piloto);
2. Clique em Acesse gov.br e faça o login com a conta gov.br (nível ouro ou prata);
3. Caso o acesso seja feito por procurador, selecione primeiro a empresa a ser representada (ver tópico Credencial gerada por procurador);
4. Na área Contribuinte, em Destaques, clique em Gerar Credencial de Acesso para API;
5. Selecione a API e o ambiente desejados, por exemplo [Produção Restrita] Enviar eventos da DeRE;
6. Confirme a geração. O portal exibirá o Client ID e o Client Secret;
7. Copie as duas informações e armazene-as em local seguro, pois serão utilizadas na parametrização da solução Senior.
Observação
Os nomes de botões e telas podem sofrer alterações conforme a evolução do portal pela Receita Federal. Os passos 5 a 7 devem ser validados na tela atual do portal antes da publicação deste artigo. A documentação técnica das APIs também fica disponível no próprio serviço de geração de credenciais.
Credencial gerada por procurador
Procuradores digitais, como escritórios de contabilidade, podem gerar credenciais próprias da relação contribuinte procurador. Para isso, basta representar a respectiva empresa no portal antes de utilizar o serviço de geração de credenciais.
As autorizações de acesso de terceiros são administradas pelo contribuinte no portal, em Controle de Acesso / Autorizações e Credenciais.
Parametrização da credencial na solução Senior
Após gerar a credencial, ela deve ser informada no componente responsável pela transmissão da DeRE (eDocsX), dentro do Tenant da empresa, para isso, siga o passo a passo a seguir:
1. Acesse o Senior X com o Tenant da empresa;
2. Acesse o menu Edocs X > Configurações > Empresas;
3. Informe o Client ID e o Client Secret gerados no portal;
4. Selecione o ambiente correspondente à credencial (Produção Restrita ou Produção);
5. Salve as informações e realize o envio do evento D-1001 para validar a autenticação.
Importante:
O ambiente selecionado na solução Senior deve ser o mesmo da API escolhida na geração da credencial. Uma credencial de Produção Restrita não autentica no ambiente de Produção.
Observações e boas práticas
Trate o Client Secret como uma senha: não o envie por e-mail aberto nem o registre em chamados ou prints sem ocultar os dados;
Se a transmissão retornar erro de autenticação, verifique se a credencial foi gerada após 24/08/2026 e se o ambiente está correto; se necessário, gere uma nova credencial e atualize-a na solução Senior;
Ao trocar o responsável legal ou o procurador, revise as autorizações no portal e gere uma nova credencial;
A mesma credencial pode atender outras APIs da Reforma Tributária (como a consulta de débitos da CBS), desde que o usuário tenha autorização para cada serviço.
Fontes
Clique aqui para acessar o Portal Nacional da Tributação de Bens e Serviços
Clique aqui para acessar a Receita libera API para consulta à apuração de CBS (LegisWeb)
Para mais informações sobre a edição de artigos, verifique o artigo: ERP - DERE - Como está o cronograma da DERE para 2026 e quais as parametrizações necessárias (Senior)