Regras de negócio

O procedimento de autenticação é realizado utilizando o usuário e senha válidos e vinculado ao SankhyaID, e deve ser o primeiro passo em uma sessão de chamadas de serviços.
Com uma autenticação é possível chamar outros serviços em sequência, como por exemplo os serviços loadrecords e saverecords. Isso porque o bearer token obtido a partir dessa requisição é que deverá ser informado no cabeçalho das chamadas subsequentes, permite que a sessão fique aberta pelo período definido no sistema, que por padrão são 30 minutos de inatividade.
Para alterar o tempo de expiração do bearer token acesse a tela Preferências no SankhyaOM e altere o parâmetro INATSESSTIMEOUT, que pode varia de 1 à 30 minutos.
Atenção: A URL para o login é específica e diferente das demais requisições: https://api.sankhya.com.br/login
No entanto, é fortemente recomendado realizar logoff após realizar as requisições desejadas. Veja a seguir um fluxo de integração recomendado:

1. login
2. requisição 1
3. requisição 2
4. requisição N
5. logout

Dependências

- O Token é gerado na tela Configurações Gateway do SankhyaOm que deseja realizar a integração.

Detalhes Técnicos:

Corpo de requisição para realizar login

  {
      curl --location --request POST 'https://api.sankhya.com.br/login' \
      --header 'token: 8fedf240-ea7f-11ed-a05b-0242ac120003' \
      --header 'appkey: db654b42-ea7f-11ed-a05b-0242ac120003' \
      --header 'username: [email protected]' \
      --header 'password: *******' \
      --data-raw '
  }

Retorno em json:

  {
      "bearerToken": "bearerToken_da_sessao_ativa_retorna_bem_aqui",
          "error": null
  }
  

Corpo de requisição para realizar logout

  {
      curl --location 'https://api.sankhya.com.br/gateway/v1/mge/service.sbr?serviceName=MobileLoginSP.logout&outputType=json' \
      --header 'appkey: db654b42-ea7f-11ed-a05b-0242ac120003' \
      --header 'Content-Type: application/json' \
      --header 'Authorization: Bearer bearerToken_da_sessao_ativa_enviado_bem_aqui'
  }
  

Retorno em json:

  {
      "serviceName": "MobileLoginSP.logout",
      "status": "1",
      "pendingPrinting": "false",
      "transactionId": "F35F4D5A07D74B06C86301D00E897ADC",
      "responseBody": {}
  }