Nesta seção, são listados os principais códigos de retorno da API Sankhya, acompanhados de suas mensagens correspondentes para referência. Além disso, são fornecidas orientações detalhadas sobre como lidar com cada situação, de acordo com o código retornado. O objetivo é facilitar a identificação e resolução de problemas durante o uso da API.

🚧
Atenção
Mensagens de erro, retornadas com "Status Code" 200, estão relacionadas a regras de negócio do SankhyaOm.
Para identificar o motivo do retorno, clique aqui, faça uma pesquisa utilizando o código do erro desejado como critério e veja detalhes em nossa página de ajuda.

Status Code	Code Gateway	Mensagem	Tratativa
200	-	Mensagens com código de erro iniciando com [CORE_Exxxxx] (onde xxxxx é um número interiro que varia de acordo com a regra no SankhyaOm) retornadas pela requisição.	Essas mensagens estão relacionadas a regras de negócio do SankhyaOm. Para identificar o motivo do retorno, clique aqui, faça uma pesquisa utilizando o código do erro desejado como critério e veja detalhes em nossa página de ajuda.
400	GTW2500	Erro inesperado na requisicao.	Verifique a estrutura da requição e tente novamente.
400	GTW2509	O atributo offsetPage é obrigatório para este tipo de consulta.	Utilize o atributo offsetPage para a paginação. Clique aqui e veja os atributos necessários para realizar uma consulta.
400	GTW2508	Erro na comunicacao com o servico de autenticacao.	Erro de comunicação interna do gateway com os serviços de autenticação. Tente realizar a requisição novamente em alguns instantes.
400	GTW3003	Erro na comunicação com o Console.	Erro de comunicação interna do gateway. Tente realizar a requisição novamente em alguns instantes.
400	GTW3407	Não foi possivel realizar login no erp.	Verifique se o ambiente do SankhyaOM está disponível. Clique aqui e veja os requisitos necessários para acessar o ambiente do SankhyaOm via gateway.
400	GTW3500	Erro na comunicação com o SankhyaID.	Não foi possível realizar login com as credencias (SankhyaID) enviadas. Clique aqui e valide as credencias de acesso.
401	GTW2510	O Header Authorization é obrigatório para esta requisição.	Adicione ao Header o BearerToken. Clique aqui e veja os requisitos necessários para realizar uma requisição.
401	GTW2511	Header Authorization fora do padrão. Não começa com 'Bearer ' ou não contém o JWT.	Adicione ao Header o BearerToken. Clique aqui e veja os requisitos necessários para realizar uma requisição.
401	GTW3501	Usuario Invalido.	Verifique as credenciais (SankhyaID) para login. Clique aqui e veja os requisitos necessários para realizar uma requisição de login.
401	GTW3502	Password Invalido.	Verifique as credenciais (SankhyaID) para login. Clique aqui e veja os requisitos necessários para realizar uma requisição de login.
401	GTW3503	Excedido o tempo máximo da Requisição do Gateway Sankhya.	Verifique se o ambiente do SankhyaOM está disponível. Clique aqui e veja os requisitos necessários para acessar o ambiente do SankhyaOm via gateway.
403	GTW3403	Bearer Token inválido ou Expirado.	Faça login, atualize o BearerToken e tente novamente. Clique aqui e veja os requisitos necessários para realizar uma requisição de login.
403	4405	Token e Appkey nao associados.	Verifique as credenciais (Appkey, Token e URL utilizados - combine corretamente as credenciais para acesso de acordo com o ambiente PRODUÇÃO ou SANDBOX) para login. Clique aqui e veja os requisitos necessários para realizar uma requisição de login.
403	4303	Token invalido ou inativado.	Verifique as credenciais (Appkey, Token e URL utilizados - combine corretamente as credenciais para acesso de acordo com o ambiente PRODUÇÃO ou SANDBOX) para login. Clique aqui e veja os requisitos necessários para realizar uma requisição de login.
500	-	Erro interno do servidor	Retorno padrão do servidor.
501	-	Not Implemented	Retorno padrão do servidor.
502	-	Bad Gateway	Retorno padrão do servidor.
503	-	Serviço Indisponível	Retorno padrão do servidor.
504	-	Gateway Timeout	Quando a requisição ultrapassa 2 minutos de processamento. Geralmente ocorre quando o SankhyaOm demora para processar a requisição.

Links Úteis