Empresas, desenvolvedores e fornecedores de sistemas que utilizam APIs relacionadas à Reforma Tributária do Consumo devem ficar atentos a uma atualização programada pela Receita Federal para 24 de agosto.
A Receita atualizará a plataforma responsável pelo gerenciamento das credenciais utilizadas no acesso às APIs dos ambientes piloto e beta da Reforma Tributária. Com a mudança, as credenciais atualmente utilizadas deixarão de ser suficientes para acessar alguns dos serviços afetados, tornando necessária a geração de novas credenciais após a conclusão do procedimento.
A atualização também permitirá que uma mesma credencial seja utilizada para diferentes serviços, desde que o usuário tenha as autorizações necessárias para acessar cada API.
Sistema ficará indisponível por três horas
A atualização está prevista para ocorrer em 24 de agosto, das 8h às 11h.
Durante esse intervalo, a plataforma ficará indisponível para que a Receita realize as alterações necessárias.
Por isso, empresas e equipes responsáveis por integrações devem considerar a janela de indisponibilidade no planejamento das operações que dependam dos serviços afetados.
Após as 11h, os usuários deverão acessar os canais disponibilizados pela Receita e gerar novas credenciais antes de retomar a utilização das APIs alcançadas pela mudança.
Quais APIs serão afetadas?
Segundo as informações divulgadas, a atualização alcançará quatro APIs:
- consulta de débitos de CBS;
- consulta de débitos de CBS no ambiente de produção restrita;
- envio de eventos da DeRe (Declaração de Regimes Específicos) no ambiente de produção restrita;
- envio de eventos de ReOps (Regime de Operações) no ambiente de produção restrita.
A alteração, portanto, merece atenção principalmente de desenvolvedores, empresas de tecnologia, fornecedores de ERP e equipes fiscais que já realizam testes ou integrações com a infraestrutura tecnológica da Reforma Tributária.
Credenciais atuais precisarão ser substituídas
As credenciais utilizadas nas APIs funcionam como um mecanismo de identificação e autenticação dos sistemas que tentam acessar determinado serviço.
Depois da atualização de 24 de agosto, as credenciais atuais não serão suficientes para utilização das quatro APIs afetadas.
Isso significa que não basta aguardar o restabelecimento da plataforma: será necessário gerar uma nova credencial e adequar a integração para utilizá-la.
A principal novidade do modelo atualizado será a possibilidade de utilizar uma única credencial em diferentes serviços.
Isso, porém, não significa acesso automático a todas as APIs.
As regras de autorização permanecem individualizadas. Dessa forma, a mesma credencial poderá ser usada em diferentes serviços somente quando o usuário possuir as permissões correspondentes.
Onde gerar as novas credenciais?
Após a atualização, as novas credenciais poderão ser geradas nos ambientes disponibilizados pela Receita Federal.
Um deles é o Portal Piloto da CBS, ambiente que vem sendo utilizado para testes e desenvolvimento das soluções relacionadas à Contribuição sobre Bens e Serviços.
O serviço também permanecerá disponível no Portal Nacional da Tributação de Bens e Serviços.
Acesse o Portal Nacional da Tributação de Bens e Serviços
Além desses canais, a ferramenta para geração das credenciais será disponibilizada no Portal de Serviços da Receita Federal.
Acesse o Portal de Serviços da Receita Federal
Empresas devem revisar integrações após atualização
Para quem utiliza diretamente alguma das quatro APIs afetadas, o procedimento não termina com a geração da nova credencial.
Será necessário verificar se os sistemas integrados estão utilizando corretamente as novas informações de autenticação e se a comunicação com os serviços foi restabelecida.
Na prática, equipes de tecnologia podem incluir no planejamento para 24 de agosto etapas como geração da nova credencial, atualização das configurações das integrações e realização de testes de comunicação com as APIs.
Também é recomendável identificar previamente quais sistemas internos ou fornecedores terceirizados dependem desses acessos, evitando descobrir a incompatibilidade somente depois que alguma integração deixar de funcionar.
APIs ganham espaço na implementação da Reforma Tributária
A atualização ocorre em meio à ampliação da infraestrutura tecnológica necessária para operacionalizar IBS e CBS.
Com a Reforma Tributária, uma série de processos fiscais passa a depender de maior comunicação entre sistemas empresariais e plataformas mantidas pela administração tributária.
Nesse cenário, as APIs permitem que softwares empresariais troquem informações diretamente com os ambientes da Reforma, reduzindo a necessidade de procedimentos manuais.
Por isso, mudanças aparentemente técnicas, como a substituição de uma credencial, podem produzir efeitos operacionais para empresas que já automatizaram esses processos.
Para contadores e responsáveis pelas áreas fiscais, vale verificar com os fornecedores de ERP e equipes de TI se alguma das integrações utilizadas pela empresa depende das APIs afetadas.
Anote o cronograma
A atualização será realizada em 24 de agosto, das 8h às 11h. Durante esse período, a plataforma de gerenciamento das credenciais ficará indisponível.
Depois da manutenção, usuários das APIs de consulta de débitos da CBS, consulta de débitos da CBS em produção restrita, DeRe e ReOps em produção restrita deverão gerar novas credenciais.
A mudança não amplia automaticamente as permissões dos usuários: embora uma mesma credencial possa passar a atender diferentes serviços, cada API continuará exigindo a respectiva autorização de acesso.
Para empresas que já estão testando as soluções tecnológicas da Reforma Tributária, a orientação prática é antecipar o mapeamento das integrações afetadas e deixar a atualização das credenciais prevista para o dia 24, evitando interrupções após a manutenção.