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 PCBANDEIRASITEFbanco a tabela PCBANDEIRASITEF;
- Pesquise e atualize o serviço WINTHOR-VAREJO;
- 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 Atualizar e após a execução, feche a rotina para que atualização do banco seja efetuada;
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:85/api/retail/v1/mercafacil/operators/'
GET/api/retail/v1/mercafacil/operators/
Host exemplo: https://localhost:85 |
|---|
Reposta da requisição Caso esteja autenticado no WTA, a resposta será retornada no seguinte formato:
Status 200 OK {
"id": "8889",
"name": "SILVIO SANTOS FARIA LIMA",
"document_no": "001.000.005-00",
"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' |
|---|
\--data-raw ''
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/
/coupons?date=10/09/2021
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 .
|
