Tempo aproximado para leitura: 00:03:00 min

Dúvida
Como avaliar mensagens de erro durante a integração dos dados Quírons x Protheus e Protheus x Quírons?

Ambiente
TOTVS RH (Linha Protheus) - Medicina e Segurança do Trabalho - Todas as versões

Solução
As integrações entre os dois produtos (Quírons e Protheus) ocorrem através de API's. As informações existentes no Protheus utilizam as API's do Quírons para atualizar suas informações e as informações no Quírons utilizam as API's do Protheus para se atualizarem.

API's são funcionalidades disponibilizadas por cada produto, que podem ser executados por outros serviços, desta forma a API executa funções dentro do próprio produto, para retornar com as informações que serão enviadas de volta ao serviço solicitante.

Um serviço API é uma comunicação entre serviços, ocorrida diretamente via web. Este tipo de comunicação possui alguns tipos de mensagens padrões de erro, conforme detalhado abaixo:
Cross Segmento - TOTVS Backoffice (Linha Protheus) - ADVPL - Codigos de erros HTTP mais comuns

Abaixo seguem os códigos de erros mais comuns dessas comunicações no PROTHEUS, porém para identificar o problema com maior assertividade, pode ser possível uma análise mais aprofundada juntamente à equipe de Suporte:

400 - Bad Request
Alguma regra de negócio foi violada ou algum parâmetro está incorreto.
É sugerido avaliar juntamente à equipe de Suporte, após garantir atualização integral dos artefatos envolvidos.

401 - Unauthorized
Usuário não está autenticado, ou a autenticação é inválida.
Nas configurações do Quírons, para integração ao Protheus, está sendo informado um usuário possivelmente bloqueado de acesso ao Protheus ou que não possui privilégio suficiente para realizar as ações. É recomendado utilizar um usuário administrador ou semelhante nesta parametrização.

403 - Forbidden
Usuário está autenticado, mas não possui permissão para acesso.
Nas configurações do Quírons, para integração ao Protheus, está sendo informado um usuário possivelmente bloqueado de acesso ao Protheus ou que não possui privilégio suficiente para realizar as ações. É recomendado utilizar um usuário administrador ou semelhante nesta parametrização.

404 - Not Found
Não foi encontrado o recurso.
É altamente recomendado uma atualização do Protheus com os seguintes itens: Pacote de Expedição Contínua do RH, LIB e Appserver.

500 - Internal Server Error
O servidor encontrou uma situação com a qual não sabe lidar, sendo geralmente caracterizado por erros.
É altamente recomendado uma atualização do Protheus com os seguintes itens: Pacote de Expedição Contínua do RH, LIB e Appserver.
Em casos de seguir apresentando o problema, é recomendado realizar a abertura de um chamado à equipe de Suporte, juntamente com o arquivo de console do serviço que disponibiliza as API's/REST, contendo o horário em que a mensagem foi apresentada.

Atualizações
RH - Linha Protheus - MEU RH - Pacote de acumulado do RH no Portal de Cliente
MP- BD - Procedimento para atualizar Lib no Protheus
Cross Segmentos - Backoffice Linha Protheus - Framework - Atualização de arquivos do Protheus 12

Saiba Mais
Documentações sobre Quírons
Artigos sobre Quírons