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 e Token) 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 e Token) 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. |