Descritivo

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

Obs: usando o ws-ard de homologação 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://{HOST_WSARD}/wsard/v1/auth/sitefgw

JSON com as credenciais de acesso:

{
    "LoginTO":{"login": "{SEU_LOGIN}",
    "senha": "{SUA_SENHA}"
}

1.2 Autenticação SiTefGw Full

Método: POST

Endpoint: https://{HOST_WSARD}/wsard/v1/auth/sitefgwfull

JSON com as credenciais de acesso:

{
    "LoginTO":{
        "login": "{SEU_LOGIN}",
         "senha": "{SUA_SENHA}"
    }
}

1.3 Autenticação SiTef Express

Método: POST

Endpoint: https://{HOST_WSARD}/wsard/v1/auth/sitefexpress

JSON com as credenciais de acesso:

{
    "LoginTO":{
        "login": "{SEU_LOGIN}",
        "senha": "{SUA_SENHA}"
    }
}

1.4 Autenticação SiTef Martins

Método: POST

Endpoint: https://{HOST_WSARD}/wsard/v1/auth/sitefmartins

JSON com as credenciais de acesso:

{
    "LoginTO":{
        "login": "{SEU_LOGIN}",
        "senha": "{SUA_SENHA}"
    }
}

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": "{TOKEN_JWT_EXAMPLE}",
"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://{HOST_WSARD}/wsard/v1/vendas?se_cliente={SE_CLIENTE}&data=YYYY-MM-DD

Authentication Bearer:

TOKEN = {TOKEN_JWT_EXAMPLE}

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://{HOST_WSARD}/integracao/login?cod_usuario={SEU_LOGIN}