Home

Descritivo

  • Tabla de códigos

    • Especificación de Archivos de devolución

      Descritivo

      A continuación se muestra un paso a paso del funcionamiento básico del WS-ARD:

      Nota: utilizando el ws-ard de aprobación (192.168.54.165) de ejemplo

      Paso 1.#

      Es necesario que el cliente se autentique según la aplicación que utilice. (GW o Express)

      1.1 Autenticación SiTefGw#

      Método: POST

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

      JSON con credenciales de acceso:

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

      1.2 Autenticación SiTefGw Full#

      Método: POST

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

      JSON con credenciales de acceso:

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

      1.3 Autenticación SiTef Express#

      Método: POST

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

      JSON con credenciales de acceso:

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

      1.4 Autenticación SiTef Martins#

      Método: POST

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

      JSON con credenciales de acceso:

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

      Nota: Todos eses endpoinst de la autenticación apunta a la misma aplicación que es un emulador. SiTef Express

      Paso 2#

      Devuelve un token al autenticarse con uno de los endpoints anterior en el siguiente formato

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

      Este token se usa para llamar los endpoints que debería devolver los datos extraídos, sigue el ejemplo 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

      Nota:

      1. El token utilizado para la autenticación tiene un tiempo, después de este tiempo se vuelve inválido.
      2. Os outros endpoints están disponibles en: Documento de integração com WS-ARD.docx
      3. El endpoint a continuación devuelve el SE Cliente que el usuario tiene acceso:

      Método: GET

      Endpoint:

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