Atualize as rotinas abaixo a partir da versões indicadas ou versões superiores: - Rotina 2000- Atualizar Procedure do Auto-Serviço 30.4.0.185;
- Rotina WTA - 801 - Atualização de Serviços Web(WTA) - Tabela PCBANDEIRASITEF:
- PCBANDEIRASITEF - Versão 1.3.01.00 ou superior;
- WINTHOR-VAREJO - Versão 1.0.1.3 ou superior;
Passo a passo: - Acesse no WTA - a rotina 801 - Atualização de Serviços Web, pesquise
- Pesquise por Varejo e instale a o serviço que possui como dependência de banco banco a tabela PCBANDEIRASITEF;
- Pesquise e atualize o serviço WINTHOR-VAREJO;
Image Modified
- Abra a rotina 2000 -Atualizar Procedure do Auto-Serviço e selecione a opção Ajustar códigos e nomes de bandeiras do SiTef (Bandeira SiTef Padrão versão 2.59) ” ”;
- Após selecionar, clique no botão botão Atualizar e e após a execução, feche a rotina para que atualização do banco seja efetuada;
Image Modified
API Varejo - Dados do Cupom Fiscal e Operador/Fiscal de Caixa Endpoint /operators/
GET - Consulta Operadores de Caixa e Supervisores de Caixa
Nesta requisição são listados todos os funcionários ativos com acesso ao PDV, operadores de caixa e fiscais de caixa.
Exemplo da Requisição
curl --location --request GET 'http://localhost: |
---|
8485/api/retail/v1/mercafacil/operators/' GET/api/retail/v1/mercafacil/operators/
|
---|
Host exemplo https84Reposta da requisição Caso esteja autenticado no WTA, a resposta será retornada no seguinte formato:
Status 200 OK "access_token"name": "SILVIO SANTOS FARIA LIMA", "document_no": " |
---|
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9eyJpc3MiOiJUT1RWUy1BRFZQTC1GV0pXVCIsInN1YiI6Im1hcmlvIiwiaWF0IjoxNTUzMDIyMjYwLCJleHAiOjE1NTMwMjU4NjAsInJlc3RyaWN0ZWR0byI6WyJhcGkvcHJvdGhldXMvIiwiYXBpL2ZyYW1ld29yay8iXX0.jgvejFxPYDchLtj04r7mizRZCerb7xFXhB8Ihk+kFqg=refresh_token": "YEv3dtFbNCisITD3yDtKi5/x.T0jkPv12SWK/JjWS0xI01YbIXWM10KWw2ehCxG9yRVkXCiItBYN57Rizh4OH67m7H3-Jd-3ruC4/pBAWBkXVO251HPiS91KAh7FfbZqWaiDPmvYBvoiaP4KRR1gYcvCr9ES7wC3iRA2wQrQvODlH7b3FCTmvHzCVmRMi4eApgy4iOGVpBK7-ryI=.fD77MI4MBk1rW6eBjMq9EutN1ZIC1YKKuKqdEhbLf/k=" , "scope" : "default" , "token_type" : "Bearer" , "expires_in" : 3600 } Observações:O birth_date": "1998-05-29 00:00:00.0", "gender": "F" } |
---|
Endpoint /coupons/
GET - Cupons Fiscais
Nesta requisição são listados todos os cupons fiscais emitidos na data informada.
curl --location --request GET 'http://localhost:85/api/retail/v1/mercafacil/coupons?date=10/09/2021' GET/api/retail/v1/mercafacil/operators/ Host exemplo: https://localhost:85 Query Params: date={dd/mm/yyyy} |
---|
Reposta da requisição Caso esteja autenticado no WTA, a resposta será retornada no seguinte formato:
Status 200 OK
{ "origin": "pdv", "transaction_id": "10001064", "client_id": "11111111111", "operator_id": "1", "pdv_code": "1", "coupon": "110092021103011204", "total_value": 9.5, "total_value_with_discount": 9.5, "date": "2021-09-10", "time": "10:30", "items": [ { "product_name": "CIGARRO DUNHILL CARLTON BLEND", "sku": "100", "ean": "100", "departament": "CIGARRO DUNHILL CARLTON BLEND", "group": "BAZAR", "family": "CIGARRO/ISQUEIRO", "unit_value": 9.5, "quantity": 1, "total_value": 9.5, "total_value_with_discount": 9.5 } ], "payments": [ { "payment_form": "other", "amount": 9.5, "acquirer_id": "05", "acquirer_name": "", "authorizer_id": "00002", "authorizer_name": "MASTERCARD", "instalments": 1 } ] } |
---|
Exemplos das requisições feitas via Postman:
/operators/
Image Added
/coupons?date=10/09/2021
Image Added
Observações:
- Para utilizar os recursos da API, o usuário deverá estar autenticado. Caso essa autenticação seja via API, siga os passos seguintes:
Endpoint /login/
POST - Login Winthor/WTA
Nesta requisição é feito o login no ambiente Winthor / WTA.
Body -JSON
{ "login": "{{Usuário}}", "senha": "{{Senha}}" }
|
---|
No campo senha, utilize a senha do Winthor / WTA codificado no padrão MD5 (pode ser feito com ferramentas on-line, por exemplo MD5 Hash Generator ) e com letras em caixa alta.
Exemplo:
Usuário: admin Senha: 1
Senha após codificar para MD5 = C4CA4238A0B923820DCC509A6F75849B
Image Added
Reposta da requisição Caso o login seja efetuado com sucesso retornará Status 200 OK .
|