A API de Web Query permite a extração de relatórios via API com base nas Web Querys do Bseller,
podendo ser extraídas em formatos (.JSON) e Excel (.XLSX)
Link Swagger API - DW de Produção: https://api-dw.bseller.com.br/swagger-ui.html
Para extração de relatórios no BSeller, é nessário:
- Ter um token do BSeller ativo e com as devidas permissões.
- Obter os parâmetros do relatório desejado.
- E Depois executá-lo para obter o relatório em formato JSON ou EXCEL.
IMPORTANTE:
Para extração de relatórios que contenham informações do WMS, é preciso que o usuário de sistema a qual o token pertence, deve ser habilitado e liberado na tela de plantas do WMS conforme documentação: Gestão de Estoque Físico - Operador, caso o usuário não tenha acesso a(s) plantas do WMS, os relatórios retornarão vazios, mesmo que exista informações para a pesquisa realizada.
Os exemplos citados nesta documentação, foram realizados através do programa POSTMAN.
1- Consultando os parâmetros do relatório.
Na API de Consulta (Consulta parâmetros webquery por código da webquery) serão retornados os parâmetros que serão utilizados na execução da WQ, é necessário informar o código da WebQuery a qual se deseja extrair os dados, no exemplo em questão foi utilizada a WQ SIGEQ230
Ex:
http://api-dw.bseller.com.br/webquery/parametros/SIGEQ230
--> Autenticação (header) utilizada para retornar dados em formato JSON.
Header | Value |
X-Auth-Token | "*Use seu Token de autenticação*" |
Content-Type | application/json |
-> API (GET) (exemplo): https://api-dw.bseller.com.br/webquery/parametros/SIGEQ230
Após execução da API em modo GET informando o ID da WQ desejada, será retornado os parâmetros dela.
Exemplo:
A API retorna os parâmetros disponíveis referente ao relatório que foi informado na execução.
no exemplo em questão, são eles:
2 - Executando o relatório.
2.1 Retorno de dados na API (JSON).
Acesse a API (Execução da webquery retornando listagem) e informe o id do relatório a ser executado.
Método POST: https://api-dw.bseller.com.br/webquery/execute/SIGEQ230
BODY (Corpo da API):
É preciso ser preenchido com os parâmetros que foram obtidos na chamada da API anterior
"Consulta parâmetros webquery por código da webquery".
Lembrando que nessa execução serão utilizados os nomes dos parâmetros obtidos no passo anterior,
todos os parâmetros devem ser colocados no "body", mesmo os parâmetros que não estão identificados como obrigatórios, caso não necessite usar um determinado parâmetro de busca, apenas informe nele o valor null .
Exemplo:
{
"parametros": {
"P_ID_CIA": 00000,
"P_ID_CONITE":1,
"P_ID_DEPART":1,
"P_ID_FORNEC":52135653000181,
"P_DT_INCL_INI": "20/09/2019",
"P_DT_INCL_FIM": "01/10/2019"
}
}
Clique em "Send":
Com tudo preenchido corretamente, serão retornados os dados do relatório executado.
Erros:
Caso o parâmetro esteja incorreto, ou seja, obrigatório e não for informado, serão exibidas mensagens de erro.
exemplo:
--> Não foi informado um parâmetro obrigatório: "P_ID_CIA".
Mensagem de erro:
--> Foi informado um parâmetro incorreto, (Ao invés de informar que o parâmetro "P_ID_DEPART" tem o valor "1", foi informado o valor "A")
Mensagem de erro:
--> Nos relatórios que possuem parâmetro de DATA, como por exemplo ("P_DT_INCL_INI" e "P_DT_INCL_FIM") é obrigatório que a data mais antiga fique no campo inicial ("P_DT_INCL_INI") e a mais recente no campo final "P_DT_INCL_FIM", senão o relatório não trará os dados solicitados.
2.2 Retorno de dados em formato Excel.
Para execução em formato Excel o body permanece o mesmo do exemplo anterior, sendo necessário alterar apenas o link da api e o modelo de autenticação.
--> Autenticação (header) utilizada para retornar dados em formato de arquivo Excel.
Header | Value |
X-Auth-Token | "*Use seu Token de autenticação*" |
Accept | application/vnd.openxmlformats-officedocument.spreadsheetml.sheet |
Com os parâmetros adquiridos, acesse a API "Execução da webquery retornando excel"
executando uma chamada do tipo POST informando os parâmetros adquiridos.
-> API (POST): https://api-dw.bseller.com.br/webquery/execute-excel/SIGEQ230
Clique na seta ao lado do botão "Send" e selecione "Send and Download".
Após execução será realizado o download do relatório em formato de arquivo Excel.
Comentários
0 comentário
Artigo fechado para comentários.