Assuntos em alta:

Conteúdo sobre todos os departamentos!

Validação: Inconsistência na comunicação com a API da Serpro

Comunicação com a API da Serpro

Durante a utilização da integração com a API da Serpro, por meio do Integra Contador, o sistema Makrosystem pode apresentar a seguinte mensagem de validação: Inconsistência na comunicação com a API da Serpro. Detalhe: {{DescricaoMensagemRetorno}} Verifique as Chaves da API da Serpro (Consumer Key e Consumer Secret) no Cadastro de Escritório e o Certificado Digital vinculado.

Mensagem de validação de inconsistência na comunicação com a API da Serpro, solicitando a verificação das chaves de acesso e do certificado digital.

Essa validação indica que ocorreu uma inconsistência na comunicação entre o sistema Makrosystem e a API da Serpro.

Para solucionar, é necessário conferir as chaves de acesso da API, o certificado digital vinculado e, quando aplicável, a procuração eletrônica.

Passo a passo:

Etapa 1 – Conferir o cadastro das chaves Consumer Key e Consumer Secret

Primeiramente, identifique se o cadastro do Integra Contador na Serpro foi realizado pelo CNPJ do escritório de contabilidade ou pelo CNPJ da empresa.

1.1 – Cadastro realizado pelo CNPJ do escritório de contabilidade

1 – Acesse o menu Preparar > Cadastros > Escritório.

Acesso ao menu Preparar > Cadastros > Escritório no Sistema Makro para verificar as configurações da API da Serpro.

2 – Acesse a aba Integrações.

3 – Verifique se os campos Consumer Key e Consumer Secret estão devidamente preenchidos com as chaves fornecidas pela Serpro.

Aba Integrações no cadastro do escritório, com destaque para os campos Consumer Key e Consumer Secret da API da Serpro.

1.2 – Cadastro realizado pelo CNPJ da empresa

1 – Acesse o menu Preparar > Cadastros > Empresas.

2 – Localize e acesse o cadastro da empresa correspondente.

Acesso ao menu Preparar > Cadastros > Empresas no Sistema Makro para conferir as chaves de integração com a Serpro.

3 – Acesse a aba Senhas e Certificados.

4 – Verifique se os campos Consumer Key e Consumer Secret estão devidamente preenchidos com as chaves fornecidas pela Serpro.

Tela de cadastro da empresa com destaque para os campos Consumer Key e Consumer Secret na seção Serpro, dentro de Senhas e Certificados.

Atenção: As chaves não devem estar preenchidas simultaneamente no cadastro da empresa e no cadastro do escritório. O preenchimento deve ocorrer em apenas um dos cadastros, conforme o CNPJ utilizado para realizar a contratação e o cadastro do Integra Contador na Serpro.

Etapa 2 – Verificar o cadastro do Certificado Digital

Após conferir as chaves de acesso, verifique se existe um certificado digital válido e vinculado corretamente.

2.1 – Certificado Digital do escritório

1 – Acesse o menu Preparar > Certificado Digital > Por Escritório.

2 – Localize o certificado digital padrão.

3 – Verifique se o certificado está válido e corresponde ao escritório de contabilidade.

4 – Confira se o CNPJ informado no certificado digital é o mesmo CNPJ cadastrado no escritório.

Acesso ao menu Preparar > Certificado Digital > Por Escritório no Sistema Makro para verificar a validade do certificado digital vinculado à integração.

2.2 – Certificado Digital da empresa

1 – Acesse o menu Preparar > Cadastros > Empresas.

2 – Localize e acesse o cadastro da empresa correspondente.

Acesso ao cadastro de empresas no Sistema Makro para conferir o certificado digital utilizado na comunicação com a API da Serpro.

3 – Acesse a aba Senhas e Certificados.

4 – Localize a opção Certificado Digital.

5 – Verifique se existe um certificado digital válido cadastrado.

6 – Confira se o CNPJ informado no certificado digital corresponde ao CNPJ da empresa.

Tela Senhas e Certificados do cadastro da empresa, com destaque para o botão Certificado Digital utilizado na verificação do certificado vinculado à integração com a Serpro.

Etapa 3 – Verificar a procuração eletrônica

Caso os envios sejam realizados pelo escritório de contabilidade, é necessário que o cliente tenha emitido uma procuração eletrônica autorizando a contabilidade a realizar os procedimentos junto à Serpro.

1 – Verifique se existe uma procuração eletrônica emitida pelo cliente em favor do escritório de contabilidade.

2 – Confira se a procuração está válida e contempla as autorizações necessárias para os serviços que estão sendo realizados.

Etapa 4 – Realizar nova tentativa de comunicação

Após conferir as chaves da API, o certificado digital e a procuração, quando aplicável:

1 – Verifique se todas as informações estão preenchidas corretamente.

2 – Retorne ao procedimento que apresentou a mensagem de validação.

3 – Realize novamente a operação para verificar se a comunicação com a API da Serpro foi restabelecida.

4 – Caso todas as configurações estejam corretas e a validação continue sendo apresentada, abra um chamado diretamente com a Serpro,  para que seja avaliada a inconsistência na comunicação com a API.

Observações:

  • As chaves Consumer Key e Consumer Secret devem estar cadastradas conforme o CNPJ utilizado na contratação do Integra Contador junto à Serpro.
  • Não mantenha as mesmas chaves preenchidas simultaneamente no cadastro do escritório e no cadastro da empresa.
  • O certificado digital deve corresponder ao CNPJ do titular utilizado na configuração da integração.
  • Quando o envio for realizado pelo escritório em nome do cliente, deve existir uma procuração eletrônica válida e com as autorizações necessárias.
  • Caso todas as configurações estejam corretas e a validação continue sendo apresentada, abra um chamado diretamente com a Serpro,  para que seja avaliada a inconsistência na comunicação com a API.

Perguntas frequentes

O que significa a mensagem 'Inconsistência na comunicação com a API da Serpro' no Makrosystem?

Indica que houve um problema na comunicação entre o Makrosystem e a API da Serpro.

Onde devo verificar o cadastro das chaves Consumer Key e Consumer Secret se o Integra Contador foi contratado pelo CNPJ do escritório?

No menu Fiscal > Cadastros > Escritório, aba Integrações.

Posso preencher as chaves Consumer Key e Consumer Secret no cadastro da empresa e no cadastro do escritório ao mesmo tempo?

Não, as chaves devem estar preenchidas apenas em um dos cadastros, conforme o CNPJ utilizado na contratação.

O que devo fazer para verificar se o certificado digital está correto para a integração com a Serpro?

Confirme se o certificado digital está válido e corresponde ao CNPJ utilizado no cadastro do escritório ou da empresa.

Se todas as configurações estiverem corretas e o erro persistir, o que devo fazer?

Abra um chamado diretamente com a Serpro para que avaliem a inconsistência na comunicação com a API.

Saiba mais:

Esse artigo foi útil para você?
SIMNÃO