Árvore de páginas

CONTEÚDO

  1. Visão Geral
  2. Exemplo de utilização
  3. Tela Calcular desconto não aplicado
    1. Outras Ações / Ações relacionadas
  4. Tela Calcular desconto não aplicado
    1. Principais Campos e Parâmetros
  5. Tabelas utilizadas
  6. Tecnologias Homologadas

01. VISÃO GERAL

Permite calcular o valor do desconto não aplicado devido à ausência de identificação do cliente no parceiro, conforme as regras configuradas no PDV.

02. EXEMPLO DE UTILIZAÇÃO

Caminho

Monitor PDV / Configurações / Configurações de PDVs / Integrações externas / Vendas

Monitor PDV / Configurações / Configurações de PDVs / Regras de negócios / Regras de incentivos

Pré-Requisitos e Restrições

Ter acesso ao monitor para realizar as configurações necessárias.

Este recurso está disponível apenas para a regra de incentivo por produto, forma de pagamento e parceiro, desde que o parâmetro Aplicar desconto no item esteja configurado com o valor diferente de Não.

O recurso deverá ser utilizado no evento do subtotal(cotSubtotalSale).

Passo a Passo

Configurações no Monitor PDV

Acesse o Monitor PDV de um navegador na URL http://<ipservidor>/monitorpdv. Troque os símbolos maior e menor e o que está entre eles pelo IP do servidor.

Na sequência informe um Usuário e Senha com permissão para acessar a aplicação.

No menu lateral do lado esquerdo, acesse Configurações e depois Configurações de PDV.

Na tela de Configurações de PDVs, no menu superior, informe a Loja, o Segmento e os PDVs que receberão as novas configurações. Em seguida, clique no botão Carregar Parâmetros.

Imagem 1 - Tela de configurações de PDVs.

Acesso o grupo Integrações externas > Vendas.

Escolha uma das 4 integrações disponíveis.

Informe o Código do parceiro.

Imagem 2 - Código do parceiro.

Acesse o grupo o Eventos > Subtotal da venda.

Configure a URL, para acionar o evento.

Imagem 4 - Evento subtotal.

Acesse o grupo o Eventos > Finalização de venda.

Configure o evento de finalização da venda para receber o valor do desconto não aplicado.

Configure a URL para acionar o evento.

Imagem 4 - Evento de finalização da venda.

Certifique-se que o parâmetro Aplicar desconto no item esteja configurado com o valor diferente de Não.

Acesse o grupo Regra de negócios > Regras de incentivos.

Imagem 4 - Parâmetro do tipo de desconto.

Operação de comunicação na API do PDV

Durante a operação do subtotal, o PDV realiza uma requisição no evento de subtotal. Quando isso ocorrer, o parceiro deverá responder com o status completado (cetCompleted) e enviar o número da forma de pagamento na propriedade PayNumberUnappliedIncentive.

A estrutura de requisição e resposta do evento subtotal contém apenas as propriedades essenciais para realizar a operação de cálculo do desconto não aplicado. Para consultar todas as propriedades disponíveis, verifique a documentação completa do Subtotal da venda

Veja a baixo a estrutura de requisição e resposta.

Requisição pagamento

{
    "Event": "cetBefore",
    "Execution": "cetContinue",
    "ID": "001032001458503",
    "Operation": "cotSubtotalSale",
    "Version": 1
}

Resposta pagamento

{
    "return": {
        "PayNumberUnappliedIncentive": 1
    },
    "execution": "cetCompleted"
}


Na finalização da venda, será enviado o valor do desconto que não foi aplicado na propriedade DiscountNotApplied.

A estrutura de requisição e resposta do vendo de finalização da venda, estão apenas com as propriedades necessárias para realizar a operação de calcular o desconto não aplicado, para verificar as todas as propriedades disponíveis consulta a documentação finaliza da venda.

Requisição finalização de venda

{
    "Event": "cetBefore",
    "Execution": "cetContinue",
    "ID": "001032001458503",
    "Operation": "cotEndSale",
    "Sale": {
        "DiscountNotApplied": 0.50
    },
    "Version": 1
}

Resposta finalização de venda

{
  "execution": "cetCompleted"
}


03. TELA Calcular desconto não aplicado

Não há.

04. TELA Calcular desconto não aplicado

Principais Campos e Parâmetros

CampoDescrição
Subtotal da vendaEvento de subtotal 
Finalização da vendaEvento finalização da venda

05. TABELAS UTILIZADAS

Não há.

06. TECNOLOGIAS HOMOLOGADAS

O uso do Tipo de Produto em diferentes tecnologias não homologadas, como em Sistema Operacional, Plataforma, Navegadores e outros dispositivos, pode comprometer a segurança dos sistemas e está sujeito a situações não previstas, sem cobertura de suporte.
Tipo de produto
  • PDV
Sistema Operacional
  • Linux
  • Windows Desktop
Plataforma
  • Desktop
Navegador
  • N/A (não se aplica)
Utilização/Experiência
  • Aplicações Desktop em geral
  • Aplicações Web em geral