Passar para o conteúdo principal

Apuração Assistida de CBS: Como gerar e configurar as credenciais na Qive

Conecte a Apuração Assistida da Reforma Tributária à Qive para sincronizar automaticamente os dados da CBS. Veja como gerar o Client ID e o Client Secret no portal do governo e cadastrá-los na plataforma.

Escrito por Julia S.

O que é a Apuração Assistida

Com a Reforma Tributária, os tributos sobre o consumo passam a ser apurados pelo próprio Fisco, no modelo chamado Apuração Assistida. A Receita Federal faz o cálculo prévio e automático da CBS (Contribuição sobre Bens e Serviços), e o Comitê Gestor faz o mesmo com o IBS (Imposto sobre Bens e Serviços). Esse cálculo usa como base os documentos fiscais eletrônicos que a empresa emite e recebe.

O processo funciona em quatro etapas:

  • Alimentação contínua: a cada documento fiscal emitido (NF-e, NFS-e, CT-e, entre outros) ou transação ligada ao split payment, o sistema do governo reúne débitos, créditos, pagamentos e retenções.

  • Pré-cálculo do saldo: no fechamento do período, o Fisco disponibiliza um extrato com o saldo apurado, que pode ser imposto a pagar ou saldo credor a recuperar.

  • Conferência e ajustes: a empresa ou o contador valida os valores, confere os créditos de entrada e faz os ajustes necessários por meio de eventos ou documentos fiscais complementares.

  • Confirmação ou presunção: se a empresa não se manifestar ou não contestar dentro do prazo regulamentar, o Fisco considera os valores corretos e o crédito tributário é constituído automaticamente.

Como a Qive se conecta à Apuração Assistida

A Qive traz para a plataforma os dados da Apuração Assistida disponibilizados pelo Fisco. Assim, a sua empresa acompanha e confere os valores junto com os documentos fiscais que já gerencia na Qive. Hoje a sincronização está disponível para a CBS. A do IBS será liberada em breve.

Para ativar a conexão, você precisa de duas chaves de autenticação geradas no portal do governo federal: o Client ID e o Client Secret. Essas chaves funcionam como uma ponte segura entre a Receita Federal e a Qive.

Pré-requisitos

  • Ter acesso à conta GOV.BR da empresa. O ideal é usar o certificado digital e-CNPJ da matriz ou uma procuração eletrônica com poderes perante a Receita Federal.

  • No portal do governo, ter perfil com permissão para gerenciar integrações e serviços de API tributários.

Na Qive, qualquer usuário pode cadastrar as credenciais.

Passo a passo para gerar e configurar as credencias:

Etapa 1: Gere as credenciais no Portal Nacional da RTC

Acesse o portal

  1. Entre no Portal Nacional da RTC pelo link oficial: https://consumo.tributos.gov.br/;

  2. Faça login com a conta GOV.BR da empresa.

Acesse a área de API

  1. Na página inicial, clique em Gerar sua credencial para acesso via API;

  2. No menu da ferramenta, acesse Chaves Secretas > Gerar Token.

Preencha as configurações da credencial

Na tela de geração da chave secreta, preencha os campos:

  1. Nome: informe uma identificação que facilite o reconhecimento interno. Sugestão: Qive - Apuração Assistida.

  2. Validade: defina por quanto tempo a chave será válida.

    • Dica: escolha o prazo máximo de 5 anos. Assim você evita interrupções na sincronização por expiração da chave em pouco tempo.

  3. Consentimento (obrigatório): mantenha esta opção marcada para que a Receita Federal realize a Assinatura Qualificada.

    • Atenção: se este campo for desmarcado, a sua empresa terá que assinar digitalmente cada requisição via API, e a integração automática com a Qive deixa de funcionar.

  4. Serviços Autorizados: confira se o serviço Reforma Tributária CBS – Apuração Assistida e Devolução de CBS aparece na lista e está habilitado. É esse serviço que permite a leitura e o processamento dos extratos de CBS.

Salve e copie as chaves de acesso

  1. Clique em confirmar para concluir a geração.

  2. A janela exibida mostra dois códigos:

    • Client ID: identificador público da aplicação.

    • Client Secret: chave de segurança privada.

  3. Copie o Client ID e o Client Secret e guarde-os temporariamente em um local seguro antes de fechar a tela.

🚩 Importante: por segurança do Fisco, o Client Secret não pode ser visualizado de novo depois que a página é fechada. Se você perder esse código, será necessário excluir a chave e gerar um novo token.

Etapa 2: Configure as credenciais na Qive

Acesse o menu de credenciais

  1. Na Qive, clique no ícone do seu perfil no canto superior direito;

  2. Selecione Detalhes da conta;

  3. No menu lateral esquerdo, selecione Credenciais da apuração assistida.

Inicie um novo cadastro

  1. Clique no botão Adicionar credencial, no centro da tela.

Informe a raiz do CNPJ

Acesse direto pelo link https://app.qive.com.br/account-management/assisted-tax-credentials ou siga o caminho, no painel que abre à direita da tela:

  1. Digite a Raiz do CNPJ da sua empresa, que são os 8 primeiros dígitos.

  2. A credencial vale automaticamente para a matriz e para todas as filiais com essa mesma raiz de CNPJ.

Preencha a credencial CBS

  1. No bloco Credencial CBS, informe o Client ID gerado no Portal Nacional da RTC.

  2. Informe o Client Secret correspondente.

  3. Clique em Salvar, logo abaixo dos campos da CBS.

Sobre o IBS: o bloco Credencial IBS aparece com o status Aguardando RFB e com os campos desabilitados. A configuração desse imposto será liberada quando a Receita Federal e os órgãos reguladores disponibilizarem o ambiente de homologação e integração.

Confirme o aviso de permissões

Depois de clicar em Salvar, a Qive exibe a janela Atenção, que explica como os dados fiscais ficam visíveis na plataforma:

  • Visibilidade por raiz de CNPJ: o Fisco envia os dados da Apuração Assistida por raiz de CNPJ. Por isso, no Extrato, qualquer usuário com acesso a um CNPJ vê os dados consolidados de todas as filiais com a mesma raiz.

  • Como restringir o acesso: para impedir que um usuário veja o consolidado da raiz no Extrato, clique no ícone do perfil no canto superior direito e acesse Usuários > Grupos de usuários > Editar permissões. Depois, remova o acesso desse usuário à funcionalidade Extrato.

Para concluir a ativação:

  1. Marque a caixa Estou ciente e de acordo.

  2. Clique em Salvar.

Quando os dados aparecem na Qive

Depois que a credencial é salva, a sua empresa entra na fila de consulta. A Qive consulta a Apuração Assistida uma vez por dia. Não há um prazo fixo para os dados aparecerem, mas a expectativa é de retorno em até 24 horas.

Vencimento da credencial

A API do governo não informa à Qive a data de expiração da credencial. Por isso:

  • Acompanhe a validade da chave diretamente no Portal Nacional da RTC.

  • Se a credencial expirar ou for desativada, a Qive deixa de conseguir consultar os dados. Nesse caso, a tela Credenciais da Apuração Assistida exibe um status de erro, indicando que você precisa agir.

  • Para corrigir, gere uma nova chave no Portal Nacional da RTC e cadastre o novo Client ID e o novo Client Secret na Qive.

Perguntas frequentes

  • Preciso cadastrar uma credencial para cada filial?
    Não. A integração é feita pela raiz do CNPJ (8 primeiros dígitos). Uma única credencial vale para todas as filiais com a mesma raiz.

  • Onde gero o Client ID e o Client Secret?
    No Portal Nacional da RTC (https://consumo.tributos.gov.br/), no menu Chaves Secretas > Gerar Token.

  • Por que os campos da Credencial IBS estão desabilitados?
    O ambiente oficial do IBS ainda depende de definição e liberação pela Receita Federal (RFB). Os campos serão habilitados automaticamente na Qive quando essa infraestrutura for homologada.

  • Perdi o Client Secret. O que faço?
    No Portal Nacional da RTC, acesse Chaves Secretas, exclua a chave criada e gere um novo token. Depois, cadastre o novo Client ID e o novo Client Secret na Qive.

  • Desmarquei o campo de consentimento. A integração vai funcionar?
    Não. Sem o consentimento, a sua empresa teria que assinar digitalmente cada requisição, e a integração automática com a Qive não funciona. Gere uma nova credencial com a opção Consentimento marcada.

Artigos relacionados
Respondeu à sua pergunta?