Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Linha de Produto:Franquias e Redes
Segmento:Varejo
Módulo:Motor de Promoções
Função:Web
Ticket:
Requisito/Story/Issue (informe o requisito relacionado) :DVARLIVECP-4045


02. SITUAÇÃO/REQUISITO

Narrativa: Disponibilizar as APIs do motor publicamente .

Eu como usuário TOTVS Motor de Promoções 
Desejo que ao efetuar a chamada dos Métodos: ConsultarPromoção, CalcularPromoção, FinalizarVenda, CancelarVenda
Permitindo que seja consultado e realizado os procedimentos via API sem precisar de client instalado

Métodos:

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

...

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"
}'


Templatedocumentos


HTML
<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}
</style>

...