Home

Descritivo

  • Tabela de Códigos

    • Especificação dos Arquivos de Retorno

      Descritivo

      Segue um passo a passo do funcionamento basico do WS-ARD:

      Obs: usando o ws-ard de homologação (192.168.54.165) de exemplo

      Passo 1.#

      É necessário que cliente faça a autenticação de acordo com a aplicação utiliza (GW ou Express)

      1.1 Autenticação SiTefGw#

      Método: POST

      Endpoint: https://192.168.54.165:9090/wsard/v1/auth/sitefgw

      JSON com as credenciais de acesso:

      {
      "LoginTO":{"login": "homologacao@softwareexpress.com.br",
      "senha": "Express@1234"
      }

      1.2 Autenticação SiTefGw Full#

      Método: POST

      Endpoint: https://192.168.54.165:9090/wsard/v1/auth/sitefgwfull

      JSON com as credenciais de acesso:

      {
      "LoginTO":{
      "login": "homologacao@softwareexpress.com.br",
      "senha": "Express@1234"
      }
      }

      1.3 Autenticação SiTef Express#

      Método: POST

      Endpoint: https://192.168.54.165:9090/wsard/v1/auth/sitefexpress

      JSON com as credenciais de acesso:

      {
      "LoginTO":{
      "login": "homologacao@softwareexpress.com.br",
      "senha": "Express@1234"
      }
      }

      1.4 Autenticação SiTef Martins#

      Método: POST

      Endpoint: https://192.168.54.165:9090/wsard/v1/auth/sitefmartins

      JSON com as credenciais de acesso:

      {
      "LoginTO":{
      "login": "homologacao@softwareexpress.com.br",
      "senha": "Express@1234"
      }
      }

      Obs: Todos esses endpoinst de autenticação estão apontando para a mesma aplicação que é um emulador do SiTef Express

      Passo 2#

      É retorna um token ao se autenticar com algum dos endpoints anteriors no seguinte formato

      {
      "token":
      "eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJob21vbG9nYWNhb0Bzb2Z0d2FyZWV4cHJlc3MuY29tLmJyIiwicGxhdGFmb3JtYSI6I
      lNJVEVGX0VYUFJFU1MiLCJjbGllbnRlcyI6W3sic2VDbGllbnRlIjoiMjAwMDIxNyIsImNucGoiOiI2MC42MjEuOTkyLzAwMD
      EtMDQifSx7InNlQ2xpZW50ZSI6IjIwMDAyNzYiLCJjbnBqIjoiMTIzIn0seyJzZUNsaWVudGUiOiIyMDAxMDg0IiwiY25waiI6Ij
      M0NSJ9LHsic2VDbGllbnRlIjoiMjAwMDI4NSIsImNucGoiOiI1NjcifSx7InNlQ2xpZW50ZSI6IjIwMDYwOTMiLCJjbnBqIjoiNz
      g5In0seyJzZUNsaWVudGUiOiIyMDAwODU5IiwiY25waiI6IjY1NSJ9XSwiZXhwIjoxNTg5NDExNTQwLCJpYXQiOjE1ODkzOT
      M1NDB9.nugw7CuaA1pQ4bYWq35zWouC-REMUi-R47zezPIRSfePVBG4RJuomEL-
      Of4FDp686OuRO2qz_u2JbHmZBQttXg",
      "type": "Bearer"
      }

      Esse token é utilizado para chamar os endpoints que devem retornar os dados do extrato, segue exemplo de endpoint:

      2.1 Endpoint Vendas#

      Método: GET

      Endpoint: https://192.168.54.165:9090/wsard/v1/vendas?se_cliente=2000217&data=2019-01-10

      Authentication Bearer:
      TOKEN =
      eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJob21vbG9nYWNhb0Bzb2Z0d2FyZWV4cHJlc3MuY29tLmJyIiwicGxhdGFmb3JtYSI6Il
      NJVEVGX0VYUFJFU1MiLCJjbGllbnRlcyI6W3sic2VDbGllbnRlIjoiMjAwMDIxNyIsImNucGoiOiI2MC42MjEuOTkyLzAwMDE
      tMDQifSx7InNlQ2xpZW50ZSI6IjIwMDAyNzYiLCJjbnBqIjoiMTIzIn0seyJzZUNsaWVudGUiOiIyMDAxMDg0IiwiY25waiI6Ij
      M0NSJ9LHsic2VDbGllbnRlIjoiMjAwMDI4NSIsImNucGoiOiI1NjcifSx7InNlQ2xpZW50ZSI6IjIwMDYwOTMiLCJjbnBqIjoiNz
      g5In0seyJzZUNsaWVudGUiOiIyMDAwODU5IiwiY25waiI6IjY1NSJ9XSwiZXhwIjoxNTg5NDExNTQwLCJpYXQiOjE1ODkzOT
      M1NDB9.nugw7CuaA1pQ4bYWq35zWouC-REMUi-R47zezPIRSfePVBG4RJuomEL-
      Of4FDp686OuRO2qz_u2JbHmZBQttXg

      Obs:

      1. O Token utilizado para na autenticação tem um tempo, apos esse tempo ele fica invalido.
      2. Os outros endpoints estão disponiveis em: Documento de integração com WS-ARD.docx
      3. O endpoint abaixo retorna os SE Cliente que o usuario tem acesso:

      Método: GET

      Endpoint:

      http://192.168.54.165:9091/integracao/login?cod_usuario=homologacao@softwareexpress.com.br