Histórico da Página

Objetivo

Orientar a configuração no Monitor de PDV para a utilização da API de inteiração de Parceiros com o PDV Consinco.

Princípios Básicos

Caminho de Acesso

Configurações > Configurações de PDVs > Integrações externas.

Autenticação

Opcionalmente, a autenticação poderá ser feita utilizando o HTTP Basic Auth, com usuário e senha configurados no Monitor de PDVs.

Configurações de Integrações

Nas configurações de inteirações poderão ser cadastrado até quatro parceiros.

Código do parceiro

Cadastrar o código do parceiro que realizará a inteiração com a API PDV. A aplicação de cadastro de código de parceiros, está presente no Monitor Plus, no caminho: Cadastros > Cadastro de parceiros.

Tela de cadastro de parceiros:

Image AddedImagem 1 – Tela Cadastro de Parceiros

Intervalo

Intervalo de espera entre as requisições na API, deve ser cadastrado valores em milissegundos.

Solicitar cupom desconto

Quando a solicitação de cupom estiver ativa, será apresentado ao operador do PDV uma caixa de diálogo perguntando se o cliente tem cupom de desconto, caso a opção seja “Não”, a caixa se fecha e a operação do PDV seguirá normalmente, caso a opção seja “Sim”, abrirá uma outra caixa de diálogo para que seja digitado o número do cupom.

Timeout de leitura

Intervalo de espera para resposta da API do parceiro, caso a API não tenha nenhum retorno nesse intervalo ocorrerá uma falha de comunicação e apresentará um erro para a operadora, deve ser cadastrado valores em milissegundos.

Autenticação

Opcionalmente, a autenticação poderá ser feita utilizando o HTTP Basic Auth, com usuário e senha configurados no Monitor de PDVs.

Eventos

Início da venda

O evento(ação) ocorrerá antes de registrar qualquer item ou qualquer identificação de pessoas.

• URL: Configurar a URL conforme exemplo: http://tp: porta.
• Timeout de Leitura :Configurar o tempo de espera, em milissegundos, para resposta da API do parceiro conforme exemplo: 5000.

Subtotal da venda

O evento(ação) ocorrerá antes de iniciar o pagamento da venda.

• URL: Configurar a URL conforme exemplo: http://tp: porta.
• Timeout de Leitura :Configurar o tempo de espera, em milissegundos, para resposta da API do parceiro conforme exemplo: 5000.

Finalização da venda

O evento(ação) ocorrerá após o pagamento e fechamento do cupom.

• URL: Configurar a URL conforme exemplo: http://tp: porta.
• Timeout de Leitura :Configurar o tempo de espera, em milissegundos, para resposta da API do parceiro conforme exemplo: 5000.

Ticket estacionamento final da venda

O evento(ação) ocorrerá após o pagamento e fechamento do cupom.

• URL: Configurar a URL conforme exemplo: http://tp: porta.
• Timeout de Leitura :Configurar o tempo de espera, em milissegundos, para resposta da API do parceiro conforme exemplo: 5000.

Cancelamento da venda

O evento(ação) ocorrerá quando o operador do PDV realizar o cancelamento da venda.

• URL: Configurar a URL conforme exemplo: http://tp: porta.
• Timeout de Leitura :Configurar o tempo de espera, em milissegundos, para resposta da API do parceiro conforme exemplo: 5000.

Vender item

O evento(ação) ocorrerá após a inserção de um item na venda, após o cancelamento de um item ou após o item não ser registrado (produto não identificado ou não cadastrado).

• URL: Configurar a URL conforme exemplo: http://tp: porta.
• Timeout de Leitura :Configurar o tempo de espera, em milissegundos, para resposta da API do parceiro conforme exemplo: 5000.

Pagamento da venda

O evento(ação) ocorrerá antes de realizar um pagamento.

• URL: Configurar a URL conforme exemplo: http://tp: porta.

• Número da forma de pagamento: Configurar o número da forma de pagamento associada ao parceiro.

• Timeout de Leitura :Configurar o tempo de espera, em milissegundos, para resposta da API do parceiro conforme exemplo: 5000.

Imagem geral da aplicação do Monitor:

Image Added

Imagem 2 – Aplicação do Monitor

Menu venda fechada

O evento(ação) ocorrerá quando o PDV estiver aberto e não pode haver uma venda em andamento. Para que a função seja exibida no menu deve-se configurar as devidas permissões no Monitor. As permissões devem ser aplicadas individualmente para cada integração configurada com parceiro.

Exemplo de configuração de permissões:

Image Added

• URL: Configurar a URL conforme exemplo: http://ip: porta.
• Timeout de Leitura :Configurar o tempo de espera, em milissegundos, para resposta da API do parceiro conforme exemplo: 5000.

Descrição do menu

Nome que deverá ser exibido na lista ao acionar a tecla de funções, caso nenhuma descrição seja definida será apresentado o valor padrão, por exemplo, “Menu integração 1”.

Image Added

Tratamento de contingência com uso de regra de desconto

Para tratamento de problemas de falhas relacionada a comunicação na identificação do consumidor será solicitado a identificação fora do fluxo da API, ao informar CPF do cliente independente se o mesmo está ativo, entrará nas regras de descontos, abaixo como ativar.

No servidor de PDVs no AcruxMonitor:

Image Added

Pode-se utilizar regras de desconto, quando falhar a comunicação será verificado se existe algum produto do cupom na regra de incentivo de contingência, será consultado o percentual ou preço com desconto no banco de dados na estrutura abaixo, para ativar o contingenciamento precisa apenas informar o número da regra de incentivo (Tipo de crédito = 13) na parametrização do servidor de PDVs.

Image Added