DT - DVARLIVECP-4045 - Publicação dos métodos do Motor

01. DADOS GERAIS

02. SITUAÇÃO/REQUISITO

Disponibilizar as APIs do motor publicamente para que as consultas e cálculos de promoções não sejam realizadas apenas via client, mas também via servidor.

Métodos:

• ConsultarPromoçõesAtivas
• CalcularPromoção
• FinalizarVenda
• CancelarVenda

03. SOLUÇÃO

Foram disponibilizados os seguintes métodos via web:

• ConsultarPromoçõesAtivas
• CalcularPromoção
• FinalizarVenda
• CancelarVenda

Como melhoria foi adicionada uma validação de token via Header. Para implantação inicial no cliente, solicite a liberação e cadastro do TOKEN para o time de produto.

Seguem abaixo exemplos de chamadas:

• ConsultarPromoçoesAtivas

curl --location --request POST 'http://homologacao.promocoes.live.totvs.com.br/motor-promocoes-web/rest/consulta/consultarPromocoesAtivas' \
--header 'Content-Type: application/json' \
--header 'token: e86f50a5ffac2a9fca143b342086dc69' \
--data-raw '{
"codFilial": "12345678"
}
'

• CalcularPromoção

curl --location --request POST 'http://homologacao.promocoes.live.totvs.com.br/motor-promocoes-web/rest/consulta/calcularPromocao' \
--header 'Content-Type: application/json' \
--header 'token: e12f50a5ffac2a9fca143b342086dc12' \
--data-raw '{
    "identificadorVenda": {
        "codVenda": "1234567890",
        "codFilial": "12345678",
        "codCanalVenda": "PDV",
        "codExternoCanalVenda": "1"
    },
    "produtos": [
        {
            "posicaoItem": 1,
            "codProduto": 1000000,
            "codEmbalagem": 1,
            "qtd": "6",
            "descontoManual": 0,
            "valorUnitario": "100"
        }
    ]
}'

• FinalizarVenda

curl --location --request POST 'http://homologacao.promocoes.live.totvs.com.br/motor-promocoes-web/rest/consulta/finalizar' \
--header 'Content-Type: application/json' \
--header 'token: e12f50a5ffac2a9fca143b342086dc12' \
--data-raw '{
"aliquotas": [
{
"codigoProduto": "1000000",
"cofins": "0",
"icms": "0",
"pis": "0"
}
],
"dataFinalizacao": "2020-11-26T20:00:00",
"identificadorVenda": {
"codCanalVenda": "PDV",
"codExternoCanalVenda": "1",
"codFilial": "12345678",
"codVenda": "1234567890"
}
}'

• CancelarVenda

curl --location --request POST 'http://homologacao.promocoes.live.totvs.com.br/motor-promocoes-web/rest/consulta/cancelar' \
--header 'Content-Type: application/json' \
--header 'token: e12f50a5ffac2a9fca143b342086dc12' \
--data-raw '{
"codCanalVenda": "PDV",
"codExternoCanalVenda": "1",
"codFilial": "12345678",
"codVenda": "1234567890"
}'