MANUAL DE USUÁRIO


PROMO v7.2




Índice 




Capítulo 1 - Sobre o manual


Finalidade e âmbito


O objetivo deste manual do usuário é treinar o usuário que deseja usar o PROMO para gerenciar suas promoções.

Ele fornece instruções passo a passo detalhadas para ajudá-lo a criar e gerenciar promoções por meio do console de administração do PROMO , além de detalhar conceitos e definições para cada componente do produto.


Conteúdo



Capítulo 1 - Sobre o manual
Contém descrições gerais sobre o conteúdo do manual.

Capítulo 2 - Introdução
Contém uma introdução ao produto PROMO e sua composição.

Capítulo 3 - Console de Administração
Contém conceitos gerais sobre o uso do console, como conexões e navegação no menu.

Capítulo 4 – Módulo Dashboard
Descreve-se a operação de utilização do Dashboard.

Capítulo 5 –  Módulo de Funcionamento
Descreve-se o funcionamento para criação e administração de Departamentos, Campanhas, Promoções, Templates de Promoção, registo massivo de promoções e Workflow.

Capítulo 6 – Módulo Workflow
Descreve-se o procedimento para criação e gestão do Workflow de Promoções e Tabelas de Preços.

Capítulo 7 –  Módulo de Distribuição
Descreve-se a operação de criação, alteração e distribuição de mapas, simulação de promoções e mapas e distribuição nas redes sociais.

Capítulo 8– Módulo Preços
Descreve-se o funcionamento para a criação e administração de Listas de Preços.

Capítulo 9 – Módulo Fidelidade
Descreve-se o procedimento de criação, edição e gestão dos elementos Fidelidade (Cupões e Elementos).

Capítulo 10 – Módulo de Relatórios
Descreve os relatórios que podem ser gerados dentro do PROMO .

Capítulo 11 - Módulo Negócios
Contém as configurações especiais que podem ser feitas através do console de administração do PROMO , como cadastro de Unidades Departamentais, Empresas, Regiões e Lojas.

Capítulo 12 - Módulo de Administração
Descreve as configurações disponíveis para o console PROMO .

Capítulo 13 – Módulo de Segurança
Descreve-se o funcionamento da administração e configuração de usuários e acessos.

Capítulo 14– Módulo de Alarmes
Descreve-se a operação de configuração e notificações de alarmes.

Capítulo 15 – Módulo de Suporte
Descrevem-se as operações de administração da base de dados e as opções de gerenciamento de suporte. Fornece informações sobre questões consideradas com frequência.

Capítulo 16 - Promoções Modelo

São explicados os passos para a montagem de promoções habituais cadastradas em PROMO.



 referências práticas


NOTA

Ele será usado para destacar esclarecimentos sobre o tema atual. 


IMPORTANTE

Será utilizado para indicar ao usuário sobre os cuidados que devem ser considerados.


Documentação da PROMOÇÃO

A PROMO fornece a seguinte documentação:


  • " Manual de Integração " - ("MANUAL DE INTEGRAÇÃO - PROMO v7.2").
    Este documento descreve detalhadamente as mensagens que devem ser enviadas ao Motor de Promoções e a forma de interpretação das mensagens de resposta que este dará a um pedido.


  • " Manual do Usuário " - ("MANUAL DO USUÁRIO - PROMO v7.2"). 
    O objetivo deste manual do usuário é servir como uma ferramenta de referência e consulta para todos os usuários que desejam usar o PROMO, para a administração de suas promoções, cupons e tabelas de preços.


Capítulo 2 - Introdução

O que é PROMO?

PROMO é uma solução que permite separar a gestão das promoções do ponto de venda. Permite definir um leque alargado de promoções e é extensível sem necessidade de efetuar alterações aos pontos de venda.

O PROMO elimina a codificação e a dependência de manutenção, reduz os tempos de implementação e teste. Possui uma interface gráfica que chamaremos de Console Administrativo - PROMO , que facilita o cadastro de uma promoção, tornando-o um processo rápido e intuitivo. Essa qualidade agiliza o processo de saída de uma promoção.
O PROMO foi concebido como uma ferramenta extremamente útil e fácil de usar destinada aos varejistas, para que eles possam gerenciar de forma centralizada as promoções atuais em diferentes regiões e locais.

No PROMO você pode construir promoções por composição de condições (combos), promoções definidas por condições simples, criar benefícios, conceder cupons e pontos fidelidade, podendo configurar os parâmetros correspondentes a cada promoção conforme a necessidade.

Também permite a criação de modelos de promoção que podem ser usados ​​para upload em massa de promoções no console Promo, economizando tempo de criação e maior confiança na consistência da promoção.
Regras de convivência e pedidos de aplicação poderão ser definidos entre as promoções vigentes. Esses parâmetros serão utilizados, por meio de algoritmos altamente eficientes, para determinar o conjunto de promoções que participam de uma determinada venda. Essas promoções serão informadas ao ponto de venda, que se encarregará de aplicar as promoções informadas por PROMO no ticket.

PROMO oferece a possibilidade de gerir de forma centralizada os cupões, registar as transações que os emitem e manter estatísticas (KPI) das transações e cupões registados, bem como gerir de forma centralizada os elementos de fidelização, gerindo os diferentes perfis de elementos de fidelização e os seus movimentos.

PROMO permite registar estornos de elementos de fidelização de devoluções ou notas de crédito efetuadas no ponto de venda onde se trate de cupões e elementos de fidelização.

A partir da consola de administração do PROMO também é possível gerir e configurar alarmes que servirão de aviso em caso de ocorrência de determinados eventos, bem como um módulo de Preços, a partir do qual se podem gerir listas de preços diferenciais para os artigos presentes na transação independentemente das promoções aplicáveis.


Componentes PROMOCIONAIS


  • Console de administração:

Ferramenta WEB para administração de promoções, cupons e elementos de fidelização, assim como alarmes e tabelas de preços. É o componente responsável por gerar o arquivo de definição das regras de negócio (mapa de promoções) que será utilizado pelo motor de promoções para avaliá-las. Encarrega-se de gerir a emissão e resgate de cupões de forma centralizada, encarregar-se da gestão dos itens de fidelização, podendo criá-los, associá-los a clientes, consultar o seu histórico e gerir saldos.


  • Motor de promoções:

É o componente PROMO encarregado de resolver e reportar as promoções participantes de um Ticket de acordo com as definições (promoções) que foram geradas através do console. É também a ligação entre o ponto de venda e a consola central de administração para tudo o que se refere à gestão dos elementos de Fidelidade.


Arquitetura






 funcionalidade


As funções desempenhadas pelo PROMO :

  • Definir e gerenciar promoções. Componente responsável: o console de gerenciamento. 
  • Defina e gerencie modelos de promoção. Componente responsável: o console de gerenciamento. 
  • Definir e gerenciar cupons. Componente responsável: o console de gerenciamento. 
  • Definir e gerenciar elementos de fidelidade. Componente responsável: o console de gerenciamento. 
  • Defina e gerencie funções de usuário do console de promoções. Componente responsável: o console de gerenciamento.
  • Definir e gerenciar KPIs. Componente responsável: o console de gerenciamento.
  • Publicação em Redes Sociais. Componente responsável: o console de gerenciamento. 
  • Resolver promoções e informá-los. Componente responsável: o motor de promoções.
  • Definir e gerenciar Alarmes. Componente responsável: o console de gerenciamento. 
  • Gerenciar listas de preços. Componente responsável: o console de gerenciamento. 

limitações

  • A PROMO não aplica as promoções, mas informa o ponto de venda como aplicá-las.
  • PROMO não é PDV.
  • PROMO delega a impressão e cálculo do IVA e impostos ao ponto de venda.
  • PROMO delega a impressão de cupons ao ponto de venda.
  • A PROMO delega a impressão das etiquetas ao lojista.


Capítulo 3 - Console de Administração


Introdução

O PROMO , através do Console de Administração , permite definir promoções combinando os componentes: condições simples, intervalo de tempo, combos e benefícios.

Através do console de promoções, é realizada a definição dos mapas nos quais estão relacionadas as promoções vigentes por meio de regras de convivência e ordens de aplicação.

No PROMO você pode gerar e gerenciar cupons para serem emitidos e resgatados por meio de uma transação.

Também é possível gerar elementos de fidelização, podendo registar diferentes perfis de elementos de fidelização como, por exemplo, GiftCards, bolsas ou elementos de fidelização de pontos, pode gerir o saldo, associá-los a clientes e permitir que a sua participação em promoções aumente ou diminua seu saldo de acordo com a promoção aplicada.

Com PROMO é possível gerir alarmes, que servirão para alertar determinados utilizadores sobre eventos relevantes que ocorram na consola e/ou transação, bem como a possibilidade de gestão de tabelas de preços e gestão de etiquetas a partir da consola de promoções.

Nesta nova versão do PROMO incorporam-se ferramentas que irão melhorar a experiência do utilizador ao agilizar a gestão de promoções e mapas, a par da possibilidade de customizar a consola de forma ágil e simples de acordo com os requisitos de cada Lojista.


conexão do console


A consola de administração é uma ferramenta Web, pelo que a ligação pode ser remota ou local, através da utilização de um navegador como Chrome ou Firefox.

Para se conectar ao console é necessário entrar na página   http:// IP-SERVER :PORT_INSTALLATION/promo onde: 


  • SERVER-IP :deve ser substituído pelo endereço IP da máquina onde está rodando o servidor de aplicação.
  • PORT_INSTALLATION :é a porta de conexão (por exemplo: 8080)



Uma vez conectado ao console, você deve inserir o nome de usuário, a senha e a empresa à qual deseja se conectar.


Por padrão, ao iniciar o console PROMO pela primeira vez, as credenciais serão (respeitando letras maiúsculas e minúsculas):

  • Nome de usuário: administrador
  • Senha : Promo2020
  • Empresa : "Empresa"

Ao entrar no console, o aplicativo exibirá os dados do usuário:

Nome de usuário: Ex: admin

Empresa: por exemplo; cochilo

Alarmes: o ícone indica os alarmes que chegam ao usuário

Lojas: aquelas às quais o usuário se vinculou. Ex: Loja1, Loja2, etc. As lojas são separadas por vírgulas.

Sair: botão para sair do aplicativo

Versão: indica a versão correspondente ao aplicativo. Ex: V.7.2.3

Integração com autenticação de usuário externo (SAML2)

Através da implementação do SAML2 no PROMO, será alcançada a integração do PROMO com um sistema externo de autenticação de usuários. Deve-se levar em consideração que dentro do console existem funções de usuário que permitem o acesso às diferentes funcionalidades que devem ser mantidas dentro do console. Sempre será necessário ter o usuário criado no banco de dados para acessar o console e realizar a autenticação.

Quando o Promo operar com essa integração, não será exibida a tela de login proposta neste manual, mas sim o login que cada lojista integrou ao SAML2.

Ao fazer login e autenticar corretamente, você verá a tela principal do PROMO de "Gerenciamento de promoções".

Para obter mais informações sobre a integração do SAML2 no Promo, consulte o Manual de instalação 7.2.


 Menu de Navegação PROMO



IMPORTANTE

Dependendo dos módulos adquiridos, mais ou menos opções aparecerão disponíveis nos menus de navegação. Este documento cobrirá todas as opções disponíveis do aplicativo base.


 Considerações gerais


Haverá dados que o usuário deve inserir no console e que são comuns a todos os componentes.

  • Nome : por meio destes dados, será possível identificar o componente que está sendo criado e será o nome que aparecerá nas diferentes listas em que pode ser utilizado. O campo de nome em todos os casos é um tipo de string de dados de até 255 caracteres.
  • Descrição : por meio destes dados, será possível inserir uma breve explicação explicativa do conteúdo do componente que está sendo criado. O campo de descrição é em todos os casos um tipo de string de dados de até 255 caracteres e cuja entrada não é obrigatória.


Observação: as mensagens padrão usam o idioma do sistema (não Promo).


Botões


Nas telas do console PROMO você encontrará os seguintes botões:

  • Voltar: botão que permite retornar à tela anterior.
  • Cancelar: botão cuja funcionalidade é cancelar o fluxo operacional que o usuário estava realizando. O usuário pode cancelar o procedimento que estava em andamento a qualquer momento, voltando ao início do menu com o qual estava trabalhando.
  • Novo: botão que permite criar um novo componente, dependendo da localização do botão na tela, será o componente que poderá ser criado.
  • Editar: botão que permite editar todos os registros do componente selecionado da tela na qual o botão está localizado.
  • Salvar: botão que permite confirmar o procedimento realizado.
  • Pesquisar ou Filtro: botão que permite realizar uma pesquisa indicando os valores desejados para um conjunto de filtros.


IMPORTANTE

Lembre-se de que se Cancelar for pressionado em qualquer uma das telas de fluxo, o que é feito é cancelar completamente o fluxo que estava sendo executado.


paginado



Paginado

Em todas as telas em que for exibido um grande número de registros, as informações serão paginadas, para facilitar sua navegação.

Sua navegação é a seguinte: 

Abaixo dos filtros de busca serão exibidos dois campos para navegar pelos registros, são os filtros de paginação que por padrão ao entrar no relatório ou tela mostrará 1 (um) e 50 (cinquenta), desta forma, os 50 primeiros serão exibido na tela. registros a partir do primeiro registro. 

Se você quiser ver os dois registros anteriores, você deve pressionar a seta dupla à esquerda. O sistema modificará automaticamente o valor do campo a partir do qual realiza a pesquisa. 

Ao pesquisar a partir de 1, a seta dupla à esquerda será desativada (se o cursor do mouse for passado sobre esse botão, ele mostrará o sinal de proibido). Quando o final da lista for atingido, a seta dupla à direita será desativada (se o cursor do mouse for passado sobre esse botão, ele mostrará o sinal de proibido). Desta forma, o relatório pode ser navegado visualizando a quantidade de registros inseridos na tela a partir do registro indicado. No máximo 1.000 (mil) registros podem ser visualizados na tela.


IMPORTANTE

IMPORTANTE:

QUANDO COMEÇAR A USAR OS FILTROS DA PÁGINA, DEPOIS DE DIGITAR OS VALORES DESEJADOS (OU SE TAMBÉM DEIXAR DE 1-50) DEVE-SE PRESSIONAR ENTER, DEPOIS CONTINUAR NAVEGANDO COM AS SETAS DUPLAS.

Ao entrar na tela pela primeira vez , desde que o usuário atual esteja logado, por padrão ela não trará informações e exibirá uma mensagem indicando que você deve utilizar os filtros para buscar informações. Após a busca (pressionando o botão "lupa"), a mensagem desaparece. Os campos de pesquisa serão armazenados com os filtros de pesquisa usados.




Capítulo 4 - Módulo do Dashboard


Dashboards   são representações gráficas das principais métricas ou KPIs que estão envolvidos na obtenção dos objetivos de uma estratégia de negócios e que são orientados para a tomada de decisões para otimizar a estratégia da empresa .

Os Dashboards em PROMO permitirão monitorizar o grau de aplicação e abrangência das diferentes promoções, cupões e elementos de fidelização com base nos diferentes indicadores predefinidos.



Menu do Dashboard

A partir deste Menu pode visualizar os KPIs de Vendas, promoções, elementos de fidelização e cupões.



 Dashboard de vendas

Nesta seção, serão mostrados os indicadores referentes às transações de vendas impactadas no banco de dados PROMO.

Os registros serão exibidos com base no intervalo de datas selecionado e os KPIs representarão os valores de diferentes aspectos das vendas realizadas.

Gráfico de Vendas por Loja: mostra, por loja, o total de vendas realizadas menos os descontos aplicados. Este gráfico mostrará apenas as lojas vinculadas ao usuário logado.

O gráfico Vendas por Categoria (Posto 5): mostra o preço total por categoria (sem aplicar o desconto).

O gráfico Vendas por hora (Posto 5): mostra o preço de venda por hora menos o desconto aplicado.

Gráfico Vendas por Forma de Pagamento: mostra a venda total (sem aplicar o desconto) por meio de pagamento.





 Dashboard de Promoções

Nesta seção serão mostrados os indicadores referentes às Promoções concedidas a partir dos pontos de vendas impactados no banco de dados PROMO.

Esses registros serão exibidos com base em um intervalo de datas selecionado e os KPIs representarão o fluxo de promoções aplicadas nos diagramas.



Nota : Ao posicionar o mouse sobre as barras coloridas, serão exibidos dois valores, no exemplo a seguir mostra: $ 700,1. O primeiro dígito indica o valor a ser representado no gráfico, o segundo dígito indica a posição da barra que está sendo visualizada contando do eixo x cartesiano para cima. Neste exemplo, sendo a primeira barra, mostra 1:



 Dashboard de cupons

Nesta seção serão mostrados os indicadores referentes aos cupons concedidos nos pontos de venda impactados na base de dados PROMO.

Os registros serão exibidos com base no intervalo de datas selecionado e os KPIs representarão o fluxo de cupons emitidos e/ou resgatados nos diagramas conforme configurados.





 Dashboard de Elementos de fidelidade

Existem indicadores referentes a elementos de fidelização ativa.
Os registros serão exibidos com base no intervalo de datas selecionado e os KPIs representarão os elementos de fidelidade ativados no intervalo indicado.


Cada um desses Dashboards pode ser editado tanto em seu formato quanto nos dados exibidos.



Capítulo 5 - Módulo de Operação


Menu de operação


A partir deste Menu pode criar Campanhas, definir Condições Gerais, criar Promoções e Modelos de Promoção, aprovar promoções, Condições Gerais, cancelar promoções em massa e/ou modificar os limites das promoções.



IMPORTANTE

 A opção " Promoções a Aprovar " só aparecerá quando mais de uma etapa de aprovação tiver sido definida em algum dos Workflows definidos.



 campanhas

Esta opção encontra-se no menu " Operação " da consola PROMO e permite-lhe gerir diferentes campanhas.

Por padrão, ao instalar o console, é carregada como exemplo a campanha "BLACK FRIDAY", que pode ser reutilizada ou desativada conforme necessário.

As campanhas podem ser classificadas de acordo com a finalidade ou objetivo das promoções que agrupam.

Por exemplo, " Campanha cochilo ", onde podem ser agrupadas todas as promoções de eletrodomésticos.

Outro exemplo poderá ser a " Campanha de Natal " onde as promoções agrupadas nesta campanha são as que vigorarão na época natalícia.

As campanhas poderão ser definidas de acordo com as necessidades do lojista, e terão apenas a finalidade de organizar as promoções dentro do console.


Você deve pressionar o botão " Novo " e a seguinte tela aparecerá para completar os dados da campanha:

Os seguintes dados devem ser inseridos:

  • Nome : nome pelo qual a campanha será identificada.
  • Descrição : este campo pode ser utilizado pelo usuário para inserir todas as informações necessárias sobre a campanha que está sendo definida, a fim de ampliar sua descrição e identificá-la com mais facilidade. Este campo não é obrigatório.
  • Data de início : indica a data em que a campanha entra em vigor.
  • Data Fim : Indica a data em que terminará a validade da campanha.
  • Canais de publicação: Você pode selecionar entre os diferentes canais de publicação definidos. (Aparecerão mais ou menos opções dependendo dos módulos adquiridos pelo cliente.)
    • Ponto de venda
    • Facebook
    • Twitter
  • Ativa: Através desta verificação pode-se indicar se a campanha que está sendo criada está Ativa (Marcada) ou não (Desmarcada). Por padrão, todas as campanhas serão criadas no estado Ativo.

Uma vez carregados os dados, deve-se pressionar o botão " Salvar ".


IMPORTANTE

Embora o PROMO permita que cada cliente crie suas próprias campanhas, deve-se levar em consideração que, uma vez criadas, por serem condições para a estruturação das tarefas que em conjunto compõem as promoções, o sistema não permitirá que sejam excluídas.



Condições Gerais

Esta opção encontra-se no menu " Operação " da consola PROMO e permite definir condições onde é possível indicar quais os artigos incluídos ou excluídos na avaliação das promoções em vigor no mapa que as contém. Estas "Condições Gerais" serão incluídas no Mapa Promocional e serão a primeira coisa que o motor irá considerar, de forma que ao avaliar o contexto, os elementos incluídos nas referidas condições sejam incluídos ou excluídos da avaliação das promoções. As Condições Gerais seriam como um pré-filtro que o motor Promo irá analisar antes de ver se analisa o mapa ou não, dependendo do que foi definido nas Condições Gerais. 

Ao clicar na nova seção " Condições Gerais " você irá para a tela " Gerenciamento de Condições Gerais 

Você pode pesquisar pelos seguintes filtros:

                                                              Código de condição geral

                                                              Nome da condição geral

                                                              Status da condição geral (Todos, Incompleto, Completo e Cancelado)

                                                              Validade da condição geral. (Atual/Não Atual)

A grade da tela "Gerenciamento de Condições Gerais" mostrará as condições geradas.


Clicando no botão " Nova Condição " você será direcionado para a tela  "Nova Condição Geral" , onde serão apresentados os seguintes dados para cadastrar uma nova condição:

  • Nome:  Nome exclusivo da condição. Não pode ser repetido. Alfanumérico máximo de 200 caracteres.
  • Código : código único da condição. Não pode ser repetido. Alfanumérico máximo de 20 caracteres
  • Descrição:  Alfanumérico máximo de 200 caracteres. 
  • Fluxo de trabalho:  você pode selecionar entre os vários fluxos de trabalho definidos ou etapas de aprovação para aprovar uma condição geral.

A partir desta versão são adicionados os campos:

Tipo de Promoções: O tipo de promoção deve ser selecionado entre as opções propostas (opcional, padrão todas).

Subtipo de promoção: O subtipo de promoção deve ser selecionado entre as opções propostas (opcional, padrão todas).

Forma de aplicação das promoções: A forma de aplicação das promoções deve ser selecionada entre as opções propostas. (opcional, padrão todos).

Indicar a que tipo, subtipo e forma de candidatura e desta forma quando a tipificação coincidir com a promoção se aplicará a condição geral. Indica quais itens estão incluídos/excluídos na avaliação das promoções vigentes no mapa que as contém. O valor padrão para os três itens será All; aplicável a qualquer tipo de promoção.

Quando "Salvar" for pressionado,   você irá para a tela " Definir condição ". Se premir "Cancelar",  regressará ao ecrã " Gestão das Condições Gerais ", sem guardar as alterações.

Na tela "Definir Condição", serão mostradas apenas as seções  "Cabeçalho",  " Condições de Faixa de Tempo " e " Condições Simples " .

Condições Gerais poderão ser geradas com validade determinada ou que se apliquem com periodicidade definida por meio da definição das condições da Faixa Horária.

As Condições Simples podem ser definidas por qualquer um dos atributos definidos para os elementos, assim como os elementos podem ser combinados para definir uma Condição Geral.


O pop-up Resumo mostrará o cabeçalho e as condições definidas.


Cenários de definição das Condições Gerais

Em uma Condição Geral, por exemplo, podem ser definidas as seguintes condições simples:

  • Por Produto:  
    Os itens, sejam eles definidos por SKU, marca ou qualquer outro atributo do produto, podem ser incluídos ou excluídos da avaliação das promoções.

> Caso a condição simples seja definida pelo SKU  "Igual a" , por exemplo, "111",  este item poderá ser avaliado pelas promoções encontradas no mapa que contém esta Condição Geral.

> Caso a condição simples seja definida por Marca  "Diferente de" , por exemplo, "Sony", os artigos pertencentes à marca Sony não poderão  ser avaliados em nenhuma das promoções encontradas no mapa que contém esta Condição Geral.

Nota

Pode acontecer que a marca Sony esteja excluída da aplicação das promoções mas que algumas das promoções do mapa que contém esta Condição Geral se apliquem, por exemplo, 10% à PlayStation (marca=Sony).

SUPOSIÇÃO : Neste caso, o cliente não obteria o desconto porque a Condição Geral havia sido aplicada primeiro.


  • Por cupons:

> Caso o cupom com tipo "Igual a" 111 seja inserido na transação, as promoções serão avaliadas.

> Caso o cupom com tipo "Diferente de" 111 seja informado na transação, as promoções serão avaliadas.


  • Por clientes:

> Caso seja cadastrado na transação um cliente com tipo VIP "Igual a", as promoções serão avaliadas.

> Caso seja cadastrado na transação um cliente com tipo VIP "Diferente de", as promoções serão avaliadas.


  • Por meio de pagamento:

> Caso seja inserido na transação um meio de pagamento com banco “Igual a” RIO, as promoções serão avaliadas.

> Caso seja inserido na transação um meio de pagamento com banco RIO “Diferente de” as promoções serão avaliadas.


  • Para elementos de fidelidade:

> Se na transação for inserido um elemento de fidelidade do tipo "Igual a" Pontos, as promoções serão avaliadas.

> Caso seja inserido na transação um item de fidelidade do tipo “Diferente de” Pontos, as promoções serão avaliadas.


  • Por transação:

> Se a transação for feita em uma loja "Igual a" 658, as promoções serão avaliadas.

> Caso a transação seja realizada em loja 658 "Diferente de", serão avaliadas as promoções.


As Condições Gerais podem participar dos Workflows como qualquer outra promoção.

As Condições Gerais só poderão ser Simuladas quando participarem de um mapa. Ao simular um mapa que contém uma Condição Geral, a tela deve mostrar que a Condição Geral foi aplicada, e qual foi o resultado, se foram aplicadas promoções ou não. Não podem ser simulados a partir da  opção Promoções  pois não possuem benefícios.

Nota: Se nas Condições Gerais for inserido um intervalo de datas, o mapa só pode ser utilizado nesse intervalo de datas.



 promoções

Uma promoção é uma ferramenta de marketing usada para informar, persuadir e lembrar potenciais consumidores da existência de um produto ou serviço, na esperança de influenciar os sentimentos, crenças ou comportamento do destinatário, estimulando assim a demanda.

As promoções têm certas restrições ou condições que devem ser cumpridas para obter os benefícios a elas associados.

Para PROMO, uma promoção é uma função que leva um contexto ( Contexto: são todos os elementos que fazem parte de uma transação (produto, cupons, clientes, eventos, meio de pagamento ) e os dados da transação (número da loja, terminal, data e hora).) como entrada e retorna um novo contexto ( com os benefícios resultantes e elementos beneficiados) como saída e os reporta ao aplicativo PDV.

Para uma promoção ser considerada "Completa" ela deve definir no mínimo uma " Condição " e um " Benefício ".


NOTA

Por configuração, pode-se definir que a entrada de um cliente, uma condição de data com hora e/ou uma condição de transação são necessárias para concluir uma promoção. Consulte " Administração " >> " Informações de configuração "


Uma " Condição " pode ser composta de elementos ou uma coleção de elementos relacionados que atendem a certas características definidas. Chamaremos a conformação desses elementos de conjuntos .

Os conjuntos também podem ser compostos por todos os elementos do tipo que foi selecionado, sem a necessidade de configurar nenhum tipo de atributo especial.

Para aceder ao ecrã “ Gestão de Promoções ”, deve selecionar a opção “ Promoções ” do menu “ Operação ” .

A seguinte tela será exibida, onde serão listadas as promoções já geradas, indicando seu status, bem como novas promoções poderão ser geradas a partir do botão "Nova Promoção".


A tela de Gerenciamento de Promoção exibirá os seguintes filtros não obrigatórios de pesquisa de promoção:  Código, Nome da Promoção, Tipo de Promoção, Subtipo de Promoção, Formas de Aplicação, Status, Campanha, Validade e Loja.

Ao entrar na tela "Gerenciamento de Promoções", o usuário logado; Você verá apenas as promoções associadas às lojas às quais você se vinculou. (Devido à migração, todas as promoções que não possuem loja também serão visualizadas).

Abaixo estão os filtros de busca, são os filtros de paginação , descritos em  Paginação

Menu de Ações

À direita de cada Promoção, independentemente de estar no estado Incompleta, Completa ou Distribuída, aparecerá o botão " Ações " a partir do qual poderão ser realizadas diversas ações sobre uma promoção.

Essas ações são:

  • Editar : A partir desta opção você pode acessar o cabeçalho da promoção. Só estará disponível se a promoção estiver no estado " incompleta " ou " completa ". No caso de estar no estado " Distribuído ", com a habilitação de edição dada pela configuração ( deployedEditable.enabled ) a opção de edição também estará disponível.
  • Definir : A partir desta opção você pode acessar o corpo da promoção. Só estará disponível se a promoção estiver no estado "incompleta" ou "completa". No caso de estar no estado " Distribuído ", com a habilitação de edição dada pela configuração ( deployedEditable.enabled ) a opção define também estará disponível.
  • Alterar imagem : uma imagem associada à promoção pode ser carregada ou alterada.
  • Summary : Mostra um PopUp com o detalhe da promoção.
  • Histórico do WF : Pode ser visualizado o circuito do Workflow pelo qual a promoção passou.
  • Cópia : Uma nova promoção pode ser feita a partir da cópia de uma já existente.
  • Distribuir : Uma distribuição imediata da promoção pode ser feita. Os requisitos para que essa opção apareça no menu são:

      • Que a promoção foi distribuída para uma loja de produção
      • Que a opção Editar promoções distribuídas esteja ativada pela configuração no console Promo ( deployEditable.enabled ).
      • Que alguma mudança foi feita na promoção em sua definição (condições e/ou benefícios)

IMPORTANTE

Quando uma promoção for distribuída individualmente, os mapas que a contiverem nas lojas ativas receberão a atualização da promoção distribuída individualmente. A numeração do mapa na loja não será afetada pela distribuição individual das promoções.



Nova promoção


Deve-se levar em consideração que uma promoção deve ser composta por pelo menos uma condição e um benefício para ser considerada "Completa".


IMPORTANTE

Recomenda-se incorporar no máximo 3.000 códigos em uma promoção.



  • Condições Simples e/ou por composição:  São as restrições definidas para uma promoção. Essas restrições devem ser atendidas para ter acesso ao benefício concedido pela promoção. simples:

    são os requisitos que devem ser cumpridos para obter um benefício. As condições simples serão definidas por meio de elementos que possam estar presentes em uma transação como Produtos, Cupons, Clientes, Eventos, Meios de Pagamento, Elementos de Fidelização, Benefício Externo e/ou dados da transação (Loja, Terminal, Canal, Cadeia, Formato, Zona, Subzona). A cada um desses elementos serão atribuídos atributos ou características que os elementos devem atender para tornar a configuração da condição mais específica. Os atributos indicados neste manual são os do produto base, pelo que se deve ter em conta que cada cliente pode alargar e adaptar os atributos de acordo com as necessidades do negócio. 

    Por composição : são formas de agrupar elementos em pacotes ou “combos” dentro do contexto para que os benefícios sejam aplicados a cada um desses conjuntos de elementos. Uma condição por composição pode ser composta por N conjuntos de Produtos, Cupons, Clientes, Meios de Pagamento e/ou Itens Fidelidade. 

    IMPORTANTE

    Nas promoções de combo, o(s) elemento(s) a ser(em) beneficiado(s) DEVE(M) ser definido(s) dentro de uma mesma condição por composição ou combo.

  • Benefícios:  É uma vantagem econômica ou material que é concedida a um cliente mediante o cumprimento de determinadas condições. 



Cadastro de Nova Promoção

Você deve pressionar o botão " Nova promoção " na janela " Gerenciamento de promoções " e as seguintes seções serão exibidas:


MODELOS DE PROMOÇÃO
  • Modelos de promoção : permite selecionar um modelo de promoção. (Para mais detalhes, vá para Modelos de promoção )


CABECEIRA

As seguintes informações devem ser inseridas nesta seção:

  • Nome da Promoção : Nome pelo qual a promoção será identificada (obrigatório).
  • Código : indica o código interno da promoção (é opcional e pode ser configurado para ser obrigatório).


NOTA

Campo do código- chave :

Por padrão, o nome da promoção será único e servirá como chave para buscas de promoções nos diferentes filtros do console Promo e relatórios.

Nesta versão do Promo foi adicionada a possibilidade de indicar desde a configuração da consola se o “ Nome  é utilizado como campo chave ou se o campo “ Código ” também é utilizado como chave para a pesquisa de promoções. Isso validará que uma promoção com o mesmo código ainda não existe ao gerar uma promoção.

Um usuário com a função de administrador poderá habilitar ou desabilitar essa configuração. Entrando em “ Administração > Informações de configuração ”, no filtro “ Word to search ” escreva: “chave”. Em “ promoção.codeKey ”, se for informado “ true ”, indicará que o campo “ código ” é uma chave junto com o “Nome” (Nem o código nem o nome da promoção podem ser repetidos na base promocional) . O valor padrão é “ false ”, indicando que apenas o campo “Nome” será chave.

Quando esta opção estiver habilitada, ao lado do campo “ Código* ”, será exibido o botão “ Gerar código automaticamente ” . Se o usuário pressionar este botão, o sistema mostrará no campo "Código *" um código que foi gerado automaticamente pelo sistema, será único, não será repetido com os códigos existentes. O usuário pode deixar o código sugerido pelo sistema e continuar com o upload. Ou você pode modificá-lo ou inserir qualquer código que desejar. O sistema sempre validará que este código é único. Se o usuário desejar, poderá pressionar novamente o botão "Gerar código automaticamente" e o sistema exibirá um código diferente a cada vez que este botão for pressionado, sendo sempre um código único.

Quando o campo " Código " estiver habilitado para funcionar como campo chave, também pode ser habilitada a opção desse código ser carregado automaticamente e incremental. Com esta opção ativada, é o sistema que atribui o Código a uma promoção e não o utilizador. Esta opção pode ser ativada em “ Administração > Informações de configuração ”, no filtro “ Palavra a pesquisar ” escreva: “ incrementalID ” e no campo “ promoção.código.ativo ” digite o valor “ verdadeiro ”. O valor padrão é “ false Se o código promocional estiver configurado como chave e incremental, o botão " não será habilitado

NOTA

Nome concatenado e código promocional :

Promo oferece a possibilidade de concatenar o Código único atribuído à promoção ao final do Nome da Promoção , para que o nome continue único.

Para isso, o Código Promocional deve ser configurado como gerado automaticamente e único (em “ Administração > Informações de configuração ”, no filtro “ Palavra a pesquisar ”, escreva: “ incrementalID ”. Em “ promoção.código.ativo ” insira o valor " true " e no filtro "Word to search" escreva: "key". Em " promotion.codeKey " se o valor " true " estiver configurado ).

Com estas opções ativas, pode-se indicar na seção “ Administração > Informações de configuração  , inserindo no filtro “ Palavra a pesquisar ”,  promo.name.code ”, se for utilizado o nome concatenado, inserindo “true” no campo campo desta configuração. O valor padrão  é " false ".

Ao cadastrar uma nova promoção, a seguinte tela será exibida onde deve ser colocado o nome da promoção, e o código será gerado automaticamente.


Ao clicar em "Salvar" o código será gerado automaticamente e será atribuído à promoção, nesse momento, o código da promoção será anexado ao final do nome.

Na lista de Promoções, o nome da Promo será mostrado com o código gerado automaticamente. O nome com o código também será exibido em relatórios envolvendo o nome da promoção.

Ao editar uma promoção, o nome pode ser editado, mas quando você pressionar salvar, um novo código de promoção exclusivo será anexado ao nome editado novamente.


Ao cadastrar um benefício , os campos "Mensagem para o PDV", "Mensagem para o Impressor" e "Mensagem para o Tlog " não adicionarão automaticamente o código da promoção, apenas será exibido o nome da empresa.

  • Descrição : este campo pode ser utilizado pelo usuário para inserir todas as informações necessárias sobre a Promoção que está sendo definida. (opcional)
  • Fluxo de trabalho : você pode selecionar entre os vários fluxos de trabalho definidos ou etapas de aprovação para dar uma promoção como aprovada.
  • Campanha : deve ser selecionada uma das campanhas definidas para promoções.
  • Canais de publicação: você deve selecionar entre os diferentes canais de publicação definidos.
    • Ponto de venda
    • Facebook
    • Twitter

NOTA

Caso o módulo Redes Sociais não tenha sido adquirido, aparecerá apenas a opção "Ponto de Venda"

IMPORTANTE

Caso a promoção seja publicada em alguma das redes sociais, deverá ser carregada uma imagem para correta visualização.


  • Avaliar condição no combo : ao marcar esta opção, indica-se que a promoção que está sendo definida terá pelo menos uma condição simples e uma condição composta (combo). Ao avaliar as promoções com este til, será verificado se cada combo formado na transação atende a condição simples definida. Caso contrário, se a promoção for definida sem esta verificação ativa, a(s) condição(ões) será(ão) avaliada(s) independentemente uma da outra.
  • Participantes do relatório : Ao marcar esta verificação, quando a promoção for avaliada, o ponto de venda será informado de todos os elementos que participaram da condição e benefícios.
  • Tipo de promoções : o tipo de promoção deve ser selecionado entre as opções propostas. (obrigatório).
  • Subtipo de promoção : o subtipo de promoção deve ser selecionado entre as opções propostas (obrigatório).

IMPORTANTE "Tipo, Sub-tipo y Formas de aplicación de la promoción"

A forma de classificação de uma promoção em tipo,  subtipo e forma de aplicação de uma promoção será utilizada no cadastro de um modelo de Mapa.

Desta forma, quando um mapa é gerado a partir de um modelo de mapa que utiliza essas classificações, as promoções serão localizadas nas etapas e funções de convivência que correspondem ao seu tipo, subtipo e forma de aplicação.

Os combos suspensos de "Tipo de promoções", "Subtipo de promoções" e "Formas de aplicação de promoções" mostrarão as opções que foram carregadas anteriormente no menu principal, selecionando a opção Administração e depois a opção correspondente . Por padrão, os combos de “Tipo de promoções”, “Subtipo de promoções” e “Formas de aplicação de promoções” apresentarão a opção “Genérica”.

  • Formas de aplicação das promoções : a forma de aplicação das promoções deve ser selecionada entre as opções propostas. (obrigatório).

Validación

Ao selecionar um " Tipo de promoção " ao definir uma promoção, o combo " Subtipo de promoção " listará os subtipos de promoções pertencentes ao tipo de promoção selecionado. E ao selecionar o Subtipo de promoções, apenas serão listados os formulários de candidatura associados a esse Tipo/Subtipo.


SUGESTÕES (PONTO DE VENDA)

A partir desta seção será possível configurar se a promoção fará sugestões ou não e se considerará o estoque para fazer a sugestão.


  • Habilitar sugestões: Se esta opção não estiver ativada, esta promoção não será levada em consideração ao fazer sugestões ao cliente. Se esta opção estiver ativada: 

    Caso o cliente informado na transação atenda à condição configurada em Condições Simples\Cliente ou Condições por Composição\Clientes, a sugestão será exibida. Caso o cliente informado na transação não atenda a condição, a sugestão não será exibida. O fato de atender a condição significa que o que está configurado no atributo Clientes (Id, Tipo, Valor Restante, Segmento, Perfil do Cliente, Campanha de Crédito, Fator de Conversão) deve entrar na transação.

            Condições por composição:


Para mostrar as sugestões serão considerados os seguintes pontos:


Configuração do elemento Cliente na PromoCumpra as Condições da PromoçãoEle exibirá as sugestões
1A promoção não tem um elemento Clienteem parteSIM (dependendo da configuração*)
2O elemento Cliente possui uma lista de Ids
(o ID digitado na transação não está na lista)
em parteNÃO
3O elemento Cliente possui uma lista de Segmentos
(o Segmento inserido na transação não está na lista)
em parteNÃO
4O elemento Cliente possui uma lista de Ids
(o ID inserido na transação se estiver na lista)
em parteSIM
5O elemento Cliente possui uma lista de Segmentos
(o Segmento inserido na transação se estiver na lista)
em parteSIM

Nota

Se as dicas estiverem habilitadas na promoção e no mapa, ele mostrará as dicas. Ou seja, se o mapa disser "não mostrar sugestões" não serão mostradas, se o mapa disser mostrar sugestões depende da promoção.


IMPORTANTE

Uma vez habilitada a sugestão, ela também deverá ser habilitada no mapa que conterá a promoção. Veja detalhes em: ATIVAR SUGESTÕES NO MAPA .

Exemplo:

Foi configurada uma promoção que tem a opção "Habilitar sugestões" habilitada e foi inserida uma mensagem no campo "Mensagem PDV". Nas Condições Simples existe um código de produto específico por exemplo SKU=1, e Tipo de Cliente=VIP. Se na transação chegar:

    • quem está com o produto 1 mas não tem cliente, vai sugerir a promoção,
    • que tem um Cliente mas é de outro Tipo, não será sugerido porque o Tipo não é o definido na promoção,
    • quem tem Tipo de Cliente=VIP mas não tem o produto 1, irá sugerir esta promoção.

Importante

Ao ativar o cheque correspondente a "Habilitar Sugestão" e NÃO indicar um valor para o campo "Mensagem PDV" e salvar as alterações, o Promo emite um pop-up com a legenda "caso a promoção inclua sugestões, deverá inserir a mensagem do ponto de oferta" 


  • Sujeito a Estoque: Se esta opção estiver habilitada, a Promo controlará a existência de estoque do produto beneficiado antes de fazer a sugestão. Se você não tiver estoque, não fará a sugestão.

Existe uma ficha que diz quais são os produtos que tem stock e se esta promoção beneficiar um produto que está nessa ficha se tiver stock vai sugerir e se não tiver stock não vai sugerir. Este arquivo é atualizado automaticamente com as informações enviadas pelo PDV, caso tenha sofrido alterações será atualizado toda vez que o Promo verificar os mapas.

Exemplo:

Foi configurada uma promoção que tem as duas opções habilitadas: "Habilitar sugestões" e "Sujeito a estoque", e no mapa habilitar sugestão, na "Mensagem PDV" você digitou "Leve o produto X e damos 20 % de desconto no produto J". Em Condições Simples, foi definido que levar o produto X dá como benefício um desconto de 20% (universo de aplicação do benefício) no produto J. Quando o cliente está no caixa e não está portando o produto X, então a Promo vai para verificar se o produto J está em estoque e se estiver, mostrará a sugestão "Leve o produto X e daremos 20% de desconto no produto J".

Neste exemplo, o controle de estoque é feito pelo Application Universe, não por Simple Condition, e é feito por SKU (não pode ser colocado por marca, por exemplo). Se você pode inserir vários SKUs, se houver estoque, ele será sugerir promoção.

Nota

O produto cujo estoque está sendo controlado deve fazer parte da promoção como produto beneficiado. Se o conjunto de aplicativos contiver vários SKUs e um deles estiver em estoque, a promoção será elegível.

Importante

Se uma promoção é gerada com uma sugestão do estoque e do cliente, surgem dois comportamentos:

  • Se atender à condição de estoque (estoque disponível) e não atender à condição do cliente, você não deve sugerir.
  • Se atender à condição do cliente, mas não à condição de estoque (não há estoque disponível), você não deve sugeri-lo.

Quando ambas as sugestões coexistirem; eles devem atender às condições ao mesmo tempo para que a promoção seja sugerida.

    • Mensagem do PDV: Neste campo deve-se inserir a mensagem a ser exibida na tela do PDV quando a promoção for sugerida.



IMAGEM ASSOCIADA (APENAS FORMATO PNG)
  • Descrição da imagem : este campo pode ser usado pelo usuário para inserir todas as informações necessárias sobre a imagem carregada.
  • Imagem associada : Mostrará a imagem que está selecionada.
  • Carregar imagem : Uma imagem pode ser carregada de um diretório específico.

NOTA

A imagem não deve exceder 1 MB de tamanho e deve estar no formato .PNG ou .JPG. A imagem carregada será apresentada em Promo no ecrã "Gestão da Promoção", na definição da promoção e caso sejam utilizados os canais Facebook e Twitter, a imagem será enviada para os mesmos (não será enviada para o PDV).


Depois que esses campos forem carregados conforme o caso, você deve pressionar o botão " Salvar " e irá para a tela " Definição da promoção ".


Definir uma promoção

Para finalizar o processo de geração de uma promoção, as seguintes informações devem ser preenchidas na tela "Definir Promoção".

Cabeçalho :  Mostra os dados inseridos na tela anterior. Os dados mostrados na caixa vermelha serão trazidos pelo sistema. Existe um botão "Editar" (permite editar o cabeçalho novamente) e um botão "Resumo".


Resumo da promoção:

O Resumo mostrará os principais dados da promoção, suas condições e benefícios.


Imagem associada:   Se não foi carregada anteriormente, pode-se carregá-la a partir da opção "Adicionar imagem".


Definir condições por intervalo de tempo: 

As condições do tipo Time Range são aquelas que avaliam as características da transação atual, permitindo a criação de condições com base em dados próprios como data com hora, hora e periodicidade. 


  • Data com condição de hora:   Dentro desta condição você pode definir uma condição para "data e hora" indicando de e para.

Importante

Em Administração\Informações de Configuração, pode-se configurar se a entrada da Condição Data com Hora é obrigatória ou não.

Requer Data com condição de hora (padrão = falso).


  • condição de tempo: 
    Aqui você pode definir uma condição de tempo, definindo horas e minutos nos campos de e para.


  • Condição de periodicidade: 
    Dentro desta condição você pode definir a partir de uma data inicial, a cada quantos dias ou semanas a promoção poderá ser aplicada. 
    Ao selecionar o botão Adicionar\Definir periodicidade, uma tela como a seguinte será exibida:

Em Data inicial, o padrão será a data atual. Este campo indicará a data que iniciará a frequência que será indicada abaixo. No campo Aplica-se a cada, deve-se exibir o combo dia/s para selecionar o tipo de frequência desejada.

Você pode selecionar as seguintes frequências:

      • Aplica-se a cada : x dia/s : permite indicar, por exemplo, que a promoção será aplicada a cada 2 dias, a partir da data de início indicada (neste exemplo a partir de 26 de maio):


      • Aplica-se a cada : x semana/s : neste exemplo, a partir de 1º de maio, a cada 3 semanas, a promoção será aplicada às quintas-feiras. Ou seja, será aplicado pela primeira vez no dia 21 de maio.

(Em Dias aplicáveis, você pode selecionar vários dias mantendo pressionada a tecla Ctrl e clicando com o mouse.)


      • Aplica-se a cada  x dia/mês : permite indicar frequências como: 4ª sexta-feira do mês. No campo antes do dia/mês aparecerá as opções: 1º, 2º, 3º e 4º:

Cabe esclarecer que para este caso deve ser previamente definido um intervalo de tempo, onde é informado uma data de início e fim, no qual será aplicado a cada x dia do mês. Caso não seja definido um intervalo de tempo, a aplicação da promoção se repetirá indefinidamente a cada x dias do mês selecionado. Por esta razão, a Data de início está esmaecida e não pode ser editada nesta tela.


      • Aplica-se todos os x dias do mês : Este tipo de frequência permite indicar, por exemplo, que a promoção será aplicada no dia 27 do mês. No campo antes de "dia do mês", mostrará como opções todos os números de 1 a 31.

Antes de criar esse tipo de frequência, você precisa adicionar a condição de data com hora. Nesta tela a edição da Data de Início não será habilitada pois leva a data com hora.

Caso o usuário selecione o dia 31 de um determinado mês, no intervalo de meses que ele selecionou, nem todos os meses terão 31 dias, então a Promo aplicará a promoção até o último dia de cada mês conforme o caso.

Se, por exemplo, for selecionado 31 de janeiro, ao aplicar a promoção em fevereiro, por ter apenas 28 ou 29 dias, será aplicada no último dia desse mês.



Definir condições simples


Unid

Chamaremos de Elementos os diferentes tipos de componentes que podem fazer parte de uma promoção. Esses componentes farão parte tanto da condição da promoção quanto do benefício.

Você deve selecionar o tipo ou tipos de elementos nos quais a condição será definida usando os seguintes botões:

Os atributos disponíveis por padrão para cada um dos elementos disponíveis são:

    • Produtos :
        • Código (SKU) : Usado para determinar a seleção de artigos através do seu código SKU.
        • Preço Unitário : Atributo utilizado para determinar se o item integra o conjunto pelo seu preço.
        • Marca : Usado para determinar a seleção de itens por meio da marca do item.
        • Fornecedor : Usado para determinar a seleção de itens por meio do fornecedor do item.
        • Departamento : Usado para determinar a seleção de itens por meio de seu departamento, é definido como o primeiro nível dentro de uma hierarquia de produtos.
        • Família : Usado para determinar a seleção de itens através da família à qual o item pertence, é definido como o segundo nível dentro de uma hierarquia de produtos.
        • Categoria : Usado para determinar a seleção de itens através da categoria à qual o item pertence, é definido como o terceiro nível dentro de uma hierarquia de produtos.
        • Subcategoria : Utilizada para determinar a seleção de itens através da subcategoria a qual o item pertence, é definida como o quarto nível dentro de uma hierarquia de produtos.
        • Descontínuo: usado para configurar promoções com produtos que ficaram no estoque, mas não entrarão mais novos para repor.
        • Baixa Rotação: é usado para criar promoções com produtos que não são os mais vendidos.
        • Produto Estrela: é utilizado para construir promoções com os produtos mais vendidos.
        • Opção de Resgate de Pontos: utilizada para configurar promoções de resgate de pontos.
        • C. Produto: as promoções podem ser configuradas indicando o Código do Produto Varejo.
        • Código de Barras: Utilizado para determinar a seleção dos artigos através do seu código de barras.
        • Aplica-se a TODOS : A seleção desta opção incluirá todos os itens que podem ser inseridos na transação na condição definida, sem considerar os atributos particulares de cada um.


Recomendación

A quantidade máxima recomendada para carregar nas Condições é de 3.000 itens.



    • Cupons :
        • Tipo:  pode ser usado para definir o tipo de cupom a ser incluído no conjunto.
        • Id:  utilizado para definir o id ou número do cupom que deseja integrar ao conjunto.
        • Aplica-se a TODOS : Selecionar esta opção incluirá todos os cupons que podem ser inseridos na transação no conjunto de condições, sem considerar os atributos particulares de cada um.

Importante

Em Administração\Informações de configuração , você pode configurar se a Validação Validação do tipo de Cupom Vs Validade da promoção é obrigatória ou não.

Ele valida a data de vigência do tipo de cupom contra a validade da promoção. (Padrão=falso)



    • Clientes :
          • Tipo : pode ser utilizado para definir o tipo de cliente que irá compor o conjunto (ex: funcionário, cliente regular, cliente frequente, etc.).
          • Id : utilizado para definir o id ou número do cliente que deseja integrar ao conjunto.
          • Valor restante : para promoções especiais em que é necessário limitar o valor sobre o qual aplicar um desconto X, relacionado ao cliente que foi inserido no ticket.
          • Segmento : Pode ser indicado se o cliente participante da promoção definida pertence a algum determinado segmento ou faixa de clientes.
          • Perfil do cliente: usado para definir uma categoria de cliente.
          • Campanha de Crédito: utilizado para indicar a campanha que o cliente pode utilizar.
          • Fator de conversão
          • Aplica-se a TODOS : A seleção desta opção incluirá todos os clientes que podem entrar na transação no conjunto de condições, sem considerar os atributos particulares de cada um.

  • Importante

    Em Administração\Informações de configuração, você pode configurar se a entrada do cliente é obrigatória ou não.

    Requer condição de cliente (padrão = falso)


    • Eventos :  Um evento é um evento ou evento que ocorre dentro da transação que pode determinar uma ação a seguir a partir de sua ocorrência. Por exemplo, número de cliente 10.000. 

        • Number : usado para definir o id ou número do evento.
        • Tipo de Transação – Pode ser usado para definir o tipo de evento.
        • Value : é usado para definir um possível valor que o evento deve ter.
        • Aplica-se a TODOS : Selecionar esta opção incluirá todos os eventos que podem ser inseridos na transação na condição definida, sem considerar os atributos particulares de cada um.


    • Meio de Pagamento :
        • Código : é utilizado para definir o id ou código do meio de pagamento que pretende integrar no conjunto.
        • Tipo : pode ser usado para definir o tipo de pagamento que você deseja integrar ao conjunto.
        • Banco : pode ser utilizado para definir o banco emissor do meio de pagamento que deseja integrar ao grupo.
        • Plano : é utilizado para definir o plano ou planos que o meio de pagamento deverá cumprir para integrar o conjunto.
        • Parcelas : utilizado para definir o valor das parcelas do plano.
        • Prefixo : é utilizado para definir o prefixo que o meio de pagamento deve ter para integrar o conjunto.
        • Bolso : Será possível indicar qual bolso ou subtipo de cartão será avaliado como condição. Exemplo, Cartão A, Bolso de Combustível. Quando uma condição for definida pelo atributo "Pocket", será necessário o carregamento prévio de uma condição pelo atributo "Prefixo" do elemento Meio de Pagamento.
        • Grupo de prefixos : pode ser usado para definir o grupo de prefixos, cadastrados no Promo, que você deseja integrar ao conjunto.
        • Campanha de Crédito : utilizada para definir uma campanha relacionada a um meio de pagamento.
        • Aplica-se a TODOS : A seleção desta opção incluirá todos os meios de pagamento que podem ser inseridos na transação no conjunto de condições, sem considerar os atributos particulares de cada um.


    • Elemento de fidelidade :
        • Id : é utilizado para definir o id ou número do(s) elemento(s) de fidelidade que você deseja integrar ao conjunto.
        • Tipo : é utilizado para definir o tipo do(s) elemento(s) de fidelidade que se deseja integrar ao conjunto.
        • Convenção : é utilizada para definir a convenção à qual pertencerá o elemento a ser incluído no conjunto.
        • Aplica-se a TODOS : Selecionar esta opção incluirá todos os elementos de fidelidade que podem ser inseridos na transação na condição definida, sem considerar os atributos particulares de cada um.

    • Lucro Externo  É um lucro informado pelo PDV e será devolvido como próprio pelo mecanismo Promo.

        • Id : utilizado para definir o Identificador do benefício.
        • Tipo : usado para definir o Tipo de Benefício.


    • transação :

        • Terminal : é utilizado para definir o id ou número do terminal que se deseja integrar ao conjunto.
        • Loja : é utilizado para definir o id ou número da loja que deseja integrar ao conjunto. Apenas as lojas que o usuário logado configurou estarão disponíveis.
                   

        • Canal:  rota ou canal a partir do qual a venda está sendo realizada.
        • Cadeia : cadeia ou linha  a partir da qual se realiza a venda.
        • Formato : é um atributo que será aplicado ao tipo de varejo que se deseja avaliar. Por exemplo: hipermercado, mercado, super mercado, atacadista. São exemplos, pois cada cliente poderá utilizar conforme sua necessidade.
        • Zona : zona geográfica a partir da qual se realiza a transação.
        • Subzona : subzona geográfica a partir da qual a transação é feita.
        • Moeda : multimoedas podem ser usadas. Isso permitirá que você selecione para qual tipo de moeda a promoção será aplicada. Ao fazer a transação no PDV, você pode escolher a moeda, essa informação chegará à Promo e dependendo do tipo de moeda recebida, a promoção será aplicada ou não.

Nota

O botão "Transação" será exibido em laranja porque se refere aos atributos no cabeçalho do ticket.


Importante

Em Administração\Informações de configuração , pode-se configurar se a entrada de uma condição definida por meio do elemento "Transação" é obrigatória ou não.

Exigir condição de transação (padrão = falso)



Multimoneda

Diferentes tipos de moeda podem ser adicionados, para serem usados ​​como “ Condição Simples ” de uma  promoção :

  • Eles podem ser adicionados por catálogo : Os diferentes tipos de moeda podem ser carregados por catálogo, no caso de querer usar moeda estrangeira.
  • Podem ser adicionados diretamente nas Condições Simples : Ao editar ou criar uma promoção, na seção  “ Condições Simples ”, selecionando o elemento “Transação” exibirá o  atributo “ Moeda ” , que exibirá o “Igual” e “Diferente” comparadores. Quando você começar a escrever na caixa de diálogo de cada um deles, ele sugerirá de acordo com o que está carregado no catálogo, se tiver, se não selecionar uma opção sugerida ou se desejar inserir uma opção diferente, você pode escreva-o e pressione a tecla tab nesta tela.

Ao ter o  atributo  " Moeda " você pode definir promoções específicas para uma determinada moeda. Se a moeda não for definida como parte da condição, a promoção será aplicada a todas as moedas.

Para  benefícios da  taxa de desconto  do Novo Preço , no caso de moeda estrangeira, deve ser definida uma exclusão da moeda estrangeira ou promoções específicas devem ser definidas, caso contrário, se a moeda não for definida como parte da condição, ela será aplicada a todas as moedas.  

Para as promoções que utilizam elementos de fidelização ou cupões, deve ter-se em consideração que se a transação for com moeda estrangeira, e se for aplicável a essa moeda, terá de ser resolvida criando um tipo diferente de elemento de fidelização ou cupão (o seu valor aplicará para aquela moeda, não acumulará em ambas).


Utilizando as setas presentes na definição de cada elemento será apresentada a lista de atributos e dentro de cada atributo será apresentada uma lista de  comparadores .


comparadores

As opções que são tratadas para a maioria dos atributos são:

      • IGUAL
      • DISTINTO
      • IDOSO
      • MENOR


Por exemplo, pode-se gerar uma condição para o elemento "Produto", selecionando o atributo "Departamento" e o comparador "Mesmo", onde será exibida a seguinte tela:

Aqui também será possível carregar os dados da condição através de um arquivo, pressionando o botão "Selecionar arquivo". O arquivo a ser carregado pode ser um arquivo .xls ou um arquivo de texto simples separado pelo delimitador configurado.

Nesta tela você pode selecionar o tipo de "entre os elementos". Os elementos podem ser relacionados a eles por meio dos seguintes operadores lógicos: 


    • ADICIONAL "E" A OBTER:  Os elementos definidos neste operador devem ser sempre preenchidos. Permite combinar duas ou mais condições em uma condição composta que será atendida se todas as condições componentes forem atendidas. 

    • "OU" QUE SE CUMPRE:  Os elementos que se definem sob este operador podem ser cumpridos ou não. Permite combinar duas ou mais condições em uma condição composta que será satisfeita se pelo menos uma das condições integrais for atendida. 

Exportando dados de uma Condição Simples ou Condição por Composição para Excel ("a partir de vEP2.2):

Ao definir uma Condição Simples ou uma Condição de Composição, você pode exportar os dados inseridos para um arquivo Excel selecionando o botão "EXCEL" na tela anterior. Esta opção será apresentada em todos os popups de todos os atributos do elemento, seja ele definido por "Igual" ou "Diferente". Pressionando o botão "EXCEL" será feito o download de um único arquivo .xlsx de folha, com os dados presentes no pop-up. Eles serão apresentados na mesma ordem em que foram inseridos no pop up e localizados na coluna A, um abaixo do outro. O nome do arquivo conterá o código promocional, o tipo de condição, o elemento e o atributo que está sendo baixado. 

Exemplo:

      • Promo_2655_CondicionSimple_Product_SKU


IMPORTANTE

O botão "EXCEL" só será habilitado quando houver pelo menos um dado válido carregado no pop up.


OBSERVAÇÃO

A possibilidade de importar dados para o Excel estará disponível tanto para atributos próprios do Promo quanto para atributos dinâmicos.

A exportação de dados quando o pop-up de edição é bloqueado pela quantidade de dados  ("a partir de vEP2.2):

Quando forem carregadas mais de "500" posições no pop up de condições, a possibilidade de edição manual do pop up será bloqueada e caso seja necessário editar os dados inseridos, o sistema solicitará a exclusão de todos os dados e o recarregamento isto.

O botão marcado em vermelho na próxima tela permitirá o download do Excel com os dados da condição quando ultrapassar a quantidade de dados permitida. Este botão só aparecerá quando a opção de edição da condição estiver bloqueada por exceder a quantidade de dados permitidos para edição.




Você pode selecionar o número de atributos que deseja definir na condição. Por exemplo, produtos com o mesmo Departamento de Eletrônica, e que também sejam da mesma Marca da SONY, WHIRLPOOL, HITACHI, PANASONIC e PHILIPS.

Cada elemento tem a opção de poder selecionar " Aplicar a TODOS ", e assim aplicará a condição a todo o conjunto do elemento selecionado.

NOTA

Os conjuntos resultantes também podem ser usados ​​para combinar com outros novos conjuntos. 



  • Condições Simples - Agrupamento

Os  Atributos  definem as características dos elementos com os quais se fará a seleção de pertencer a um determinado conjunto e dependerão do tipo de conjunto ou elemento selecionado. 


Para definir um critério de agrupamento, você deve clicar no ícone "Lápis" que aparece à direita do elemento que deseja agrupar (neste exemplo, o elemento Produtos).


O pop-up "Condições simples (agrupamento)" será apresentado com um menu suspenso mostrando as opções de agrupamento.

Os seguintes comparadores são usados ​​para cada atributo de aplicativo:

      • SEM  AGRUPAMENTO
      • MENOS QUE OU IGUAL A
      • MENOR QUE
      • MAIOR OU IGUAL A
      • MAIOR DO QUE


Se, por exemplo, for selecionado "Maior que", o Pop-Up será exibido com as seguintes opções:


Neste exemplo, será possível indicar para o elemento "Produto" os critérios de agrupamento por "Quantidade", "Magnitude" ou "Preço Total", conforme a imagem a seguir:

Se ao invés do elemento "Produto" tiver sido selecionado o elemento "Clientes", os critérios de agrupamento a serem exibidos serão "Saldos" e "Pontos".

PROMO permite gerir conjuntos agrupando os seguintes elementos:

      • produtos
        • Quantidade: É usado para determinar uma determinada quantidade de um determinado item.
        • Magnitude: Atributo usado para determinar uma magnitude, como:

            • peso (para itens pesáveis: comida, etc.)
            • comprimento (para artigos vendidos a metro: tecidos, tapetes, etc.)
            • volume (para artigos que são vendidos a granel ou por volume – metro cúbico ou metro quadrado – ex.: areia, cerâmica, etc.).
        • Preço Total: É utilizado para definir o preço total de todos os elementos definidos.
      • Cupom
        • Quantidade: utilizada para definir a quantidade de cupons que deseja compor o conjunto.
        • Valor: usado para definir o valor que os cupons que compõem o conjunto devem adicionar
      • Meios de pagamento
        • Quantia


Agrupación por "Pago Total"

Quando uma condição é definida através do elemento " Meio de Pagamento ", pode-se indicar se se deseja avaliar se o referido meio de pagamento cobre o saldo total dos elementos beneficiados. Para isso, clique no " lápis " que está à direita do elemento " Meios de Pagamento " e ali será apresentado o PopUp de "Condições Simples (agrupamento)" e entre as opções de agrupamento propostas estará "Pagamento Total Produtos Beneficiados". Selecioná-lo indicará que o valor do pagamento inserido na transação deve cobrir totalmente os itens beneficiados.


      • Clientes
        • Saldos
        • Pontos
      • Elementos de fidelidade
        • Quantia


Outros exemplos de agrupamento podem ser:


      • A quantidade dos produtos na transação é superior a 10 unidades.


      • A compra mínima é de 1500 pesos.


Definir Condições por composição

As promoções por composição, combo ou pacotes são aquelas que se aplicam quando a formação de um subticket é preenchida com os dados de contexto recebidos do PDV. Esta forma de definição de Promoções terá em conta as iterações no cumprimento da condição definida. Por exemplo: " 2X1 em Fanta ". (A cada duas Fantas vendidas, será aplicado 100% de desconto em uma)

  • A promoção é por Composição ou Combo
     
    • Exemplo: MxN, Compre A + B Grátis B ou Compre A + B +C a um preço especial.


Um combo pode ser composto por N componentes.

IMPORTANTE

Nas promoções de composição ou combo, o(s) elemento(s) a beneficiar  DEVEM  ser definidos como um componente de combo .


Para criar estas promoções é necessário adicionar um ou mais elementos na secção " Condições por composição ".

Cada componente de um combo é formado por um elemento, cada um com sua própria configuração. 

Os " Combos " são grupos ou sub-bilhetes dentro do contexto da transação e os benefícios serão aplicados quando as condições indicadas nos referidos sub-bilhetes forem atendidas, como se fosse um bilhete completo. 

Para adicionar um componente de combo, o botão "Adicionar" deve ser selecionado e os elementos com os quais os combos podem ser definidos serão exibidos conforme a imagem a seguir: 


Ao selecionar um dos elementos, será exibido o seguinte Pop-Up: (neste exemplo, foi selecionado o elemento "Produtos")

Os seguintes dados estão associados a um componente de combinação :

  • Limite de aplicação : Indica o limite máximo de combo a ser formado dentro de uma transação. Este parâmetro não admite 0 (zero) como valor, mas se não for definido um Limite (deixando a caixa em branco) podem ser formados tantos combos quanto possível por transação. O campo não é obrigatório.
  • Tipo de elementos: Elementos com os quais os combos serão montados, e são definidos em primeira instância da definição de condição por composição (produtos, cupons, clientes, meios de pagamento e elementos de fidelização).
  • Ocorrências Mínimas: Valor real que representa a quantidade mínima necessária para compor a condição por composição ou combo. Este parâmetro não aceita 0 (zero) como valor.
  • Máximo de Ocorrências: Valor real que representa o valor máximo necessário para compor a condição. Este parâmetro não aceita 0 (zero) como valor.

NOTA

Em geral, mínimo e máximo serão usados ​​com valores iguais.


  • Unidade de medida : Este parâmetro define os critérios com os quais o agrupamento do conjunto será realizado. 

Se o "Tipo de Item" selecionado for "Produto", a combinação suspensa Unidade de Medida mostrará as opções "Quantidade", "Magnitude", "Preço Total".

Se o "Tipo de item" selecionado for "Cupons", a combinação suspensa Unidade de medida exibirá as opções "Quantidade" e "Valor".

Se o "Tipo de Item" selecionado for "Meio de Pagamento", o combo suspenso de Unidade de Medida exibirá a opção "Valor".

Se o "Tipo de Item" selecionado for "Clientes", o combo suspenso de Unidade de Medida mostrará as opções "Saldo" e "Pontos".

Se o "Tipo de item" selecionado for "Itens de fidelidade", a combinação suspensa Unidade de medida exibirá a opção "Valor".


Os critérios de seleção definem de forma mais limitada a seleção dos elementos do contexto para a formação das condições por composição (pacotes ou combos).
Podem ser definidos nos benefícios da promoção e na definição de condições por composição . Eles só podem ser aplicados a conjuntos do tipo de produto.

  • Critérios de ordenação : Indica os critérios de ordenação dos elementos do conjunto definido. ( Mais caro primeiro, Mais caro por combo, Mais barato primeiro, Mais barato por combo )
  • Critérios de equivalência: Este tipo de parâmetro indicará os atributos pelos quais pode ser definida uma equivalência ou igualdade entre os elementos que irão compor o conjunto, por exemplo, “ Carregando dois sucos do mesmo sabor , 2X1 em sucos da Marca X ”, em neste caso o critério de equivalência seria o código dos Sucos da marca X já que agrupará cada dois do mesmo sabor.
  • Critério de inequivalência : Este tipo de parâmetro indicará os atributos pelos quais pode ser definida uma inequivalência ou desigualdade entre os elementos que irão compor o conjunto, por exemplo, " Carregando dois sucos de sabor diferente , 2X1 em sucos da Marca X ", neste caso o critério de inequivalência seria o código dos Sucos da marga X já que agrupará cada um dois sucos de sabor diferente .


NOTA

Se no   botão Adicionar  foi selecionado o elemento " Meio de pagamento " nos  critérios de Equivalência,  serão exibidas as seguintes opções:   [indistinto], Código, Tipo, Banco, Plano, Taxas, Valor do Item, Prefixo, Campanha de Crédito . E em  Critérios de Inequivalência  serão mostradas as seguintes opções:  [indistinto], Valor do Item, Plano, Tipo, Banco, Valor, Prefixo, Código, Taxas, Campanha de Crédito. 

A opção "Critérios de Ordenação" não estará disponível para o elemento "Meio de Pagamento"


Exportação para Excel dos dados carregados nas condições

Será possível tanto nas definições de condições simples quanto nas condições por composição, exportar os dados carregados para excel. Para fazer isso, você deve pressionar o botão "EXCEL" que está localizado na margem inferior direita dos popUps.

Este botão só estará ativo quando houver pelo menos um item carregado na condição. 

Apertando o botão "EXCEL" será baixada uma planilha com todos os dados contidos na condição.

O nome do arquivo irá detalhar a qual promoção e tipo de condição ela pertence. Exemplo: " 10001_condicion_simple_productos_departamento.xlsx "


Definir benefícios

Os Benefícios são parte integrante das Promoções e são atribuídos para determinar a consequência de ter cumprido as condições de uma promoção.

O benefício é uma vantagem econômica ou material que é concedida a um cliente mediante o cumprimento de determinadas condições.

As vantagens aplicam-se sobretudo ao conteúdo do bilhete ou aos subbilhetes conforme tenham sido reunidos por condições simples ou por composição.

As promoções definidas por condições simples, entregam o benefício apenas com o cumprimento das condições definidas.

Promoções com condições por composição, entregam o benefício em cada pacote ou combo que for definido.

Você deve pressionar " Novo benefício " para acessar a janela de definição do benefício.



Será exibida a tela " Novo Benefício ", onde serão exibidas as seguintes opções:

  • Promoção : Mostra o nome da promoção.
  • Aplica-se em condições? :  Por padrão, esta caixa estará marcada, portanto o benefício será aplicado aos mesmos elementos definidos na condição. Caso esteja desmarcada no ato do registro do benefício, o universo de aplicação do benefício deve ser definido manualmente, podendo indicar outro(s) elemento(s) que não fazem parte da condição. Se você optar por usar os mesmos elementos para a definição do universo do aplicativo, este último poderá ser editado, mas se o fizer, a verificação "Aplica-se às condições" será destilada automaticamente, pois o conjunto beneficiado não será mais o mesmo como o conjunto da condição. Na edição de benefícios, esta verificação permanecerá acinzentada.
  • Tipo de benefício : Refere-se a se o benefício é Monetário ou Não Monetário . O comportamento do benefício vai depender desse valor.


Benefícios Monetários:


Caso seja selecionada a opção Monetário em Tipo de Benefício , em “Classe de Benefício” poderá ser selecionado:

  • Resgate de Cupom Calculado:  será aplicado na transação o valor do desconto informado pelo cupom informado. (Para visualizar esta opção, o cliente deve ter adquirido o módulo de fidelidade PROMO) .





Canje de cupón calculado: Acumular el monto de beneficios en un cupón único

A opção " Acumular o valor do benefício em um único cupom " indica se o benefício se aplica ou não ao valor acumulado em um único cupom.

Ao aplicar um benefício não monetário da classe de cupons calculados, deve ser emitido um único cupom que acumule o valor de todos os itens beneficiados (aplicar grupos  ) .

Se for especificado mais de 1 cupom, o benefício é dividido pelo número de cupons a serem emitidos, ou seja, se 100 pesos devem ser dados em benefício e foram colocados 2 cupons, são emitidos 2 cupons de 50 pesos cada.

Para fazer isso, no console, marque a caixa de seleção "Acumular a quantidade de benefícios em um único cupom":

Exemplo: a promoção é criada:

A venda é feita:

Ao criar um mapa, caso seja indicado no benefício que se aplica, será gerado no mapa o seguinte atributo acumuleInSingleCoupon, no cupom benefício calculado, em true:

Eu faço uma venda:

E como está desmarcado, terá um valor falso:


  • Benefício Externo  :  é um benefício informado pelo PDV e retornado pelo motor Promo como próprio. Deve ser indicado o ID do benefício externo a ser aplicado.

Beneficio Externo

Para a correta configuração e aplicação de uma promoção que aplique um benefício externo, deve-se definir o seguinte:

  • Condição :

Selecionando o elemento "Benefício Externo" na secção "Condições Simples", deve indicar se o benefício externo a aplicar é identificado por <Tipo> ou <Id> do PDV. Na promoção poderão ser definidas mais condições por mais elementos que condicionam ainda mais a aplicação do benefício, mas a definição da condição através do elemento Benefício Externo será fundamental para a correta aplicação da promoção.


  • benefício :

Na promoção deve ser adicionado um benefício do tipo Monetário, da classe "Benefício Externo" onde deve ser indicado o mesmo Tipo definido na condição, ou o mesmo tipo ao qual o ID do elemento do benefício externo definido na condição pertence.


Desta forma, quando o PDV enviar o elemento Benefício Externo com o Tipo definido em “a” será aplicado o valor ou percentual do desconto informado pelo PDV no elemento “Benefício Externo”.

(Para mais informações sobre a integração com o PDV, consulte o Manual de Integração, Benefícios >> Benefício Externo)


  • Troca com Opções : Neste tipo de Benefício, poderá ser indicado, com base nos pontos apresentados pelo cliente, quais opções de benefício monetário serão acessadas, dentre as quais: “Desconto Fixo”, “Desconto Percentual” e “Novo Preço” . Estas opções de benefícios serão informadas ao PDV, para que o cliente escolha e de acordo com o que for escolhido, será aplicado o benefício correspondente.

NOTA: Canje con Opciones

Para a correta configuração e aplicação de uma promoção que aplique um benefício da classe “Câmbio com Opções”, deve-se definir o seguinte:

As condições definidas na promoção serão aquelas definidas pelo lojista para indicar em que horários o cliente acessará as opções propostas na “ Troca com Opções ”:

Ao definir um novo benefício, será indicado que o mesmo é do tipo “Monetário”, da classe “Câmbio com Opções”.

Ao selecionar este tipo de benefício você pode inserir "Opções" que o posto irá propor ao cliente com base nos pontos que ele possui.


No campo “Benefício a Aplicar” pode selecionar entre os benefícios monetários que pretende aplicar (“Desconto Fixo”, “Desconto Percentual” ou “Novo Preço”).


Ao selecionar um dos benefícios, serão apresentados os campos de definição do benefício e os pontos a apresentar pelo cliente e/ou elementos de fidelização para aceder ao referido benefício.

A tecla "Adicionar Opção" deve ser pressionada para que o que for definido seja incorporado como opção dentro dela. Para que o benefício seja considerado completo, pelo menos uma opção deve ser informada. Você pode inserir quantas opções forem necessárias.

Depois que uma opção é adicionada, ela não pode ser editada, deve ser removida e adicionada novamente.


Quando as condições definidas na promoção forem atendidas, o mecanismo avaliará se o valor de pontos do item inserido está coberto pelos pontos obrigatórios definidos no benefício. Se não for suficiente, o benefício não se aplica. Se o valor em pontos do item for menor que os pontos exigidos no benefício, o benefício não é aplicado.


Da mesma forma, poderá ser indicado se o benefício a ser concedido contempla a existência de Pontos de elementos de Fidelidade . Ao fazer isso, por exemplo, selecionando "Desconto Percentual", as seguintes opções serão apresentadas.

Os campos " Tipo de Elementos Fidelidade " e " Pontos Elementos Fidelidade " serão opcionais e somente quando forem carregados será validado que foi inserido na transação um cartão do tipo definido e com os pontos necessários para a concessão do benefício.

No campo " Tipo de Elemento de Fidelização " deverá indicar o código do tipo de elemento de fidelização a avaliar para aceder ao desconto. Já no campo “ Pontos Elemento Fidelidade ” deve ser definido o número de pontos a apresentar para obtenção do benefício.


Cenários para definição de promoções de resgate de pontos fidelidade:

  • pontos de fidelidade

Exemplo: "Apresentando 10 Pontos Fidelidade Vermelho" ganhe 100% de desconto em refrigerantes
>> A condição será a venda de pelo menos um refrigerante.
>> O benefício a ser aplicado será uma >> Troca Monetária com opções, definidas a seguir:


  • Pontos Fidelidade + Desconto Monetário

Exemplo: "Apresentando 10 Pontos Fidelidade Vermelho " ganhe 50% de desconto em refrigerantes



  • Pontos de fidelidade + desconto monetário + pontos de cliente 

Exemplo: "Apresentando 10 Pontos Fidelidade Vermelho e resgatando 100 pontos ganhe 50% de desconto em refrigerantes


  • Pontos Fidelidade + Pontos Cliente

Exemplo: "Apresentando 10 Pontos Fidelidade Vermelho e resgatando 100 pontos ganhe 100% de desconto em refrigerantes


OBSERVAÇÃO:

Todas as opções podem coexistir dentro do mesmo benefício Troca com Opções.


(Para mais informações sobre a integração com o POS, consulte o Manual de Integração, Benefícios >> Câmbio com Opções)


IMPORTANTE

Cálculo dos pontos a consumir com base nos produtos inseridos pela Magnitude:

Quando uma promoção que concede o benefício Resgate com Opções for definida com base na unidade de medida “Magnitude” (tanto na condição Simples quanto na Composição), o cálculo dos pontos a serem consumidos será baseado em 1 (um) quilo. Dessa forma, será possível indicar, com base nos pontos exigidos pela opção de benefício, quantos pontos serão necessários para obter o benefício de um produto mensurável.

Os pontos informados nas opções serão sempre os calculados com base em 1 (um) quilo. Ao selecionar uma das opções, a engine retornará a quantidade de pontos calculada com base na magnitude enviada para o(s) produto(s) beneficiado(s).


Exemplo : Você pode comprar maçãs com 20% de desconto trocando 200 Pontos.

O que for definido na promoção será a base de cálculo, ou seja, a quantidade de pontos necessários para o Quilo (un).

Quando o cliente selecionar esta opção, o motor calculará, com base na magnitude informada para as maçãs da pos, o número de pontos necessários para acessar o benefício.


magnitude relatadapontos necessários
1 (k)200 (definido)
0,80 (k)160
5(k)1000

Beneficio Canje con Opciones Evaluado en un paso Maximo Descuento Combinado

A partir desta versão, está habilitada a possibilidade de avaliar promoções que concedam benefício Monetário da classe “ Câmbio com Opções ” .

Ao incluir este benefício na avaliação da função de coexistência “Desconto Máximo Combinado”, pode-se propor ao cliente a opção que aplica o melhor desconto ao contexto da transação. Caso o cliente não escolha uma opção, será concedida a seguinte promoção ou promoções que proporcionem o melhor benefício para o contexto dado.


IMPORTANTE

As promoções que concedem esse benefício, quando estiverem dentro dessa função de convivência, poderão ter um número indefinido de opções, mas no momento da avaliação no motor, apenas as duas primeiras opções serão levadas para avaliação.

Calculo de puntos a otorgar cuando en la misma transacción se aplica un beneficio Canje con opciones donde se redimen puntos

Quando na mesma transação for concedida uma promoção que atribua pontos (seja Promo próprio ou externo), pode-se indicar através de mensagem entre Promo e o PDV, que o motor faça os cálculos correspondentes para que apenas os pontos a serem calculados sejam premiados com base nos valores não beneficiados com a promoção de resgate com opções de resgate de pontos.

O cálculo só será feito quando o correio enviar os dados necessários para realizar o cálculo no elemento pago e quando estiver sendo aplicado um benefício de troca com opções que resgatem pontos.

Para obter mais informações sobre mensagens, consulte o manual de integração Promo-ENGINE >> Atributos de comando > elemento " payment " .



  • Desconto Fixo:  aplica-se um desconto de valor fixo ao preço dos elementos do conjunto de artigos selecionado. Pode ser aplicado a cada unidade (na quantidade ou na magnitude) ou em todos os elementos do conjunto.
  • Desconto percentual:  aplica-se um desconto percentual ao preço dos elementos do conjunto de artigos que selecionou. Pode ser aplicado a cada unidade (na quantidade ou na magnitude) ou em todos os elementos do conjunto.
  • Novo Preço:  é atribuído um Novo Preço aos elementos do tipo de produto selecionado e a diferença entre o preço original e o novo preço é aplicada como desconto. Pode ser aplicado a cada unidade (na quantidade ou na magnitude) ou em todos os elementos do conjunto. Por exemplo: se o produto valer $ 10 e o novo preço for $ 8, você terá um desconto de $ 2. Quando for necessário aplicar um novo preço, a engine calculará a diferença entre o preço do produto e o novo preço informado pelo benefício, e aplicará como desconto ou sobretaxa, conforme o caso.

Aplicacion Nuevo precio informado por Externo

Poderá ser indicado no momento da definição do benefício se o novo preço a ser aplicado será informado por pessoa externa quando determinada quantidade de produtos vendidos for atingida.

Tanto a quantidade de pontos necessários quanto o novo preço a ser aplicado a partir desse valor serão informados no nível do item da pos.

Isso pode ser indicado marcando a caixa "Preço informado pelo PDV". Ao fazer isso, o campo de definição do novo preço e quantidade ficará acinzentado, pois esses dados serão informados da pos.



  • Resgate de Pontos: é aplicado um desconto calculado pela promoção, baseado na quantidade de pontos, dinheiro, valores, etc. Adicionado à transação ao apresentar o elemento de fidelidade que os contém. (Para visualizar esta opção, o cliente deve ter adquirido o módulo de fidelização PROMO)
  • Desconto por acordo : será aplicada uma percentagem de desconto sobre o preço dos elementos do conjunto de artigos participantes. Pode ser aplicado a cada unidade (na quantidade ou na magnitude) ou em todos os elementos do conjunto. Este benefício funcionará da mesma forma que o “Desconto Percentual” só que quando nele for definido um limite, só poderá ser para Clientes e somente acumulará Dinheiro. Nos casos em que este benefício é aplicado, e tenha sido identificado um cliente na transação, o valor do desconto aplicado acumulará sobre ele e este ajustará o desconto ao limite definido sem ter margem para ultrapassar (Estes tipos de benefício só pode ser aplicado a elementos do tipo de produto.)

    Definición de "Balance" en Beneficio Monetario "Descuento por Convenio"

    Poderá ser indicado, no momento da definição do Benefício Monetário, Desconto por Convênio, se o limite do cliente a ser considerado para o cálculo do valor do desconto a ser aplicado neste benefício, for o administrado pela Promo ou se o o saldo do cliente será informado no PDV.

    No caso de ser informado pelo posto, deve ser indicado no campo "Saldo", podendo selecionar entre as opções que são inseridas pelo catálogo de Saldo, pois foi integrado ao posto.

    A partir da Promoção 7.2


    (Para mais informações Ver Manual de Integração Promo 7.2 - Benefícios)

  • Resgate de Pontos por Catálogo:    é aplicado um desconto Percentual, Fixo ou Alteração de Preço de acordo com uma tabela predefinida para determinados produtos (ver  Catálogos ) em troca de uma quantidade de pontos também definidos na mesma tabela. 

    (Esses tipos de benefício só podem ser aplicados a elementos do tipo de produto.)

Caso de Uso: Canje de Puntos por Catalogo

Deve ser definido um Benefício Monetário, “Troca de Pontos por Catálogo”, devendo ser especificado o tipo de cartão que será aplicado para a avaliação da troca de pontos conforme indicado no catálogo “CatálogoResgatarBenefício  .


Uma vez definido o benefício, a promoção que o contém pode ser adicionada a um mapa e distribuída às lojas que se candidatarem.

Deve-se definir o catálogo onde se indica Loja, código do produto, pontos requeridos, valor do desconto e tipo de desconto, respeitando esta ordem das colunas.

Leve em consideração que a condição de promoção deve conter a definição de algum dos atributos dos itens definidos na tabela. (exemplo: a condição do botão indica "Para todos os produtos da marca Sony" e a tabela deve indicar SKUs que correspondem à marca Sony)

Loja (código da loja onde se aplica, - indicar todas)

código  (código do produto)

pontos (pontos necessários)

valordesconto (Valor do desconto)

tipodesconto (Tipo de desconto)

B320

1000

100

10

perc

-3000305perc
B3206027fixo
A922

1001

80

1500

fixo

B320

1002

70

487,89

npreço

  • Caso o código da loja não seja indicado, presume-se que a referida opção de resgate se aplica a todas as lojas.

Para o exemplo dado, quando na loja B320 é inserido em uma transação um item da marca Sony, e este é o código="2000", e na transação também há um cartão do tipo "555" com os pontos suficientes para efetue a troca conforme, neste caso "80", será aplicado um desconto fixo de $27 no código do item="2000"


Para cada um dos Benefícios Monetários, também deve ser indicado

    • Valor , Porcentagem ou Preço conforme apropriado para o benefício monetário selecionado.
    • Unidade de medida na qual aplicar. Este parâmetro permite definir em que será aplicado o benefício. Ser capaz de selecionar entre Cada unidade de quantidade, Cada unidade de magnitude Todos
    • Porcentagem , quantidade e tipo se for um cupom calculado.
    • Tipo e Fator : Se for um benefício de troca de pontos.
    • Valor Payback : utilizado para indicar o valor que vai concorrer com outra promoção na análise do mapa, se esta promoção for utilizada com a característica de "Desconto Máximo Combinado", e se der como benefício o mesmo valor de outra promoção nesse mesmo map sob a mesma função. A promoção que tiver o maior valor neste campo será premiada. Por exemplo: se duas promoções oferecem um benefício de $ 5 e ambas estão em um mapa na função "Desconto máximo combinado", se a promoção A tiver um "Valor de recuperação" de 3 e "Tipo de recuperação", é por exemplo . porcentagem e a promoção B tiver um "Valor de recuperação" de 5 e o "Tipo de recuperação" também for uma porcentagem, o benefício da promoção B será concedido.
    • Tipo de recuperação : permite selecionar se o valor indicado no campo anterior é uma porcentagem ou um valor fixo.
    • Rateio entre participantes: poderá ser indicado se o valor do desconto concedido pelo benefício monetário definido será rateado entre os participantes da condição de promoção. Exemplo:  "Na compra de uma batata frita, um hambúrguer e um refrigerante, o mais barato ganha 100% e o valor do desconto é distribuído proporcionalmente entre os 3 itens que participam da condição".

Caso de uso : Prorrateo entre participantes

Quando um benefício estiver com a opção "Proporcionar entre Participantes" marcada, o valor do desconto a ser concedido será distribuído proporcionalmente entre os itens participantes da promoção. Por exemplo:

Na promoção "Comprando um Hambúrguer e um Refrigerante, leve a fritada de graça", a condição será atendida quando os três itens forem encontrados no ticket, e o benefício será aplicado na fritada, por exemplo, o valor do desconto ( 100% em batatas) é $ 75. Quando a opção "Proporcionar entre participantes" estiver marcada , o desconto de $ 75 não será aplicado apenas ao item batata, mas cada item receberá uma parte proporcional do valor total do desconto. Deixando os itens participantes afetados pelo desconto:

Item$ vendaValor do desconto
Hamburger$ 150

$ 35,71

Refrigerante$ 90$ 21,43
Batatas$ 75$ 17,86



RECUPERO en Beneficios Monetarios

Ao definir um benefício monetário, pode-se indicar que tipo e valor de recuperação esse benefício terá para o Varejo. Dessa forma, o benefício pode ser identificado a partir do pos e o lojista pode detectar qual é a sua margem de lucro de acordo com a forma como esses campos são definidos.

Este valor de recuperação será levado em consideração quando o benefício fizer parte de uma função de coexistência "Desconto Máximo Combinado " . Dessa forma, quando dois benefícios dentro dessa função de coexistência concederem o mesmo valor de desconto no mesmo universo de aplicação, a engine poderá detectar e aplicar o desconto que tiver o maior valor de recuperação definido.


Obligatoriedad de los campos de recupero

Quando um dos campos de recuperação ("Valor" ou "Tipo") for carregado, o outro campo será obrigatório como carregamento obrigatório (a partir do EP2.2)




Benefícios NÃO Monetários:

Caso seja selecionada a opção Não Monetário em Tipo de Benefício , em “ Classe de Benefício ” poderá ser selecionado:

  • Benefício Geral:   a aplicação do benefício é a entrega de um ou mais benefícios gerais que devem ser interpretados pelo pos conforme a integração corresponde. (Exemplos de integração: Reembolso de IVA - Caso de Sucesso - O pos é quem vai calcular o valor do IVA dos artigos e o Promo, com base na aplicação deste benefício, vai indicar quais os artigos que vão aplicar o benefício).
  • Carteira  : para poder visualizá-la, a funcionalidade Carteira deve ser ativada pelo Usuário Principal . Por padrão, a funcionalidade Wallet está desativada. É apenas um benefício informativo .


Información sobre Monedero

As informações a serem exibidas no campo "Carteira" vem por catálogo se for integrado ao Vtol será um campo de preenchimento automático então vai mostrando as informações conforme você digita, se não for integrado ao Vtol você pode preencher manualmente com o que você quer.

Para receber informações Vtol você deve configurar em Administration\ Configuration Information, em vtol.url =  https://demo.napse.global:8554/v1/configuration?merchantCode=65

o url para obter as carteiras Vtol.

Por exemplo: Se você paga com Modo e tem 365, tem um limite máximo de 200 (campo Limite) e eles te dão 10% de desconto (campo Porcentagem). Todos esses são campos informativos.


  • Cupom:  a aplicação do benefício consiste na emissão de cupons.

IMPORTANTE.

No resgate de um cupom (emitido por meio da aplicação do benefício não monetário " Cupom "), deve-se considerar que o tipo de cupom ao qual pertence o cupom a ser resgatado deve ser definido como condição na promoção de resgate. Caso não seja definido, no momento da finalização da transação, a Promo retornará uma mensagem de erro, informando que os requisitos para resgate do cupom do benefício concedido pela promoção não foram atendidos.


Datos para el Pos

Ao selecionar a classe " Cupom ", será possível indicar no combo "Dados para o PDV" se informações adicionais são enviadas ao PDV no momento da comunicação do benefício.

Os nomes das duas opções a serem exibidas no combo podem ser definidos na seção "Administração", "Informações de configuração". Com base nessas opções, o PDV poderá realizar ações específicas no momento da concessão do benefício do Cupom e dependerá de como isso for implementado no varejo.

O campo "Dados para o PDV", mostrará por padrão as opções: "Indistinto" (estará sempre presente e se selecionado, nenhuma informação extra será indicada ao PDV referente aos dados do PDV), Campo 1 e Campo 2. (Consulte Administração >> Informações de configuração)




A promoção que resgata o cupom deve ser criada:



  • Cupom calculado:  a aplicação do benefício consiste na emissão de cupons de um determinado valor de desconto calculado com base no total da transação. (Para visualizar esta opção, o cliente deve ter adquirido o módulo de fidelização PROMO).


Aplicación del Cupón Calculado

Ao selecionar a classe " Cupom Calculado ", aparecerá o combo "Aplicável*", onde você poderá selecionar:

  • Percentagem
  • Quantia fixa
  • Valor Externo


Cupom calculado definido por PERCENTAGEM:

Ao selecionar, será exibido o campo " Porcentagem " onde você deverá informar o número que representará a porcentagem com a qual será calculado o valor do cupom a ser emitido.


A promoção que resgata o cupom deve ser criada:

Quando o cupom for usado, esse cupom é digitalizado no PDV. O PDV envia à Promo o número do cupom. Promo procura no banco de dados as informações desse cupom. Aí se fosse por exemplo. um cupom calculado que dá 10% de desconto para a próxima compra, pega essa informação do banco de dados e o Promo calcula 50% do ingresso atual porque o cupom está sendo resgatado.


IMPORTANTE

O valor do cupom não pode ser consumido em transações diferentes. Se em uma transação houver sobra no cupom; este está perdido.


Com esta definição, será indicado que a promoção dará como benefício o valor que o cupom informado carregou no banco de dados.


Caso seja necessário delimitar melhor a aplicação do benefício, maiores informações poderão ser especificadas nos campos “Forma de rateio”, “Aplica-se a...” e “Critérios de ordenação”.


Cupom calculado definido por VALOR FIXO:

Ao ser selecionado, será exibido o campo " Valor Fixo " onde você deverá informar o número que representará o valor ou valor com o qual o cupom será emitido na aplicação do benefício.



Cupom Calculado definido pelo VALOR EXTERNO:

Ao selecioná-lo, não será proposto definir um valor ou percentual, pois este dado será informado pelo PDV (ou por parte externa).


Emisión de cupones calculados considerando descuentos que modifiquen el saldo del producto beneficiado en un mismo paso (adjustCalculatedCoupon)

Ao calcular o valor de um cupom calculado que será emitido no ponto de venda, pode-se indicar por configuração, se o valor a ser atribuído ao cupom será calculado com base no preço beneficiado ou no preço original do produto beneficiado , quando as promoções são encontradas dentro da mesma etapa.

Para isso, o parâmetro </adjustCalculatedCoupon> deve ser definido no config.xml do motor como " true " (consulte PROMO - Manual de Instalação 7.2) e o benefício concedido pelo cupom calculado deve ser definido para que opere com o preço beneficiado .

Levando em consideração que dentro da mesma etapa, os benefícios são calculados com base no valor do produto com o qual eu entro na etapa, quando esta funcionalidade é ativada, para calcular o valor do cupom calculado, os benefícios que podem ser aplicados dentro do etapa.






  • Coeficiente de fidelização:  a aplicação do benefício consiste em conceder um fator de multiplicação da unidade utilizada nos sistemas de fidelização.

  • Percentagem de fidelização: a percentagem de pontos é aplicada sobre o preço dos elementos do conjunto de artigos que selecionou. Permite calcular os pontos que correspondem ao prémio com base na percentagem e no preço alargado dos artigos a que se aplica.

  • Pontos de fidelidade:  a aplicação do benefício consiste em conceder pontos, milhas, pesos a uma carteira eletrônica ou à unidade utilizada para sistemas de fidelidade. O motor de promoções calcula os pontos que este benefício confere, que podem ser aplicados a cada unidade (na quantidade ou na grandeza) ou em todos os elementos do conjunto. Ou seja, agora será possível definir, através deste benefício, vantagens como: atribuir pontos por cada artigo do departamento X ou atribuir P ​​pontos na compra de artigos do departamento X.



A partir desta versão, o campo "Ignorar pagamento com pontos" é incluído nos benefícios que concedem pontos (fator, coeficiente e pontos de fidelidade).

Esta funcionalidade permitirá ao TPV gerir a informação necessária para identificar, se aplicável, quando está a ser atribuído um benefício de resgate de pontos em simultâneo com um benefício que atribui pontos, e apenas conceder os pontos que correspondam ao pagamento efetuado e que não não correspondem à troca de pontos.

Ao detectar na transação que existem benefícios de fidelidade (“Coeficiente de Fidelidade”, “Percentual de Fidelidade” e “Pontos de Fidelidade”) que contenham o atributo "Ignorar Pagamento com Pontos" em falso (desmarcado) a lógica de cálculo será aplicada para obter o número final de pontos a serem atribuídos

Por padrão, o sinalizador estará desmarcado (falso) indicando que os pontos não devem ser acumulados em pagamentos feitos com pontos.


Caso Prático:

  • Promoção 1: Troca com Opções (Trocar Pontos - "Pagar Pontos")

  • Promoção 2: Coeficiente de Fidelidade (Grants Points)

Mapa

  • Passo 1:
    • Promoção 1 (na função Todos)
  • Passo 2:
    • Promoção 2 (em Todas as funções)


Um item por $ 43.900 é vendido.


A engine informará o aplicativo da Troca de benefícios com opções, onde o cliente deverá optar por consumir os 500 pontos para ter acesso ao benefício de -20% sobre o item vendido.

O motor também informará, neste momento, que 62 pontos estão sendo concedidos pela aplicação do benefício do coeficiente de fidelidade.

<?xml version="1.0" encoding="UTF-8"?><message ack="0" channel="T" companyId="napse" engine="7.1.7-SNAPSHOT" mapversion="712" messageId= "" store="0013" terminal="022">
  <opcional>
    <promo code="4280468" id="Resgatar com opções - Resgatar pontos" nro="61545e4116f79a304cced688">
      <benefit TLOGMessage="Resgatar com opções" a789="1" account="" applicationMethod="lineByLine" baseAmount="43900" BenefitType="RedeemWithOptionsBenefit" displayMessage="Resgatar com opções" name="61545e4116f79a304cced688" nro="61546274 16f79a304cced6 a8 " order="1" printerMessage="Resgatar com opções" prorationMethod="PROPORCIONAL" usedPoints="0">
        <aplicar>
          <item magnitude="0.000" qty="1.000" seq="1" value="0" valueWithTaxes="0" xprice="43900"/>
        </aplicar>
        <redeemOptions>dfgdfgdfgdfg
          <option BenefitType="percentageDiscount" cardPoints="0.0" cardType="-" id="6154627416f79a304cced6a8_0" requiredPoints="500.0" unit="qty" value="20.0"/>
        </redeemOptions>
      </benefício>
    </promo>
    <promo code="4280467" id="Award Points" nro="6153983116f79a304cced625">
      <benefit TLOGMessage="Prêmio Pontos de Fidelidade" account="" applicationMethod="lineByLine" baseAmount="43900" BenefitType="FactorLoyaltyBenefit" displayMessage="Prêmio Pontos de Fidelidade" name="6153983116f79a304cced625" nro="61545cc81 6f79a304cced685 "fator=" 0 " order="2" printerMessage="Prêmio Pontos de Fidelidade" totalpoints="62" type="external">
        <aplicar>
          <item magnitude="0.000" points="62.71" qty="1.000" seq="1" value="0" valueWithTaxes="0" xprice="43900"/>
        </aplicar>
      </benefício>
    </promo>
  </opcional>
</mensagem>


Quando a aplicação da opção de resgate de pontos escolhida pelo cliente for enviada do PDV, a engine retornará o benefício de resgate com opções já com as informações correspondentes ao consumo dos 500 Pontos bem como o valor do desconto aplicado.

Neste ponto, ao detectar no motor que será feito um "pagamento" com pontos correspondente ao pedido de troca com opções, será afetado o benefício que concede pontos e será informada a nova quantidade de pontos, que neste caso será ser cinquenta.

<?xml version="1.0" encoding="UTF-8"?><message ack="0" channel="T" companyId="napse" engine="7.1.7-SNAPSHOT" mapversion="712" messageId= "" store="0013" terminal="022">
  <opcional>
    <promo code="4280468" id="Resgatar com opções - Resgatar pontos" nro="61545e4116f79a304cced688">
      <benefit TLOGMessage="Resgatar com opções" a789="1" account="" applicationMethod="lineByLine" baseAmount="43900" BenefitType="RedeemWithOptionsBenefit" displayMessage="Resgatar com opções" name="61545e4116f79a304cced688" nro="61546274 16f79a304cced6 a8 " order="1" printerMessage="Resgatar com opções" prorationMethod="PROPORCIONAL" usedPoints="500">
        <aplicar>
          <tem 6154627416f79a304cced6a8_0" seq="1" usedPoints="500" value="5280" valuePoints="3500" valueWithTaxes="5280" xprice="43900"/>
        </aplicar>
      </benefício>
    </promo>
    <promo code="4280467" id="Award Points" nro="6153983116f79a304cced625">
      <benefit TLOGMessage="Prêmio Pontos de Fidelidade" account="" applicationMethod="lineByLine" baseAmount="35120" BenefitType="FactorLoyaltyBenefit" displayMessage="Prêmio Pontos de Fidelidade" name="6153983116f79a304cced625" nro="61545cc81 6f79a304cced685 "fator=" 0 " order="2" printerMessage="Prêmio Pontos de Fidelidade" totalpoints="50" type="external">
        <aplicar>
          <item magnitude="0.000" points="50.17" qty="1.000" seq="1" value="0" valueWithTaxes="0" xprice="43900"/>
        </aplicar>
      </benefício>
    </promo>
  </opcional>
</mensagem>


O cliente pode então optar por liquidar a transação com pontos de fidelização, podendo solicitar ao motor que o referido pagamento com pontos não seja contabilizado para o cálculo dos pontos já atribuídos pela promoção 2.

Para isso, o atributo pointsType= deve ser incluído na mensagem que informa o pagamento ( <payment-add/> ) , informando ali o tipo de cartão que acumula os pontos ou, no caso de pontos externos, a palavra " externo "

<?xml versão="1.0" codificação="UTF-8"?>
<message channel="T" cia="1" city="58" companyId="napse" date-time="2021-08-30 18:23:17" avalia="true" format="H" init- tck="false" limitBalances="true" localidade="1" map-version="712"
 status="venda" store="0013" storeChain="S" subZone="1" terminal="022" tipologia="oi" zonaprecio="E22" zona="1">
<payment-add amount="35120" balance="true" itemamount="35120" pointsType="external" seq="2" type="11"/>
</mensagem>


Desta forma, o motor irá incorporar o novo benefício " PromoçãoPaidInPoints " na mensagem enviada para o PDV, onde serão informados os pontos que deverão ser deduzidos aos pontos já atribuídos anteriormente.

<?xml version="1.0" encoding="UTF-8"?><message ack="0" channel="T" companyId="napse" engine="7.1.7-SNAPSHOT" mapversion="712" messageId= "" store="0013" terminal="022">
  <opcional>
    <promo code="4280468" id="Resgatar com opções - Resgatar pontos" nro="61545e4116f79a304cced688">
      <benefit TLOGMessage="Resgatar com opções" a789="1" account="" applicationMethod="lineByLine" baseAmount="43900" BenefitType="RedeemWithOptionsBenefit" displayMessage="Resgatar com opções" name="61545e4116f79a304cced688" nro="61546274 16f79a304cced6 a8 " order="1" printerMessage="Resgatar com opções" prorationMethod="PROPORCIONAL" usedPoints="500">
        <aplicar>
          <tem 6154627416f79a304cced6a8_0" seq="1" usedPoints="500" value="5280" valuePoints="3500" valueWithTaxes="5280" xprice="43900"/>
        </aplicar>
      </benefício>
    </promo>
    <promo code="4280467" id="Award Points" nro="6153983116f79a304cced625">
      <benefit TLOGMessage="Prêmio Pontos de Fidelidade" account="" applicationMethod="lineByLine" baseAmount="35120" BenefitType="FactorLoyaltyBenefit" displayMessage="Prêmio Pontos de Fidelidade" name="6153983116f79a304cced625" nro="61545cc81 6f79a304cced685 "fator=" 0 " order="2" printerMessage="Prêmio Pontos de Fidelidade" totalpoints="50" type="external">
        <aplicar>
          <item magnitude="0.000" points="50.17" qty="1.000" seq="1" value="0" valueWithTaxes="0" xprice="43900"/>
        </aplicar>
      </benefício>
    </promo>
    <promo id="PromotionPaidInPoints" no="0">
      <benefit TLOGMessage="" account="" applicationMethod="" baseAmount="35120" BenefitType="LoyaltyBenefit" displayMessage="" order="3" printerMessage="" totalpoints="-5" type="external" unit= "" valor="-5">
        <aplicar>
          <item magnitude="0.000" points="-4.99" qty="1.000" seq="1" value="0" valueWithTaxes="0" xprice="35120"/>
        </aplicar>
      </benefício>
    </promo>
  </opcional>
</mensagem>

Após receber esta informação do motor, o PDV calculará descontando dos pontos a serem atribuídos para o tipo=externo (o utilizado neste exemplo) os pontos informados na promoção “ PromoçãoPaidInPoints ”.

(Para maiores informações sobre os cálculos utilizados na aplicação do benefício " PromotionPaidInPoints " , consulte o manual de integração Promo 7 - Engine)

Para os benefícios não pecuniários " Pontos ", " Coeficiente " e " Fator " de Fidelidade, pode-se indicar que os pontos atribuídos serão reportados no elemento "Cliente" e que a gestão destes pontos não será da responsabilidade do Promo.

Para indicar que os saldos são informados pelo elemento "Cliente", deve-se marcar a opção " Pontos informados pelo cliente " no campo " Tipo de Pontos " , ao fazer isso o campo "Tipo de Pontos" ficará desabilitado e não será possível indicar um tipo de elemento de fidelização para acumulação de pontos. Desta forma, interpreta-se que será o TPV o responsável pela gestão dos saldos ao sistema ou sistemas correspondentes.


Exemplo:


Para os benefícios não monetários " Pontos ", " Coeficiente " e " Fator " Fidelidade , podem ser indicados os pontos máximos a serem atribuídos cada vez que o benefício é concedido em uma transação.

Para isso, o campo “Máximo de Pontos por Transação” está disponível na definição de cada um desses benefícios.


O campo será mostrado em branco por padrão, indicando que não há quantidade máxima de pontos a serem concedidos definida no benefício. Ao colocar um valor, quando o benefício for aplicado em uma transação, serão atribuídos pontos até o valor definido neste campo.

Campo alfanumérico, não admite 0 (zero).

Exemplo: Se o parâmetro for 400, quando o benefício for aplicado em uma transação e o total de pontos a serem concedidos para aquele benefício for 500, este valor se ajustará ao valor máximo definido no benefício de 400.


  • Brinde: a aplicação do benefício consiste na concessão de brinde de um item extra ou prêmio (geralmente são itens ou serviços não comercializados pela empresa, por exemplo: dar ingressos de cinema, oferecer serviço de táxi gratuito).
  • Plano de pagamento:  a aplicação do benefício é para conceder planos de pagamento. Para a correta aplicação do benefício "Plano de Pagamento", a opção "Promoção Codificada" deve ser habilitada em Administração >> Informações de Configuração.


Plan de Pago VTol

Abaixo do campo "Classe de benefício" aparecerá o campo: " Plano de Pagamento VTol ". Este campo só aparecerá quando preenchido em Administração/Informações de Configuração, o campo:  "URL VTol :", ou seja, quando a integração VTol está sendo usada. Este campo é de preenchimento automático. Mostra o id do paymentPlanList que traz a resposta do Vtol. Se nenhuma das opções sugeridas pelo preenchimento automático for selecionada, ele permite que você preencha livremente como é feito atualmente. Trará as informações que o VTol salva em: paymentPlanList - id. Este campo (Plano de Pagamento VTol) será a chave. Para uma melhor identificação do plano a selecionar pelo operador, será apresentado o valor do id do PaymentPlanList seguido do nome do id do prestador + o valor do pagamento que corresponde a esse id do paymentPlanList.

Caso seja adicionada uma URL em Administração/Informações de Configuração, no campo:  "URL VTol :" A Promo interpretará que será utilizado o meio de pagamento informado pela VTOL.

Os meios de pagamento informados pela VTOL não modificarão os existentes nos catálogos Promo, serão salvos separadamente.

Para utilizá-lo, o Usuário Principal deverá habilitá-lo na definição da empresa, na seção “Benefícios Não Monetários Habilitados”:


No Promo existe um processo que atualizará o meio de pagamento obtido na VTOL.


Ao adicionar ou editar um benefício de uma promoção, se em "Tipo de benefício" selecionar "Não monetário", e em "Classe de benefício" selecionar "Plano de pagamento", na seção "Definição principal" aparecerá a propriedade "Tipo de Operação Vtol " que é integrada aos Planos de Pagamento que vêm da Vtol.


Saque bancário : herdará o mesmo comportamento do plano de pagamento ao trabalhar em modo integrado com o VTol.


  • Devolução Bancária: a aplicação do benefício tem como objetivo conceder a restituição bancária. Para a correta aplicação do benefício "Plano de Pagamento", a opção "Promoção Codificada" deve ser habilitada em Administração >> Informações de Configuração.

NOTA

Para obter mais informações sobre a configuração do plano de pagamento e saque bancário, consulte  Administração,  Informações  de configuração . Para mais informações sobre a integração do plano de pagamento e reembolso bancário, consulte o Manual de Integração, Benefício, plano de pagamento e reembolso bancário.


Para cada uma das classes de prestações não pecuniárias , deve ainda ser indicado o seguinte:


    • Coeficiente de Pontos de Fidelidade , indica o Tipo de Pontos e Fator.
    • Cupom , podendo indicar "quantia" e "Tipo/Identificador" (Caso tenha adquirido o Módulo Fidelidade, será apresentado um combo com os tipos de cupons ativos para seleção)
    • Plano de Pagamento , podendo escolher entre Plano de Pagamento, Tipo de Pagamento, Meio de Pagamento, Contas, Banco, Valor Limite, Prefixo, Percentual, Desconto/Sobretaxa.
    • Porcentagem de Fidelidade , podendo selecionar entre Porcentagem do preço em pontos e Tipo.
    • Pontos Fidelidade , podendo selecionar entre Quantidade, Tipo e Para cada unidade de.
    • Presente , podendo selecionar entre Quantidade, Id e Tipo.
    • Cupom Calculado , podendo selecionar entre Porcentagem, Valor e Tipo.


Os campos presentes em " Informações do Requerimento " devem ser indicados na definição do benefício.


  • Aplicação máxima (valor) : valor máximo a ser aplicado do benefício

Nota

Na mesma transação (no mesmo boleto) se uma promoção tiver vários benefícios, o máximo de aplicações será por benefício.

  • Aplicação máxima (medida) : nos casos em que se deseja limitar a aplicação do benefício, pode-se selecionar o atributo ao qual se deseja limitar. As opções são: Quantidade, Preço e Magnitude.
  • Desconto mínimo a aplicar : valor mínimo a aplicar ao benefício. É apenas por valor e como "mínimo" que o valor é concedido, desde que não exceda o valor do produto. Exemplos: Se o  valor mínimo  for definido como: 1,0. Se o  benefício  for 0,5, dá 1 (ou seja, dá pelo menos o valor mínimo configurado). Se o  benefício  for 1,2 dá 1,2 (dá o benefício porque dá o valor mínimo configurado como mínimo, se o benefício for maior dá o benefício).
  • Método de rateio - representa a maneira pela qual o PROMO distribuirá o benefício monetário concedido entre todos os itens afetados. As opções habilitadas são:
    • Proporcional:  Refere-se a distribuir o benefício proporcionalmente entre todos os produtos.
    • Mais caro primeiro:   Refere-se a ordenar os produtos beneficiados do maior para o menor e aplicar o desconto nessa ordem.
    • Mais barato primeiro:   Refere-se a ordenar os produtos beneficiados do menor para o maior e aplicar o desconto nessa ordem.

Este campo só será habilitado para os benefícios "Tipo de Benefício" =  Monetário.


IMPORTANTE

Para que os Métodos de Rateio = " Mais barato primeiro " e " Mais caro primeiro " sejam aplicados corretamente, é imprescindível selecionar a opção " Todos " no campo " Para cada unidade de: ".

Um exemplo está anexado abaixo:



Caso seja selecionada qualquer outra opção no campo “ Para cada unidade de ” ( Quantidade ou Magnitude ), o benefício sempre será aplicado proporcionalmente aos itens participantes, independentemente de “ Primeiro o mais barato ” e “ Primeiro o mais caro ” serem selecionados no campo Campo Método de rateio .


Além disso, o PROMO permite que o rateio seja feito sobre o preço original do item, ou seja, antes de qualquer benefício; ou no preço já beneficiado.

  • Aplicar em : Indica em qual preço do item o benefício será calculado. As opções de preços serão:
    • Original:   Refere-se à aplicação do benefício sobre o preço original do item.
    • Beneficiário:   Refere-se à aplicação do benefício sobre o preço já beneficiado do item.
  • Critérios de ordenação: permite selecionar um critério para ordenar os itens aos quais o benefício será aplicado. Você pode escolher entre:
    • o mais caro primeiro:   Refere-se à ordenação dos itens beneficiados com base em seu preço. Preços do mais alto ao mais baixo.
    • o mais barato primeiro:   Refere-se à ordenação dos itens beneficiados com base em seu preço. Preços do menor ao maior.
    • indistinto:   Sem ordenação específica dos itens beneficiados.  




Limites  de Aplicação :

Dependendo do tipo de benefício que está sendo definido, a partir desta seção podem ser gerenciados diferentes "Limites" que indicarão quando um benefício é entregue ou não, com base em um estoque geral do Lojista, por loja ou por Cliente, permitindo um controle mais geral das vezes que um determinado benefício foi concedido ao longo de um determinado período.

O limite de aplicação de um benefício pode ser definido por valor em dinheiro, valor de benefícios concedidos, por cliente, dia, lojas, etc. e serão configurados em cada benefício que aplicar uma promoção. 

No mesmo benefício podem ser definidos um ou mais limites, mas estes devem ser sempre diferentes, ou seja, não será permitido definir o mesmo tipo de limites, por exemplo, por loja que acumule dinheiro, no mesmo benefício. Se for definido mais de um limite, quando pelo menos um deles for atingido, a promoção não aplicará mais o benefício limitado. 
Se uma promoção tiver vários benefícios definidos e apenas um deles tiver um limite de aplicação definido, uma vez atingido esse limite, esse benefício deixará de ser aplicável, mas os outros benefícios da promoção (sem limites) continuarão a vigorar enquanto a promoção e/ ou mapa são válidos. 

Para cada um dos benefícios disponíveis, o PROMO pode ser definido como aplicando um benefício, deixando de fora o benefício Cupom Calculado Monetário e o benefício Não Monetário Plano de Pagamento.

Ao selecionar um tipo e classe de benefício ao qual se aplica a definição de limites, a seção "Limites de Aplicação" será exibida na definição do benefício:


No combo " Adicionar " estarão disponíveis as seguintes opções:

    • Geral : Indicará que todas as lojas do lojista irão somar ao limite que está sendo definido. Por exemplo, " 2 por 1 em garrafa térmica, até esgotar o estoque de 1000 unidades " ( independentemente da loja onde é vendida ou do cliente que a compra, durante a vigência da promoção, a garrafa térmica pode beneficiar até 1000 unidades.)

    • Loja : Indicará que cada loja do lojista terá um balcão independente do limite definido neste benefício. Dessa forma, pode ser que uma loja tenha atingido o limite do benefício definido e não possa mais aplicar o benefício, e outra loja ainda possa continuar operando com ela visto que ainda não atingiu seu limite. O limite aqui definido é aquele que todas as lojas herdarão igualmente. Por exemplo: " 2x1 em Thermos até acabar o Estoque de 100 unidades por loja". ( Durante a vigência da promoção poderão ser beneficiados até 100 garrafas térmicas por loja, caso a loja A fique sem estoque, a promoção não será aplicada ou sugerida mais, mas caso a loja B ainda tenha Estoque disponível, pode continuar operando com o referido promoção.)

    • Cliente : Indicará que o limite será acumulado por cada cliente informado na transação. Por exemplo, " 2 por 1 em garrafa térmica até durar o estoque de 1000 unidades, uma por cliente ". ( Durante a vigência da promoção, as garrafas térmicas podem beneficiar até 1000 unidades, mas apenas uma pode ser entregue por cliente.)

Selecionando um dos critérios de agrupamento mencionados acima, o seguinte pop-up será exibido:

Poderá ser indicada uma Descrição do Limite, isto não terá qualquer efeito na gestão dos limites, é apenas informativa.

       Essa descrição  no Json das listas negras que são enviadas pelas filas do RabbitMQ. Será informado sob o " código " que é informado no Json. O campo não será obrigatório. Se não estiver carregado, pode ser reportado em branco.

       Essa descrição deve ser informada no Json de Promoções  sob o " código " que é informado no Json.

        A descrição não será informada no benefício pois os limites não trafegam no mapa mas são consultados durante a transação.

Para cada um dos critérios de acumulação (Geral, Loja ou Clientes) pode ser definido um “ Período ” no campo “ Período a Contabilizar ”. O Período indicará com que frequência o contador acumulado será zerado durante a vigência da promoção. Exemplo: " 2x1 em garrafa térmica até acabar o estoque de 10 unidades por dia ". 

Aqui, seja o limite por Geral, Loja ou Clientes, será avaliado que em um dia não seja ultrapassado o limite de 10 garrafas térmicas beneficiadas. Caso seja atingido o limite de 10 garrafas térmicas beneficiadas por dia, a promoção não será aplicada nem serão sugeridas mais para aquele dia. No dia seguinte, o contador zera e a promoção pode ser aplicada até atingir novamente o limite de 10 garrafas diárias.


Deve-se considerar que, dependendo do benefício a ser definido, diferentes critérios de acumulação podem ser utilizados para definir o limite. No campo " Limitado por " deve ser indicado este critério de acumulação. Podendo escolher entre os seguintes acumuladores:


    • Quantidade de dinheiro
    • Número de aplicações
    • Quantidade de Produtos beneficiados
    • Quantidade de Cupons emitidos (somente disponível ao definir um Benefício Não Monetário, Cupom)
    • Quantidade de Unidades Fidelidade Atribuídas (apenas disponível ao definir um benefício Não Monetário, Pontos/Percentagem ou Coeficiente de Fidelidade)
    • Quantidade de presentes concedidos (disponível apenas ao definir um benefício não monetário, presente)


Uma vez selecionado o critério de acumulação, deve-se indicar o valor que define o limite de aplicação do benefício.


O exemplo anterior pode ser interpretado como uma espécie de Limite Geral, que zera o contador diariamente, e que acumula aplicações do benefício definido até o máximo de 100. Uma vez atingido o limite, o benefício não será aplicado até a próxima dia. Caso não tenha atingido o limite no momento de zerar o contador, ele será reiniciado mesmo assim, voltando a 0 para acumular até 100 no dia seguinte.


Limites ao definir o cupom calculado :

  • Quando for definido um Benefício Não Monetário, da  classe Cupom Calculado , definido por  Percentual , poderão ser definidos limites por “Varejo”, “Loja” e/ou “cliente” limitando por valor em dinheiro  aplicações  ou  produtos  beneficiados.

  • Quando for definido um Benefício Não Monetário, da  classe Cupom Calculado , definido por  Valor Fixo , poderão ser definidos limites por “Lojista”, “Loja” e/ou “cliente” limitando por valor em dinheiro  aplicações  ou  produtos  beneficiados.

  • Quando for definido benefício não monetário, da  classe Cupom Calculado , definido por  Valor Externo , poderão ser definidos limites por “Varejo”, “Loja” e/ou “cliente” limitando o número de aplicações  ou  produtos  beneficiados.


NOTA

Uma vez definido um limite para um benefício, este não pode ser editado, devendo-se eliminar o limite e recriá-lo caso seja necessária alguma modificação.


NOTA 2

Uma vez definido um limite para um benefício, o tipo e a classe do benefício não podem ser editados, devendo-se deletar o limite e recriá-lo caso seja necessária alguma modificação.


Adicionado os limites e salvo o benefício, ao retornar a página de definição da promoção, os limites definidos serão visualizados da seguinte forma:


Nota

Quando o benefício definido for " Benefício Externo " nenhum tipo de Limite poderá ser definido.


Campo DESCRIPCIÓN en la definición de Limites de aplicación del beneficio (Disponible a partir de PROMO 7.0.1)

O campo descrição é habilitado ao definir um limite de aplicação nos benefícios.

Este campo de descrição está disponível para qualquer um dos limites disponíveis na definição (Geral, Loja e Cliente)



O campo não é obrigatório, e será informado nos serviços que reportam promoções e limites (RabbitMQ).

Importante

Ao adicionar ou remover um limite no benefício de uma promoção que já está em estado distribuído, ele deve ser redistribuído em um novo mapa, para que desta forma as coleções de limites no banco de dados sejam atualizadas.
Alocação do limite de lucro por loja e por promoção

A partir desta versão é possível atribuir um limite customizado de aplicações de benefícios de uma promoção por loja. Isso permitirá lidar com uma maior diversidade no controle de um limite de aplicativos e reduzirá o número de configurações de promoções para cobrir essa necessidade.

Para isso, quando uma promoção é criada e você deseja adicionar limites, Promo oferece a possibilidade de manualmente ou através de um arquivo:

Como pode ser visto na imagem, o combo da loja é autocomplete, com o qual o usuário possui links.



Eles também podem ser incorporados, por meio de um arquivo .xls

Se você não conhece o formato do arquivo, pode baixá-lo pressionando o botão

O aplicativo fará o download de um arquivo, onde o usuário poderá preenchê-lo com os dados correspondentes:

O formato do arquivo pode ser obtido pressionando o botão: 

Lá você deve preenchê-lo com as seguintes informações:

Operação (obrigatório):

                 I: inserir novo(s) limite(s)

                 OU; modifica os dados de um limite(s)

                 A: remove o(s) limite(s) desejado(s)

Limit id: é o identificador do limite. Se a operação for um Insert; este campo ficará vazio, caso contrário (Modificação U ou Eliminação R) seu valor poderá ser obtido na view onde estão sendo configurados:

e para as operações de atualização e remoção são obrigatórios.

Tipo de limite (obrigatório):

                       Varejo:

                       Lojas:

                       cliente:

Descrição (opcional): Você pode ter uma descrição do limite

Loja: Código da Loja à qual deseja aplicar o limite. Para obter o seu valor, procure por:

Prazo para postagem (obrigatório): pode ser indeterminado ou aplicar a cada certo valor. de dias.

Número de dias: é obrigatório se Dias no período para postagem foi selecionado

Limite por (obrigatório): critérios para limitar, dependendo do tipo de limite escolhido.

Depois que o arquivo for importado, o aplicativo exibirá apenas doze (12) limites.

Caso haja algum erro na importação, o aplicativo apresentará o erro:

Serão exibidos tantos registros quantos forem os erros no arquivo.

       A partir do botão Excluir no canto superior direito, pode-se removê-lo, desde que o número de limites configurados seja inferior a 12 (doze)

        

         e pode ser modificado a partir da visualização Limites de Promoções, desde que o número de limites configurados seja menor que 12 (doze):


Quando ultrapassam esse valor, os limites podem ser modificados e/ou removidos através do arquivo .xls

Importante

Somente o Valor dos limites pode ser modificado.

O arquivo de modificação só pode conter os registros a serem modificados e/ou deletados. Não precisa conter todos os registros do arquivo original.

Definição  de escalonado :

A partir desta versão, a possibilidade de aplicar descontos escalonados é incorporada ao Promo. Pode-se indicar a partir da definição do benefício qual é o valor do desconto quando se atinge uma determinada quantidade, valor ou preço total dos produtos participantes.


Ao definir um benefício, a seção " Definição de escalonado " será exibida no formulário.


Deve-se definir em que tipo de unidade se aplicará a etapa que está sendo definida. Para isso, no combo " Unidade Escalonada " você pode selecionar entre " Quantidade ", " Magnitude " ou " Preço Total ".

Definicion de Escalonadas por magnitud

Será tomado como unidade de grandeza para a definição do quilo, 1000. Podendo definir os 100 gramas como 0,1 ou os 10 gramas como 0,01


Ao pressionar " Adicionar ", serão propostos os seguintes campos para indicar as condições de aplicação da etapa que está sendo definida.


Para salvar o passo definido, você deve pressionar " Continuar " exibindo-o da seguinte forma:


Se pressionar novamente " Adicionar etapa " e incorporar uma 2ª etapa, a grade e a etapa já definida serão exibidas, conforme a seguir.




IMPORTANTE

A definição de escalonado estará disponível nos benefícios “Monetários” da classe “Desconto Fixo”, “Desconto por Convênio”, “Desconto Percentual”, “Novo preço” e “Troca de Pontos”. Assim como nos benefícios "Não Monetários" da "Carteira", "Benefício Geral", "Coeficiente de Fidelidade", "Percentual de Fidelidade", "Pontos de Fidelidade", "Presente", "Cupom" e "Cupom Calculado"




Considerações na definição de benefícios escalonados:

    • No benefício que se aplica ao escalonado, deve ser definido o valor do desconto padrão, que será aplicado quando alguma das etapas definidas não for atendida.
    • O valor e o tipo de cobrança que forem definidos para o benefício que opera com uma etapa, serão aplicados ao benefício concedido pela(s) etapa(s) que forem cumpridas na transação.
    • A repartição entre participantes, se habilitada, regerá todos os elementos que se aplicam ao cumprimento da etapa definida.
    • Uma vez definida uma etapa, o tipo e a classe do benefício não podem ser alterados. Estes aparecerão acinzentados. Os degraus devem ser removidos para poder editar esses campos.

    • Aplicação Máxima (Valor/Medida) ao definir benefício escalonado: os valores definidos serão aplicados ao benefício concedido pelo escalão que for atendido.
    • Desconto mínimo a ser aplicado  na definição de benefício escalonado  incidirá sobre o benefício concedido pela etapa atendida.
    • Método de rateio na definição de benefício escalonado :  aplicar-se-á ao benefício concedido pela etapa atendida.
    • Definição do campo "Aplica-se a"  ao definir um benefício escalonado : será aplicado ao benefício concedido pela etapa atendida.
    • Critérios de ordenação  na definição de uma prestação escalonada :  aplicar-se-á aos elementos sobre os quais se concede o escalão que se cumpre.

    • Os benefícios que se apliquem em etapas contarão para os limites que o benefício da promoção escalonada possa ter definido, seja ele limitado por cliente, loja ou geral, a produtos beneficiados, valor monetário ou número de aplicações. 

    • Todos os campos referentes à informação adicional de um benefício se aplicarão ao benefício concedido pela etapa atendida.

(Ver também  Anexo VII - Modelo de Promoções , para exemplos de aplicação de promoções escalonadas)



Por fim, serão solicitados os campos da seção “ Informações Adicionais ” para conclusão da definição do benefício.

  • Forma de aplicação : representa a forma como o PDV emitirá as promoções (seja na tela ou no comprovante de venda). Por exemplo, mostre detalhadamente o desconto afetado a cada item ou mostre um resumo de todos os descontos aplicados antes do total. As opções que podem ser selecionadas são:
    • Resumo
    • linha a linha

  • Conta contábil : informe a conta contábil na qual o benefício será alocado no POS. Não é um campo obrigatório.
  • Provedor do bem e Provedor Financeiro: poderá aqui ser indicado a quem será atribuído o valor do desconto a aplicar, indicando o valor ou percentagem que lhe corresponde. 

Pode-se configurar que seja obrigatório o preenchimento dos dois campos (Provedor do bem e Provedor Financeiro) caso sejam inseridos valores em um deles. O seguinte deve ser configurado:

Se essa configuração estiver em: 

    • true = requer o carregamento de ambos (Provedor de mercadorias e Provedor financeiro) se pelo menos um for carregado.
    • false = não requer o carregamento de ambos (Provedor de Bens e Provedor Financeiro), apenas um pode ser carregado.

      Quer seja definido como verdadeiro ou falso, nenhum pode ser carregado (nem Bom Provedor nem Provedor Financeiro).

Nos campos "Fornecedor do bem" e "Fornecedor financeiro" você pode inserir texto de até 250 caracteres. Ambos os campos à medida que você digita mostram sugestões selecionáveis ​​que ele traz do catálogo "Fornecedor".

Valores com decimais podem ser carregados; tanto no campo "Fornecedor do bem" quanto no campo "Fornecedor financeiro" (seja para Valor ou para Percentual); que serão detalhados no Universo de Aplicação. Tanto o Fornecedor do bem quanto o Fornecedor Financeiro, seja o Valor usado como Percentual, o Valor funciona com 2 casas decimais. No caso de inserir 3 casas decimais, o valor inserido será arredondado.



A soma dos valores definidos para ambos os provedores não pode ultrapassar 100% quando eles definem por porcentagem. Caso ambos os provedores sejam definidos por valor, não será feita nenhuma validação dos valores informados em um ou outro provedor. Por quantidade permite inserir valores com duas casas decimais. Se o provedor financeiro for definido por %, o provedor de crédito também deve ser definido por % e o mesmo quando for definido por valor. Ambos os campos são opcionais, mas se um for carregado o outro deve ser definido mesmo com % ou $ em zero ( 0 ).

Tanto para benefícios monetários quanto não monetários, os dados podem ser registrados em dois provedores extras, com os mesmos atributos do identificador, percentual/valor e valor. Isso permitirá a possibilidade de gerenciar três ou quatro provedores que cobrem o desconto dado pelo benefício. Deve-se levar em consideração que esses dois atores adicionais não são obrigatórios e podem ou não ser parametrizados nos benefícios.                                

            

        

Nota

Para a seleção do provedor adicional, deve-se buscar no mesmo catálogo que é utilizado para configurar o provedor do bem e financeiro.

Os dados dos “Provedores Adicionais” devem ser retornados da mesma forma que os dados dos provedores de bens e financeiros na estrutura XML no momento da obtenção do benefício. Se esses provedores adicionais não forem configurados, o comportamento será o mesmo do provedor bom e financeiro na resposta do mecanismo.



<p><?xml version="1.0" codificação="UTF-8" standalone="no"?></p><p><message ack="0" empresald="2" motor="7.0.8 #30" versão do mapa="999" messageld="0001" loja="251" terminal="1"></p><p><opcional></p><p><código promocional="10994" id=" E:PRM LONAS BIOSIL 25% 01-19 SET 21/MMG/LS/10994" nro="5fab2867daf8070e08cbc208"></p><p><benefício AJUS_PVP_PC="NÃO" CARGA DA UNIDADE="NÃO" PROMOCIONAL="NÃO" FECHA_FIN_PROMO="</p><p>2021/09/19" LPCOBRO=& "PVP" REQDIG="NÃO" RQDEVPREMIO="Sim" TLOGMessage="PRM LONAS BIOSIL 25% 01-</p><p>19 SET 21" conta="" applicationMethod="currículo" baseAmount="8.0357"</p><p>benefitType="PercentageDiscount" creditProviderName="1791994531001" creditProviderValue="80"</p><p>creditProviderValueType="PERCENTAGE" descontoPorcentagem="5.0000" displayMessage=" PRM BIOSIL LONA 25% 01-19 SET 21" FinancialProviderName="1791984722001" FinancialProviderValue="10" <br /> financeProviderValueType="PERCENTAGEM" nome="5fab2867daf8070e08cbc208" <br /> nro="5fab2867daf8070e08cbc202" pedido="1" printerMessage=" PRM BIOSIL LONA 25% 01-19 SET 21" <br /> prorationMethod="PROPORCIONAL" tipoPromo="DV" unit="qtyr adicionalProvider1Name="1002003001"</p><p><strong>1111</strong>             <strong>111111.11111111•111•11111111111111</strong>             & nbsp; &n bsp;     ;        &   <strong>11MNTAGE"></strong></p><p><aplicar></p><p><item magnitude="0.0000" quantidade="1.0000" seq="2" valor="0.4018" valueWithTaxes="0.4018" xprice="8.0357"/></p><p></apply></p><p></benefit> </promoção> </opcional> <sugestões></p><p><código promocional="9662" descriptor="[P1]-PRM GUARDA-CHUVA-COMBO LANCHES GRÁTIS 03 A 31AG021 (PRÊMIO OBRIGATÓRIO: COCACOLA500mI+NACHO 0 TOSTIT045g)" id="EM:PRM UMBRELLA-COMBO SNACKS GRÁTIS 03-31AG021/MBG/AS/9662" item-seq="2"/></p><p>
  • Mensagem PDV : este texto será enviado ao PDV para ser visualizado no display quando uma Promoção que inclua este Benefício for aplicada em um contexto específico. Não é um campo obrigatório.
  • Mensagem para a impressora : este texto será enviado ao PDV para ser impresso no comprovante de venda quando uma Promoção que inclua este Benefício for aplicada em um contexto específico. Não é um campo obrigatório.

Recortar Mensaje para la impresora

O número de caracteres a inserir neste campo pode ser limitado, ou pode ser usado como vem por padrão, que é ilimitado. Se você deseja limitar o número de caracteres a inserir, deve fazê-lo em Administração\Informações de configuração, na configuração: “Mensagem de corte para a impressora”, cuja chave será message.printer.maxLength  .

No campo  " Mensagem ao Gráfica " de um benefício da promoção , não haverá limite para inserir informações. Ao pressionar o botão Salvar, se o número de caracteres inseridos neste campo exceder o valor configurado no campo “ Trim Message to Printer ”, será exibida uma mensagem informando “ O número de caracteres inseridos excede o valor configurado ” e uma mensagem será exibida. será exibida uma caixa bordô ao redor do campo "Mensagem para a impressora" com o ponto de exclamação à direita. O sistema não salvará as alterações, e continuará exibindo a mesma tela até que o usuário altere a mensagem digitada no campo " Mensagem para impressora" .". Depois de inserido um número de caracteres menor ou igual ao número configurado, a mensagem será salva após pressionar o botão Salvar.

Caso o campo de configuração “ Trim Message to Printer ” tenha sido deixado vazio, o sistema salvará as informações inseridas no campo “ Message to Printer ”, independentemente de quaisquer limites.

Caso seja editada uma promoção que tenha uma Mensagem para a Impressora maior do que a configurada no campo "Aparar Mensagem para a Impressora", ao pressionar o botão "Salvar", o sistema exibirá a mensagem "O número de caracteres inseridos excede o valor configurado " e uma caixa bordô será exibida ao redor do campo "Mensagem para impressora" com o ponto de exclamação. As alterações não serão salvas até que um valor igual ou menor que o valor configurado seja inserido.



  • Mensagem para o TLOG : este texto será enviado ao PDV para ser registrado no TLOG quando uma Promoção que inclua este Benefício for aplicada em um contexto específico. Não é um campo obrigatório.


NOTA

Todos os atributos que contém o símbolo  são de preenchimento obrigatório, uma vez finalizado o carregamento do benefício, deverá ser pressionado o botão " Aceitar " para que o benefício seja salvo dentro da promoção e nesse momento será validado que todos os campos obrigatórios estão preenchidos carregado.



Publique Promoções no RabbitMQ sob demanda

A possibilidade de postar promoções em estado "completo" para as filas do RabbitMQ configuradas pode ser configurada a partir do console Promo.

O processo padrão envia automaticamente para as filas do RabbitMQ, as promoções que vão para o estado "Complete" e todas as modificações que são feitas nele, desde que não mude seu status "Complete" quando a funcionalidade é habilitada e configurada . a funcionalidade. 

Também pode ser configurado que este envio não seja automático, mas que o usuário se encarregue de fazer esta postagem quando a promoção estiver em estado automático.

Esta funcionalidade pode ser habilitada em " Administração " >> " Informações de configuração ", na opção de configuração " rabbitMQ.producer.manual.promotion.enabled " que será definido como " false " por padrão. Definir como " true " alternará para o modo de postagem de promoções sob demanda.


Se uma promoção for completa ou distribuída, ou for editada e mantiver seu status completo, um botão " Postar no RabbitMQ " será apresentado. Uma vez clicado, os dados da promoção editados e concluídos serão postados para serem enviados via RabbitMQ, e o botão não será mais exibido até que uma nova edição seja feita.


Considerações: 

  • Promoções incompletas ou canceladas não podem ser lançadas manualmente.
  • Quando uma promoção passa para o status " Cancelada ", a postagem na fila correspondente do RabbitMQ será automática.
  • Em promoções massivamente cadastradas, ou via serviço, a postagem na fila correspondente do RabbitMQ será automática.


Modificação de promoções com base na sua validade

Pode ser indicado pela configuração se uma promoção pode ou não ser editada após o vencimento, para isso você deve acessar Administração > Informações de Configuração e habilitar ou desabilitar a opção " dataEditableIfActive".

Também pode ser indicado por configuração que uma promoção não pode ser editada na data efetiva, quando foi atingida. ( Para obter mais informações, consulte Administração >> Informações de configuração)

Promociones vigentes/vencida con edición inhabilitada

Na grelha " Gestão de promoções ", as opções "Editar" e "Definir" não estarão disponíveis no menu Ações das promoções cuja validade seja atingida quando a configuração assim o indicar. Promoções cuja validade esteja em andamento ou expirada poderão ser copiadas, mas a condição de tempo não será copiada.


As promoções lançadas ou editadas, quando passarem para o status "Concluído" e o WorkFlow (WF) for "Aprovado", poderão ser enviadas para um sistema externo via fila do Rabbit-MQ para que esses dados sejam levados por sistemas externos.

Por padrão, esta funcionalidade será desativada e os dados da fila do Rabbit-MQ correspondente devem ser configurados para ativar a funcionalidade. As configurações necessárias para enviar Promoções podem ser feitas a partir do Promo Console acessando o menu Administração >> Informações de configuração.

No campo de pesquisa: "Palavra a pesquisar", digite a palavra-chave: " Produtor ". Como resultado, mostrará as variáveis ​​de configuração para envio de Promoções via MQ Rabbit Queues.

O status desse processo pode ser visualizado na seção "Import Monitor" no console Promo.

(Para obter mais informações sobre as configurações disponíveis, consulte Administração >> Informações de configuração)

(Para maiores informações sobre o processo de envio de Promoções Via Rabbit MQ consulte o Manual de Integração Promo 7.2)

Exclusão de promoções por data e loja

A partir desta versão será possível excluir promoções em determinadas datas, informadas através do serviço Correios, detalhadas em Serviço de exclusão de datas para que não seja realizada uma promoção.


Importação  bem-sucedida

Uma vez que a importação massiva das exclusões tenha sido realizada corretamente, você poderá visualizar o registro de importação com o status Processado dentro da lista de importações. 

Da mesma forma, você poderá visualizar o detalhe geral que indicará o número de registros processados.


Importação de exclusão de promoção parcial

As importações com status Parcial ocorrem quando há erros de validação em algum dos registros de exclusão a serem processados.

No detalhe da importação você pode ver quantos registros foram processados ​​corretamente, bem como o detalhamento dos registros com erro, permitindo assim identificar o problema com mais facilidade, pois será indicado o campo com o valor inválido, assim como o json associado ao item.


Falha na importação da exclusão da promoção

No caso de erros de validação nos campos em todos os registros a serem processados, você pode visualizar o status da importação Erro

No detalhe da importação onde você pode ver mais especificamente os erros encontrados em cada registro.

Entre os possíveis erros que podem ocorrer estão:

A. Erro no campo nomeDaPromoção → Ocorre quando é indicado um nome de promoção que não existe.

B. Erro no campo storeCode → Ocorre quando é indicado um código de loja inexistente.

C. Erro no campo de exclusãoDatas → Quando forem indicadas datas inválidas (datas fora da validade da promoção, datas anteriores à data atual ou datas com formato diferente de "ano-mês-dia"), ou na sua falta, é enviou o campo vazio.

Monitor de exportação

Caso haja registros de postagens no servidor RabbitMQ com ERRO, será exibido um banner no cabeçalho da Promo, indicando a ocorrência em geral.


  1. Banner com detalhes do incidente. 
    - Para saber o detalhe do incidente, pressione  Ver mais detalhes .


  2. Lista de processos de exportação com falha.
    - No campo Descrição : a causa do erro pode ser visualizada
    - Uma vez corrigido o erro que causa a falha no envio de mensagens ao servidor RabbitMQ, você deve pressionar o  botão Reprocessar


  3. Se o processamento das falhas relacionadas à postagem de dados via RabbitMQ for bem-sucedido, a grade deverá ficar sem registros para Reprocessamento.



Modelos de promoção


O que é um modelo de promoções?

A partir desta seção do console Promo, você pode cadastrar diferentes modelos de  Templates de Promoção  que posteriormente permitirão baixar os excels para que o usuário ou sistema responsável possa gerar , modificar ou cancelar promoções conforme definido no template e assim poder gerencie as promoções de forma massiva ao processar os excels.

Em cada template podem ser indicados os critérios de definição do cabeçalho, condições e vantagens que serão comuns às promoções que são geridas a partir deste template.

Por meio deste modelo será possível indicar quais elementos deverão ser carregados no Excel que serão posteriormente processados.

As variáveis ​​definidas a seguir podem ser usadas para definir os campos que compõem um modelo:  @[ variável ]. Também pode ser definido um valor fixo para qualquer um dos campos do modelo de promoção, e se nenhum outro dado for carregado para esse campo ao definir o excel, o valor definido será o tomado para a definição da promoção.

Para acessar a criação de um modelo de promoção, você deve acessá-lo através da opção " Modelos de promoção " .



Ao acessar " Modelos de Promoção ", será exibida a tela " Gestão de Modelos de Promoção " , onde serão listados os diversos modelos de promoção já gerados e de onde poderão ser cadastrados novos modelos ou editados os já existentes. Você também pode filtrar aqui pelo Estado ou Nome dos modelos existentes.


Em cada Template presente nesta grade, é proposto o botão " Ações " , a partir do qual um template pode ser editado ou definido, bem como ver um resumo, cancelá-lo ou gerar um Excel a partir dele.


NOTA

Quando um Modelo de Promoção estiver com o status "Cancelado", apenas a opção "Resumo" será proposta.


Para cadastrar um novo Template de Promoções, você deve clicar em " Novo Template "


Novo Modelo de Promoções

Ao clicar em " Novo Template " aparecerá a tela  "Novo Template de Promoção"  onde você poderá indicar um Nome  e uma  Descrição  para o template que deseja criar.

Uma vez identificado o modelo de promoção, devem ser carregados os campos Cabeçalho, Condições e Benefícios que deseja incluir no modelo e estes definirão a estrutura das promoções que são definidas a partir deste modelo de promoção.

Também será possível indicar se o modelo está ativo ou não. Se um modelo de promoção estiver "Inativo" (sem a verificação Ativa), os arquivos Excel não poderão ser gerados a partir desses modelos



Definindo o cabeçalho do modelo de promoção

Na mesma tela de definição do cabeçalho do modelo, haverá a seção de definição do cabeçalho da promoção . Aqui você deve inserir os campos obrigatórios para o gerenciamento de promoções, esses campos serão as colunas que serão apresentadas no Excel para o processo de registro, cancelamento e/ou alteração de promoções por arquivo. 

Haverá campos de preenchimento obrigatório e outros campos poderão ser substituídos por variáveis ​​de forma a ajudar o utilizador final a interpretar, conforme necessário, os dados a carregar nesse campo para uma promoção.



Nesta seção não é proposto inserir uma variável para o "Nome" e para o "Código" das promoções a serem gerenciadas a partir deste modelo. Isso porque são campos de preenchimento obrigatório e estarão sempre na planilha excel a ser carregada.


IMPORTANTE

Quando o Excel for gerado a partir de um modelo de Promoção, juntamente com os campos "Nome" e "Código" que sempre estarão como colunas, haverá também as colunas "Operação" e " Motivo do Cancelamento " .


No campo "Operação" deverá indicar se a promoção indicada na referida linha é uma nova promoção, se uma promoção existente está a ser editada ou cancelada.

Os valores aceitos para este campo são:

  • eu : inserir
  • U : atualização
  • R : cancelar

Quando a ação for R ( cancelar promoção), deverá ser indicado o Motivo do Cancelamento " , bem como o  código  e/ou  nome  da promoção que deseja cancelar.


Os campos que podem ser inseridos por variável serão os de entrada não obrigatória e se desejar defini-la deverá indicar a variável que deseja ver na coluna onde esse campo será definido para a promoção.

Esta definição de campos variáveis ​​se aplicará aos campos dinâmicos do cabeçalho e à descrição da promoção. Só podem ser definidos os campos habilitados por configuração, e se for inserida uma variável, a coluna que corresponde à carga desse campo será exibida com a variável de usuário definida no template.

Os atributos do cabeçalho podem ser preenchidos:

Também poderá ser indicada a tipificação que a promoção terá e se utiliza ou não sugestão .


NOTA

A classificação proposta para a definição do modelo de promoção será a mesma utilizada por padrão para a definição das promoções.

As sugestões podem ser vistas em detalhes em SUGESTÕES

Exemplo: exibição  da tela completa de Cadastro de Novo Modelo.




Se um arquivo Excel for gerado com esta definição do cabeçalho Promoção, ele será exibido da seguinte forma:

OperaçãoRazão para cancelamentonome da promoçãoCódigofluxo de trabalhoCampainhacanais de publicaçãoTipo de promoçõesSubtipo de promoçõesForma de aplicação das promoçõesdescriçãosugerir


























REFERENCIAS

Para mais detalhes sobre os valores aceitos ao definir o cabeçalho de uma promoção Ver "Apêndice VI"


As colunas “ Operações ”, “ Motivo do cancelamento ”, “ Nome da Promoção ” e “ Código ”, sempre estarão presentes no Excel e são de preenchimento obrigatório. (O motivo do cancelamento será obrigatório se a operação for um Cancelamento)


As colunas “ Workflow ”, “ Campanha ”, “ Canais  de Publicação ”, “ Tipo de Promoções ”, “ Sub-Tipo de Promoções ” e “ Forma de Aplicação de Promoções ”, sempre estarão presentes no Excel, mas não são carregadas obrigatoriamente . Se forem deixados em branco, quando o Excel for processado, a promoção gerada assumirá os valores definidos no modelo de promoção, por outro lado, se for inserido um valor em algum dos campos, a promoção gerada será pegue este valor inserido e não o que está definido no template.


As colunas " Descrição" e " Sugestão " correspondem às variáveis ​​inseridas nos campos " Descrição " e " 

Essas validações serão realizadas ao processar o arquivo Excel.


Depois de carregados os dados correspondentes ao cabeçalho do modelo de promoção, você pode pressionar " Salvar " e a definição das condições e benefícios que você deseja incluir no modelo de promoção será passada.


IMPORTANTE

Cada linha corresponderá a uma promoção.


definir modelo

Uma vez salvo corretamente, você poderá visualizar a  tela Definir Modelo , onde poderá indicar as condições por  Faixa Horária, Simples, por composição e os benefícios  associados ao modelo de promoção.

Também será exibido um detalhe do cabeçalho do modelo de promoção que está sendo definido. Nesta seção você pode acessar um resumo do modelo que está sendo gerado e pode gerar o Excel correspondente quando o modelo estiver completo.


Condições de intervalo de tempo

Devido à natureza dos campos associados às Time Range Conditions , as variáveis ​​não podem ser indicadas ( @[variable...] ), portanto, ao definir uma condição desse tipo, as colunas serão adicionadas com os seguintes  cabeçalhos Condition de data com tempo, Condição do tempo, Condição por periodicidade



IMPORTANTE

Caso o usuário não indique nenhum dado na coluna correspondente às  variáveis ​​Time Range Condition,  durante a importação serão tomados os valores definidos no template.


REFERENCIAS

Para mais detalhes sobre os valores aceitos ao definir as condições do intervalo de tempo, consulte "Apêndice VI"



Condições Simples

Caso o template a ser definido deva conter condições simples, será necessário definir as variáveis ​​que representam os atributos dos elementos, por meio das quais serão indicadas essas condições.

O formato dessas variáveis ​​será @[variável_condição_1] , onde " v ariável_condição_1 " deve ser substituído pelo valor que se deseja ver na coluna correspondente ao atributo no Excel. 

Esta definição de variáveis ​​será somente  para condições com Auto-completar que permitem a entrada de valores alfanuméricos.

A definição do nome das variáveis ​​não pode ser separada por espaços, sugere-se o uso de hífen ou sublinhado (-, _), por exemplo: @[  variável_condição_1] ou  @[variável-condição-2]


Caso um atributo seja definido com um valor literal e não por meio de uma variável, o atributo que o contém não será exibido como uma coluna no Excel, mas será considerado como uma definição fixa para esse atributo e será incluído em todas as promoções geradas a partir deste modelo.



marca (Condição Simples 1. Produtos)família (Condição Simples 1. Produtos)TPagamento (Condição Simples 2. Meio de Pagamento)prov (Condição Simples 3. Produtos)

















REFERENCIAS

Para mais detalhes sobre os valores aceitos ao definir condições simples, consulte "Apêndice VI"


Condições por composição

Caso queira definir as promoções por meio de condições de composição, serão tomados como variáveis ​​todos os campos com valores definidos pelo usuário (A), assim como todas as variáveis ​​(@[variable_test]) que forem definidas dentro os tipos de elementos de cada condição (B).



Para diferenciar as variáveis ​​associadas a diferentes condições por composição dentro do Excel, adiciona-se a cada variável um sufixo com o número da condição a que pertence.

Exemplo:

Variáveis ​​para a condição por composição 1

  1. Limite de aplicação (Cond. por composição: 1)

  2. Unidade de medida (Cond. por composição: 1)

  3. Ocorrências Menores (Cond. por Composição: 1)

  4. Máximo de Ocorrências (Cond. por Composição: 1)

  5. marca (Cond. por composição: 1. Produtos)

  6. famila_en_combo (Cond. por composição: 1. Produtos)

Variáveis ​​para a condição por composição 2

  1. Limite de aplicação (Cond. por composição: 2)

  2. Unidade de medida (Cond. por composição: 2)

  3. Ocorrências Menores (Cond. por Composição: 2)

  4. Máximo de Ocorrências (Cond. por composição: 2)

  5. Critério de equivalência (Cond. por composição: 2)

  6. Critério de inequivalência (Cond. por composição: 2)

  7. tipo_cliente (Cond. por composição: 2. Clientes)


Exemplo de cabeçalhos no modelo excel

Limite de aplicação (Cond. por composição: 1)Critério de inequivalência (Cond. por composição: 1. Produtos)Máximo de Ocorrências #1 (Cond. por composição: 1. Produtos)Unidade de medida #1 (Cond. por composição: 1. Produtos)Critérios de ordenação (Cond. por composição: 1. Produtos)família (Cond. por composição: 1. Produtos)Ocorrências Mínimas #1 (Cond. por composição: 1. Produtos)Critério de equivalência (Cond. por composição: 1. Produtos)Máximo de Ocorrências #2 (Cond. por composição: 2. Produtos)Unidade de medida #2 (Cond. por composição: 2. Produtos)fornecedor (Cond. por composição: 2. Produtos)Ocorrências Mínimas #2 (Cond. por composição: 2. Produtos)


























REFERENCIAS

Para mais detalhes sobre os valores aceitos ao definir condições por composição Ver "Anexo VI"



Beneficiar 

Ao definir um benefício no modelo de Promoções, deve-se levar em consideração que os campos “ Tipo de benefício ” e “ Classe de benefício ”  não serão mostrados como variáveis ​​dentro do Excel, pois os demais campos que identificam o benefício dependem de ambos. beneficiar.


Somente os campos associados ao " Tipo de benefício " e " Classe de benefício ",  que são do tipo alfanumérico, permitirão a declaração de variáveis  ​​(@[variable_test]). 

Também não será válida a entrada de variáveis  ​​(@[variable_test])  para os campos do tipo auto-complete , que embora permitam a entrada de dados alfanuméricos, não são válidos para a entrada de variáveis, pois devem ser validados, no casos, contra catálogos.


Exemplo - Benefício Monetário



Exemplo - Benefício Não Monetário



> Informações do aplicativo

Aqueles campos com valores definidos pelo usuário serão tomados como variáveis. Da mesma forma, aqueles campos que permitem a entrada de valores alfanuméricos permitirão a definição de variáveis ​​(@[variável]).



As variáveis ​​a levar para mostrar no Excel serão:

  1. Aplicação máxima (valor)

  2. Aplicação máxima (medida)

  3. método de repartição

  4. Aplicar em…



> Limites de aplicação

Ao indicar um limite dentro do benefício do modelo, o usuário poderá visualizar a variável Limites de Aplicação no Excel  , onde poderá indicar os dados correspondentes ao limite entre parênteses  ([])  ou, na sua falta, indicar vários limites separando com vírgulas ( , ).


O usuário poderá indicar os dados de cada limite conforme a estrutura:

[ Tipo de limite, Período a contar, número de dias, Limite por, Valor ]


Caso o usuário não indique dados na  coluna Limites da Aplicação  Excel ... , durante a importação, serão tomados como valores dos limites aqueles definidos no template.


> Informações adicionais

Todos os campos onde o usuário definir um valor serão tomados como variáveis ​​e caso algum dos campos permita a definição de variáveis, como Conta  , Mensagem PDV, Mensagem impressora, Mensagem TLOG , será mostrado como um cabeçalho de a coluna o nome indicado na dita variável.



IMPORTANTE

Para identificar as variáveis ​​pertencentes a cada Benefício, adiciona-se o sufixo com a seguinte estrutura: 

Nome da variável  (Nº do benefício. Classe e tipo de benefício)

Exemplo:

  1. Limites de aplicação (Benefício 1. Troca com opções)
  2. Limites de aplicação (Benefício 2. Troca com opções)

Só será obrigatório carregar dados naquelas colunas definidas como variáveis ​​(@[....]) pelo usuário dentro do template, para os campos que não permitem a entrada de variáveis ​​e cujos valores tenham sido indicados em do template, o usuário pode ou não indicar valores nestas colunas, pois se estiverem vazias no momento da importação, o valor definido no template será tomado como valor final.



REFERENCIAS

Para maiores detalhes sobre os valores aceitos na definição dos benefícios Ver “Anexo VI”


Casos Prácticos de definición de Beneficios

Para mais informações e exemplos de como definir os campos de benefícios veja "Anexo VI - Casos Práticos"


Gerar modelo em formato excel

Depois que o modelo de promoção estiver completo, ele poderá ser baixado em formato Excel pressionando o  botão Gerar Excel  localizado na parte superior da  tela Definir.


 Ou na lista geral de dados  Ações  →  Gerar Excel. 



Será possível indicar, por configuração, qual será a linha do arquivo excel que atuará como cabeçalho, caso se deseje que não seja a linha um (padrão). Para isso, você deve editar o parâmetro de configuração em  Administração  →  Informações de configuração  e editar a  variável file.xls.header.rowStart.



Registo Massivo de Promoções

Ao entrar no menu  Operação  ->  Cadastro em massa , você poderá visualizar a lista de modelos disponíveis para o processo (gerados anteriormente, consulte "Modelos de promoção"). A grelha de dados apresentará o nome do template, bem como o número de promoções inseridas, atualizadas, canceladas e com erros, juntamente com a data da última execução do processo de registo massivo associado a esse template.


Ao premir o  botão Ver detalhe , será apresentada a janela " Registo massivo de promoções ", onde serão apresentados os dados do cabeçalho do modelo e o resumo dos dados associados. 

Nesta seção você pode gerar o modelo excel da promoção que está completa e ativa, bem como a seleção e processamento do arquivo ( arquivo de processo ) .


Quando o processo terminar satisfatoriamente, o status Processado será exibido à esquerda do registro indicado em " Últimas operações realizadas " e um relatório das promoções geradas poderá ser visualizado clicando no botão " Ver relatório ".


Caso tenham ocorrido erros durante o processo,  será exibido o status Erro  à esquerda do registro indicado em " Últimas Operações Efetuadas " e poderá ser visualizado um relatório detalhado dos registros que apresentaram problemas no processamento.


Limitantes y Asumisiones en el Alta Masiva de Promociones

limitações

  • As variáveis ​​não podem ser atribuídas a campos que tenham validações (máscaras) ou formatos específicos (selecionar, numérico, booleano, entre outros) do lado do console, portanto, todos aqueles campos onde o usuário indicar algum dado serão considerados como variáveis ​​no modelo. , então ao indicar valores nas colunas que representam o referido campo, eles serão salvos na promoção durante a importação, caso não indique nenhum valor na coluna do excel, o valor definido pelo usuário durante a criação será levado de o modelo.


  • Para campos de preenchimento automático, não é possível definir variáveis ​​com espaços, exemplo:  @[perfil do cliente] , pois o mecanismo de atribuição de valores em um elemento de preenchimento automático não permite, nesse caso sugere-se definir  @ [ client_profile] ou usando qualquer outro separador.

  • Apenas para os casos em que o código promocional se repete em outras promoções, ou seja, o código não é único.
    1. O usuário deverá utilizar o nome como campo chave para atualizar ou cancelar as promoções através do Excel, pois é a única forma de identificar a promoção que será atualizada/cancelada, portanto não será necessário especificar o código da promoção no Excel.
    2. É importante ter em conta que apenas pode atualizar o nome da promoção através do Excel especificando o código e se este código for único, ou seja, ainda não está atribuído a outra promoção existente.
  • Validação durante o processo de importação: 
    Benefícios:
    - Para os campos dentro do benefício que representam porcentagens, não pode ser identificado para validar que o valor não seja maior que 100.

    - Para opções de benefícios ( BenefitRedeemWithOptions ) e limites de benefícios ( Limit ) , o listDeclaredFields () método foi criado em cada entidade  onde são indicados os detalhes de cada campo (nome, tipo, obrigatório), esta solução surgiu como resposta à dificuldade de manter dinamicamente as validações dos campos associados às Opções e Limites de Benefícios, uma vez que os tipos dispostos para cada campo dentro de cada entidade não correspondem ao tipo fornecido operacionalmente do lado do console e não foi possível determinar qual era necessário ou não.

  • Edição das promoções  geradas a partir do template: Como distinguir entre uma atualização total e uma parcial (indicando campos específicos), exemplo: no caso de condições simples, se estiver definido: Marca, Fornecedor e Código (SKU )

    Caso 1:  Você deseja atualizar apenas o valor do Marca e que tanto o Fornecedor quanto o Código (SKU) permaneçam como estão definidos na promoção a ser editada, estes campos seriam deixados em branco no Excel.

    Caso 2: Se, de outra forma, o que você deseja é atualizar o valor do  elemento Marca  e que os elementos Fornecedor e Código (SKU) não estejam mais disponíveis nas condições simples, os valores associados a esses campos seriam deixados em branco dentro do Excel.


premissas

  • As colunas associadas aos campos nos quais não foi definida nenhuma variável (@[......]), estando vazias durante o processamento do Excel, assumirão o valor definido pelo usuário durante a criação do modelo de promoção.


  • Durante o processo de importação, cada coluna de cabeçalho estará sujeita às validações do campo que representa.

  • Elementos de preenchimento automático, que permitem ao usuário atribuir valores alfanuméricos, podem ser usados ​​para definir variáveis. Não será possível definir variáveis ​​com espaços nos elementos de condições simples ou universo de aplicação dos Combos ou benefícios , neste caso sugere-se o uso de um separador (_,-) entre cada palavra, como:  @ [cliente_perfil] .

  • Para os  campos nativos do benefício,  seu nome é obtido do  message.properties , no caso de ser um novo campo inserido do  ABM Propriedades do Benefício , o nome é obtido do campo nome dessa  propriedade.


  • Para as  operações de Atualização  e  Cancelamento , deverá indicar o código ou nome associado à promoção na qual deseja realizar a referida ação.

  • Não será possível Atualizar ou Cancelar promoções com status Distribuído ou Distribuído editável ( DEPLOYED/DEPLOYEDEDITABLE ), como ocorre do lado do console, além disso evitará problemas com a regeneração do id do benefício, pois ele precisa ser mantido devido à sua associação com os limites.


Importante

Quando uma promoção é criada a partir de um modelo, o aplicativo verifica as lojas. Caso o usuário logado seja um usuário com função de administrador ou tenha todas as lojas associadas, o campo Loja será um campo de texto livre, você pode inserir lojas inativas e inexistentes. Caso o usuário logado tenha uma função diferente de administrador e não tenha todas as lojas associadas, você poderá inserir apenas as lojas que estiverem associadas, serão lojas existentes e ativas vinculadas ao usuário logado, não será gratuito campo.

Caso o usuário tenha uma função diferente de administrador e não possua todas as lojas associadas, o usuário deverá inserir pelo menos uma loja no modelo de promoções, caso contrário ficará no estado "Incompleto" até que adicionem pelo menos uma loja que o usuário vinculou.


Variáveis : na seção "Condições Simples", Transação\ Armazenar, você pode inserir uma variável conforme indicado na imagem a seguir: 


Em seguida, no modelo criado pressionando o botão "Gerar Excel" no arquivo que ele cria, adicione uma coluna com o nome indicado na variável:


cancelamento em massa 

A partir da consola Promo, pode cancelar várias promoções ao mesmo tempo, para isso deve aceder, no menu Operações, à opção " Cancelamento em massa "

A tela " Cancelamento de promoções em massa " será exibida , onde você poderá selecionar as promoções que deseja cancelar. No filtro das lojas; Haverá apenas aqueles que o cliente vinculou.




Os seguintes filtros podem ser executados nesta tela para identificar as promoções que você deseja cancelar:

  • Código 
  • Nome da promoção
  • Estado
  • Campainha
  • Validade
  • Lojas


Todas as promoções serão mostradas na grade, mas somente as promoções com status " Completa " ou " Incompleta " poderão ser canceladas. As promoções no estado " Distribuído " não podem ser canceladas.


Ao selecionar uma ou mais promoções, deve-se pressionar o botão "Cancelar Promoções Selecionadas", e será exibida a tela "Cancelar Promoções", onde deverá ser indicado o motivo do cancelamento das promoções.




IMPORTANTE

O cancelamento de uma promoção NÃO tem revés.



IMPORTANTE

Caso ocorra um erro de validação durante a verificação do Excel, nenhuma das operações associadas às promoções geradas durante esse processamento serão processadas.



Limites Promoções

A partir desta opção de menu, você pode alterar o limite (ou limites) de qualquer promoção que esteja em pleno e em situação atual já em operação em uma loja. O PDV receberá esses limites sem precisar redistribuir um mapa. Se as promoções estiverem no estado Incompleto, seu limite pode ser alterado editando-o.


NOTA

Para configurar os limites de uma promoção Veja a definição dos benefícios da Promoção >> Limites.


Limite de edição:

No menu principal, selecionando: Operação > Limites de Promoções, o sistema exibirá a tela “ Limites de Promoções ”.

Abaixo do título você verá os campos "Código", "Nome da promoção" e "Lojas" através dos quais você pode pesquisar as promoções.

As lojas disponíveis no filtro são apenas aquelas às quais o usuário se vinculou.

Abaixo dos filtros você verá uma lista com todas as promoções ativas em um mapa que foram movimentadas e que possuem um limite definido (ou vários) e não estão no estado Incompleto, independentemente de sua validade. Você pode modificar tanto as promoções vigentes quanto as expiradas ou sem validade definida.  

A lista mostrará as seguintes colunas:

  • " Status " (status da promoção), 
  • " Código " (Código de Promoção), 
  • " Nome " (nome da promoção), 
  • " Campanha ", 
  • " Canais ", 
  • " Validade ", 
  • " Classe de lucro ", 
  • " Lucro "
  • "Lojas"


Importante

Você só pode alterar os "Valores"  para os limites já definidos para a promoção selecionada e que já foram transacionados . A partir desta secção não será possível adicionar nenhum "Tipo de limite" (ex. Geral, Loja, Cliente) que a promoção não tenha associado.

O "Período a contar" não pode ser modificado (ex.: indefinido, x dia).

A opção "Limitar por" não pode ser modificada (ex.: Valor em dinheiro, Quantidade de aplicações, Quantidade de produtos beneficiados).


Na tela "Limites da promoção", à direita de cada promoção listada, será exibido o botão "Editar" a partir do qual você poderá acessar a seção de edição dos limites de cada promoção.

Ao selecionar o botão "Editar", o sistema exibirá todos os limites configurados no(s) benefício(s) da promoção, e a partir daí você poderá modificar (aumentar ou diminuir) qualquer um dos limites existentes.


Limite de edição:




Os seguintes campos não serão editáveis:

Nome da promoção – exibirá o nome da promoção.

Código : mostrará o Código da promoção.

Classe de benefício : mostrará a classe a que pertence o benefício (ex: Percentual de desconto).

Benefício : exibirá o número do benefício (por exemplo, Benefício nº 1).


Na seção " Limites Configurados " mostrará:  Geral  Loja  e  Cliente  e dentro de cada um poderá mostrar: " Valor em dinheiro ", " Quantidade de aplicações ", " Quantidade de produtos beneficiados ", dependendo dos campos que contêm limites configurados. Pode haver até 9 limites para um benefício. À direita de cada Tipo de Limite será exibido um campo editável, onde você pode inserir um número sem casas decimais maior ou igual a 0. Não é possível inserir um número negativo. Por padrão trará o valor configurado na promoção ou o último modificado nesta tela.


Motivo : Neste campo é obrigatório selecionar uma das opções apresentadas no combo drop-down caso algum limite seja modificado. Entrando na tela "Editar limite" para visualizar/modificar os limites existentes de uma promoção. No campo Motivo, sempre mostrará "[Motivo]" não mostrará o último motivo digitado. Este campo é utilizado para manter um registro de auditoria que pode ser visualizado no Relatório "Histórico de Limites". (veja também "Razões para Modificação de Saldo")


Ao editar o limite, a alteração será refletida tanto na definição do benefício na promoção, quanto no Popup resumo da promoção.


Envío de Información de Estado de Limites vía RabbitMQ

Quando qualquer modificação é feita nos limites de qualquer promoção, o sistema pode reportar esta ação de atualização para um sistema externo que deseja receber esta informação.

No console do usuário promocional, indique o nome da fila do RabbitMQ para postar os dados do tipo limites de promoção ( rabbitMQ.limitstatus.endpointName ) e, ao fazer isso, ativará essa funcionalidade.

O status desse processo pode ser visualizado na seção "Import Monitor" no console Promo.


(Para obter mais informações sobre a configuração no console Promo, consulte Administração > Informações de configuração neste documento.)

(Para maiores informações sobre o processo e dados da integração com as filas do RabbitMQ, consulte o Manual de Integração Promo 7.2.)


Capítulo 6 - Módulo de Fluxo de Trabalho


O Workflow descreve as etapas necessárias para aprovar uma promoção, mostrando sua estrutura e ordem correlata. As etapas representam as etapas de aprovação de uma promoção ou tabela de preços e a função associada a cada uma delas.

Por padrão, existe um fluxo de trabalho padrão (Workflow Geral), que possui uma única etapa para aprovação de uma promoção ou tabela de preços. O universo de aplicação de um fluxo de trabalho não pode ser editado uma vez que tenha promoções ou tabelas de preços associadas.


MÚLTIPLOS fluxos de trabalho

No PROMO existe a possibilidade de definir mais de um Workflow para aprovação de promoções e tabelas de preços. Desta forma, as etapas para aprovação de um determinado grupo de promoções ou tabela de preços podem ser realizadas de forma independente.

Por exemplo, promoções que se aplicam a determinado item ou fornecem determinado benefício podem ser aprovadas no Workflow A , que possui 4 etapas definidas, enquanto outro grupo de promoções que se aplica a outro grupo ou segmento de itens ou aplica outra margem de lucro. ser aprovado pelo Workflow B , que possui 2 etapas definidas.

O mesmo ocorre para os Workflows de Lista de Preços.

O WF pode ser aplicado a:

  • promoções
  • Lista de preços


Para definir estes Workflows, clique no botão "Novo" na janela "Workflows".

A tela " Novo Workflow " será exibida onde você deve inserir um nome e uma descrição.

3 caixas de seleção são exibidas, indicando se o Workflow se aplica a promoções, listas de preços ou ambos, e se as condições gerais serão aplicadas. Por padrão, as 3 caixas de seleção estão marcadas.


NOTA

Caso uma empresa não tenha o módulo de listas de preços habilitado, os fluxos de trabalho serão aplicados apenas para Promoções.

Se um fluxo de trabalho já estiver sendo usado em uma promoção ou em uma tabela de preços, NÃO será possível desmarcar a caixa de seleção "Aplicar promoções" ou "Aplicar preços".


 Clicando em "Salvar" aparecerá a tela com a lista de "Workflows" onde você poderá indicar as etapas que irão compor aquele Workflow e quais as funções que se encarregarão de realizar a aprovação em cada etapa.

Por padrão, a etapa 1 já estará definida com o nome "Captura" e a ela será atribuída a função de administrador.


Ao clicar no botão "Novo", novas etapas podem ser definidas dentro dele e associar a função correspondente para aprovação.

Ao selecionar a função, o aplicativo exibirá uma caixa de texto com todos os usuários que foram atribuídos a essa função:

Se nenhum usuário for selecionado, a ordem 1 será semelhante ao exemplo a seguir. Se apenas 1 usuário for selecionado, será semelhante à ordem 2 da imagem a seguir. Se dois usuários forem selecionados, eles serão exibidos conforme mostrado na ordem 3. Se todos os usuários forem selecionados, todos os usuários serão exibidos separados por vírgulas. Ao clicar em "Salvar", serão mostrados os passos que compõem o WF:

Exemplo:

Seguindo o exemplo anterior, como na Etapa de Captura não foi selecionado nenhum usuário dentro da Função de Administrador, qualquer usuário com essa função poderá criar uma promoção usando esse fluxo de trabalho (workflow2 no exemplo).

Após a criação da promoção, o usuário administrador pode enviá-la para aprovação:

Nota

O usuário que criar o fluxo de trabalho terá disponíveis apenas as funções que possuem as permissões configuradas.

Etapas de um fluxo de trabalho

Ao criar uma promoção, ela é atribuída a um Workflow específico (na definição do cabeçalho da promoção) e, uma vez concluída, pode ser enviada para aprovação.

Caso tenhamos definido mais de uma etapa para o workflow selecionado, a promoção deverá ser aprovada por todas as etapas que fazem parte do Workflow ao qual pertence para participar após um mapa.

Para enviar uma promoção para análise ou aprovação, você deve clicar no botão " Enviar para aprovação ", no item Ações, conforme a imagem abaixo:


Promoções a Aprovar


Uma vez enviada uma promoção para aprovação, ela permanecerá na tela "Gestão de Promoções" com o status "Avaliar/Aprovar" e, por sua vez, aparecerá na tela "Promoções a Aprovar", de onde o usuário com a função definido para aquela etapa do fluxo de trabalho ao qual a promoção pertence, aprova ou rejeita a promoção enviada.

Para aceder às promoções a aprovar, deverá entrar no menu "Operação" e no menu apresentado deverá carregar em "Promoções a Aprovar", conforme a imagem seguinte:

No caso de ter entrado com um usuário com direitos de administrador, será exibido o contador à direita do título "Promoções a Aprovar" indicando "n" número de promoções enviadas a aprovar (neste caso, continuando com o exemplo, será ser "1" conforme indicado na imagem).

No caso de ter entrado sem permissões de administrador (como com o usuário "Operador"), o título "Promoções a Aprovar" será exibido no submenu, mas com o valor da quantidade que está à direita, em zero "0".

Cada função verá as promoções a serem aprovadas dos fluxos de trabalho dos quais participa.

Ao clicar na opção "Promoções a aprovar", um usuário pertencente à função definida poderá revisar e  aprovar/rejeitar  a promoção.

O sistema o levará para a seguinte tela, onde pressionando o botão "Ações" aparecerá o submenu com as seguintes opções:

  1. história do wf
  2. Resumo
  3. aprovar/rejeitar


Para aprovar ou rejeitar uma promoção, você deve clicar na opção "Aprovar/Rejeitar" e feito isso, o sistema exibirá a seguinte caixa de diálogo:

A partir daí você pode rejeitar ou aprovar uma promoção, pressionando "Rejeitar" ou "Aprovar" além de poder registrar informações (texto) na caixa "Observação" vazia em relação à ação realizada.

Depois de aprovada ou rejeitada, a promoção aparecerá com o status correspondente, na página "Gestão de promoção", na coluna Fluxo de trabalho que aparece com o nome do fluxo de trabalho ao qual pertence

Ao final do ciclo de revisão, a promoção estará totalmente aprovada e poderá ser incorporada a um mapa.


Workflows de mas de un paso de aprobacion

Quando uma promoção é atribuída a um fluxo de trabalho com mais de uma etapa, e é "ENVIADA PARA APROVAÇÃO", a promoção NÃO PODE SER EDITADA , pois é esperada a aprovação ou rejeição do que está definido nela.

Caso a promoção seja "rejeitada" por alguma das etapas do WF, ela retornará à primeira etapa, onde poderá ser editada e corrigida.

Quando a promoção for "APROVADA" por todas as etapas do WF ao qual foi atribuída, a promoção NÃO PODERÁ SER EDITADA, ficando disponível para ser incluída em um mapa.


Workflows de solo un paso de aprobación

Quando uma promoção é atribuída a um fluxo de trabalho de apenas uma etapa, ela será "Aprovada" imediatamente quando for para "Concluída", poderá ser editada e estará disponível para ser incluída em um mapa.

Promociones para Aprobar

Por padrão (se nada for filtrado), ao entrar na tela "Promoções a aprovar" serão mostradas todas as promoções que o usuário logado tem pendentes de aprovação para todas as lojas vinculadas.



Histórico do fluxo de trabalho

O Workflow permite definir um fluxo de revisão e aprovação de promoções.


Exemplo:

  1. A operadora capta as promoções e as envia para aprovação.
  2. O supervisor valida a promoção carregada e aprova ou rejeita de acordo com seus critérios.



As promoções totalmente aprovadas poderão ser adicionadas a um mapa e distribuídas nas lojas.


Para acessar o histórico do fluxo de trabalho, você pode entrar em:

  • "Promoções a Aprovar" conforme detalhado na imagem, clicando no submenu exibido a partir do botão "Ações", opção "Histórico WF"
  • "Gestão da promoção" pressionando o botão "Ações" à direita da tela na promoção escolhida e no submenu exibido, pressionando "Histórico WF".


No histórico do fluxo de trabalho, você pode ver:

  1. As etapas realizadas com cada promoção
  2. O usuário que fez cada um deles
  3. A data e a hora em que foram feitos
  4. Se eles foram bem sucedidos


Na imagem a seguir você pode ver as etapas detalhadas do Workflow em ordem crescente (de baixo para cima) com as informações especificadas:

Capítulo 7 - Módulo de Distribuição



Menu de Distribuição


A partir desta opção PROMO, pode criar e distribuir mapas, simular bilhetes com promoções e mapas, bem como distribuir promoções em diferentes redes sociais.


mapas

Um mapa é um conjunto de promoções, com uma validade e regras que irão coexistir no motor de promoções num determinado momento.

O mapa deve ser definido para poder especificar regras de convivência entre as promoções que o compõem e especificar a ordem de aplicação e consumo que existirá entre elas.

Para gerar um mapa, o mesmo deve ser acessado através do menu Distribuição > Mapas (POS).

NOTA

As promoções não serão válidas se não estiverem dentro de um mapa. Só então poderão ser avaliados e aplicados de acordo com as regras de convivência que foram definidas para eles no mapa. 




Criar Mapa


Para criar mapas, você deve pressionar o botão "Novo".

Ao definir um novo mapa, você pode optar por usar um dos modelos de mapa completos , criados anteriormente no menu Administração > Modelos de mapas .


No ecrã " Publicações de mapas (POS) " devem ser introduzidos os seguintes dados obrigatórios:

  • Publicação : nome pelo qual o mapa será identificado quando for listado para gerar os arquivos de definição.
  • Início de validade : indica a data inicial a partir da qual o mapa estará em vigor uma vez distribuído. Tome 00:00 como a hora de início do dia. A data deve ser atual ou superior.
  • Término da validade : indica a data em que terminará a validade do mapa. Leva 23:59 como a hora final do dia.


O comportamento da sugestão no nível do Mapa também pode ser configurado aqui. Este campo também é obrigatório, por padrão ele salva "Não sugerir".

Os campos a configurar serão:

  • Dicas – As opções para este campo são:
    • NÃO sugerir: Não serão feitas sugestões para nenhuma das promoções que compõem o mapa, independentemente do valor de "sugerir" que cada promoção tenha configurado.
    • SEMPRE sugerir : As sugestões serão avaliadas para todas as promoções que compõem o mapa, independentemente do valor de "sugerir" que cada promoção tenha configurado.
    • Sugerir de acordo com a PROMOÇÃO: as promoções serão sugeridas ou não de acordo com a configuração de sugestão no nível da promoção.


  • Dias para devolução : indica o número de dias que o mapa ficará disponível após a data de vencimento, somente para transações de devolução. 

Esses dados permitem que o sistema determine a quantidade de dias que o uso do mapa deve ser considerado para resolver as promoções nas transações de devolução, assim como foram feitas na compra original. Caso não seja informado um valor neste campo, considera-se que não há limitação de dias. O preenchimento deste campo é opcional.


IMPORTANTE

O mapa entrará em vigor somente após a geração do arquivo de definição correspondente.


Se em Administração > Modelos de Mapas, na tela "Gerenciamento de Modelos de Mapas", o botão " Gerar Mapa " foi pressionado, irá para a tela " Publicações de Mapas (POS) ", onde aparecerá o campo " Modelo de Mapa " carregou o nome do modelo que está sendo cadastrado e não pode ser editado.

No campo "Publicação" você deve inserir o nome sob o qual o mapa será publicado.

As datas de início e término do mapa apresentarão os valores padrão e poderão ser editadas. O campo de sugestão assumirá os valores configurados no template e o campo dias para retorno ficará vazio como de costume.


Em seguida, pressionando "Salvar" será exibida a tela " Definir mapa (POS) " , onde já serão exibidas as promoções pertencentes aos tipos, subtipos e formas de aplicação definidos no modelo de mapa que foi fornecido na composição do mapa.


Se um modelo de mapa foi selecionado 

Mostrará mais uma opção na parte inferior da tela: “ Distribuição Programada ”. É uma verificação que por padrão vem desmarcada. 

Se você habilitou a Distribuição Agendada : Existe um processo que  é executado automaticamente uma vez ao dia para distribuir os mapas que possuem essa verificação ativa. Estes mapas devem ter um modelo associado e devem ser automáticos (Ver CONFIGURAÇÃO E FUNCIONAMENTO DA DISTRIBUIÇÃO AUTOMÁTICA E AGENDADA DE MAPAS abaixo  ).


Pressionando " Salvar " na tela "Publicação do mapa (POS)" irá para a tela " Definir mapa (POS)" , onde serão exibidas as promoções pertencentes aos tipos, subtipos e formas de promoções na composição do mapa. aplicativo definido no modelo de mapa.



Se um modelo de mapa não foi selecionado :

Depois de inserir todos os dados do mapa, pressione o botão " Salvar ".

Será apresentado o ecrã “ Definir Mapa (POS) ”, no qual deverá selecionar as promoções que irão integrar o mapa.

Esta tela é dividida em dois setores:


O cabeçalho onde serão exibidos os dados carregados anteriormente junto com as opções Verificar Colisões, Geração Automática, Resumo, Baixar, Distribuir, Editar e Retornar.


Os dados de composição do mapa , onde serão mostrados os Passos , Funções,  Promoções  Cond Gral (Condições Gerais) disponíveis.

Na área esquerda pode definir os passos, funções, promoções e condições gerais selecionando o elemento que pretende criar e arrastando-o para a janela direita do Dashboard. Uma etapa deve ser criada selecionando o botão " Nova etapa " e arrastando-a para a janela da direita.


NOTA

Para facilitar a navegação entre as promoções de um mapa, existe a opção de recolher ou expandir todas as etapas do mapa, pressionando o botão localizado no canto superior direito da definição do mapa.


Passos

Quando o mapa é definido, cada uma das promoções integrará uma das Etapas e se várias promoções coexistirem na mesma etapa, elas serão combinadas através de funções de coexistência.

A existência de etapas dentro do mapa permite restaurar os elementos consumidos pelas promoções entre uma etapa e outra.

O usuário logado verá todas as promoções associadas às suas lojas vinculadas (o que significa que o usuário administrador verá todas as promoções e outro usuário verá apenas as promoções associadas às lojas vinculadas).

O usuário logado poderá  editar  o mapa que chegou em sua loja, poderá ver todas as promoções no mapa, sejam elas vinculadas a suas lojas ou não. O mapa o verá completo, mas só poderá adicionar ou remover promoções que tenham lojas associadas a ele. Você não poderá remover promoções que tenham lojas associadas que você não tenha vinculado.

O procedimento para avaliação e aplicação dos benefícios presentes no mapa funcionará da seguinte forma:

  1. A função de coexistência integral do primeiro passo é avaliada (lembre-se que a função é sempre única e pode ser composta por promoções ou outras funções).
  2. Dependendo do tipo de função, uma vez avaliada, os elementos de contexto recebidos entre as promoções foram consumidos e os benefícios aplicados, passa para a próxima etapa restaurando os elementos de contexto que foram consumidos quando as diferentes promoções são aplicadas e com os preços ampliados modificados pela aplicação de benefícios.
  3. Continue avaliando os próximos passos do mapa conforme explicado nos pontos 1 e 2.

Uma promoção só pode existir em uma única etapa, e a mesma promoção não pode ser encontrada em mais de uma etapa.


funções de coexistência

Chamaremos a expressão que determina a ordem de processamento entre as promoções dentro da mesma etapa de "função de coexistência" .

Também determinará como será o "consumo do item".

Chamaremos de " Consumo de elementos " quando uma promoção utilizar um ou vários elementos do contexto para aplicar um benefício.

Os itens que receberam um buff em uma etapa não estarão mais disponíveis para uso em uma promoção futura, a menos que o recurso de coexistência permita.

As funções de coexistência disponíveis são:

  • SEQUENCIAL (CONSUMA)

Dentro da função SEQUENCIAL, cada promoção de componente é processada na ordem em que a função foi configurada.
A promoção processada consumirá os elementos que dela participaram e não poderá ser utilizada nas próximas promoções integrantes dessa função SEQUENCIAL. A ordem em que cada promoção é definida dentro da função
é muito importante , pois essa ordem é a que será utilizada para realizar o consumo dos elementos. Do processo de todas as promoções da função, será obtida uma arrecadação de benefícios composta pela soma dos benefícios obtidos em cada uma das promoções da função.

  • TODOS

Dentro da função, TODAS as promoções envolvidas são processadas de forma independente com base no mesmo contexto recebido pela função, gerando uma coleção de benefícios independentes que serão somados ao final do processo. Neste caso, a ordem em que as promoções são definidas dentro da função TODAS não será tão importante , pois seu processo é independente.As Promoções Intervenientes serão aquelas que tiverem suas lojas vinculadas associadas (ou seja, o usuário admin verá promoções, e outro usuário verá apenas as promoções associadas às lojas que ele vinculou).

  • OPÇÕES

Neste tipo de função, cada promoção é processada de forma independente e é gerado um conjunto de opções entre as quais o cliente pode escolher. De cada opção será obtido um conjunto de benefícios que serão aplicados de acordo com a opção selecionada pelo cliente. No caso da função OPÇÕES, o número de opções que o motor irá responder dependerá do número de promoções que o integram, aplicáveis ​​ou não.

  • EXCLUIR

Com este tipo de função, as promoções são avaliadas por ordem (conforme como foi definida a função), antes da primeira promoção que cumpra a sua condição e possa ser aplicada, é feita a avaliação das restantes promoções que fazem parte da função parado, com o qual Antes da primeira promoção que se aplica, o resto das promoções já estão excluídas da avaliação.

  • AVALIE SE (SE)

Esta função consiste em uma série de promoções, que serão chamadas de "condicionamento", e uma que será a promoção "condicional". Desta forma, a promoção condicional só será aplicada aos artigos que tenham beneficiado de pelo menos uma das promoções condicionais. As promoções de condicionamento pertencem a etapas anteriores à etapa em que a função AVALIAR SE aparece. É por isso que a função AVALIAR SE aparecerá em uma segunda etapa ou etapas superiores, mas nunca na primeira etapa. A promoção condicional será a última a aparecer na lista, enquanto as condicionadas, portanto, serão todas as que aparecerem primeiro. Se você deseja que exista mais de uma promoção condicional, todas elas devem fazer parte de alguma função de coexistência.


Exemplo:

    • Promo-A: avalia a existência de artigos com o código 111 e que pertença à família "Electro".
    • Promo-B: avalia a existência de itens da família "Electro".


O mapa será constituído da seguinte forma:


1 item em conformidade com a Promo-A ("111") e outro item em conformidade com a Promo-B ("333") é inserido na transação.

Ao avaliar os itens com o mapa que contém a função "Avaliar Se", o Promo-A e Promo-B serão aplicados ao item "111", enquanto o item "333" não obterá benefícios, pois por definição, Somente a promoção condicional (Promo-B) será aplicada aos artigos que beneficiaram da promoção condicional (Promo-A). 


  • AVALIE OUTRO (SE NÃO)

Esta função consiste em uma série de promoções, que serão chamadas de "condicionamento", e uma que será a promoção "condicional". Desta forma, e ao contrário da função anterior, a promoção condicional só será aplicada a artigos que não tenham beneficiado de nenhuma das promoções condicionais.
As promoções de condicionamento pertencem às etapas anteriores à etapa em que a função EVALUATE ELSE aparece. É por isso que a função EVALUATE SinNOT aparecerá em uma segunda etapa ou etapas superiores, mas nunca na primeira etapa. Exemplo: Se a função EVALUA ELSE estiver na terceira etapa, as promoções que fazem parte das etapas 1 e 2 podem ser utilizadas como condicionantes.
Como na função anterior, a promoção condicional será a última a aparecer na lista, enquanto as condicionais serão, portanto, todas as que forem encontradas primeiro. Se você deseja que exista mais de uma promoção condicional, todas elas devem fazer parte de alguma função de coexistência.


Exemplo:

    • Promo-A: avalia a existência de artigos com o código 111 e que pertença à família "Electro".
    • Promo-B: avalia a existência de itens da família "Electro".


O mapa será constituído da seguinte forma:


1 item em conformidade com a Promo-A ("111") e outro item em conformidade com a Promo-B ("333") é inserido na transação.

Ao avaliar os itens com o mapa que contém a função "Avaliar Se Não", será aplicado o Promo-A no item "111" e o "Promo-B" no item "333".

O item "111" não se beneficiará da Promo-B, pois por definição, a promoção condicional (Promo-B) só será aplicada aos itens que NÃO se beneficiaram da promoção condicional (Promo-A). 



As seguintes funções são apenas para BENEFÍCIOS MONETÁRIOS:


  • DESCONTO MÁXIMO (DESCONTO MÁXIMO)

Neste tipo de função, cada promoção é processada de forma independente e PROMO informa qual é a promoção e correspondente benefício que concede o maior desconto entre todas as promoções que fazem parte da função.  Com isso, será aplicada  apenas uma promoção , aquela que der o maior desconto ao cliente .


Cupon Calculado como Beneficio Monetario

Quando uma promoção conceder um benefício que conceda um cupom calculado (Não Monetário), ou seja, terá um valor associado, e esta promoção for colocada dentro de uma função de coexistência de Desconto Máximo, será avaliado o valor a ser emitido no cupom no âmbito da transação como Benefício Monetário e se for o melhor benefício que se aplica ao contexto ou faz parte do conjunto de promoções que se aplicam ao contexto, será aplicado e será emitido o cupão com o valor correspondente .


  • DESCONTO MÍNIMO (DESCONTO MÍNIMO)

Neste tipo de função, cada promoção é processada de forma independente e PROMO informa qual é a promoção e benefício correspondente que concede o menor desconto entre todas as promoções que fazem parte da função.


NOTA

Nos casos em que a promoção que faz parte da função DESCONTO MAX ou MIN contém mais de um benefício e alguns deles NÃO Monetários, a promoção será avaliada da mesma forma que as demais, mas no caso de NÃO -Benefícios monetários, não contarão nem somarão um valor ao valor do benefício que será o que posteriormente será avaliado entre todas as promoções que fazem parte da função que possam ser aplicadas.


  • DESCONTO MÁXIMO COMBINADO

Esta função avalia todas as promoções incluídas nela, com base em um determinado contexto (bilhete) e então  concede  o conjunto de promoções  que dá o maior valor de desconto ao cliente .

Nota

Esta função de coexistência deve ser utilizada sem nenhum tipo de aninhamento, nem dentro nem fora dela, pois somente a operação do desconto máximo combinado será considerada e não as demais funções de coexistência aninhadas.


Deve-se considerar também que as promoções que constam na avaliação dessa função de convivência devem ser constituídas por um único benefício.


A função combinada Desconto máximo deve ter pelo menos duas promoções dentro da etapa para aplicar a funcionalidade de competição de promoção.



Os seguintes recursos são apenas para BENEFÍCIOS NÃO MONETÁRIOS:


      • MAXIMUM POINTS (MAX POINTS)

Neste tipo de função, cada promoção é processada de forma independente e PROMO informa qual é a promoção e correspondente benefício que concede maior número de pontos entre todas as promoções que fazem parte da função.


      • PONTOS MÍNIMOS (PONTOS MIN)

Neste tipo de função, cada promoção é processada de forma independente e PROMO informa qual é a promoção e correspondente benefício que concede o menor número de pontos entre todas as promoções que fazem parte da função.


NOTA

Nos casos em que a promoção que faz parte da função MAX ou MIN POINTS contém mais de um benefício e um deles é Monetário, a promoção será avaliada da mesma forma que as demais, mas no caso de benefícios Monetários eles não contarão ou somarão pontos ao benefício total que será aquele que posteriormente será avaliado entre todas as promoções que fazem parte da função que podem ser aplicadas.


NOTA 2

Nos casos em que a única promoção aplicável dentro da função MAX ou MIN POINTS seja uma promoção que conceda um único benefício Monetário, então não será considerada como aplicada. Já que dentro desta função, a única promoção que é retornada deve ter pelo menos um benefício NÃO Monetário de porcentagem ou pontos de fidelidade


NOTA 3

As promoções que concedem benefício da classe Saque Bancário, estarão localizadas em uma única e última etapa, dentro de uma função Todas, e não coexistirão com outras promoções.

Composição de funções de coexistência

Os argumentos das funções, além de serem compostos por promoções, também podem ser compostos com outras funções.

Ao poder combinar as funções, pode-se obter uma maior variedade de relacionamentos entre as promoções ao determinar sua prioridade entre elas.


Exemplo:


No passo 1 , utilizando a função DESCONTO MÍNIMO, seria avaliado qual das duas promoções concede o menor benefício.

No passo 2 expressa-se que o PDV será informado de duas opções para que o cliente possa escolher entre duas listas de benefícios que decorrem de:


      • primeiro aplique a promoção PR03 e a promoção PR04 e depois aplique as promoções PR05 e PR06 nos produtos que não participaram das promoções PR03 e PR04
      • primeiro aplique a promoção PR05 e a promoção PR06 e depois aplique as promoções PR03 e PR04 nos produtos que não participaram das promoções PR05 e PR06


Na última etapa é aconselhável definir as promoções no nível de pagamento médio, que atuam na aplicação total das promoções.

Na etapa 3, a promoção PR07 poderá ser um desconto de 10% para funcionários, que será aplicado ao último contexto restaurado da etapa anterior, ou seja, se um perfume de R$ 80 recebeu um desconto de R$ 40, para a base de desconto de 10% será leva $ 40 (seu preço estendido).

Uma vez definidas as etapas e funções de convivência, o sistema mostrará na tela como cada uma delas foi definida com suas promoções correspondentes.


NOTA

A mesma promoção não pode ser adicionada duas vezes com o mesmo operador. Por exemplo: se o usuário quiser definir uma função através de ALL e selecionar a mesma promoção duas vezes, o sistema irá adicioná-la apenas uma vez.



CONDIÇÕES GERAIS


Na janela " Definir Mapa (POS) " existe um separador chamado " Condições Gerais " na secção Composição do Mapa. Ao premir este separador, serão apresentadas todas as condições gerais em vigor para a data definida no mapa. Ele irá exibi-los do mais novo para o mais antigo. A partir daí você pode arrastar para a seção "Condições Gerais" à direita, as condições gerais que deseja incluir no mapa que está sendo gerado.

Depois de adicionar as Condições Gerais desejadas, elas serão incorporadas ao mapa quando ele for distribuído ou baixado.

Todas as Condições Gerais adicionadas ao mapa serão avaliadas, independente da ordem em que forem colocadas. 

O mapa que se descarrega conterá as Condições Gerais.



colisões


As colisões referem-se ao conflito que pode ocorrer ao avaliar promoções ou adicionar promoções a um mapa e que vinculam aquelas promoções que usam o mesmo código de artigo , deixando de lado aquelas que se aplicam a todo um grupo de artigos ou departamento ou grupo.

As colisões podem ser verificadas com as Condições Gerais incluídas, e será informado com quais colisões e/ou promoções há colisão.

Os momentos em que a verificação de colisão é realizada são detalhados a seguir.

O código do artigo com valor 8321 é tomado como exemplo.


Caso A: Criação de promoção


      1. Está registada uma promoção PROMO_A que utiliza o artigo com o código 8321.
      2. É registada uma nova promoção PROMO_B, cuja data de vigência cruza com a PROMO_A, e que também utiliza o artigo com o código 8321.



Caso B: Adicionando promoção a um mapa.


      1. A promoção PROMO_A é adicionada ao mapa, que utiliza o artigo com o código 8321
      2. Ao mapa é adicionada a promoção PROMO_B, cuja data de vigência cruza com a PROMO_A, e que também utiliza o artigo com o código 8321.
      3. Um aviso de aviso de colisão de promoção aparecerá conforme mostrado na imagem a seguir.






CONFIGURAÇÃO E FUNCIONAMENTO DA DISTRIBUIÇÃO AUTOMÁTICA E PROGRAMADA DE MAPAS:


Na  seção Administração\Informações de configuração , as opções necessárias para a execução do processo de geração e distribuição de mapas programados podem ser configuradas.

As opções para configurar são:

  • Geração e distribuição agendada de mapas -  schedule.enable :  permitirá ativar o processo de distribuição agendada através de um job que será executado uma vez ao dia. Por padrão, ele virá em false.
  • Filtre as promoções por loja para distribuição agendada e manual -ched.filter.enable : indicará se as promoções que se aplicam à loja dentro do mapa são ou não filtradas. Se definido como  false , todas as promoções serão enviadas para todas as lojas. Se for  true , os mapas que serão distribuídos conterão apenas as promoções que se aplicam à loja para a qual é distribuído e as promoções que não possuem condição de loja definida. Por padrão, ele virá em  false . 
  • Aumente a versão do mapa para a distribuição de mapas-  agendada.mapVersion :  Aqui é indicado que a cada distribuição, seja para uma loja de laboratório ou para uma loja de produção, o número do mapa aumentará, e na tela "Distribuição" / Maps ” sempre poderá observar a última distribuição feita para o mapa.  Por padrão, ele virá em true




Uma vez habilitadas as variáveis ​​de configuração necessárias, para executar o circuito automático de geração e distribuição de mapas, você deverá criar um modelo de mapa em  Administração \ Modelo de mapa  e criar o modelo de mapa, que deve estar completo e ativo.

Em seguida, em  Distribuição\Mapas (POS) ao cadastrar um novo mapa   deve-se selecionar o modelo recém cadastrado, e ao fazer isso aparecerá uma nova opção " Distribuição agendada"  ( caixa de seleção ) ao final do formulário, que deve estar habilitada , para indicar desta forma que o referido mapa será utilizado pelo processo de geração e distribuição programada de mapas.




Todos os mapas que não tiverem o  campo Distribuição agendada habilitado  não serão levados pelo processo de geração e distribuição de mapas agendados . Eles podem ser distribuídos a partir do console manualmente.


Importante

Ao criar ou editar um mapa, se o usuário selecionar um Template de Mapa, aparecerá o seguinte aviso "No caso de mapas baseados em templates com status INCOMPLETO devido a promoções que ficaram de fora por expiração e que foram atualizadas para torná-los válido, você deve entrar na janela Editar e pressionar o botão Salvar para atualizar o estado do mapa”.

Caso o mapa com distribuição agendada fique incompleto, não será levado pelo processo agendado, neste caso o usuário deve ir em Mapas -> Editar e pressionando o botão Salvar o mapa baseado em um modelo será regenerado incluindo as novas promoções ou promoções que voltem a vigorar e retirando as que já não valem ou foram canceladas.

Exemplo 1:

Tenho um mapa com 2 passos e em cada passo tem 1 promo. A promoção que está na etapa 2 expirou. O processo de distribuição do mapa agendado removerá o Step 2 e o promo que está nele, deixando apenas o Step 1 com o Promo a neste mapa. E o mapa continua em estado completo.

Passo 1

    promoção para

Passo 2

    Promoção b (expirada)


Exemplo 2:

Tenho um mapa com 2 passos e em cada passo tem 1 promo. As 2 promoções expiraram ou foram canceladas ou estão incompletas

  • Nesse caso, o mapa fica incompleto para resolvê-lo: o usuário deve editar a promoção e torná-la válida e depois ir em Mapas -> Editar e pressionar o botão Salvar. Neste caso, o Step 1 com Promo a permanecerá no mapa, o step 2 e o Promo b serão excluídos do mapa.
  • Defina no mapa e coloque diferentes promoções nessas etapas

Passo 1 

     Promoção para (cancelada, expirada ou incompleta)

Passo 2

      Promoção b (cancelada, expirada ou incompleta)

O importante é que o mapa permaneça em um estado completo.



Uma vez gerado o mapa por meio do modelo selecionado,  deve-se clicar no botão Distribuir.



Lá serão selecionadas as lojas (  botão Selecionar Lojas ) que serão associadas ao mapa e nas quais será feita a distribuição programada, e pressione " Salvar "


Tanto na aba "Laboratório" quanto na aba "Produção", o usuário logado verá apenas as lojas que estiverem vinculadas.

Importante

Apenas a(s) loja(s) que o usuário vinculou estarão disponíveis para distribuição. Da mesma forma, o usuário verá apenas os mapas que foram distribuídos na(s) loja(s) a que estão vinculados.


Desta forma, o mapa estará pronto para ser levado pelo processo  de geração e distribuição programada de mapas . Este processo irá filtrar as promoções que se aplicam a cada uma das lojas  com ligação automática  (desde que a variável de configuração esteja habilitada:  ched.filter.enable.)

Info

O usuário logado poderá editar  (editar e definir) o mapa que chegou em sua loja, poderá ver todas as promoções no mapa, sejam elas vinculadas a suas lojas ou não. O mapa o verá completo, mas só poderá adicionar ou remover promoções que tenham lojas associadas a ele. Você não poderá sacar promoções que tenham lojas associadas que você não tenha vinculado.


Na secção "Cabeçalho" do ecrã Distribuição, será apresentada a legenda "Lojas a distribuir" onde poderá visualizar a lista de lojas associadas ao mapa.

Cada vez que o processo de distribuição agendada automática for executado, será gerado um registro no  Histórico do Mapa  , que apresentará no máximo 25 registros de distribuição.



Caso o tamanho do mapa exceda o máximo permitido ( 16 megabytes), não será possível salvar o mapa da loja, portanto o detalhe do erro será armazenado no log de distribuição nas lojas onde não foi possível salvá-lo. o xml gerados durante o processo de distribuição.



Processo detalhado de Geração e Distribuição de mapas programados.

  1. Ao iniciar o processo automático de Geração e Distribuição Agendada de Mapas, buscará as lojas definidas para cada empresa e utilizará para distribuição apenas aquelas que estiverem ativas, com tipo de conexão AUTO, e pelo menos um motor associado. 
  2. Em seguida, ele procurará o modelo de mapa de estado COMPLETO mais recente que você gerou ou editou.
  3. Concluídas as etapas 1 e 2 com sucesso, as promoções Completas e Atual serão adicionadas ao mapa com base no modelo de mapa escolhido, tomando como referência a definição de “transação” que cada promoção possui, e assim agrupar por mapa, as promoções que se aplicam a cada uma das lojas, esta última somente se a variável de configuração  schedule.filter.enable estiver habilitada.
    As promoções que não tiverem condição de "transação" definida serão distribuídas para todas as lojas.
  4. Assim que os mapas completos de cada uma das lojas estiverem disponíveis, os .xml são distribuídos.


Importante

Quando uma promoção expira, é cancelada ou fica incompleta, o processo de distribuição do mapa agendado removerá essas promoções do mapa. Também incluirá novas promoções. Para isso (adicionar ou remover promoções) analisará o tipo, subtipo e forma de aplicação das promoções, que devem coincidir com o definido no modelo de mapa utilizado.



Se no processo de distribuição alguma loja não estiver disponível ou a conexão for perdida, o arquivo .xml será postado e ficará pendente para que quando a conexão for restabelecida, a entrega seja automaticamente repetida.


Caso pretenda que um mapa deixe de fazer parte do processo de distribuição agendada, terá de aceder a Distribution\Maps, e editar o mapa que pretende remover.

A tela de Publicação do Mapa será aberta e a caixa de seleção: "Distribuição Programada" poderá ser desmarcada. Neste caso os demais campos não serão habilitados.


Todos os mapas gerados a partir de um modelo de mapa, tenham ou não distribuição agendada ativa, podem ser editados e habilitar ou desabilitar o processamento agendado.




Distribuir um mapa


Uma vez cadastrado o mapa no console de administração de promoções com suas respectivas funções de promoção e convivência, o próximo passo para que o mapa se torne válido será gerar um arquivo de definição ou Mapa, o que pode ser feito pressionando o botão "Distribuir " localizado na mesma tela onde o mapa é criado no canto superior direito.

O arquivo de definição é um arquivo em formato XML que será utilizado pelo motor PROMO para poder avaliar as promoções. Contém todos os dados dos componentes que compõem o mapa.

O arquivo de definição pode ser gerado e depois distribuído. Para realizar a geração, deve-se selecionar o mapa desejado e o arquivo de definição estará pronto para ser distribuído a qualquer momento.

Ao distribuir o arquivo de definição já gerado para as lojas, o usuário pode escolher entre AUTO, FTP, FTP Seguro e Arquivo.



As promoções só estarão em vigor ao integrar um mapa. A partir do mapa será gerado o arquivo de definição com o qual o motor PROMO irá trabalhar.

O processo que permite fazer isso é: Distribuir , onde além de gerar esse arquivo, você pode distribuí-lo para as lojas onde opera o motor de promoções.

Você deve selecionar a loja ou lojas nas quais deseja distribuir um mapa.

Ao pressionar " Selecionar lojas " aparecerá o seguinte pop-up onde você poderá selecionar entre as lojas de Laboratório ou Produção, conforme necessário. Feita a seleção, o sistema apresentará as lojas correspondentes e a Zona a que corresponde.

O sistema permite ao utente selecionar para cada zona, uma ou todas as lojas que lhe estão atribuídas sem perder a seleção efetuada para as outras zonas. O combo Zonas recupera a informação que foi carregada através do catálogo, e para cada Zona são mostradas todas as lojas contidas na zona selecionada.


Você deve selecionar as lojas correspondentes e pressionar o botão " Salvar ", indicando que o mapa está pronto e disponível para ser publicado.

Em seguida, você deve pressionar "Publicar" na tela de Distribuição, para executar o processo manual de distribuição do mapa.


Pressionar "publicar" exibirá um pop-up confirmando a ação. 


Uma vez pressionado " Aceitar ", o mapa será distribuído no (s) destino(s) selecionado(s).

A seguir, será exibido um breve resumo da distribuição desse mapa, indicando a versão, o número de vezes que foi distribuído, as lojas em que foi distribuído e se o processo foi concluído com sucesso.

O arquivo de definição terá um número de versão que será único e atribuído pelo sistema quando for gerado.

O nome do arquivo será o número da versão e sua extensão .xml (Ex: 1.xml )


IMPORTANTE

Depois que um mapa é distribuído para uma loja de produção, ele não pode ser modificado ou excluído.



Distribuição individual de Promoções

A partir desta versão, Promo permite a distribuição de promoções individualmente em motores que já tenham distribuído tal promoção. 

As promoções devem estar no status " Distributed " e para poder editá-las, deve-se habilitar a configuração " DeployedEditable.enabled ", que habilita a edição da promoção com o status Deployed .

Cumprindo estes pré-requisitos, quando uma promoção for editada, seja em seu cabeçalho, condições e/ou benefícios, será exibida no menu " Ações ", à direita da promoção, na tela de gerenciamento da promoção, a opção " Distribuir ".

Este botão só aparecerá quando o parâmetro de configuração indicado no ponto anterior for "verdadeiro" e não será mostrado enquanto a promoção não tiver sofrido alterações, só será habilitado quando pelo menos um dos seus componentes tiver sido modificado (cabeçalho, condição e/ou benefício).



Ao clicar no botão " Distribuir " aparecerá um pop-up solicitando a confirmação da distribuição da promoção.


Ao aceitar o popUp, a promoção será  postada  para ser distribuída nos mapas das lojas que contém a promoção editada.

Depois que a promoção for distribuída individualmente, o botão " Distribuir " não será mais exibido até que uma nova modificação seja feita na promoção.


NOTA

O processo contempla apenas a edição de promoções existentes em mapas ativos distribuídos (em lojas de produção). Você não poderá remover e adicionar promoções em mapas ativos por meio deste processo.


Enviar uma promoção editada para os mapas que a contém não alterará o número da versão do mapa.


IMPORTANTE

Quando uma promoção em estado “Distribuído” for editada, e passar para o estado “Incompleto” (eliminação de condições e/ou benefícios), quando for novamente concluída, manterá o seu estado “Completo” mas como foi distribuído anteriormente, no menu de ações aparecerá a opção "Distribuição" dessa promoção. Ao distribuí-lo, ele voltará ao status "Distribuído".


Em relação ao resultado da distribuição individual, pode-se observar que no menu Distribuição\Mapas, será indicado com o texto "Promoção Individual" no campo Template da listagem, sem versão mapa por se tratar de uma promoção, e o nome "Promoção : nome da promoção", conforme a imagem a seguir:

image-2021-04-23-17-19-32-940.png

Selecionar o botão Ações exibirá as seguintes opções:

image-2021-04-23-17-32-18-740.png

Se você selecionar a opção "Editar promoção", será direcionado para a tela de definição da promoção.

Se você selecionar "Histórico", ele mostrará o histórico dos mapas, mas da promoção. A tela terá a seguinte aparência:

image-2021-04-23-17-34-00-512.png



Processo de atualização do arquivo de definição

O motor de promoções atualiza seus arquivos de definição (mapas) através de um processo automático que funciona através de um índice, que contém uma lista de todas as versões de mapas encontradas em seus diretórios junto com suas validades e com as quais irá funcionar, tanto para transações de venda quanto para devolução transações.



Cópia de mapa

Há momentos em que você deseja que determinadas promoções usadas anteriormente façam parte de um novo mapa, integrando-se a outras novas promoções. 

O PROMO concede uma funcionalidade que permite copiar um mapa já distribuído e incluir novas promoções sem a necessidade de incluí-las manualmente em cada novo mapa. Isso será feito enquanto as promoções estiverem em vigor, caso contrário, a estrutura será copiada, eliminando promoções expiradas . Esta ação pode ser encontrada no combo " Ações " do menu Distribuição > Mapas .


Simulação

Dentro de " Distribuição " está a opção " Simulação " onde você pode simular o comportamento tanto dos mapas quanto das promoções.

Criação de Ticket


Ao pressionar o botão " Novo " é gerado um modelo de comprovante de compra que deve conter as seguintes opções:


      • Nome: Nome pelo qual o ticket será identificado quando for listado.
      • Loja: Loja que será informada no momento da simulação O usuário logado; Apenas as lojas que você configurou estarão disponíveis.
      • Terminal (código) : Código do terminal que será informado ao realizar a simulação.
      • Canal : Via ou canal a partir do qual a venda seria simulada. É um campo de texto opcional e livre. O sistema não irá sugerir informações de catálogo relacionadas a este campo.
      • Moeda : Neste campo você pode inserir o tipo de moeda com a qual a simulação de compra será feita. É um campo de texto opcional e livre. Ele mostrará vazio ao entrar. O sistema não irá sugerir informações de catálogo relacionadas a este campo. Ao simular, a moeda inserida será levada em consideração.
      • Data da Compra : Data e hora que serão utilizadas ao realizar a simulação.


Uma vez carregados os dados do cabeçalho, pressione o botão " Salvar ".

O sistema apresentará a seguinte tela, na qual você deverá informar os dados do modelo de tíquete que deseja simular.


Para a simulação de um Ticket, podem ser inseridos os seguintes elementos:


    • Produtos: Clique no botão " Produtos " e o sistema solicitará as seguintes informações:
      • Código (SKU):  código que identifica o item.
      • Preço Unitário:  O preço de cada unidade do item que está sendo adicionado à transação.
      • Quantidade – Quantidade de itens com o código digitado que estão "vendendo".
      • Magnitude : Peso, comprimento ou volume do item.
      • Preço total :  Preço total dos itens. Ela surge da multiplicação do preço unitário pela quantidade.
      • Marca – Marca do item que está sendo inserido.
      • Fornecedor : indica o código representativo do fornecedor do item.
      • Departamento : departamento ou seção a que pertence o artigo.
      • Família : Família de itens à qual pertence o item que está sendo inserido.
      • Categoria : categoria do artigo que está sendo inserido.
      • Subcategoria : Subcategoria do artigo que está sendo inserido.
      • Descontínuo : para indicar se o produto é descontínuo.
      • Baixa Rotação : permite indicar se o produto está com baixa rotação.
      • Produto Estrela : para indicar se o produto é estrela.
      • Opção de resgate de pontos : permite inserir na simulação da transação uma quantidade de pontos que o Promo utilizará para conceder a promoção de resgate de pontos.
      • C. Produto : permite inserir o código do produto de varejo.
      • Código de barras : permite inserir o código de barras do produto.

Pode ainda contar com o auxílio de catálogos para a introdução do código ou códigos, família, marca, departamento e/ou fornecedor do artigo. Quando terminar, pressione  "OK"  para que os dados sejam carregados.

    • Cupons – Representa os cupons que serão informados na transação. Clique no botão " Cupons " e o sistema solicitará as seguintes informações: 

      • Id : identificador único do cupom. É obrigatório.
      • Tipo : Representa o tipo de cupom. É obrigatório.
      • Quantidade : Número de cupons que estão sendo apresentados. É obrigatório.
      • Valor : valor equivalente em dinheiro que o cupom possui. ( este atributo não é avaliado ao utilizar o módulo Cupons )


    • Cliente – Representa os dados relativos ao cliente que realiza a transação. Clique no botão " Clientes " e o sistema solicitará as seguintes informações: 

      • Id : identificador do cliente. É obrigatório.
      • Tipo : representa o tipo de cliente que está realizando a transação.
      • Pontos : número de pontos (fidelização/milhas/etc.) do cliente que efetua a transação.
      • Valor restante : limite do valor sobre o qual aplicar determinado desconto (para promoções que assim o tenham definido).
      • Segmento : indica o segmento ou intervalo a que pertence o cliente que efetua a transação.
      • Perfil do cliente : permite inserir o perfil do cliente com o qual se está realizando a simulação.
      • Campanha de crédito : para indicar a campanha que o cliente está usando.
      • Saldo : para indicar o saldo que o cliente possui.


    • Eventos – Representa os eventos que serão reportados na transação. Clique no botão " Eventos " e o sistema solicitará as seguintes informações: 

      • Number : identificador único do evento.
      • Tipo de transação: representa o tipo de evento.
      • Valor – Valor do evento a ser reportado.


    • Meio de pagamento : representa o meio de pagamento que será informado na transação. Clique no botão " Meios de Pagamento " e o sistema solicitará as seguintes informações: 

    • Código : do meio de pagamento. É obrigatório.
    • Tipo : representa o tipo de meio de pagamento com o qual a transação está sendo realizada.
    • Banco : Identifica o banco associado ao plano de pagamento.
    • Plan : para identificar o plano de pagamento a ser utilizado.
    • Parcelado : para indicar em quantas parcelas o pagamento será feito.
    • Valor : valor que está sendo pago com este meio de pagamento específico. É obrigatório.
    • Valor do artigo : montante dos artigos que pretende pagar com este determinado meio de pagamento.
    • Prefixo : para identificar o prefixo do cartão utilizado.
    • Campanha de crédito : para indicar à campanha que está sendo utilizada.



  • Elementos de Fidelidade: representa os dados relativos aos elementos de fidelidade que podem ser inseridos na transação para avaliação. Clique no botão " Elementos de Fidelidade " e o sistema solicitará as seguintes informações: 

    • Id: identificador único do cartão.
    • Tipo: Representa o tipo de elemento de fidelidade que está sendo inserido.
    • Valor: indica o saldo do elemento fidelidade que está sendo inserido.
    • Convênio: Indica o convênio ao qual pertence o elemento de fidelidade que está sendo inserido.


  • Benefício Externo : representa os dados relativos aos elementos de fidelidade que podem ser inseridos na transação para avaliação. Clique no botãoElemento de Fidelidade"

    • Id:  identificador único do benefício.
    • Tipo:  representa o tipo de benefício utilizado.
    • Valor:  indica o valor correspondente ao benefício.
    • Tipo de benefício : pode ser Valor ou Percentual.


NOTA

Os atributos de cada elemento adicionado à simulação do ticket podem variar de acordo com os requisitos de negócio de cada cliente.


Poderá inserir mais do que um dos elementos referidos no modelo de bilhete para posteriormente simular promoções e/ou mapas.

Uma vez preenchidos os dados do modelo de ticket a ser simulado, pressione "Simulação".


        • O sistema permitirá que você selecione se deseja simular uma promoção ou um mapa.
        • Uma vez exibida a lista de promoções ou mapas, você deve escolher uma opção e pressionar " Simular "



Simulação de mapa:


Simulação de Promoções:

Nota

Nesta tela, se for selecionado "Promoções", serão exibidas as promoções prontas para serem utilizadas, ou seja, em estado Completo e que o intervalo de datas das promoções coincida com o definido no ticket de simulação.



Se os elementos inseridos no ticket de simulação atenderem às condições definidas na promoção ou mapa que está sendo simulado, os resultados da simulação serão apresentados na tela seguinte.


O resultado da simulação, neste caso, foi que é aplicada a promoção "- 10% de desconto em toda a compra " , no código (SKU) 112.

Também é informado o detalhamento do benefício concedido, neste caso um Desconto de 10% que equivale a -$990 no item da transação.

O Total informado nesta janela corresponde ao total da transação com o desconto aplicado.


Quando aplicado o valor mínimo de desconto, será informado no pupUp da simulação da seguinte forma:


Os Benefícios Externos serão exibidos na seção "Componentes do Ticket" conforme a tela a seguir.

Ao simular o ticket, os benefícios externos serão mostrados da seguinte forma:




O popup de sugestão na simulação da promoção será exibido da seguinte forma:



Simular bilhete existente


Ao aparecer a tela de simulação, as seguintes ações podem ser acessadas:


        • Editar : permite modificar o cabeçalho do ticket.
        • Definir : Permite modificar o corpo do ticket a ser simulado
        • Simulação : Permite realizar diretamente uma simulação de mapa ou promoção caso o ticket esteja no estado " Completo "


NOTA

Dentro do cabeçalho você pode visualizar o status do ticket para poder realizar a simulação, ele deve ter pelo menos um elemento para poder simular a operação.





Redes sociais

A PROMO permite a publicação de promoções em diferentes redes sociais de forma a agilizar as estratégias de marketing e melhorar a comunicação das promoções e benefícios a potenciais clientes.

Para publicar promoções nas redes sociais é requisito que a promoção tenha sido cadastrada para este fim, bem como que estejam configuradas as permissões de acesso às diferentes páginas (ver Manual de Instalação Promo 7 - Configuração de Redes Sociais ) .

A publicação nas redes sociais tem por finalidade exclusivamente comunicar ofertas, oportunidades e/ou benefícios a potenciais clientes através dos canais digitais configurados, não podendo os benefícios ser aplicados por este meio.


NOTA

O módulo Redes Sociais deve ser adquirido para poder publicar promoções nestes meios.


Definição de promoção para Redes Sociais


Ao editar o cabeçalho de uma nova promoção, são propostos os seguintes canais de publicação: "Ponto de Venda", "Facebook" e "Twitter"

Uma promoção pode ser configurada para um ou vários canais de publicação simultaneamente e se algumas das redes sociais habilitadas forem selecionadas, será solicitado o upload de uma imagem na promoção (somente no formato .PNG).


Uma vez registada a promoção num dos canais de publicação da rede social selecionada, o ecrã de promoções apresentará as promoções, com o logótipo correspondente ao canal selecionado.

Publicação em Redes Sociais


Depois de definir as promoções que serão publicadas nas redes sociais e configurar o acesso às redes sociais.

No módulo Distribuição >> Redes Sociais , será exibida a tela " Publicação em Redes Sociais ", onde serão listadas as promoções com os canais de publicação habilitados para publicação.


Os indicadores que aparecem à direita de cada promoção são aqueles que devem ser pressionados de acordo com a ação que você deseja realizar.
Se pretender publicar, por exemplo, no Facebook, deverá premir o logótipo do Facebook (quando o logótipo for apresentado a vermelho, será solicitada a autenticação do utilizador para aceder à rede social a partir da aplicação PROMO), e a(s) página(s) habilitada(s) será exibido para publicação.


Você deve verificar a página em que deseja publicar e clicar em " Publicar "

Feito isso, a promoção publicada recentemente pode ser visualizada na página selecionada.




Para cada promoção publicada nas redes sociais, um resumo das publicações realizadas pode ser visto pressionando o último ícone de estatísticas que aparece no final de cada promoção.




Proceda da mesma forma para publicar as promoções na rede social Twitter, e após a publicação será exibido da seguinte forma:


Capítulo 8 - Módulo de Precificação


Lista de preços


O módulo Tabelas de Preços irá gerir os diferentes tipos de Listas de Preços, que serão tratadas nas lojas do lojista.

Existem três tipos de listas de preços:

      1. LISTAS ZERO : Estas listas são criadas automaticamente quando uma nova loja é criada na empresa. Eles não podem ser editados, nem um universo de aplicativo definido para eles. Os itens participantes são obtidos através de uma interface, para recebimento e processamento de preços do SAP.

      2. LISTAS DERIVADAS : Estas são listas que têm a Lista 0 como sua lista pai, e algum tipo de operação de cálculo é aplicada a elas que se aplicará aos preços da lista pai (por exemplo, aumento de %, diminuição de $, adicionar $ 1, subtrair $ 1, aplicar arredondamento). Seus itens não são definidos, pois ele tem associação direta, com os itens de sua Lista pai (Lista 0). Esclarecimento : as listas derivadas foram criadas para lidar com ofertas de preços ou aumentos de preços.

      3. LISTAS NOVAS ou GERADAS : São listas que são criadas e não possuem uma Lista 0 como lista pai, mas são criadas definindo um universo de aplicativo específico. Os itens participantes são definidos a partir do catálogo de itens BM Central, no caso do Promo Bridge, ou do catálogo de itens Promo.


A partir do menu Operação > Tabelas de Preços, serão geridas as tabelas de preços, a distribuir nas lojas de retalho:



Entrando no menu Operação > Preços > Tabelas de Preços, a seguinte tela de Administração de Tabelas de Preços será exibida:

Ele listará as listas de preços existentes que conterão as seguintes informações:

      • Status (Incompleto, Completo, Aprovado, Distribuído, Cancelado, Em distribuição)
      • Tipo (Zero, Gerado, Derivado)
      • Lista de base zero (para derivadas)
      • Código
      • Nome
      • Descrição 
      • Lojas; Você só pode inserir aqueles que o usuário vinculou.
      • WF (fluxo de trabalho)
      • Validade
      • Prioridade

Você pode pesquisar as tabelas de preços pelos seguintes filtros: tipo (zero, gerado, derivado), código (da lista), nome, loja (mostrar todas as lojas que o usuário vinculou (autocomplete)), código (sku ), estado e validade.


O filtro Validade aplica-se apenas às listas de preços "Geradas" e "Derivadas". As 0 listas, por terem validade indefinida, não serão exibidas nesta busca. Será possível filtrar usando o Tipo de lista.

Importante: Ao indicar a prioridade da tabela de preços , deve-se levar em consideração a forma como o motor avaliará os preços. O motor irá avaliar as tabelas de preços de acordo com a sua prioridade, da maior para a menor, tendo em conta o universo da sua aplicação. 

O motor avalia o Universo de aplicação das listas de preços (Loja, Faixa horária, Cliente, Tipo de cliente, Evento) se existem 3 listas com prioridade 0, 1 e 2 (a maior prioridade é 2 e a menor é 0, em este exemplo). Avalie 2 primeiro, se não for aplicado, continuará com 1 e assim sucessivamente até 0.

Exemplo :

Universo de aplicação:

Lista com prioridade 2: é para o tipo de cliente vip e loja = Unicenter

Lista com prioridade 1: é para uma loja = Unicenter, Horário: 9h00 às 20h00

Lista com prioridade 0: é para loja = Unicenter

 Dois clientes chegam às 10:00 da manhã. Um VIP e um comum. Os preços para o primeiro serão os da lista com prioridade 2, e para o segundo serão os de prioridade 1.


IMPORTANTE

Nenhuma lista de preços (nem as listas zero, nem as derivadas, nem as geradas), pode ter preço 0 nos campos: $ (preço de venda, preço à vista), $ Credit (preço de crédito). Em ambos os campos o preço deve ser maior que 0.


Listas Novas ou Geradas


Uma nova lista de preços pode ser gerada a partir do botão "Nova Lista" na tela Administração da Lista de Preços:


Nela devem ser informados os seguintes campos:

      • Code (código da lista de preços, string de até 5 posições, obrigatório)
      • Nome (nome da lista de preços, string de até 30 posições, obrigatório)
      • Descrição (string de até 50 posições, opcional)
      • Fluxo de trabalho (caixa de combinação)
      • Aplicar Promoções (Você pode selecionar "SIM", NÃO ou "Por item da lista") Por padrão, virá em "SIM".
      • Aplicar descontos manuais (você pode selecionar "SIM", NÃO ou "Por item da lista") Por padrão, virá em "SIM".
      • Início da validade (data e hora, obrigatório)
      • Fim de Validade (Datetime, obrigatório)

        A lista será salva com o tipo "Gerada" e no status "Incompleta", até que seja definido seu universo de aplicação, e o detalhamento dos produtos que a compõem.
        Para isso, você deve escolher o botão "Ações" > "Detalhe":



  A partir daí você acessará a seguinte tela:




Dentro do Application Universe, você pode adicionar:

      • Lojas: para indicar em quais Lojas será aplicada esta tabela de preços (estarão disponíveis apenas aquelas que o usuário vinculou).
      • Faixa horária: para que a lista seja aplicada dentro de uma faixa horária específica, por exemplo: das 17h00 às 20h00. 
        NOTA:  Só pode haver uma lista com um intervalo de tempo por loja (para cada horário, várias listas com o mesmo intervalo de tempo não podem se sobrepor).
      • Tipos de Clientes
      • Eventos: refere-se ao tipo de evento.
      • Clientes
      • Prioridade: O sistema irá sugerir uma prioridade que pode ser modificada.

Ao selecionar as opções do combo, aparecerão as janelas para poder inserir os valores dos atributos:

Se você selecionou  Lojas :


Se você selecionou  Intervalo de tempo :

Se você selecionou  Tipos de cliente :

Se você selecionou  Eventos :

Se você selecionou  Clientes :


Se você selecionou  Prioridade:

Uma vez inserida a(s) loja(s), irá sugerir uma prioridade para aquela lista na(s) loja(s) indicada(s):

Uma lista pode ter várias lojas associadas a ela. No momento da geração da lista, o sistema avaliará todas as prioridades relacionadas às lojas associadas àquela lista e atribuirá o número próximo à maior prioridade encontrada entre elas.

A prioridade pode ser alterada. Caso o valor informado já seja utilizado naquela/naquelas lojas, aparecerá uma mensagem na tela, indicando que esta prioridade já foi atribuída a outra loja e indicará qual loja. E não deixa de salvar a lista com essa prioridade. Você precisará selecionar outra prioridade que não esteja em uso.

O valor máximo que a prioridade pode ter é 999.999. Quando este número for alcançado, o sistema continuará atribuindo e salvando o mesmo valor. O usuário pode atribuir um número menor que não tenha sido utilizado (se a prioridade sugerida for sempre utilizada, não são gerados espaços vazios, se o usuário pular números ocorre esta situação), e para a próxima lista o sistema partirá desse número para a busca pela próxima prioridade disponível.



Para adicionar produtos à lista de preços, você deve acessar o setor "Detalhes do produto":


Para obter o catálogo de produtos, você deve clicar no botão "Exportar catálogo base". Será aberto um arquivo Excel, com o catálogo de produtos para completar os preços correspondentes à lista que está sendo gerada.

Os campos incluídos no arquivo serão os seguintes:

      • Código (SKU: código do artigo, obrigatório)
      • Nome (Descrição: string de 50 posições, obrigatório)
      • Departamento (string 40 posições)
      • Mark (string de 30 posições)
      • Provedor (string 30 posições)
      • Magnitude
      • Preço de custo (decimal 10.2, opcional)
      • Preço de venda efetivo ($) (decimal 10,2, obrigatório)
      • Preço de venda a crédito ($ Credito) (decimal 10.2, obrigatório. Caso não tenha um preço de venda a crédito, deve inserir neste campo o mesmo valor que colocou no Preço de venda efetivo, preço de venda. Não deve ter um valor de 0)
      • Preço de venda em branco (decimal 10.2, obrigatório)
      • Preço de venda a crédito (decimal 10.2, obrigatório)
      • Unidade de medida (sequência de 15 posições, opcional)
      • Preço por grandeza (quilo, litro, embalagem, etc.) (decimal 10,2, opcional)
      • Preço de atacado (decimal 10.2, obrigatório)
      • Limite de atacado (quantidade a partir da qual se aplica o preço de atacado), 
      • Vendor Good (sequência de 30 posições, opcional)
      • Valor de Recuperação PB (decimal 10.2, opcional)
      • Provedor financeiro (sequência de 30 posições, opcional)
      • Valor de Recuperação PF
      • Aplicar Promoções (SIM=1/NÃO=0, por padrão vem com valor 1)
      • Aplicar desconto manual (SIM=1/NÃO=0, por padrão vem com valor 1)
      • Limit (limite de unidades que podem ser vendidas a esse preço). Ao atingir esse limite, esse preço não estará mais disponível para venda, será retirado de outra lista atual ou da lista 0 da loja, opcional)
      • Início de Validade (formato da data: dd/mm/aaaa, deve ser maior ou igual ao início da validade da tabela de preços, opcional)
      • Fim da validade (formato da data: dd/mm/aaaa, e, deve ser menor ou igual ao fim da validade da tabela de preços, opcional)

A partir deste catálogo, os preços podem ser adicionados à lista, salvar o arquivo no formato Excel e carregá-lo no botão "Selecionar arquivo".

Ao fazer o upload do arquivo, será exibida uma mensagem indicando se os registros foram importados com sucesso ou se ocorreu algum erro.

Você pode pesquisar por SKU, para encontrar um determinado item, e poder visualizar seu preço, e pode gerar um Excel com os dados da grade, clicando no botão "Exportar detalhe atual".



NOTAS: 

O operador pode baixar o modelo Excel, para gerar a lista a ser importada, a partir da opção "Exportar catálogo base", que conterá o catálogo Bridge completo ou itens Promo conforme o caso.

Caso algum dos preços da lista seja inferior ao preço de custo do produto, será apresentada uma mensagem no ecrã a avisar desta situação. O operador terá o poder de modificá-lo ou não, de acordo com as regras de negócio a serem aplicadas na tabela de preços que está sendo definida.
A soma dos campos PB Recovery Amount e PF Recovery Amount não pode exceder o valor total (preço de venda).

Cada produto pode ou não ter uma validade. Se for, deve estar dentro do prazo definido para a tabela de preços, ou pode ser inferior ao prazo definido na tabela, mas nunca ultrapassá-lo.



Listas derivadas

Será possível criar uma nova tabela de preços derivados , a partir de qualquer “Lista 0” existente, para isso você irá selecionar uma Lista 0, e no botão “Opções”, deverá selecionar “Nova Lista de Preços Derivados”:




Os dados do cabeçalho da lista derivada devem ser inseridos. Será associado à Lista 0 a partir da qual foi gerado, não podendo este dado ser modificado.

Ele também herdará a loja da Lista 0. 

Os campos obrigatórios devem ser preenchidos, e aquele que se aplicará ao conjunto de itens deve ser definido entre as seguintes opções:

      • Aumentar diminuir %
      • valor da diferença
      • Arredondar para (é arredondar para baixo. Por exemplo: tem um item que vale R$ 100,00 e eu indico que quero arredondar para: 99, então esse item vai valer R$ 99,99. Outro exemplo: Play Station: preço efetivo R$ 94,26 , digo a ele para arredondar para 99, o preço permanece em $ 93,99).

E será possível determinar se o arredondamento pode ser aplicado ao resultado obtido, sem casas decimais (por exemplo: se eu tiver um item: Play Station: preço efetivo $ 94,26, e ao gerar a lista derivada eu ativo a verificação: "Arredondamento em cálculo sem casas decimais", na lista derivada o preço efetivo desse item será: $94). 

Os preços (colunas) que são modificados na nova lista derivada são: $, $Crédito, $Magnitude e $Atacado. 

A nova lista de preços "Derivado" será salva.


IMPORTANTE

Ao criar a tabela de preços Derivada ela ficará em um estado incompleto até que você adicione mais informações a ela no Universo da Aplicação , então a lista irá para o estado Completa .


A lista será criada em estado "incompleto", até que o botão "Ações" > "Detalhe" seja utilizado para adicionar  seu universo de aplicação :


O universo de aplicação  do mesmo deve ser  definido, inserindo algum  outro atributo, por exemplo: intervalo de tempo, tipo de cliente, cliente, evento:

Ele irá sugerir uma prioridade de acordo com os disponíveis nas lojas.

Para ver o detalhe dos produtos na lista derivada, você deve entrar no setor "Detalhe do produto" e clicar no botão "Exportar detalhe atual":

Será gerado um Excel, com o detalhamento dos produtos, e seu respectivo preço  conforme  definido na lista derivada:


Nota

  • Preço de venda efetivo ($) (decimal 10,2, obrigatório)
  • Preço de venda a crédito ($ Credito) (decimal 10.2, obrigatório. Caso não tenha um preço de venda a crédito, deve inserir neste campo o mesmo valor que colocou no Preço de venda efetivo, preço de venda. Não deve ter um valor de 0)


IMPORTANTE:

UMA LISTA DERIVADA NÃO PODE SER GERADA DE UMA LISTA 0 ATÉ QUE A LISTA 0 ESTEJA EM UM ESTADO COMPLETO OU DISTRIBUÍDO E APROVADO.

SE A LISTA 0 ESTIVER INCOMPLETA E SEM APROVAÇÃO, A OPÇÃO DO BOTÃO "AÇÕES" > "NOVA LISTA DE PREÇOS DERIVADOS" APARECERÁ DESATIVADA.


Importante:

Ao criar uma lista de preços "Derivada" ou "Gerada", o sistema validará a existência de cada item no Catálogo de Itens (catalogItem). Se algum sku não existir no Catálogo de Itens e você estiver trabalhando com uma lista:

  • Gerado: o sistema exibirá uma mensagem de erro ao carregar o arquivo Excel com os preços e não permitirá que você continue até adicionar o sku que falta ao Catálogo de Itens ou remover esse sku da lista Gerado. O console Promo não permite criar uma lista gerada se você tiver um item que não existe em catalogItem.
  • Derivado: o sistema informará essa diferença no "Monitor de Importação" (Monitor de Suporte/Importação) (irá informar que a quantidade de itens indicados ficou de fora da distribuição daquela tabela de preços). Recomenda-se atualizar a lista Zero, para que já esteja atualizada com os itens que existem atualmente no catálogo Item e regenere e distribua a lista, ou modifique a lista gerada e redistribua-a.

Vigencia de los ítems

A validade do item ("Válido de" e "Válido até"), esteja expirado ou se torne efetivo no futuro, deve estar dentro da faixa de validade da tabela de preços. A Promo não permite artigos com validade anterior ou posterior à definida no Preçário.


Aprovação de Tabelas de Preços


A autorização de tabelas de preços será realizada através de um Workflow de Tabelas de Preços.

O fluxo de trabalho pode ser:

      • Etapa 1, na qual as listas de preços são criadas e aprovadas automaticamente (caso a tarefa agendada "Atualização da lista de preços" esteja configurada para execução automática).
      • 2-etapas: uma etapa para criação e outra etapa para aprovação.


Exemplo:


Caso a tabela de preços possua um Workflow, com duas etapas (ou seja, uma etapa de criação e outra de aprovação), deve-se selecionar a opção "Tabela de preços pendente de aprovação".

O sistema o levará à seguinte tela, onde pressionando o botão "Ações" aparecerá o submenu com as diferentes opções mostradas abaixo:


Para aprovar ou rejeitar uma Tabela de Preços, você deve pressionar a opção "Aprovar/Rejeitar" e, feito isso, o sistema exibirá a seguinte caixa de diálogo:

A partir daí pode rejeitar ou aprovar uma tabela de preços, premindo "Rejeitar" ou "Aprovar", bem como adicionar informação (texto) na caixa "Nota" vazia, relativa à acção efectuada.


NOTAS:
As listas de preços podem ser aprovadas por um usuário que tenha a função definida na etapa WF (workflow) correspondente.
Quando uma tabela de preços for aprovada, será gerado um alarme que notificará o usuário administrador, que possui tabelas de preços pendentes de distribuição em uma loja. 



Distribuição de Listas de Preços


As tabelas de preços podem ser distribuídas, na(s) loja(s) correspondente(s), a partir da tela Administração de Tabelas de Preços.

Você deve selecionar uma tabela de preços, e dentro de "Ações" escolher a opção "Distribuir Lista". O sistema pedirá para confirmar a ação: "TODOS os preços da lista selecionada serão distribuídos aos motores associados às lojas da lista." E exibirá os botões “OK” e “Cancelar”.

A opção priceList.distribution.print.before: sua funcionalidade não está disponível.


Nota

Se você já distribuiu para um motor e ao redistribuir, esse motor não está ligado, o sistema não permite a redistribuição. Apresenta um sinal vermelho informando que há distribuições pendentes. A partir da versão EP2.1 , as tabelas de preços com motores off-line são mantidas com o estado "completo" até que o motor esteja online. Quando o mecanismo estiver online, ele redistribuirá automaticamente a lista, que passará para o status "distribuído".

Quando se adiciona um motor a uma loja, se essa loja tiver listas de preços distribuídas, gera-se a redistribuição automática dessas listas para o motor (a partir da versão EP2.1 ) .


IMPORTANTE

Há um status: “In Distribution” e a variável é usada: priceList.distribution.print.before .

Se a variável for " True ", e a tabela de preços estiver no estado " completa ", permite a impressão das etiquetas.

Se a variável estiver configurada para " False ", a lista deve estar no estado " In Distribution " ou no estado " Distributed " para poder imprimir as etiquetas.

O status “ Em distribuição ” significa que você selecionou o botão "Ações" / "Lista de distribuição" em uma lista de preços e a lista de preços está sendo liberada para os mecanismos de loja. Uma vez que todos os motores o recebam, ele passa para o status "Distribuído".

Caso algum motor da loja tenha sido desligado no momento da distribuição da tabela de preços, ele permanecerá no estado "Em Distribuição" até que todos os motores da loja tenham sido ligados para receber a tabela, só então irá para status "Distribuído". Mas as engines que receberam a lista já podem utilizá-la (mesmo que esteja no estado "Em distribuição"), independentemente de haver uma engine que não a recebeu.

O parâmetro será padronizado como verdadeiro.



IMPORTANTE

Se a tabela de preços estiver fora de vigor (Início de Validade e Fim de Validade do cabeçalho da lista) ela não poderá ser distribuída (no botão "Ações" a opção "Distribuir" não estará disponível).



Distribuição de Tabelas de Preços para Contingências

No botão Ações será adicionada a opção "Baixar Distribuição" (somente habilitará esta opção nas tabelas de preços que estão pendentes de distribuição).

Ao clicar nesta opção, aparecerá um pop-up informando:

“Esta opção só deve ser utilizada no caso de não haver ligação com a loja correspondente. Um arquivo com a Lista de Preços (nome da lista) será baixado em (o caminho do motor onde a lista será baixada). Quer continuar S/N?”

Ao aceitar, um pop-up será exibido indicando:

“A lista de preços foi baixada com sucesso. Deve ser enviado por correio ao usuário responsável pela loja correspondente.

Em seguida, a lista de preços retornará ao status "Completa".

Existe um parâmetro de configuração que nos permitirá distribuir por contingência.

Deve ser definido como "true" para que o sistema permita que a operação seja realizada. Por padrão, ele virá em "falso":

Ativação  de Listas de Preços

A ativação pode ser  automática ou manual .


No menu principal, em Administration\ Configuration Information, encontra-se o parâmetro: priceList.requiresActivation. Este parâmetro será utilizado para indicar se a ativação da lista é automática ou manual:


Se o parâmetro for "true", indica que requer ativação manual. Se estiver em "false", não é necessário, a ativação é automática. Por padrão, ele virá em false


Ativação Automática:

Se estiver configurado para  ativação automática , uma vez distribuídas as listas, ativa automaticamente as listas de preços e aplica a validade definida no cabeçalho da Lista (gerada ou derivada).


Ativação manual:

Caso esteja configurado para acionamento  manual , o acionamento deverá ser feito por um usuário responsável, assim que os anúncios forem distribuídos às lojas. 

Ao distribuir uma lista, o sistema distribuirá tudo: o cabeçalho e os itens. Essa lista estará em um estado inativo . Uma vez distribuída a lista, a opção "Ativar" será habilitada.

A ativação manual da lista de preços pode ser feita  a partir da tela: Administração da lista de preços. Você deve selecionar a tabela de preços que deseja ativar e, dentro do botão "Ações", deve escolher a opção "Ativar". O sistema pedirá para confirmar a ação. Uma vez confirmado, o sistema ativará a tabela de preços. 


Cancelamento de Tabelas de Preços

As listas de preços podem ser canceladas no console. Desta forma ficarão inativos para serem utilizados na loja em que foram distribuídos.

Para cancelar uma Tabela de Preços, ela deve estar no status "Completa" ou "Distribuída".

Neste estado, deve-se selecionar o botão "Ações" > "Cancelar lista". O sistema pedirá para confirmar a ação.


Considerações:

      1. Se a lista já estava no estado "Distribuído" em alguma loja/s, será guardada com o estado "Cancelado", e será redistribuída na/s loja/s correspondente, de forma a que o seu estado seja reflectido, e é NÃO mais válido na loja.
      2. Se a lista estiver no estado "Completa", e ainda não tiver sido distribuída, ficará guardada no estado "Cancelada", e nesse estado NÃO será possível distribuir a nenhuma loja/s.




Administração de Preciadores


As impressões de etiquetas podem ser geradas a partir da Lista 0 e sob demanda de: Listas 0, Geradas e Derivadas.

As impressões serão feitas em impressoras jato de tinta.


FORMATO PRECIADORES


Os formatos dos preços funcionarão com a seguinte estrutura:


      • Tipo:  O utilizador poderá selecionar o tipo de template a desenhar (genérico/oferta). Esses tipos são fixos, são definidos no Promo e servem para organizar os tipos de etiquetas que serão utilizadas.
      • Categoria : O usuário poderá selecionar a categoria (departamento) entre: casa, eletrodomésticos, entre outros. É importante que o usuário tenha um catálogo de  Categorias  (departamentos)  cadastradas , caso contrário não conseguirá  visualizar  os elementos a selecionar.
      • Formato : Corresponde ao cluster  (campo Formato, disponível em Negócios →  Lojas ) que está atribuído à(s) loja(s) associada(s) ao utilizador. Para fazer isso, você deve primeiro importar o catálogo correspondente (CatalogFormat.catalog) em Administração  Importação de catálogo . É importante que antes de criar o modelo, as lojas associadas ao utilizador já tenham um Cluster atribuído (formato), caso contrário o utilizador não conseguirá visualizar os artigos a selecionar.
      • Conteúdo : O usuário poderá desenhar a etiqueta no tamanho que desejar, utilizando ferramentas como tabelas, inserção de imagens, fontes, entre outros elementos de design disponíveis nas barras de ferramentas, bem como a inserção de variáveis ​​(detalhes do produto, cotas de número , preço normal, preço de crédito , etc) que serão  substituídos  pelos valores reais do avaliador no momento da impressão. O tamanho padrão para impressão é A4. O usuário poderá configurar os demais tamanhos de folha, como A5, A6, A7 e A9, inserindo uma tabela e indicando o tamanho correspondente (largura e altura) em pixels.


Modelos de modelo:


 










Impressões de etiquetas

    • Um usuário pode ter 1 ou mais lojas vinculadas a etiquetas de impressão.
    • Uma loja pode ter 1 ou mais modelos de etiquetas associados a ela. 
    • As lojas podem ser agrupadas em Clusters, para os quais pode ser utilizado o atributo "Formato", a partir da tela de Administração da Loja.
    • Um modelo de impressão tem 1 categoria de produto associada a ele.

Exemplo :



Geração de modelos (modelos de etiquetas)


A partir do menu Preços -> Modelos de Etiquetas, o utilizador poderá criar, editar e visualizar os registos dos modelos realizados, que ficarão associados ao cluster (formato) da loja.


Ao criar um novo registo, o utilizador deve indicar todos os campos assinalados como obrigatórios:

    • Código:  identificador único do modelo
    • Nome:  Nome que descreve brevemente o modelo de etiqueta.
    • Tipo:  Oferta de Tipo Predefinido ou Genérico.
    • Categoria:  nome da categoria.
    • Formato:  Formato/Cluster associado às lojas que o utilizador possui.
    • Orientação:  Permite selecionar a orientação que a página terá ao imprimir. Permite selecionar entre Vertical e Horizontal.
    • Template:  Implementa-se o design e o conteúdo que cada etiqueta terá.
    • Rótulos por página:  Número de rótulos que serão exibidos por página.
    • Ativo:  Permite habilitar ou desabilitar o uso do template ao gerar as etiquetas.




Recomendações:

    1. Crie o modelo modelo dentro de uma tabela, para manter o alinhamento dos elementos de uma etiqueta.
    2. Adicione valores fixos como legais e insira variáveis ​​antes de definir um estilo.
    3. Ajuste a largura e a altura comparando o resultado com a visualização.
    4. Atribua um tipo de fonte e tamanho aos textos e variáveis ​​inseridos, caso contrário, eles serão exibidos com o tamanho e fonte padrão disponibilizados pelo navegador. Para rótulos A4 paisagem, recomenda-se o uso de fontes com tamanho superior a 48px.
    5. Ao inserir uma imagem, lembre-se de que ela está no mesmo servidor onde está o sistema, caso contrário, você poderá ter problemas para acessar a imagem ao imprimir devido a problemas de CORS no servidor de origem.
    6. Ao gerar as etiquetas, é possível que o formato do documento pdf tenha margens predefinidas que modificam o resultado, deslocando os elementos.
    7. O conteúdo que é exibido no Preview é apenas um conteúdo de referência para uma melhor apreciação do resultado final.
    8. Para manter o alinhamento dos elementos de uma etiqueta, recomenda-se o uso de tabelas.
    9. Adicione valores fixos como legais e insira variáveis ​​antes de definir um estilo.
    10. Defina o tamanho e o tipo de fonte em todas as variáveis ​​e textos incluídos.
    11. O uso de fontes maiores que 48px é recomendado apenas para etiquetas A4 paisagem.


Considerações:

      • O usuário poderá visualizar a lista de templates associados ao cluster da(s) loja(s).
      • Ao construir o Template é importante definir quantos "Tags por página" você deseja que caibam em uma página.
      • Os modelos não podem ser excluídos, eles só podem ser desativados desmarcando a caixa "Ativo".


Pasos para crear una plantilla

  1. Para desenhar um modelo, sugere-se inserir uma tabela pressionando o  botão  Tabela  (imagem 1), indique o número de linhas e colunas para se adequar ao design.

 Imagem 1.  Barra de ferramentas do editor de texto.

2.  Defina a largura, borda e espaço entre as células  acessando as propriedades da tabela (imagem 2).

Figura 2.  Propriedades da tabela.


3.  Para inserir uma cor de fundo na tabela,  vá em  Table Properties e selecione a  aba  Advanced  e indique no  campo Styles  a propriedade css background-color: color-code; 

Figura 3.  Propriedades da Tabela - Avançado.


4.  Para indicar a cor de fundo ou borda da célula,  clique com o botão direito do mouse sobre a tabela, na  opção Célula  e acesse suas propriedades, onde poderá visualizar o estilo de conteúdo e as opções de ajuste disponíveis.

Figura 4.  Propriedades da Célula.


5.  Para mesclar as células,  é necessário entrar nas propriedades e selecionar o tipo de combinação disponível (direita, esquerda, baixo).

Figura 5.  Combine células em uma tabela.

 

 

6.  Para criar um design construindo diretamente o código html ou visualizar o código html associado aos elementos inseridos anteriormente,  acesse a  opção HTML Source.

Imagem 6.  Opção de Fonte HTML

Nesta opção você pode escrever a estrutura HTML desejada, bem como indicar o estilo CSS específico para cada tag.


7.  Insira as variáveis ​​(botão: "Adicionar uma variável de sistema") associadas aos dados que deseja ver na etiqueta  ao imprimir

Figura 7.  Opção Variáveis ​​.

 Localize a variável dentro da tabela e indique um estilo nela usando as opções disponíveis para definir o  tipo de fonte  formato   cor  do texto.


A funcionalidade Superdecimal permitirá formatar as variáveis ​​do sistema que representam os valores, que são: @itemCreditPrice, @itemRegularPrice, @itemOfferPrice, @save. Para aplicar o formato Superdecimal (sobrescrito) à variável, basta selecionar o seu texto e apertar o botão Superdecimal, ele ficará sombreado indicando que a variável possui aquele formato aplicado.


8.  Se o design assim o exigir, pode-se inserir uma imagem na etiqueta pressionando o  botão  Imagem , em seguida será exibida a janela com as propriedades  da Imagem , indicando a  URL  (endereço http da imagem) e um  texto alternativo , também como largura, altura e borda, se necessário.

Figura 8.  Propriedades da imagem.


9.  Indique o número de etiquetas por página e veja o resultado no Preview , ajuste o número e a largura de cada etiqueta de acordo com a visualização.

 Figura 9.  Visualização do desenho da etiqueta por página.

 Nota:  Ao gerar as etiquetas, é possível que o formato do documento pdf tenha margens predefinidas que modificam o resultado, deslocando os elementos para a direita ou para baixo.


Aclaración

Se você deseja estilizar o conteúdo da tag na  opção HTML Source:


Observe que, se você deseja inserir qualquer variável de sistema, deve manter o seguinte formato:

Exemplo:

<span class="promo-variable promo-variable-itemOfferPrice" data-value="itemOfferPrice" data-variable="itemOfferPrice">@itemOfferPrice</span>


Se você quiser adicionar o formato Superdecimal a ele, você deve incluir a classe super_decimal no atributo class, deixando o seguinte como resultado:

Exemplo:

<span class="promo-variable promo-variable-itemOfferPrice super_decimal" data-value="itemOfferPrice" data-variable="itemOfferPrice">@itemOfferPrice</span>


Nota (Variables de sistemas)

A variável @itemRegularPrice exibirá o conteúdo da coluna $ do item correspondente, levando em consideração:

  • Se a lista que está tendo prioridade for a lista zero, mostrará o conteúdo do campo $ da lista zero.
  • Se a lista que você está priorizando for uma lista derivada , ela assumirá o preço da lista zero .
  • Se a lista que você está priorizando for uma lista gerada, ele exibirá o conteúdo da coluna $ dessa lista gerada.

A variável @itemOfferPrice aplicará as seguintes condições: ( Nota : listas derivadas foram criadas para lidar com preços de lances ou aumentos de preços)

  • Se a lista que está tendo prioridade for a lista zero, mostrará o conteúdo do campo $ da lista zero.
  • Se a lista que está tomando como prioridade for uma lista derivada, tomará o preço da lista zero da coluna $ e aplicará o cálculo que a lista derivada configurou.
  • Se a lista que você está priorizando for uma lista gerada, ele exibirá o conteúdo da coluna $ dessa lista gerada.


Importante

Imagens inseridas nos rótulos:

Você deve configurar a URL, texto alternativo, largura e altura da imagem a inserir:

 


As imagens não podem estar em uma máquina local, elas devem estar em um servidor. Eles podem estar em um servidor na internet (primeira imagem) ou no servidor onde o Promo está instalado (segunda imagem).


As imagens usadas no modelo de tag precisam estar em um domínio com redirecionamentos autorizados ou no domínio onde o Promo está localizado. Tudo isso para evitar problemas com políticas de segurança como -> cabeçalho CORS 'Access-Control-Allow-Origin' que ocorre quando são utilizadas imagens da Internet de um domínio que não autoriza seu uso.

Caso esta observação seja omitida pelo sistema ao imprimir as etiquetas com um modelo que possua uma imagem de fundo dessas características, será exibida a seguinte mensagem: "Por favor, verifique a configuração do modelo, é possível que você não tenha permissões de origem para acesse a imagem utilizada ."

 





Brincos de impressão de etiquetas

Será possível visualizar os preços de uma tabela de preços em "Impressão de etiquetas pendentes", quando passar para o estado "Completo" ou "Distribuído" (não dependerá da variável priceList.distribution.print.before, será não levar isso em conta variável) (a partir de v.6.4.19). Em "Pendente impressão de etiquetas" serão listadas por prioridade todas as etiquetas de preços que entram em vigor e estão pendentes de impressão.

IMPORTANTE

Há um novo status: “In Distribution” e a variável continuará sendo usada: priceList.distribution.print.before .

Se a variável for " True ", e a tabela de preços estiver no estado " completa ", permite a impressão das etiquetas.

Se a variável estiver configurada para " False ", a lista deve estar no estado " In Distribution " ou no estado " Distributed " para poder imprimir as etiquetas.

O status “ Em distribuição ” significa que você selecionou o botão "Ações" / "Lista de distribuição" em uma lista de preços e a lista de preços está sendo liberada para os mecanismos de loja. Uma vez que todos os motores o recebam, ele passa para o status "Distribuído".

Caso algum motor da loja tenha sido desligado no momento da distribuição da tabela de preços, ele permanecerá no estado "Em Distribuição" até que todos os motores da loja tenham sido ligados para receber a tabela, só então irá para status "Distribuído". Mas as engines que receberam a lista já podem utilizá-la (mesmo que esteja no estado "Em distribuição"), independentemente de haver uma engine que não a recebeu.

O parâmetro será padronizado como verdadeiro.


O filtro "Loja" será mostrado se em Negócios\Lojas houver mais de uma loja ativa, se houver apenas uma loja ativa este filtro não será mostrado. 

O filtro "Loja" é autopreenchido (sugere enquanto você digita) e mostrará ao usuário logado as lojas que estão ativas em Segurança\ Administração de Usuários, seção "Lojas Disponíveis"; Caso não haja nenhuma loja selecionada, o filtro "Loja" mostrará todas as lojas que estão ativas em Negócios\Lojas. O usuário deve selecionar uma loja (somente aquelas que foram configuradas).



Depois de selecionar a "Categoria" você ativará o botão "Gerar etiquetas", para o qual você deve primeiro selecionar um modelo no botão "Modelos". Depois de inserir os filtros, selecione a lupa para ver o resultado na tela. 

Ao gerar os preços, o usuário não precisará saber de qual lista o preço deve ser gerado. O sistema detectará o preço atual naquele dia, naquela loja.

Existe apenas um preço atual para cada SKU, se o produto existir em várias listas com validade sobreposta, o sistema pegará o preço da lista de maior prioridade, e dependendo de cada SKU, esse preço pode estar na lista 0, lista 1, etc


SKUlista 0Lista 1lista 2
1111.9992.3002.100
1121.5001.8002.000
Prioridade025
Válido desdeindeterminado02/08/201901/02/2019
Válido atéindeterminado15/03/201903/01/2019


Desta forma, o sistema do exemplo 1, ao gerar a Lista 0, irá gerar um alerta de impressão de etiqueta, e o avaliador ficará com o preço de $ 1.999 pelo artigo 111.

No dia 01/02 irá gerar um alerta com alteração de preço, e o avaliador pegará o preço da Lista 2, R$ 2.100.

No dia 08/02 não será gerado alerta de alteração de preço pois a prioridade da lista 1 é menor que a da lista 2.

No dia 15/03 será gerado um alerta com alteração de preço e o avaliador pegará o preço da lista 1, pois a lista 2 de maior prioridade já expirou.


Com o qual, o sistema ficará a par das variações de preços que ocorrerem, devido a variações de preços das Listas 0, devido à entrada em vigor de novas listas (geradas e derivadas), assumindo a de maior prioridade caso os períodos de validade se sobreponham , e das alterações que ocorram devido ao término da validade de qualquer tabela de preços.

Caso o item de preço tenha uma validade atribuída ("Válido de" e "Válido até"), o sistema o avaliará. Caso já esteja fora de vigor ou venha a vigorar futuramente, o sistema buscará esse item em outra tabela de preços, avaliando as prioridades conforme descrito acima.

Nota

Se após pesquisar por prioridade em todas as listas de preços Derivados e Gerados no estado Completo ou Distribuído (a partir de 6.4.19), o avaliador não encontrar o item para atribuir um preço, ele o procura na Lista Zero, se não encontrar nenhum deles, então o preço atual será aplicado mesmo que esse item esteja vencido ou no futuro, pois não há uma lista válida disponível para obter o preço. Essa situação só ocorreria por alguma contingência para não mostrar o preço em 0.



Considerações:

      1. O número de etiquetas pendentes pode ser visualizado no menu.
      2. A opção de geração de etiquetas estará disponível ao selecionar a categoria, esta categoria está diretamente associada ao cluster da loja.
      3. Para impressões com estoque, os itens que não tiverem estoque disponível ficarão de fora da geração de etiquetas.
      4. As etiquetas geradas com erro permanecerão na lista de pendências.
      5. Ao registrar a impressão, o usuário poderá visualizar os detalhes associados apenas às impressões pendentes realizadas, na seção: "Impressões de etiquetas".
      6. Para imprimir etiquetas mais especificamente, selecione os itens na caixa de seleção localizada à esquerda da lista.
      7. O botão "Gerar Etiquetas" permanecerá desabilitado até que o usuário selecione uma categoria que tenha um modelo associado à loja. Caso contrário, será exibido o alerta "Não há modelo associado à categoria".


NOTAS:

O usuário poderá escolher se deseja imprimir as etiquetas dos produtos "com estoque" ou "sem estoque", no caso de escolher a opção "com estoque", aqueles produtos que estavam em estado pendente de impressão, e que não foram impressos, pois não possuem estoque na loja correspondente, ficarão com o status "sem estoque".


Geração de etiquetas:

Ao gerar uma impressão, o usuário poderá visualizar uma barra de progresso que indica o andamento do download do documento (PDF) com todas as etiquetas a serem impressas.

Terminada a geração, a barra será exibida com 100% de progresso, gerando uma janela com o arquivo em formato PDF para download.


      


Registro de impressão:

Cada impressão registrada irá salvar: data-hora, loja, status (impressão com erro, impressão ok), número de itens, observação e detalhes (aplicando tabela ou listas de preços, categoria, número de skus em estoque e número de skus fora de estoque).

Caso a impressão não seja realizada com sucesso, o usuário pode registrar os detalhes do erro, marcando a opção "impressão com erro" e indicar os detalhes do problema ou observações.

Para etiquetas impressas com erros, o usuário pode visualizar a lista de etiquetas com o ícone (), eles permanecerão na lista de pendentes até que sejam impressos com sucesso.


  

Adicionalmente, o usuário poderá visualizar todos os registros das impressões realizadas, na seção "Impressões de etiquetas".



Cada impressão efectuada criará um registo correspondente, guardando:  a data-hora, loja,  estado (impressão com erro, impressão ok), número de artigos, observação e detalhes (aplicando tabela ou listas de preços, categoria, número de sku com stock e quantidade de sku sem estoque).


Depuración de Registros de Impresión de Listas de Precios

A lista de itens pendentes de impressão será excluída após o período de tempo configurado no módulo Administração\ Informações de configuração: "preços", chave: "priceList.job.cleanPriceListSchedule.time", mesmo que esses itens não tenham sido impressos.


Uma vez que as etiquetas pendentes tenham sido geradas e a impressão salva, elas podem ser reimpressas quantas vezes forem necessárias em " Impressão de etiquetas sob demanda ".


Impressão de etiquetas sob demanda

O usuário poderá consultar por loja, categoria, sku e tabela de preços (opcional) e gerar etiquetas de preços previamente impressas. É importante ter em conta que ao consultar por categoria ou sku o preço a aplicar será o da tabela de preços em vigor e com maior prioridade. No caso de selecionar uma determinada lista de preços, as etiquetas refletirão apenas os preços associados à lista selecionada. As tabelas de preços das etiquetas apresentadas nesta tela estarão no estado "Completa" ou "Distribuída", ordenadas por prioridade.


IMPORTANTE

Há um novo status: “In Distribution” e a variável continuará sendo usada: priceList.distribution.print.before .

Se a variável for " True ", e a tabela de preços estiver no estado " completa ", permite a impressão das etiquetas.

Se a variável estiver configurada para " False ", a lista deve estar no estado " In Distribution " ou no estado " Distributed " para poder imprimir as etiquetas.

O status “ Em distribuição ” significa que você selecionou o botão "Ações" / "Lista de distribuição" em uma lista de preços e a lista de preços está sendo liberada para os mecanismos de loja. Uma vez que todos os motores o recebam, ele passa para o status "Distribuído".

Caso algum motor da loja tenha sido desligado no momento da distribuição da tabela de preços, ele permanecerá no estado "Em Distribuição" até que todos os motores da loja tenham sido ligados para receber a tabela, só então irá para status "Distribuído". Mas as engines que receberam a lista já podem utilizá-la (mesmo que esteja no estado "Em distribuição"), independentemente de haver uma engine que não a recebeu.

O parâmetro será padronizado como verdadeiro.


Além disso, você pode registrar as impressões feitas e visualizar os detalhes na seção "Impressões de etiquetas".


Em " Impressão de Etiquetas sob Demanda " você pode reimprimir selecionando a tabela de preços que deseja, desde que esta lista não tenha para o Loja e Categoria itens selecionados pendentes de impressão, se for o caso, você deve ir para " Impressão de etiquetas pendentes " e imprimir essas etiquetas para poder reimprimi-las a partir da impressão sob demanda.

O filtro "Loja" será mostrado se em Negócios\Lojas houver mais de uma loja ativa, se houver apenas uma loja ativa este filtro não será mostrado. 

O filtro "Loja" é autopreenchido (sugere enquanto você digita) e mostrará ao usuário logado as lojas que estão ativas em Segurança\ Administração de Usuários, seção "Lojas Disponíveis"; Caso não haja nenhuma loja selecionada, o filtro "Loja" mostrará todas as lojas que estão ativas em Negócios\Lojas. O usuário deve selecionar uma loja.  

image2021-9-28_14-4-59.png


Considerações:

      1. O usuário poderá consultar preços a serem impressos por: Loja, Categoria, sku, com estoque e tabela de preços
      2. A opção de geração de etiquetas estará disponível ao selecionar a categoria, esta categoria estará diretamente associada ao cluster da loja
      3. Para impressões com estoque, os itens que não tiverem estoque disponível ficarão de fora da geração das etiquetas
      4. Ao cadastrar a impressão, o usuário poderá visualizar os detalhes associados apenas às impressões sob demanda, na seção: "Impressões de etiquetas".
      5. Para imprimir etiquetas mais especificamente, selecione os itens na caixa de seleção localizada à esquerda da lista.
      6. O botão "Gerar Etiquetas" permanecerá desabilitado até que o usuário selecione uma categoria que tenha um modelo associado à loja. Caso contrário, será exibido o alerta "Não há modelo associado à categoria".
      7. Ao selecionar uma categoria que possui preços pendentes para impressão, o usuário verá o seguinte alerta:  "Para os filtros selecionados, existem itens pendentes para impressão" , indicando que os itens pendentes devem ser impressos antes de continuar.




Capítulo 9 - Módulo de Fidelidade


Menu Fidelidade

O módulo PROMO Loyalty irá gerir os diferentes cupões e elementos de fidelização que farão parte da estratégia de fidelização do cliente.

A partir desta opção de menu, você pode criar e gerenciar os modelos e tipos de cupons, bem como gerenciar os cupons existentes.


modelo de cupom


Com os modelos de cupons, você pode definir os formatos e design dos cupons que serão gerenciados no PROMO, que serão usados ​​para definir os tipos de cupons.

Ao clicar no botão " Modelos de cupom " do menu " Fidelidade " , será exibido o Dashboard " Gerenciamento de modelos " onde você poderá visualizar os modelos já gerados com seu código, nome e formato correspondentes. Existe um botão " Editar " a partir do qual você pode acessar a seção " Editar modelo ". 

Existe também um filtro que permitirá uma busca mais detalhada entre os modelos de cupons existentes, seja por código, nome, formato e/ou status (ativo, inativo ou todos).


Novos modelos de cupom

Na parte inferior da tela de administração de Templates está o botão " Novo " a partir do qual você pode cadastrar novos templates de cupom.

    • Os seguintes campos serão obrigatórios para cadastrar o Modelo de Cupom:

        • Formato Impresso: Serão os tipos de cupons que poderão ser emitidos no ponto de venda. Se este formato for selecionado, os dados do cupom devem ser indicados em formato de texto para que possam ser enviados ao ponto de venda.
        • Formato Eletrônico: Esses serão os tipos de cupons que poderão ser enviados por e-mail. Se for selecionado este formato, os dados do cupão deverão ser indicados em formato .HTML para que possam ser enviados ao cliente beneficiário da promoção que emita estes cupões.
        • Codificação : Um texto simples ou HTML pode ser inserido lá, dependendo do formato do modelo de cupom a ser usado. As variáveis ​​do usuário e/ou do sistema podem ser inseridas conforme desejado para fazer o modelo de cupom.
          • Variáveis ​​do Usuário: São variáveis ​​que posteriormente serão editáveis ​​a partir da definição do Tipo de Cupom. Propõe-se para a definição destas variáveis ​​inserir um "Nome" e um "Tipo" de dados (Texto ou Texto Grande)
          • Variáveis ​​do Sistema : são dados que serão substituídos pela variável informada pelo ponto de venda no momento da emissão do cupom.

As variáveis ​​do sistema disponíveis nos cupons são:

              • @cupomid : código de identificação do cupom
              • @validfrom : Data de validade definida como DDMMYYYYHHmm
              • @ validto : Data de expiração definida como DDMMAAAAHHmm
              • @mount : Valor calculado do cupom (aplica-se a cupons que possuem valor)
              • @ código de barras : código de barras gerado
              • @issueddate : data de emissão do cupom


As variáveis ​​do sistema dos dados disponíveis na transação são:

              • @ cliente : Nome do Cliente associado à transação, se existir
              • @ customerid : Identificação do cliente associado à transação, se existir
              • @ customerin : Número de identificação do cliente associado à transação.
              • @loja : ID da loja associada à transação
              • @storename : Nome da loja que emitiu o cupom.
              • @ terminal : Identificação do terminal associado à transação
              • @ nomedapromoção : Nome da promoção que concede o cupom
              • @raffleData : Números para imprimir no voucher do sorteio
              • @usedPoints : Quantidade de pontos usados ​​pelo Cliente para Sorteio e/ou Aliança


Importante

  Se o tipo de cupom for eletrônico; o Barcode é o código de barras, como é conhecido; e o cupomid é o código de barras em forma de texto.


Tipos de cupom


Os Tipos de Cupom permitirão definir os parâmetros que um cupom manipulará quando for emitido, bem como os parâmetros que serão avaliados quando você quiser resgatá-lo. Estes tipos de cupões serão consultados quando desde o ponto de venda ou desde a própria consola se deseje gerar um cupão com a sua numeração e formato correspondentes.

Aqui poderão gerar e gerir Tipos de Cupons a partir dos quais serão criados os cupons que serão avaliados ou dados como benefício.

Ao clicar no botão " Tipos de cupom " do menu " fidelidade ", será exibido o Dashboard " Administração do tipo de cupom " , onde você poderá visualizar todos os tipos de cupom já gerados com seu código correspondente, nome, prefixo, modelo de cupom, codificação , campanhas de fidelização e destino das exportações.

Existe um botão " Acções " a partir do qual pode editar, definir a pré-visualização ou ver as promoções associadas que emitem e/ou resgatam este tipo de cupão. A partir da versão 7.0EP2.1 o botão "Ações" também mostrará a opção "Exportar".


Existe ainda um filtro que permitirá realizar uma pesquisa mais detalhada entre os tipos de cupões registados, seja pelo seu código, nome, prefixo, modelo de cupão, codificação e/ou estado (ativo, inativo ou todos).


Novo tipo de cupom:

Na parte inferior da tela "Gestão do tipo de cupom" está o botão " Novo " a partir do qual você pode cadastrar novos tipos de cupons.



Os dados solicitados para cadastrar um novo tipo de cupom são:

        • Código: Será o identificador único do tipo de cupom, campo alfanumérico.
        • Nome: Identificador dentro do console de tipo de cupom, campo alfanumérico.
        • Descrição: campo alfanumérico, irá descrever o tipo de cupom que está sendo criado.
        • Formato: é a forma como o cupom chega ao usuário beneficiário.
          • Impresso : Cupons que serão emitidos em papel físico na impressora do caixa.
          • Eletrônico : Cupom que será enviado via correio para um cliente específico
          • Externo : Cupons não administrados pela PROMO. Este tipo de cupom é emitido e/ou resgatado por um sistema externo ao PROMO.
          • Pré-Impresso : São cupons que o motor apenas informará, mas não gerará nada no momento da emissão no PDV, pois entende-se que o caixa já os terá consigo para entregá-los, não pode ser indicado um modelo de cupom a isso e eles não serão nomeados.
          • Informativo : São cupons que podem ser emitidos de Promo quando uma Promoção assim o indicar, mas não será feito nenhum registro dessa emissão no banco de dados Promo, nem será atribuído qualquer código de barras ou número de cupom. As informações detalhadas do cupom serão impressas ou enviadas por e-mail (conforme configuração do formato no modelo de cupom). Este tipo de cupom é usado apenas para relatórios.
        • Prefixo: São os três primeiros dígitos com os quais será gerado o código de barras de um cupom a ser emitido. Este campo pode ser preenchido automaticamente pelo próprio console PROMO ou pode ser digitado manualmente conforme configurado. (Consulte Administração > Informações de configuração para obter mais informações sobre como configurar prefixos de cupom)
        • Codificação: Deve ser indicado qual tipo de código de barras será informado no cupom que será emitido com base no tipo de cupom que está sendo definido.
        • As codificações suportadas pelo PROMO são
            • EAN13: Numérico, 12 dígitos mais 1 dígito de verificação.  Exemplo: 1040010010131
            • UPC-A: Numérico, 11 dígitos mais 1 dígito de verificação.  Exemplo: 108001010171
            • CÓDIGO-128: Alfanumérico, comprimento variável.  Ex: 108001001000000000000000000000087
            • Personalizado : Campo alfanumérico obrigatório, com comprimento variável. Os dados inseridos não podem ser nulos ou 0 (zero). 
              Os cupões emitidos serão constituídos por lotes de 999, sendo o máximo de 1.000.000.
              Quanto à nomenclatura, ela será composta pela concatenação do campo personalizado + a numeração sequencial do cupom (6 dígitos). 
              Ex: "Natal + 123658".→ Natal123658

        • Tipo de início de validade: pode ser definido para um tipo de cupom quando o cupom ou cupons gerados a partir dele começaram a ser válidos (Válido para uso). Ele exibirá as seguintes opções:
          • Data : quando selecionado, será exibido o campo " Válido a partir de ", onde você pode selecionar o dia, mês e ano específico em que um cupom começará a ser válido. (O tempo que o sistema levará para o início da validade será 00:00:00)
            Dias desde a criação : Você pode indicar a quantidade de dias a partir do momento da criação, que deve passar para que o cupom gerado a partir do tipo de cupom se torne efetivo .

          • A partir da emissão : Ao selecioná-lo, estará indicando que o cupom gerado a partir do tipo de cupom começará a ser válido a partir do momento em que for gerado.
        • Valid From:  Indicará a data a ser considerada a partir do início da validade. Por padrão, a data atual é carregada.
        • Tipo de fim de validade:   pode ser definido para um tipo de cupom quando o(s) cupom(s) gerado(s) a partir dele expirarem (não poderá mais ser resgatado ou trocado por nenhum benefício). Ele exibirá as seguintes opções:
            • Data : quando selecionado, será exibido o campo " Válido até " , onde você pode selecionar o dia, mês e ano específico em que um cupom expirará. (O tempo levado pelo sistema para o término da validade será 23:59:59)
            • Dias Após Ativação : Você pode indicar o número de dias que devem passar a partir do momento em que o cupom foi ativado e entrou em vigor, para que o cupom gerado a partir do tipo de cupom passe para o status "Expirado".
            • Horas de validade: selecionando esta opção aparecerá abaixo o campo "Horas de validade" e dois campos que permitirão inserir a hora no campo da esquerda e os minutos no campo da direita.

Conforme mostrado no exemplo a seguir, você pode inserir o seguinte horário: 23:53 hs.


Ejemplos casos de uso Horas de vigencia:

  • No exemplo a seguir, o cupom será válido das 00h00 do dia 1º de outubro de 2022 até as 10h00 do mesmo dia.


  • No exemplo a seguir, o cupom será válido desde o momento em que foi emitido (por exemplo, se for emitido às 13h00), até as 18h30 (porque as horas e minutos de validade são adicionados ao horário de emissão). definido no tipo de cupom, que neste exemplo é 5h30.


  • No exemplo a seguir, o cupom será válido a partir das 00h00 desde que foi criado, até as 05h30 da manhã.


Importante

Se a opção "Data" ou "Dias desde a criação" for selecionada no campo "Tipo de início efetivo", o horário de início efetivo será considerado a partir de 00:00.



            • Sem Expiração: Cupons gerados a partir de um tipo de cupom com este tipo de vencimento, ou nunca irão expirar.


              Poderá ser indicado, através da configuração no console Promo, se será validado que a validade da promoção está contemplada dentro da validade do tipo de cupom.

              Para isso, a opção " valid.date.couponType " deve estar habilitada. A configuração que marca como obrigatória a entrada da condição Intervalo de Tempo de Data com Hora também será necessária para concluir a promoção, e que o tipo de cupom a ser validado seja definido com um tipo de validade definido por data de início e data de término .


              Caso algum dos 3 pré-requisitos não seja cumprido, a validação não será realizada entre as datas de validade do tipo de cupom e a validade da promoção.

              Quando esta configuração estiver habilitada, será validado que ao definir uma promoção de resgate de cupom, a data de vigência do tipo de cupom informado na definição da condição da promoção inclui as datas definidas na condição de intervalo de tempo da promoção ( Date with Time ).

              Também será validado que ao definir uma promoção de emissão de cupom, a data de vigência do tipo de cupom informado na definição do benefício contempla as datas definidas na condição de intervalo de tempo da promoção (Data com Hora).

        • Válido Até:  Indicará a data a ser considerada para o término da validade. Por padrão, a data atual é carregada.
        • Modelo de cupom : neste menu serão propostos os modelos de cupom gerados anteriormente, e dependendo se for escolhido o formato eletrônico ou impresso, o menu mostrará os modelos gerados para tal formato, evitando assim que um modelo seja atribuído erroneamente, por exemplo impresso para um formato de tipo de cupom eletrônico.
        • Nomeado : Se esta opção for selecionada, para conceder este tipo de cupom será necessário que haja um cliente associado à venda. No resgate de um cupom Nomeado, será validado que o cliente associado ao cupom é o mesmo que está presente na transação para possibilitar o consumo do cupom.
        • Cupom calculado : selecionar esta opção indicará que o modelo será usado para gerar cupons calculados.
        • Consumo Total:  Quando for indicado que o tipo de cupom será "Calculado" será habilitada a possibilidade de indicar se, para resgate do tipo de cupom calculado que está sendo cadastrado, deverá ser validado o valor dos elementos beneficiados pelo cupom calculado deste tipo, seja igual ou superior ao valor do cupom. Depois que este cupom for resgatado, ele não poderá ser usado novamente, mesmo que tenha sido resgatado por menos do que seu valor.
        • Limite de usos: Indicará o número de vezes que um cupom pode ser trocado pelo benefício que concede, sempre deve haver uma promoção que avalie a existência desse tipo de cupom como condição e que conceda como benefício o indicado no cupom que é emitido. .


        • Campanhas de Fidelidade : Pode ser indicado se o tipo de cupom se aplica a uma campanha. Esta definição não altera ou modifica o funcionamento e funcionalidade do tipo de cupom.
        • Ativo: será possível indicar se o template que está sendo gerado ou editado está ativo para seu uso ou não.
          Ao clicar no botão "Salvar" será exibida a seguinte tela:


  • Selecione Editar modelo:

                   

                    

                    

Ao pressionar o botão salvar:

                    

Você verá o tipo de cupom:

      

                    


Edicion de Tipo de cupon DISTRIBUIDO

A edição ou não dos tipos de cupons que estão no status "Distribuído" pode ser configurada no console Promo.

Um tipo de cupom entra no estado distribuído quando pelo menos um cupom ativo foi gerado a partir dele.

Por padrão, os tipos de cupons distribuídos não podem ser editados, está disponível a opção de configuração que permite a edição dos tipos de cupons distribuídos.

Esta opção de configuração é " isEditableCouponTypeDistributed "

Valor padrão em Administração/Informações de configuração:


Quando o parâmetro isEditableCouponTypeDistributed " estiver definido como "true", a opção "Editar" será habilitada no menu de ação disponível à direita de cada tipo de cupom no status " Distribuído " e somente os seguintes campos poderão ser editados:

  • Descrição
  • Codificação:  Pode ser selecionada entre as opções do combo.
  • Data de término do cupom . Apenas para os casos em que o tipo de cupão está definido em "Tipo de fim de validade", "Data". Uma data pode não ser indicada antes da data efetiva.
  • modelo  de cupom
  • Verificação ativa



IMPORTANTE

Quando um tipo de cupom é editado, as alterações feitas nele começarão a se aplicar aos cupons gerados após a edição do tipo de cupom.

Os cupons gerados anteriormente não serão afetados pelas alterações feitas no tipo de cupom.


Nota

Os tipos de Cupons Impressos passam do estado Habilitado para Distribuído após a realização de uma venda que tenha sido concedida por uma promoção que emita aquele tipo de cupom e após o processo correspondente ter sido executado automaticamente.


Información

Na impressão dos tipos de vales nos formatos: Electrónico, Impresso e Informativo, quando atribuídos a um cliente,  imprime-se no cupão apenas o número de dígitos configurados desde a consola. Quando o usuário seleciona @customerid e @customerin, ao imprimir este dado na tira, serão refletidos apenas os últimos 4 dígitos do identificador ou código e os anteriores serão refletidos com  ****. Ex: Cedula: 98708090
Exibição esperada na tira: ****8090).



Por padrão, o valor do campo estará vazio, o que implica que nenhum dígito do ID do cliente deve ser mascarado. Quando um dado é inserido, a funcionalidade de mascaramento de ID do cliente será habilitada com o número de dígitos informados lá.

Importante

Se você colocar o valor 0 na configuração, o aplicativo mascarará todo o código do cliente.

Se você colocar letras no campo de valor, o aplicativo não fará nada e o código do cliente será exibido por completo.

Exportación de Cupones a Sistemas Externos

Você pode exportar cupons para Sistemas Externos através do RabbitMQ Queues ou Microsoft Dynamics (CRM), para isso você deve realizar as configurações indicadas abaixo.


  • Configurando a exportação para RabbitMQ Queues:  Para poder utilizar RabbitMQ Queues para exportar cupons, você deve configurar o nome da fila RabbitMQ em Administration\ Configuration Information, no módulo Coupons, categoria promo.promotion, sob a chave "rabbitMQ.couponHistory. endpointName ", no campo de valor, insira o nome da fila RabbitMQ a ser usada.


  • Configuração para exportar para Microsoft Dynamics (CRM): 


Ao selecionar fidelidade\ Tipos de cupons, botão "Ações", o menu suspenso mostrará a opção " Exportar ".

Selecionando a opção "Exportar" aparecerá a seguinte tela:


Na seção de cabeçalho da tela "Exportar" será mostrado o "Código", "Nome" e "Formato" do tipo de cupom no qual foi gerada a exportação. À direita aparecerá o botão "Devolver" que, ao ser selecionado, retornará à tela "Gerenciamento do tipo de cupom". Abaixo serão mostrados os campos selecionáveis ​​"Destinos" e "Ação" e à direita destes um botão para salvar a seleção feita. Ao exibir o campo " Destinos " aparecerá "Rabbit" ou "CRM". Selecionar o campo "Ação" exibirá as ações que acionarão essa exportação para a fila do RabbitMQ ou para o CRM. As ações que ele mostrará são as seguintes:

    • Emitido (ao emitir cupons que tenham esse tipo de cupom, esses cupons serão enviados para a fila do RabbitMQ ou CRM)
    • Resgatados (ao resgatar cupons que tenham esse tipo de cupom, esses cupons serão enviados para a fila do RabbitMQ ou CRM)
    • Emitido/Resgatado (ao emitir/resgatar cupons que possuam este tipo de cupom, os mesmos serão enviados para a fila do RabbitMQ ou para o CRM)
    • Anulado (os cupons anulados com esse tipo de cupom definido enviarão esses cupons para a fila ou CRM do RabbitMQ)
    • Expirado (quando os cupons com esse tipo de cupom expirarem, eles serão enviados para a fila do RabbitMQ ou CRM)
    • Ativo (quando os cupons com este tipo de cupom forem ativados, esses cupons serão enviados para a fila ou CRM do RabbitMQ).

Com isso, ao definir uma exportação para um determinado tipo de cupom, por exemplo para cupom tipo 001, foi definido que os cupons que possuem este tipo serão exportados para as filas do RabbitMQ, quando (essas são as ações) estes cupons forem emitidos , e quando eles expiram, e quando esses cupons são emitidos/resgatados.

Uma vez selecionados o Destino e a Ação, você deve pressionar o botão que possui um disquete   para salvar essa exportação. Então, quando essa ação for realizada com esse tipo de cupom que possui uma exportação definida, esse cupom será enviado para a fila do RabbitMQ ou para o CRM definido na configuração.


Nota

  • As exportações definidas não podem ser modificadas. Mas eles podem ser excluídos e recriados.
  • Os campos Destino e Ação não são obrigatórios.
  • A mesma ação não pode ser cobrada duas vezes para o mesmo destino. Se você tentar fazer isso, o sistema exibirá a seguinte mensagem:


Ao selecionar o botão " Excluir ", o sistema solicitará a confirmação apresentando a seguinte tela: 


Na tela "Administração de tipos de cupom" você verá a coluna "Destino de exportação"  onde será exibido o Destino e a(s) Ação(ões) salva(s) para cada tipo de cupom. Se nenhuma exportação foi salva para esse tipo de cupom, o conteúdo desse registro será exibido vazio nessa coluna.



cupons

Desde a consola PROMO pode definir, desenhar e importar cupões próprios ou externos que depois podem ser emitidos e/ou resgatados nos pontos de venda.

A gestão dos cupões será da responsabilidade da consola de promoções, cabendo ao motor PROMO avaliar a aplicação de promoções que emite e/ou resgata cupões e depois reporta à consola de promoções.

Nesta seção serão exibidos os cupons cadastrados no banco de dados PROMO .

O status de cada um dos cupons será exibido, assim como os eventos associados a cada cupom.

Ao clicar em " Cupões " do menu " Fidelidade " será apresentado o ecrã " Gestão de Cupões " onde poderão ser visualizados os cupões com o seu estado, identificador do cupão, tipo de cupão, identificador do cliente, número de utilizações, data de emissão, data de resgate e vencimento.

Nesta tela existem filtros que permitirão uma busca mais detalhada dos cupons, seja por identificador de cliente, identificador de cupom, tipo de cupom, estado, loja ou data de emissão de e para.

Por padrão, alguns filtros vêm pré-carregados para limitar a busca de cupons e não sobrecarregar o banco de dados recuperando longas listas de cupons. Ao entrar nesta tela pela primeira vez ela trará alguns filtros pré-carregados e se houver informações que coincidam com esses filtros ela mostrará ao entrar. Uma vez que já foi realizada uma busca nesta tela, ao entrar novamente aparecerá a última busca realizada.

Os filtros que aparecerão já pré-carregados serão:

          • Tipo de Cupom : Mostrará a primeira opção da lista de tipos de cupons que estão em status ativo (distribuído ou habilitado) e você poderá selecionar um desses tipos. (Os tipos de cupons "Externo" não serão apresentados no filtro, pois não são gerenciados pela Promo.)
          • Status : mostrará "Emitido" e você pode selecionar emitido, resgatado, cancelado, inativo ou expirado.
          • Broadcast From e Broadcast To : Mostrará o dia " De " e " Até " que a busca é realizada. Ao entrar irá sugerir a última semana; mas intervalos maiores que 7 dias podem ser filtrados. Não haverá limite com o intervalo de datas a filtrar.

Os seguintes filtros podem ser inseridos de acordo com a necessidade da pesquisa:

          • Identificador de cliente : a pesquisa de cupons pode ser realizada inserindo um identificador de cliente específico. Apenas o identificador do cliente pode ser inserido para obter todos os cupons associados a ele.
          • Identificador do Cupom – Pode ser filtrado pelo código de barras ou código de um cupom. Apenas o identificador do cupom pode ser inserido para obter os dados de um determinado cupom.
          • Loja : você poderá filtrar pelas lojas ativas no console. Aqui também será possível indicar se a busca será realizada por cupons cadastrados massivamente selecionando a opção "- Cupons Massivos -".


Abaixo dos filtros de busca serão mostrados dois campos para navegação nos registros , que estão descritos em Paginado

                      Ao entrar, aparecerá uma tela como a seguinte:

IMPORTANTE

Se você usar os filtros "ID do cliente" e/ou "ID do cupom", os outros filtros não serão levados em consideração para essa pesquisa . Por exemplo: na busca a seguir, ele foi filtrado por "Identificador de cupom" e apesar de o "Tipo de cupom" e as Datas "De" e "Até" não corresponderem ao cupom pesquisado, ele ainda é exibido corretamente no resultado da pesquisa. pesquisa:



Se os filtros forem editados, eles persistirão tanto na tela de gerenciamento de cupons quanto nos relatórios de cupons. Se desejar redefinir os filtros, você deve pressionar o botão " X " para eliminar os filtros configurados e retornar ao padrão.

À direita de cada cupom gerado, será exibido o botão " Visualizar ", pressionando-o exibirá a tela " Eventos de Cupom " onde serão listadas as informações e eventos associados ao cupom, ordenados do mais recente ao mais antigo.


Importante

Ao resgatar um cupom, ele é consumido. O cupom consumido não pode ser reativado.

O valor do benefício de um cupom não pode ser consumido em transações diferentes. Se houver sobra em um cupom, ele será perdido.




Registro massivo de cupons

Na parte inferior da tela "Gestão de Cupons", o botão "Registro Massivo" será exibido

Ao clicar neste botão, será exibida a tela " Cadastro de cupom massivo ".

Um upload em massa só será possível para tipos de cupom pré-impressos e não nomeados.


Para realizar o cadastro massivo de cupons, no menu " Tipo de cupom " devem ser selecionados os tipos de cupons pré-impressos e não nomeados que foram criados anteriormente em " Tipo de cupom " e especificada a " Quantidade " de cupons .para gerar.

NOTA

O número máximo de cupons a serem gerados por este meio será configurável em  Administração  >> " Informações de configuração " no parâmetro " cupom.bulk ".


Na tela " Cadastro Massivo de Cupons ", o histórico de transações que geraram cupons será listado do mais recente ao mais antigo com as seguintes colunas:


          • Status (Processado [Verde], em andamento [Azul claro], Erro [Vermelho])

          • Data (Data e hora em que o processo foi iniciado)
          • Número de cupons gerados


Existe a opção " Ver Relatório " ao final de cada transação que gera cupons de forma massiva. Ao clicar neste botão, você será direcionado para a seção " Relatórios " >> " Cupons " onde será exibida a lista de cupons gerados neste processo.

Os filtros que são oferecidos, para entrar por esta seção, para visualizar os cupons pré-impressos serão: " Identifier " e " status " e este último já será mostrado pré-carregado com o status " Emitido " (ao criar o cupom o status está Inativo, existe um processo interno que muda automaticamente de Inativo para Emitido, você tem que dar tempo para esse processo rodar para ele mudar de status).

O cupom deve estar Ativo ou no status Emitido para que a promoção o utilize.

  • Crie a Promoção que emite o cupom

        

     Criação de modelo de cupom


Ao cadastrar um tipo de cupom, pode ser gerado o modelo de promoção que inclui entre seus elementos o tipo de cupom que está sendo gerado, ou um modelo para a emissão de um cupom, onde o tipo de cupom é concedido como benefício não monetário ( Cupom), ou para resgate de cupom, onde será avaliada a existência do tipo de cupom gerado na transação (condição simples).

Información

 Benefício cupom:  a aplicação do benefício consiste na emissão de cupons.

Benefício do cupom calculado:  a aplicação do benefício consiste na emissão de cupons de um determinado valor de desconto calculado com base no total da transação.

Para cupom calculado:

No benefício da promoção que emitir : o Tipo de Benefício deverá ser: Não Monetário e a Classe de Benefício: Cupom Calculado.

No benefício da promoção que resgata : o Tipo de Benefício deve ser: Monetário, e a Classe de Benefício: Resgate de cupom calculado.


Para cupom (não calculado):

No benefício da promoção que for emitido: o Tipo de Benefício deve ser: Não Monetário e a Classe de Benefício: Cupom.

Na condição deve constar o tipo de cupom que foi emitido (ou algo que se refira ao cupom que foi emitido), o benefício da promoção que resgata : o desconto que é feito, por exemplo $2.

Exemplos podem ser vistos em: PROMO - Final User Manual 7 - Apêndices - Espanhol#ManualdeUsuarioFinal7-Ap%C3%A9ndices-Espa%C3%B1ol-_Toc513717178%22Llevando3om%C3%A1sart%C3%ADculosdeldto.Limpieza,ganaunCup%C3% B3n % 22

A promoção que emite o cupom e a promoção que resgata o cupom devem ser criadas

Quando o cupom for usado, esse cupom é digitalizado no PDV. O PDV envia à Promo o número do cupom. Promo procura no banco de dados as informações desse cupom. Por exemplo um cupom calculado que dá 10% de desconto para a próxima compra, pega essa informação do banco de dados e o Promo calcula 10% do ingresso atual porque o cupom está sendo resgatado.

IMPORTANTE

Para que a Promo que Resgata cupom funcione corretamente, é necessário colocar o Tipo de Cupom utilizado em "CONDIÇÕES SIMPLES"; também pode ser em "Condições por Composição".



Tipos de elementos de fidelidade

Nesta secção poderá gerar e gerir os diferentes tipos de elementos de fidelização que gere o lojista, a partir dos quais poderá criar elementos que participarão nas transações nos diferentes pontos de venda. 

A gestão dos elementos de fidelização ficará a cargo da consola de promoções, enquanto o motor PROMO avaliará a aplicação de promoções que concedam e/ou consumam valores (pontos, dinheiro, etc.) . promoções. O motor encarregar-se-á de informar a consola dos pedidos de informação, consumo ou cobrança de saldos que receba dos vários canais que atende. O consumo de carga ou saldo de um elemento de fidelização também pode ser indicado a partir do PDV, independentemente de participar ou não de uma promoção.

Ao clicar em fidelidade >> Tipos de Elementos de fidelidade aparecerá a seguinte tela onde você encontrará os diferentes tipos de Elementos de fidelidade já gerados.



Novo tipo de elemento de fidelidade

Para cadastrar um novo tipo de elemento fidelidade, clique em " Novo " e a seguinte tela será exibida:

 

Os Tipos de Elementos de Fidelização permitirão definir os parâmetros que um elemento de fidelização atenderá no momento de se cadastrar, bem como os parâmetros que serão avaliados quando se deseja alocar ou descontar seu saldo.

Estes tipos de elementos de fidelização serão consultados quando, a partir do ponto de venda ou da própria consola, pretender gerar um elemento de fidelização de um determinado tipo ou atribuir/desconto.

Quando quiser definir um tipo de elemento de fidelização, deverá ter em conta as seguintes opções:


          • Código: Será o identificador único do tipo de elemento de fidelização, campo alfanumérico.
            Isso pode ser gerado automaticamente; para isso deve ser configurado em: Administração >> Informações  de configuração , cardtype.IncrementalCode = true



            Habilitando a opção de código autogerado e incremental, ao cadastrar um novo tipo de elemento, o código não poderá mais ser digitado manualmente , mas o sistema já vai propor um número para atribuir ao tipo de elemento.

                             
          • Nome: Identificador dentro do console do tipo de elemento fidelidade, campo alfanumérico.
          • Descrição: campo alfanumérico, irá descrever o tipo de elemento de fidelidade que está sendo criado.
          • Faixas de Prefixos: o(s) valor(es) indicado(s) neste popUp representarão os primeiros dígitos com os quais serão atribuídos ao código dos elementos gerados a partir do tipo de elemento de fidelidade que está sendo definido. Este valor pode ser inserido manualmente ou pode ser gerado automaticamente. ( Veja mais detalhes abaixo ).
          • Externo : Pode-se indicar que o tipo de elemento que está sendo registrado no Promo será gerenciado por um terceiro, ou seja, não será gerenciado pelo Promo. Eles serão cadastrados apenas para poderem participar de promoções, seja para acúmulo de pontos ou resgate, mas essas ações não serão cadastradas no Promo, mas serão informadas ao PDV, que se encarregará de reportar essas movimentações ao quem corresponde. Quando esta opção está assinalada, só se pode indicar se está ativo e se participa numa campanha de fidelização, as restantes opções não se aplicam à definição deste tipo de elemento.
          • Número de dígitos: aqui deve ser indicado o comprimento do código do elemento a ser gerado a partir do tipo de elemento de fidelização selecionado. O comprimento do prefixo que deve ser considerado ao definir este campo será levado em consideração para a geração do código do elemento de fidelidade. Por exemplo, se um elemento tiver o prefixo "333" e o comprimento do elemento for 13, os três primeiros dígitos do elemento serão "333" e os 10 dígitos restantes serão o número do próprio elemento.
          • Tipo de expiração: a expiração associada ao elemento gerado a partir dele pode ser definida para um tipo de elemento de fidelidade.

Você pode selecionar entre:

              • Datas: Quando selecionado, habilitará dois campos obrigatórios, que determinarão a data de início e término do elemento. Estes dados podem ser definidos no ficheiro a partir do qual são registados os elementos de fidelização, se na consola for escolhido o registo em massa. Caso não seja indicada uma validade no arquivo de registro, os elementos gerados terão a validade definida no Tipo de elemento. Se uma data de e uma data para forem indicadas no arquivo de registro, os elementos serão gerados com a data indicada no arquivo de registro. Esta operação aplica-se também ao registo de elementos através do Ponto de Venda bem como ao registo de elementos através do serviço/RabbitMq.

                  • Válido a partir de:   Refere-se à data efetiva do elemento. (O tempo que o sistema levará para o início da validade será 00:00:00).
                  • Válido até:  Refere-se ao final da data de validade do elemento. (O tempo que o sistema levará para o término da validade será 23:59:59).




              • Dias a partir da ativação: o item gerado a partir deste tipo de item de fidelidade será válido por x dias a partir do momento em que foi ativado. Este número de dias deve ser definido no campo "dias de ativação" que aparecerá abaixo do campo "tipo de vencimento" quando esta opção for selecionada (padrão 365 dias).

            • N/A: o elemento gerado a partir deste tipo de elemento de fidelidade não expirará e será válido a partir do dia de sua ativação.

          • Pré-carregado: neste menu será possível indicar se os elementos registados deste tipo de elemento de fidelização terão ou não um carregamento associado.

Você pode selecionar entre:


            • Não: O elemento que for gerado a partir deste tipo de elemento fidelidade não terá cobrança no momento do cadastro.
            • Ficheiro: o elemento que se gera a partir deste tipo de elemento fidelização deve ter um saldo associado no ficheiro que o gera.
            • Definir pré-carga: o elemento que for gerado a partir deste tipo de elemento fidelidade terá o saldo definido no campo " Definir pré-carga " no momento do cadastro.
          • Recarregável: Se esta opção estiver selecionada, o elemento registado deste tipo de elemento fidelização pode ser carregado quer na consola quer nas promoções aplicadas.
          • Vencimento da cobrança : neste menu pode indicar se a cobrança ou tarifas associadas a um elemento de fidelização têm uma data de validade associada.Neste campo pode definir a política de vencimento de saldo dos cartões que são definidos a partir deste tipo de elemento. As opções disponíveis são:

Você pode selecionar entre:

            • Sem vencimento  Indica que os saldos atribuídos ao elemento fidelidade nunca expiram.
            • Dias desde o upload : Indica que os pontos atribuídos ao elemento de fidelidade podem ter datas de vencimento diferentes, com base na data em que foram atribuídos. (365 dias por padrão).
            • Data : A partir de um calendário, pode-se indicar a data em que expiram todos os pontos de um tipo de elemento de fidelização  , independentemente da data em que foram atribuídos.
            • Dias desde a ativação: A caducidade de todos os pontos de um tipo de elemento de fidelização pode ser indicada,  em número de dias, independentemente da data em que foram atribuídos. Os dias começarão a contar a partir do momento da ativação.
            • Frequência : Pode ser indicada  com base em opções predefinidas quando expiram todos os pontos de um tipo de elemento de fidelização, independentemente da data em que foram atribuídos. Selecionando a Freqüência aparecerá a opção  " Mensal " , e selecionando  indicará que os pontos cobrados do item vencerão  no primeiro  dia  de cada mês às 00:00:00 




          • Nomeado: No menu suspenso, será possível indicar se o elemento a ser cadastrado com o tipo de elemento que está sendo definido pode ter um cliente associado ou não.

As opções disponíveis são:

            • Não (itens gerados a partir de um tipo de item com esta definição não terão um cliente associado a ele)
            • Por arquivo de adição em massa (os elementos gerados a partir de um tipo de elemento com esta definição devem ser associados ao cliente no arquivo de adição de elemento)
            • No canal de Vendas (elementos gerados a partir de um tipo de elemento com esta definição podem ser associados a um cliente do ponto de venda). Valor padrão.
        • Nota

          Quando o tipo de elemento for nomeado , o sistema validará o cliente associado. Se não for nomeado , pode ou não ter um cliente associado, mas o sistema não o validará.

          Configuración disponible

          As opções de nomenclatura padrão que os tipos de elementos assumirão ao serem registrados podem ser indicadas por Configuração.

          Você deve procurar a chave card.nominated.default.option em Administration >> Configuration Information , e lá será apresentado o combo onde você poderá indicar o valor padrão que trará o campo " Nominated " no cadastro de um elemento, sendo podendo escolher entre "Não" (padrão), " Por arquivo de registro massivo" ou " No canal de vendas ".




          • Transferível: Neste menu será possível indicar se um elemento de fidelização pode transferir todo ou parte do saldo para outro elemento do mesmo tipo.

Você pode selecionar entre:


            • NÃO : o tipo de elemento de fidelidade que tiver esta opção definida como NÃO, indicará que os elementos gerados a partir deste tipo não podem fazer nenhum tipo de transferência para outro.
            • Total : Total: o tipo de elemento de fidelização que tem a opção de transferência definida para "Total" só pode transferir todo o saldo numa única ação para outro elemento do mesmo tipo e que se encontre em estado inativo. Ao fazer isso, o elemento fonte (que dá o saldo) será cancelado e com saldo zerado, enquanto o elemento destino (recebe o saldo) passará de inativo para ativo e terá como saldo todo o saldo que o elemento fonte tinha , bem como o contrato e o cliente associados ao elemento de origem também serão atribuídos.
            • Parcial : o tipo de elemento de fidelização que tem a opção de transferência definida como "Parcial" pode transferir a totalidade ou parte dele para um elemento ativo do mesmo tipo sem sofrer alteração de estado de nenhum dos dois elementos.

          • CVV requerido: De seleccionarse esta opción, el elemento que se dé de alta con este tipo de elemento deberá que tener asociado un código CVV de validación, el cual será requerido tanto para el alta del elemento como para la imputación o consumo de saldo desde el ponto de venda. . Os elementos que sejam registados a partir de um tipo de cartão que tenha a verificação CVV necessária ativa, devem ser efetuados através de um ficheiro. O CVV não pode ter comprimento maior que 5 posições, nem deve ser nulo se a verificação estiver marcada.

          • Canal Exceto CVV:   Ao marcar o  campo "Obrigatório CVV",  será habilitado o combo "Canal Exceto CVV" de onde será possível indicar qual " canal " será excetuado da validação CVV ao realizar qualquer operação com o mesmo. tipo. Este campo só pode ser carregado via catálogo. Se o catálogo de canais (catalogChannel.catalog) não for carregado  o combo será exibido vazio e os canais não poderão ser excluídos da validação CVV. Ao carregar o catálogo de canais, ao exibir o combo, serão exibidos os canais ali presentes e poderá ser selecionado um para ser dispensado da validação CVV; em operações onde se insere um elemento deste tipo.

            No caso de ser um canal excluído do CVV, e requerer a validação do CustomerID, deve-se configurar a variável correspondente, descrita no Manual de Instalação.


            IMPORTANTE

            Quando uma consulta ou transação com um elemento de fidelidade é enviada de um ponto de venda, o atributo " canal " do cabeçalho da mensagem será avaliado para validar se o canal ali indicado corresponde ao definido no canal exceto para o tipo de elemento de fidelidade a que pertence o elemento.

            Caso haja correspondência (o canal informado na mensagem está isento de validação CVV no tipo de elemento fidelidade ao qual pertence o elemento consultado), o CVV não será validado mesmo que não tenha sido enviado no elemento. (<adicionar cartão de fidelidade />)

            As validações CVV de acordo com o canal são realizadas nos seguintes status reservados: 

            • Validação de fidelidade
            • Ativação de Fidelidade
            • TERMINAR
            • RetornoFinalizar


            A validação do CVV não é realizada nos seguintes status reservados (para manter a compatibilidade com versões anteriores em que o CVV também não foi validado)

            • Transferência de Fidelidade
            • fidelidadeVazio
            • LoyaltyAssign

          • Máximo de pontos a atribuir por transacção: Ao registar um tipo de elemento de fidelização, poderá ser indicado se o tipo de elemento controla um máximo de pontos atribuídos por transacção, independentemente das vantagens agregadas a este tipo de elemento na transacção. Será possível na mesma transação aplicar n benefícios que apliquem o mesmo tipo de elemento de fidelização, mas se for carregado um valor neste campo, o número de pontos a atribuir ao valor aqui definido será reduzido. Caso o tipo de elemento tenha um valor definido no campo “ Máximo de pontos a atribuir por transacção ” , este prevalecerá sobre o definido no benefício que atribui os pontos.

            IMPORTANTE

            Caso o TPV comunique uma cobrança direta a um elemento de fidelização na transação (“chargeAmount”) , será validado que o tipo de elemento a que pertence tem um valor definido em “ Máximo de pontos a atribuir por transação ” . No caso de tê-lo, a cobrança será feita até o valor indicado no campo Máximo de pontos a serem atribuídos por transação " .

            Quando um elemento de fidelidade estiver no estado "Distribuído", apenas será permitida a edição do campo "Máximo de pontos a serem atribuídos por transação", todos os outros campos e verificações serão desativados.

          • Limite de saldo: neste campo deverá ser indicado um valor caso seja exigido que os elementos cadastrados deste tipo de elemento fidelidade não possam ter saldo superior ao aqui indicado. Caso este campo não seja preenchido, a recarga de saldo não terá limite.

          • Consumo parcial: Se esta opção estiver marcada, os elementos gerados a partir deste tipo de elemento fidelização podem consumir todo o saldo em mais de uma operação, caso contrário, se não estiver marcada, o saldo do elemento deve ser consumido em uma única transação. Caso esta única transação seja de valor inferior ao saldo do elemento, esta será inativada, perdendo-se o saldo remanescente.

          • Ativo : Se esta opção não estiver marcada, o tipo de elemento fidelidade não estará disponível para a geração do elemento. Por padrão, a verificação é marcada para que todos os tipos de elementos gerados sejam ativados para geração de elementos.

          • Campanhas de fidelização : será possível indicar se os elementos registados deste tipo de elemento estarão associados a uma campanha. As mesmas campanhas serão exibidas ao registrar uma promoção.


        • Faixas de Prefixos:  Ao pressionar o botão  Adicionar Prefixos , na tela "Novo Tipo de Elemento Fidelidade", o sistema exibirá o seguinte modal para carregar a faixa de prefixos. O usuário poderá inserir os prefixos conforme mostrado na tela a seguir.

NOTA

No pop-up "Enter Prefix Range", o sistema realizará as seguintes validações:

      1. Será validado que o intervalo To é maior que o intervalo From
      2. Será validado que a faixa digitada não consta na lista de faixas inseridas anteriormente para aquele elemento. Neste caso, quando o usuário pressionar Enter ou Tab, o sistema não permitirá a entrada de um valor já informado.
      3. Será validado que o intervalo inserido não está atribuído a outro elemento. Neste caso, o sistema validará que a faixa digitada não está sendo utilizada parcial ou totalmente para outro tipo de elemento. Por exemplo, se para o elemento tipo A existe uma faixa 144-184 e para o elemento B queremos inserir a faixa 150-165, o sistema não permitirá inseri-la pois a faixa está sendo utilizada para outro tipo de elemento.
      4. Não será permitida a entrada de letras ou caracteres especiais.
      5. Se todas as condições acima forem atendidas, o intervalo será inserido.


O upload em massa de prefixos por arquivo será permitido.

Entrada de intervalo de prefixo por arquivo:

No popUp "Enter Prefix Range", selecionando o botão "Select file", você pode carregar um arquivo com os intervalos de prefixo, então você deve selecionar o botão "Process File".

Formato para entrada de intervalo de prefixo: de-para, de-para. Exemplo 100-140, 245-280. (Caso deseje inserir um único intervalo, por exemplo 111, deverá inserir da seguinte forma: 111-111). Onde os valores de e para serão separados por um hífen e entre os intervalos o separador será uma vírgula. O tipo de arquivo a ser processado deve ser .CSV ou .TXT onde o nome do arquivo é indistinto desde que respeitado o tipo.

O sistema processará o arquivo, descartando as faixas que não atenderem às condições mencionadas no  popUp "Enter Prefix Range" Nota .

Todas as faixas que atenderem às condições serão carregadas e serão visualizadas na tela, então se o sistema detectar faixas que não atendam às condições descritas acima, exibirá uma mensagem informando ao cliente quais faixas não atendem às condições e irá exibir a lista das condições na tela. Da seguinte forma:

Na tela "Gerenciamento do tipo de elemento de fidelidade", a coluna "Intervalo de prefixos" detalhará os prefixos inseridos para esse tipo.


O  campo Faixa de Prefixo da tela "Novo Tipo de Elemento Fidelidade" pode ser preenchido automaticamente (gerado automaticamente) pelo próprio console PROMO ou pode ser inserido manualmente, conforme configurado. 

NOTA: Configuración de Rangos de Tipos de Prefijo

A configuração das faixas de prefixos pode ser feita em " Administração " >> " Informações  de configuração ", a opção que configura o manual ou entrada sugerida desta opção é " cardType.incrementalPrefix " // prefix.active que pertence ao módulo " Fidelity elements " e suporta dois valores " true " ou " false ", onde " true " indicará que o prefixo será gerado automaticamente e sugerido pelo console e " false" indicará que a entrada do prefixo será manual. Por padrão, este valor é falso. Ao inserir uma faixa de prefixos, será validado que estes não estão incluídos nas faixas de outros tipos de elemento.

Se definido como " true ", o intervalo do prefixo será inserido automaticamente. O sistema irá sugerir intervalos de prefixos. Habilitar esta funcionalidade não desativa a possibilidade de editar a faixa de prefixos, podendo adicionar uma nova faixa, ou deletar a faixa gerada automaticamente e inserir outra. Ao pressionar o botão "Nova Faixa de Prefixo", será exibido o campo de faixa de prefixo já definido.

Selecionando o lápis na sugestão Intervalos de Prefixos, ou o botão "+Adicionar Prefixos", será exibida a seguinte tela:


Se " False " for definido, a entrada manual pode ser feita. Você pode optar por definir um único prefixo a partir do qual os elementos podem ser gerados ou uma gama de prefixos que incluirão o universo de elementos a serem registrados neste tipo de elementos de fidelidade.

Quando o usuário insere o intervalo de prefixos e pressiona o botão continuar, na tela do novo tipo de elemento de fidelidade, no botão "Adicionar prefixo", a lista de prefixos inseridos será exibida.


Na tela "Gerenciamento de Tipos de Elementos de fidelidade", o " Resumo " mostrará a etiqueta "Faixa de Prefixo" e mostrará as faixas de prefixo carregadas para aquele tipo. 


Editando o tipo de elemento de fidelidade


Em fidelidade\ Tipos de Itens de fidelidade, ao selecionar o botão “Ações” em qualquer um dos tipos de itens em status: Ativado, Desativado e Distribuído, todos eles exibirão as três opções: Editar, Copiar e Resumo.

Os possíveis estados dos tipos de elementos de fidelidade podem ser:

          • Habilitado: O tipo de item está disponível para geração de itens. Os tipos de item no estado ativado  movem-se para o  estado distribuído quando um item é gerado no estado ativo ou inativo. Se foram gerados com o cadastro massivo de elementos, mas a geração falhou por algum motivo , o tipo de elemento não vai para o estado distribuído (se já não estava no estado distribuído antes), permanece no estado habilitado.
          • Distribuído: Itens deste tipo foram criados, eles podem estar ativos ou inativos.
          • Desativado: tipo de elemento de fidelidade cuja verificação "Ativo" está desmarcada.


Edição de tipo de item ativada  e desativada: como nenhum item foi gerado ainda, você pode continuar editando o tipo de item até que ele entre em um estado distribuído. Você pode continuar modificando todos os dados, exceto o código. 


Edição do tipo de elemento em estado distribuído : dependerá da configuração do parâmetro “ isEditableAfterCardsGeneration ”.

Se este parâmetro for falso (esta é a configuração padrão), apenas os campos "Intervalo de prefixo" (você só pode adicionar prefixos, não pode excluir prefixos) e "Ativo" podem ser modificados.


Se a opção “ isEditableAfterCardGeneration ” for true , todos os campos, exceto o código, podem ser modificados.




Elementos de fidelidade


A gestão dos elementos de fidelização ficará a cargo da consola de promoções, enquanto o motor PROMO avaliará a aplicação de promoções que concedam e/ou consumam valores (pontos, dinheiro, etc.) . promoções. Será ainda responsável por informar a consola dos pedidos de informação, consumo ou cobrança de saldos que receba dos vários canais que atende.

Nesta secção serão apresentados os elementos de fidelização registados na base de dados PROMO.

Ao clicar em " Elementos Fidelidade " do menu "Fidelidade" será apresentado o ecrã " Gestão dos Elementos Fidelidade " onde poderá visualizar os elementos com o seu estado, número do elemento, tipo de elemento, identificador de cliente, acordo, validade de/ até e saldo disponível.



Este ecrã possui filtros que permitirão uma pesquisa mais detalhada dos elementos a efetuar, seja pelo seu identificador de cliente, número do elemento, tipo de elemento, estado, validade de/para ou acordo.

Os filtros que aparecerão já pré-carregados serão:

          • Status : Ele mostrará "Ativo" e você poderá selecionar Ativo, Inativo, Cancelado ou Expirado. 
          • Tipo de Cartão : Mostrando a primeira opção da lista. Isso permitirá que você filtre por tipos de elementos de fidelidade ativos no console.
          • Válido de e Válido até : Por padrão, mostrará um intervalo de 7 dias,  onde o dia em que a pesquisa for realizada será a data tomada para o " Até ". O " De " mostrará a data que corresponde a 7 dias antes do " Até "). Intervalos maiores que 7 dias podem ser escolhidos.

Os seguintes filtros podem ser inseridos de acordo com a necessidade da pesquisa:

          • Identificador do cliente : você pode filtrar por um determinado identificador do cliente. Apenas o identificador do cliente pode ser inserido para obter todos os elementos associados a ele.
          • Número do cartão : Você pode filtrar pelo número do elemento determinado. Apenas o identificador do elemento de fidelidade pode ser inserido para obter os dados de um determinado elemento.
          • Acordo: Os elementos associados a um acordo específico podem ser filtrados.

A partir do botão " Ações " você pode ver os detalhes de cada um dos cartões existentes, podendo ativar elementos, modificar o saldo, cancelá-los ou simplesmente visualizar seu status e histórico de ações.

NOTA

Se o saldo de um item inativo mudar, o item será movido para Ativo.


Adição massiva de elementos

Para gerar elementos de fidelização a partir dos tipos de elementos existentes, deve clicar em " Registo Massivo ". 

Será apresentada a tela " Cadastro massivo de elementos de fidelização "



Aqui serão apresentados os processos de cadastro massivo já executados, ordenados do mais recente ao mais antigo.

Para proceder ao registo do elemento, em primeiro lugar, deve selecionar o tipo de elemento a partir do qual pretende registar. 

Dependendo da configuração de cada tipo de elemento, você pode registrar elementos diretamente do console (cadastro manual) ou registrá-los de um arquivo 

Dependendo da configuração de cada tipo de elemento, os elementos podem ser cadastrados:

          • do console (registro manual) ou
          • de um arquivo .catalog (se o tipo for: nomeado, ou requer cvv, ou data). 

Registro manual

Terá de selecionar no combo "[Tipos de elementos]" o código de um tipo de elemento de fidelização que permita o registo manual (que não requeira CVV, ou que não seja nomeado ou nomeado do canal de venda ou cuja validade não seja definido por intervalo de datas ). Ao selecionar o tipo de elemento, deve-se indicar se os elementos cadastrados serão ativos ou inativos, e por último indicar a quantidade de elementos a serem gerados.



No primeiro campo: " Tipo de Elemento " deve-se selecionar no combo drop-down o tipo ao qual pertencerão os elementos a serem gerados (pode ser, por exemplo, tipo Visa, neste exemplo é tp1).

No segundo campo você deve selecionar se vai " Gerar elementos ativos " ou " Gerar elementos inativos ".

No terceiro campo " Range Prefixes " você pode selecionar para qual faixa deseja gerar elementos (por exemplo: 250-400).

No quarto campo " Quantidade a gerar " deve inserir um número inteiro para indicar o número de elementos que deseja criar.

Depois de inseridos todos os dados solicitados, você deve pressionar o botão de porca para iniciar o processo de geração. O sistema validará:

            • Se foi inserida uma quantidade que excede a quantidade de elementos restantes a serem gerados. Para cada intervalo de prefixos, apenas números de elementos podem ser gerados até o número máximo de intervalos. Uma vez ultrapassado o limite, o sistema exibirá uma mensagem indicando que o número de elementos a serem gerados foi excedido. Exemplo de mensagem : "O máximo disponível para gerar elementos é 90".
              Exemplo de cenário: se foi definido um intervalo onde o número máximo possível de prefixos é 30 e foram gerados 10 intervalos anteriormente. Da próxima vez que for necessário gerar novos, e for digitado um valor maior que 20, somente até 20 elementos poderão ser gerados e então o sistema mostrará uma mensagem indicando que não é possível gerar mais de x quantidade de elementos.
            • Que o registro de mais de 999 registros não seja excedido.


Uma vez finalizado o processo, aparecerá uma nova linha na lista de “ Últimas operações realizadas ” com os dados do processo executado recentemente.

Se o processo for concluído satisfatoriamente, o status "Processado" será exibido na primeira coluna, e o relatório dos cartões gerados poderá ser acessado a partir do botão " Visualizar relatório ".



          • Registo por arquivo (ou automático):

Terá de selecionar no combo “[ Tipos de elemento ]” o código de um tipo de elemento de fidelização que permita  o registo por ficheiro (que exija CVV, ou que seja nomeado por ficheiro ou cuja validade seja definida por intervalo de datas). Ao selecionar o tipo de elemento, deve-se selecionar o arquivo card_timestamp.catalog que contém todos os elementos que devem ser cadastrados neste processo.

Uma vez inseridos os dados solicitados e pressionado o botão porca, o sistema validará um a um todos os números de elementos inseridos, validará que as faixas utilizadas no arquivo correspondem às faixas do tipo.

Nota

Formato do nome do arquivo Card_timestamp.catalog :

Onde o timestamp deve ser substituído por DDMMAAAAhhmmss (correspondente a: DD: dia de 2 dígitos, MM: mês de 2 dígitos, AAAA: ano de 4 dígitos, hh: hora de 2 dígitos, mm: minuto de 2 dígitos e ss: dois dígitos dígitos para segundos).

card_DDMMYYYYhhmmss.catalog


Por exemplo, o nome do arquivo para upload em massa pode ser:

card_31102019095001.catálogo

Os elementos cadastrados através do arquivo serão gerados no estado “ INATIVO ”.


NOTA

Caso o arquivo a ser processado contenha um Element Id existente no banco de dados, apenas o Client Id será atualizado, caso seja um elemento nomeado.


Uma vez finalizado o processo, será habilitado o botão "visualizar relatório" a partir do qual poderão ser vistos os elementos cadastrados quando o arquivo está sendo processado e será exibido o estado "Processado" na primeira coluna do registro que corresponde ao processado arquivo.

Caso haja algum erro no processo, será exibida a mensagem "Foram encontrados erros em alguns dos elementos importados". Por favor, insira os detalhes dos erros." e será habilitado o botão "Detalhe do Erro" a partir do qual poderão ser visualizadas as linhas do arquivo que apresentaram erros no momento do processo. 


E   o erro do(s) registro(s) em questão pode ser visualizado acessando o relatório de erros a partir do botão "Detalhe do erro".

Da mesma forma, será gerado um arquivo de log diário com o nome "yyyydd.log" (ex: 2017514.log) e ali indicará quais ou quais foram as falhas pelas quais o processo não foi concluído. O arquivo de log para revisão está localizado no caminho síntese\promo\LOG\


IMPORTANTE

O arquivo card_timestamp.catalog deve ser corrigido para então poder executar o processo novamente, levando em consideração que o nome do arquivo também deve mudar, pois o mesmo arquivo não pode ser processado duas vezes.


          •  Formato de arquivo " card_timestamp.catalog"

O arquivo a partir do qual são gerados os cartões de fidelidade deve ter o seguinte formato separado por barras verticais ( | )

      ID|Tipo|Data desde|Data até|CVV|Cliente|Valor


ID: Corresponde ao número do elemento de fidelização a registar. Obrigatório.
Tipo: Corresponde ao código do tipo de elemento de fidelização a registar. Obrigatório.
Date-from/Date-to : deve ser preenchido se o tipo de elemento ao qual o elemento a ser registrado indicar que o "tipo de vencimento" deve ser especificado por "Intervalo de datas". (formato de data AAAA-MM-DD)
CVV: deve ser preenchido se o tipo de elemento ao qual o elemento a ser registrado indicar "CVV obrigatório". (Campo numérico, comprimento máximo 5 dígitos)
Cliente:  deve ser preenchido com o Código, que pode ser visualizado no ecrã "Gestão de Clientes".
Deve ser preenchido caso o tipo de elemento ao qual o elemento a ser registrado indique que o "Pré-carregamento" deve ser especificado por "Arquivo".


Dependendo do tipo de elemento de fidelização a que pertença o(s) elemento(s) a registar, alguns campos poderão ou não estar preenchidos, sendo os campos ID e Tipo de preenchimento obrigatório.
(Ex: 541400002201|541|2019-01-01|2019-12-31|520|9595|500)

NOTA

Nota : Tenha em atenção que se após o registo de um elemento por ficheiro e a atribuição do cliente e acordo, o processo ABM do elemento for novamente efectuado, informando o interface de um elemento existente na base de dados mas sem informar o cliente, o cliente Originalmente associado ao elemento será excluído, pois a atualização do elemento via interface ( card_timestamp.catalog ) atualiza o campo cliente e o cliente atribuído pode ser desatribuído, não deixando nenhum cliente atribuído ou sendo atribuído a outro cliente.


Atribuição/Atualização de Elementos

Através do processo de Atribuição/Atualização, um número de elemento pode ser associado a um determinado cliente e contrato, bem como um saldo pode ser atribuído ou atualizado.

Uma vez registados os elementos, quer para cedência de clientes e acordos ao elemento, quer para carregamento ou modificação do seu saldo, deve ser efetuada a Cessão/Atualização dos elementos.

Através deste processo você será capaz de:

          • Associar os elementos, com os clientes, os acordos, e atribuir-lhes um saldo inicial
          • Ajustar os saldos dos itens (Aumentar, diminuir ou substituir o saldo de um item de fidelidade)

Quando for efectuada a atribuição de clientes/convénio, aos elementos, estes passarão ao estado " activo ".

Quando for feito um ajuste de saldo, os valores presentes em cada elemento participante do processo serão atualizados conforme informado na interface "Associação/Atualização".

O processo será realizado através de um arquivo que só poderá ser processado uma vez, caso ocorra algum erro no processo, deverá ser corrigido e renomeado para ser processado novamente.


Nome do arquivo :   tipo de card_ cod convention_timestamp.catalog

(Ex: 111_333_201808021030.catálogo)


Formato de cada Registro : Id|cliente|quantia


          • Id: Número do elemento existente ao qual o cliente/contrato será associado ou ao qual será atualizado o seu saldo. 
          • customer : Cliente a ser associado ao elemento.
          • montante : Saldo a ser alocado ao item. (numérico com casas decimais)


Suma, Resta o Reemplazo de saldo

O saldo será modificado de acordo com o sinal indicado no campo valor.

Se o sinal à esquerda do campo de valor for positivo ( + ), ele adicionará o saldo.

Se for negativo (-) o saldo será subtraído.

Se nenhum sinal for inserido, o valor existente será substituído pelo informado no arquivo.


Exemplo:

555000000000000010000|2222|-2000

55500000000000010011|3333|2000

555000000000000010022|4444|+2100

555000000000000010044|7777|2100


Depois que o arquivo for processado, ele será salvo no banco de dados com o status " processado ", para que não possa ser processado novamente.


O arquivo estará sujeito às seguintes validações :

          • Se for feita uma tentativa de processar um arquivo que já foi processado anteriormente, o arquivo não será processado e uma mensagem indicando que o arquivo já foi processado será exibida na tela.
          •  Caso o nome ou extensão do arquivo não corresponda ao formato indicado, o arquivo não será processado e será exibida uma mensagem indicando que o nome ou extensão do arquivo a ser processado está incorreto.
          • Caso o arquivo possua em seu nome um tipo de elemento que não corresponda ao tipo de elemento existente no PROMO, será exibida uma mensagem na tela, indicando que o tipo de elemento não corresponde a um tipo de elemento válido, e não permitirá que o arquivo seja processado. .
          • Caso o arquivo possua em seu nome um código de convênio que não corresponda aos códigos de convênio que o(s) elemento(s) que ele contém tenham associado no BD , será exibida uma mensagem na tela, indicando que o(s) elemento(s) está(ão) já encontrado associado no BD a outra convenção e não permitirá que o arquivo seja processado.
          • Caso o arquivo possua um tipo de elemento em seu nome, que não corresponda aos tipos de elemento que os elementos que ele contém possuem associados no BD, será exibida uma mensagem na tela, indicando que o tipo de elemento informado no nome do arquivo não corresponde ao tipo de item dos itens relatados no arquivo e não permitirá que o arquivo seja processado.
          • Caso o arquivo possua um código de convênio em seu nome, que não existe dentro dos convênios cadastrados pelo PROMO  será exibida uma mensagem na tela, indicando que o convênio não corresponde a um código de convênio válido e não permitirá que o arquivo seja ser processado. .
          • Caso o elemento não tenha um código de contrato atribuído, o elemento será atualizado com o código do contrato, contido no nome do arquivo que está sendo processado.
          • Caso o elemento não tenha um código de Cliente atribuído, o elemento será atualizado com o código de cliente informado no registro.
          • Se o elemento tiver o status "Ativo", o campo de valor atualizará o saldo do elemento.
          • Caso o elemento esteja com status inativo, seu saldo será atualizado com o valor informado no campo valor e o elemento ficará "ativo".
          • Caso seja reportado um cliente e o elemento não tenha um cliente associado, será verificado se o cliente reportado existe na base de clientes, e caso exista, o campo será atualizado com o valor informado no arquivo. Caso o cliente informado não exista, informará uma mensagem na tela, indicando que o cliente informado não existe, e não permitirá o processamento do arquivo.
          • Caso seja reportado um cliente e o elemento possua outro cliente associado, será reportada uma mensagem na tela, indicando que o elemento possui outro cliente associado e não permitirá o processamento do arquivo .
          • Caso o cliente não seja informado, será informada uma mensagem na tela, indicando que o campo cliente é obrigatório, e não permitirá o processamento daquele arquivo


Validações dos campos contidos no arquivo:

Todos os três campos, Id, Customer e Amount, são obrigatórios. Caso algum deles não seja informado, não permitirá que o arquivo seja processado e será informado na tela que o campo é obrigatório.


ir

        • O elemento deve existir.
        • Obrigatório

cliente

        • Caso o cliente seja informado e o elemento não possua cliente associado no BD, será verificado se o cliente informado existe no BD, e caso exista, o campo será atualizado com o valor informado no arquivo. Caso o cliente informado não exista no BD, informará uma mensagem na tela, indicando que o cliente informado não existe como tal no BD, e não permitirá o processamento do registro.
        • Se o cliente for informado, e no BD o elemento tiver o mesmo cliente associado, o campo fica da seguinte forma.
        • Se o cliente for informado, e no BD o elemento possuir outro cliente associado, informará uma mensagem na tela, indicando que o elemento possui outro cliente associado no BD, e não permitirá o processamento daquele registro .
        • Caso o cliente não seja informado, será informada uma mensagem na tela, indicando que o campo cliente é obrigatório, e não permitirá o processamento daquele registro .

Quantia

        • Obrigatório



NOTA

Caso ocorra algum erro, o processo será abortado e os erros serão reportados na seção " ASSOCIAÇÃO/ATRIBUIÇÃO DE SALDOS DE ERROS " que é exibida ao pressionar o botão visualizar de um arquivo cujo processo finalizou com erro.



Para realizar o processo de Atribuição de contrato de cliente e/ou atualização de Saldos, deve aceder a Fidelidade >> Elementos de Fidelização. >>  " Associação/Atualização "


Ao pressioná-lo, a seguinte tela será exibida:

Uma vez selecionado o tipo de elemento e o Acordo, você deve pressionar o botão "Selecionar arquivo" a partir do qual você pode carregar o tipo de arquivo do elemento_código convention_timestamp.catalog  e, em seguida, pressionar o ícone do processo.

Quando o processo terminar OK, a linha será exibida na seção Últimas Operações com o nome do arquivo processado, o tipo de elemento, a data, o número de registros processados, o contrato ao qual pertencem os elementos processados ​​e o usuário quem realizou o processo.importação no estado "Processado".


Nesta linha, o botão "Visualizar" será exibido à direita quando o processo terminar OK e quando pressionado, irá para a tela "Atualizar/Detalhe Atribuição". 


Caso o processo termine com erros (O processo é abortado e não salva nenhum registro), uma linha será exibida na seção Últimas operações com o nome do arquivo processado, o tipo de elemento, a data, o número de registros processados, acordo a que pertencem os elementos processados ​​e o usuário que realizou a importação em estado "ERRO".

E ao apertar o botão "Visualizar", será exibida uma tela com os detalhes das linhas que falharam no processo e porque falharam. 


Ao tentar processar um arquivo cujo nome está malformado, a seguinte mensagem de erro será exibida:




IMPORTANTE

Tanto o registo massivo de elementos, como a atribuição de cliente/contrato por ficheiro podem ser executados via Job (processo automatizado).

Para isso, como primeiro passo, deve-se configurar o diretório de onde o Job irá tirar as interfaces de cadastro e associação. Isso é feito no console do Promo, indo para Administração > Informações de configuração .

Lá, você deve procurar a seguinte linha:

E deve-se indicar a rota onde as interfaces serão deixadas para serem processadas ( card_timestamp.catalog e tipo de cartão _coded agreement_timestamp.catalog ).

Este trabalho por padrão é executado uma vez por dia à noite.


Ver detalhes do cartão

A partir do ecrã “Gestão dos Elementos de Fidelidade” pode aceder ao detalhe dos movimentos de qualquer um dos elementos presentes na consola. Ao pressionar o botão " Visualizar " localizado no combo "Ações" à direita de cada elemento, você acessará a visualização "Transações cadastradas", onde é exibido um resumo dos dados do elemento e os detalhes das operações realizadas. podendo filtrar por um intervalo de datas específicas e exportar os dados para o Excel.

(Nas versões posteriores a 7.EP2.1 ) A coluna "Motivo" mostrará ou não as informações de acordo com o seguinte:

Se a transação tiver um motivo informado pelo Promo na alteração de saldo ou pelo PDV, esse motivo será exibido.

Se o motivo que traz do PDV não existir em Promo, o código será mostrado conforme o traz; e isso será a indicação para o usuário saber que deve adicionar manualmente (a partir da tela Gerenciamento de Motivos de Alteração de Saldo) aquele novo motivo que está sendo utilizado. 

Caso não traga o motivo, será exibida uma das opções da tabela a seguir, de acordo com a ação realizada com o cartão. Apenas para ações de recarga e consumo, se traz um motivo, mostra.  Para as demais ações, deve-se evidenciar o motivo encontrado na tabela a seguir:


na Razão, em show espanhol

Ativação
inativação
associação de clientes
desassociação do cliente
Retornar
Consulta
Fardo

Ao fazer uma recarga:

    • se o motivo que traz for nulo mostrará: Transferência
    • se o motivo que retorna for '-', o motivo está vazio (não mostra nada na grade)
    • Caso as situações anteriores não ocorram, será mostrado o motivo informado , caso o motivo não esteja cadastrado, mostra o código que ele traz
balança manual

Oferta

(se traz um motivo, esse motivo que traz é sempre mostrado Venda)

Ao fazer um consumo:

    • se o motivo que traz for nulo, mostrará : Redenção
    • se o motivo que retorna for '-', o motivo está vazio (não mostra nada na grade)
    • Caso as situações anteriores não ocorram, será mostrado o motivo informado , caso o motivo não esteja cadastrado, mostra o código que ele traz.
redenção parcial
redenção completa
Transferir
Cancelamento
Expiração
extensão de validade
Cessão de Contrato

Se o cvv de um elemento de fidelização foi modificado, ficará registado no relatório "Transações Registadas" que se acede seleccionando Fidelidade\Elementos de Fidelidade\ no elemento pretendido, seleccione o botão Acções\Ver, na secção "Movimento" mostrará na

As seguintes ações também serão permitidas nesta seção (dependendo da configuração do tipo de elemento ao qual o elemento em questão pertence)


                    • Ativar/Cancelar : Um elemento que está inativo pode ser ativado ou um elemento que está ativo pode ser cancelado.Esta ação de cancelamento não pode ser desfeita.







                • Modificar Saldo : Será permitido aumentar e/ou diminuir o saldo de um elemento de acordo com a configuração do tipo de elemento ao qual pertence.

(Veja também "Razões para Modificação de Saldo")


                    • Transferência : o saldo pode ser transferido entre elementos pertencentes ao mesmo tipo e que aceitem recarga, se a configuração do tipo de elemento a que pertencem o permitir.



              • Cliente associado : um elemento de fidelização pode ser associado a um determinado código de cliente, se a configuração do tipo de elemento a que pertence o permitir.



Extensão  de Validade :

Na seção " Transações cadastradas " de um item, se o item pertencer a um tipo de item com expiração de cobrança habilitada, o botão "Exclui consumo e pontos atuais" será exibido à direita de cada cobrança vencida. Estender Validade "


Ao ser pressionado, será exibido um pop-up mostrando a data de vencimento atual, o número de pontos a serem afetados e será proposto um calendário, indicando a nova data de vencimento dos pontos selecionados.


Uma vez indicada a nova data de validade, será pressionado " Aceitar " e estes pontos serão mostrados com sua nova data de validade na grade de movimentação das transações com cartão cadastrado.


Transferência antes perdida.

Quando um cliente comunica a perda do seu elemento de fidelização, poderá ser efetuada a transferência TOTAL dos dados e saldos do elemento perdido para um novo elemento.

O item informado ficará cancelado e com saldo 0 (zero), enquanto o item de destino permanecerá ativo, com o saldo total, o cliente e o convênio (se associado) que o item de origem possuía. A transferência será sempre feita entre elementos do mesmo tipo e o elemento de destino deve estar inativo com saldo zero e sem convênio ou cliente associado para receber os dados do elemento informado.

Ao pressionar "Transferir" (quando o tipo de cartão permite transferência total), o seguinte pop-up será exibido:

O Saldo proposto a ser repassado será o total do item informado e não poderá ser editado.

No campo Elemento de destino , à medida que vão sendo introduzidos os dígitos do elemento de destino, serão propostos a selecionar os números de elementos inativos desse tipo, com saldo zero, sem cliente ou acordo associado.

Uma vez escolhido o elemento de destino, pressionar-se-á Aplicar e realizar-se-á a transferência total

    • Acordos


Um acordo é um acordo estabelecido entre duas ou mais entidades, a fim de proporcionar benefícios aos clientes.

A partir da consola Promo pode registar "Acordos", que depois podem ser associados a elementos.

A partir da secção Fidelidade >> Acordos é possível gerir e gerar novos Acordos, que posteriormente serão associados a diferentes tipos de elementos de fidelização através do processo de “Associação/Atualização” do cartão (Atribuir Acordos de Fidelidade >> Elementos de Fidelidade).

Existe apenas o filtro "Status" com o qual você pode filtrar entre contratos ativos E inativos.



Para cadastrar um novo contrato, você deve clicar no botão "Novo" e a seguinte tela será exibida:


Os seguintes campos devem ser preenchidos para registrar o contrato:



            • Código : Identificador único do contrato (Obrigatório)
            • Nome : Nome atribuído ao contrato a registar (Obrigatório)
            • Descrição : dados extras que se aplicam ao contrato de registro (opcional)
            • Ativo : Marque que indicará se o convênio a ser cadastrado está ativo para ser associado a elementos de fidelização.

Depois de preencher todos os campos, você pode clicar em “Salvar”.

Os contratos existentes podem ser editados, mas uma vez que os elementos foram associados e estes estão ativos, o código do contrato não pode mais ser modificado.

Importante

Um cliente só pode ter um tipo de elemento de fidelização associado ao mesmo contrato. Ou seja, um cliente não pode ter dois ou mais cartões de fidelidade associados ao mesmo convênio.


Clientes

Ao clicar em “ Fidelidade ” > “ Clientes ” será apresentada a tela “ Gestão de Clientes ” onde poderá visualizar os clientes presentes na PROMO. 


Será possível aceder aos dados de cada um dos clientes e visualizar, caso existam, os elementos de fidelização e cupões associados, bem como o estado de cada um desses elementos de fidelização.

Para fazer isso, clique no menu suspenso "Ações" e depois em "Visualizar" Por padrão, o aplicativo retorna os dados dos últimos três meses.



Quando for solicitado um relatório com datas superiores àquelas que o aplicativo traz por padrão; ele corrigirá automaticamente as datas e exibirá a mensagem correspondente.

Dentro desta tela poderemos observar os elementos e Cupons associados ao cliente e o estado de cada um deles.

Aqui também é apresentado o relatório " Movimentos Limite por Cliente ", onde serão detalhadas as promoções em que o cliente participou e que têm associado um limite de cliente que foi consumido por ele, podendo as promoções aplicadas ser filtradas por intervalo de datas .


Exclusão de dados do cliente

Os dados do cliente e seus dados de fidelidade relacionados podem ser excluídos no Promo Console.

Ao selecionar fidelidade\ Clientes, aparecerá a tela "Gestão de Clientes". Uma vez identificado o cliente a ser excluído, o botão "Ações" será selecionado nesse cliente, o qual exibirá as opções: 

              • Ver 
              • Excluir dados do cliente

IMPORTANTE

IMPORTANTE

A opção "Excluir dados do cliente" só será vista e acessível por usuários que receberam a permissão "Excluir dados do cliente". Por padrão, apenas usuários com a função de administrador o verão.

Ao selecionar a opção "Excluir dados do cliente" será exibida a seguinte tela: 

Por padrão, a primeira opção (Excluir dados do cliente) será selecionada.

Se a opção " Excluir dados do cliente " estiver selecionada e, em seguida, pressione o botão "Excluir":

O sistema mostrará um banner solicitando a confirmação "Tem certeza que deseja deletar os dados do cliente selecionado?" exibirá os botões: OK/Cancelar.

Se o usuário confirmar pressionando o botão "OK", o sistema substituirá todos os dados do cliente por - (exceto o código), e esse cliente ficará com o status inativo. Ele só continuará a se referir ao código. Se esse cliente tivesse dados de fidelidade, ele continuará existindo.

IMPORTANTE

Os dados de fidelização de clientes parcialmente apagados podem ser recuperados ; desde que seu Código esteja disponível.

Observe que, se os dados de outro cliente forem adicionados ao catálogo. Cliente usando o Código do Cliente Parcialmente Removido, esse cliente terá os dados de Fidelidade do cliente parcialmente removido adicionados.


A exclusão parcial será registrada na visualização Log de auditoria:

Se a opção " Excluir dados e fidelização do cliente " estiver selecionada e, em seguida, pressione o botão "Excluir":

    O sistema mostrará um banner solicitando a confirmação "Tem certeza que deseja deletar os dados do cliente selecionado?" exibirá os botões: OK/Cancelar. Se o usuário confirmar pressionando o botão "OK", o sistema excluirá:

              • o cadastro do cliente em catalog.customer (o cliente não aparecerá mais na tela "Gestão de Clientes", nem o código aparecerá), 
              • cupons,  
              • cartões relacionados 
              • histórico de cartões e cupons (os pontos ficam no cartão, se o cartão for deletado, os pontos não ficam mais disponíveis). 

Se você pressionar o botão "Cancelar", nenhum dado será excluído. 

O sistema mostrará um banner solicitando a confirmação "Tem certeza que deseja deletar os dados do cliente selecionado?" exibirá os botões: OK/Cancelar.

Se o usuário confirmar pressionando o botão "OK", o sistema o excluirá e seus dados não serão refletidos na visão de Gerenciamento de Clientes. Se este cliente tiver dados de fidelidade, eles serão excluídos.

No exemplo, o registro de código 1 não está mais visível.

                                         A exclusão completa será registrada na visualização Log de auditoria:


Capítulo 10 - Módulo de Relatórios


PROMO - Manual do Usuário Final 7 - Relatórios - Espanhol





Capítulo 11 - Módulo de Negócios


cardápio empresarial


Este menu permite a criação e administração de unidades departamentais, empresas e lojas que estão dispostas dentro do negócio.


Lojas


A loja é a unidade mínima que será levada para distribuição do mapa. Diferentes métodos de distribuição podem ser definidos para cada uma das lojas. No menu Negócios > Lojas, você pode acessar a Tela de Administração da Loja:



Os filtros são organizados:

        • Código : Uma determinada loja pode ser pesquisada pelo seu código.
        • Nome:  Uma determinada loja pode ser procurada pelo seu código. 


Os dados da loja são exibidos nas colunas Código, nome, endereço, e-mail e tipo de conexão da grade.

O usuário logado verá apenas as lojas que configurou.


nova loja

Dentro do menu Lojas, pressionando o botão "Novo" acessará a tela " Criar Loja ":




          • Os campos a preencher são:
            • Código: Um código identificador deve ser atribuído.
            • Nome: Nome que identifica a loja. Pode ter de 3 a 150 caracteres.
            • Endereço: Endereço próprio da loja
            • E-mail: endereço de e-mail com o qual você está registrado.
            • CIA : a que pertence a Loja
            • Zona: a zona a que pertence a loja.
            • Subzona: a subzona a que pertence a loja
            • Canal: o canal de uma loja
            • Cadeia:  a cadeia de lojas
            • Formato:  o formato da loja
            • Armazém do Laboratório : deve ser informado se o depósito é para produção ou laboratório para preparação de exames caso seja necessário.
            • Ativo: Indica se a Loja para a qual é criado está Ativa ou não.

Se uma loja for gerada e não ativada, ela não aparecerá disponível para seleção nos diferentes menus onde uma loja deve ser indicada.

Importante

Para que as informações sejam exibidas nas listas suspensas, o usuário deve realizar previamente o carregamento massivo por catálogo acessando  Administração  ->  Importação de catálogo.

Assim que todos os campos estiverem preenchidos, você deve pressionar "Salvar" para que a Loja seja criada corretamente. O aplicativo não permitirá salvar lojas que o usuário não tenha configurado.


adicionar conexões

Uma vez gerada a Store, pode-se adicionar e configurar o tipo ou tipos de conexões que ela terá para distribuir os mapas.

Para fazer isso, você deve acessar a loja à qual deseja adicionar uma conexão a partir do botão "Editar".



Então você deve clicar no botão " + Adicionar conexão "

 


A seguinte venda será apresentada onde deverá ser indicado o tipo de ligação que pretende configurar à loja.

As opções disponíveis para configuração são:

              • AUTO:  o mapa a ser distribuído será postado em um ou vários motores que irão baixá-lo automaticamente em seus diretórios.
              • ARQUIVO: pode ser distribuído em um diretório específico.
              • FTP seguro: as credenciais correspondentes podem ser indicadas para poder distribuir via FTP.
              • FTP: as credenciais correspondentes podem ser indicadas para poder distribuir via FTP.


Se for selecionada a conexão "Arquivo" , a seguinte tela será exibida onde os dados solicitados devem ser inseridos para configurar corretamente o tipo de distribuição.


Ser-lhes-á pedido que detalhem o "Directório" ou rota onde serão distribuídos os mapas que utilizam este tipo de ligação.

Neste ponto será possível indicar se o arquivo (mapa) a ser distribuído será enviado em formato ZIP, para que posteriormente o motor o descompacte e carregue automaticamente, ou se será distribuído como um arquivo .XML como de costume, indicando na opção " Distribuir em ZIP SIM/NÃO "

Se você escolher uma das distribuições de FTP (FTP ou FTP Seguro), também poderá optar por enviar o mapa compactado em um arquivo ZIP.

Os dados mostrados no PopUp a seguir também serão necessários ao configurar a conexão FTP:



Distribuição Automática

A partir da consola PROMO será possível indicar os mapas que estarão disponíveis para que o(s) motor(es) da loja possa descarregar e atualizar para o mapa atual mais recente.

No caso de optar pela distribuição automática, não serão solicitados dados adicionais, uma vez que o motor ou motores associados à loja se encarregarão de descarregar o mapa e colocá-lo no diretório de distribuição que cada um tiver associado.




IMPORTANTE


Caso a distribuição automática seja para um motor que opere no modo "Multistore", o mapa será enviado com um caminho relativo  /company_code/store_code.  Com isso o motor saberá que deve baixar o arquivo em  c:\meumotor\vendas\codigo_empresa\codigo_tienda


Caso contrário, se a distribuição automática for realizada em NÃO operar no modo "Multistore", o mapa será enviado com um caminho relativo  /company_code.   Com isso, a engine saberá que se o caminho do seu mapa for  c:\myengine\sales , deverá baixar o arquivo para:  c:\myengine\sales\company_code.



Se for usado um tipo de distribuição automática para uma loja, não pode ser definido outra ligação posteriormente, nem pode ser definido um tipo de distribuição automática quando a loja já tem outro tipo de distribuição definido, pelo que o tipo de não definição deve ser eliminado. se o tipo de definição automático só puder ser definido.


Mecanismo de várias lojas

Ao definir as conexões, também será possível indicar se o motor utilizado possui configuração Multistore.

Se a opção " Multistore Engine " não estiver marcada , indicará que o motor não opera com multistore, portanto o console criará o diretório \SALES ao distribuir, devendo configurar as rotas de implantação sem indicar este subdiretório. (Ex: C:\síntese\Promo\motor)

Caso opte por operar com o Mecanismo Multi-lojas, deverá marcar a opção " Mecanismo Multi-lojas ", para que o console NÃO crie o diretório \SALES ao distribuir, devendo indicá-lo explicitamente ao definir a distribuição path (por exemplo: C:\synthesis\Promo\engine\sales).


Motor Associado

Uma loja específica pode estar associada a um ou mais motores que nela operam. Esses mecanismos relatarão a cada determinado período de tempo qual é o mapa ativo com o qual está operando.

Para isso, clique em " Associar Motor ".




IMPORTANTE

Cuando un nuevo motor se instale, este se reportará a la consola de PROMO que se haya definido (URL indicada en el archivo config.xml del motor), se reportará quedando ONLINE ya la espera de que sea asignada a una tienda y se le distribuya um mapa.

O id do motor configurado no arquivo config.xml (que é o nome do motor que será exibido na seleção) tem um limite de 100 caracteres.



Ao clicar em " Associar Motor " será apresentado o seguinte pop-up :


Dos motores disponíveis, deverá selecionar aquele que pretende associar à loja. 

Pressionando " Salvar " aparecerá a tela de edição de lojas, o motor a ela associado e que reportará seu mapa ativo ao console.




Novos motores podem ser associados à loja, bem como excluir a associação feita.

Importante

Quando novas empresas são criadas; se já existe um motor associado a um já existente, o novo não verá o estado desse motor em Support, System Status. Quando um mapa atual é distribuído manualmente em uma loja da nova empresa; O motor já pode ser associado a ele e esta nova empresa poderá ver seu status em Suporte, Status do Sistema; item do motor selecionado.


 Concorrentes


A partir do Menu Negócios/Concorrentes, acede-se ao seguinte ecrã, onde serão registados os Concorrentes, com as respetivas lojas, e os preços que publicam para os artigos.

Os concorrentes podem ser pesquisados ​​filtrando por Código e Nome.

Inscrições de Competidores:

O usuário operador acessa o menu “Concorrentes” e seleciona o botão “Novo”

A partir deste menu será criado o cabeçalho do concorrente.

Os campos devem ser preenchidos:

          • Código (alfanumérico até 15 posições, obrigatório)
          • Nome (alfanumérico até 30 posições, obrigatório)
          • Código identificador (alfanumérico com 15 posições, opcional) (por exemplo, na Argentina seria o CUIT)
          • Ativo (verificar)
          • Descrição da imagem (alfanumérico até 50 caracteres, opcional)
          • Imagem associada, upload de imagem (imagem do concorrente, opcional)

  

O usuário salva o novo Competidor selecionando o botão “Salvar e continuar”

Uma vez criado o cabeçalho do concorrente, o utilizador deverá criar as lojas associadas a esse concorrente, entrando em Negócios\ Concorrentes\ Concorrentes, seleccionando o botão Acções\ Definir no concorrente ao qual vai adicionar as lojas.


Uma tela como a seguinte será exibida. Onde o usuário pode editar o cabeçalho. Ou pressionando o botão "Adicionar lojas", você pode adicionar lojas que serão associadas a esse concorrente.

O filtro "Loja" permite pesquisar pelo nome da loja do concorrente que está sendo criada ou definida.


Ao selecionar o botão "Adicionar Lojas" aparecerá um pop up solicitando os dados da nova loja.

Os campos devem ser preenchidos:

          • Código (alfanumérico até 15 posições, obrigatório)
          • Nome (alfanumérico até 30 posições, obrigatório)
          • Endereço (alfanumérico até 50 caracteres, opcional)
          • Ativo (marque para Ativar ou Desativar loja)

Selecionar o botão "Salvar" salvará as alterações e fechará o pop-up. Selecionar o botão x fechará a janela sem salvar as alterações feitas.


Modificar concorrente:

A imagem associada pode ser alterada ou pode ser deixada sem imagem associada.

Os campos "Código" e "Nome" não podem ser modificados.

O campo "Código Identificador" é editável.

A verificação ativa pode ser ativada ou desativada

No menu  Competidores > Ações > Editar   ,  o competidor pode ser editado:

           

           Os dados do Concorrente poderão ser modificados e  registrados clicando no botão "Salvar".


Publicação de preço do concorrente:


A partir do Menu Concorrentes > Publicações de Preços, você acessará a tela onde poderá cadastrar as publicações dos concorrentes:

Ao clicar no item "Seleções de lojas", o aplicativo exibirá as lojas que o usuário configurou.
  

Ao selecionar o botão "Novo", você pode criar o cabeçalho de publicação de preço do concorrente, ele mostrará uma tela como a seguinte:

Selecione o Concorrente e a Loja correspondentes nos combos suspensos (somente aqueles que o cliente configurou).

Salve as alterações selecionando o botão “Salvar e continuar”.


Abrirá a tela Detalhes onde será exibido por alguns segundos um sinal verde indicando "A operação foi realizada com sucesso". Na parte superior mostra os detalhes do "Header", que pode ser editado se desejar. E abaixo mostra “Postagens de preços”.

 

No campo Item, você pode inserir o código de um produto (SKU), ou pode escrever o nome do item.Se forem encontradas correspondências, uma janela será exibida com todas as correspondências encontradas para os caracteres inseridos.


Selecione o artigo.

O sistema mostrará o produto selecionado e permitirá carregar os preços das publicações dos concorrentes:

O usuário deverá preencher os campos: preço publicado (obrigatório), data de publicação (obrigatório) e imagem (opcional). Você deve pressionar o botão "Salvar" para salvar os dados inseridos.


 


Modificação das Publicações de Preços:

 No menu Concorrentes\Publicações de preços, selecione o botão Ações do concorrente e selecione “Definir”.

Nesta visualização serão detalhadas apenas as lojas que o usuário configurou; da mesma forma que no combo para selecionar uma loja.

Pode ver a imagem associada ao produto introduzido selecionando o botão "Imagem Associada"

A publicação pode ser modificada selecionando o botão Editar.


O produto pode ser removido selecionando o botão Remover.

 

Publicações de preços de filtros:

Em Negócios\ Concorrentes\ Publicações de Preços, você pode filtrar por Concorrente ou por Loja (o usuário terá disponíveis apenas aqueles que foram configurados), selecionando o combo correspondente e em seguida o botão da lupa.

Os filtros são limpos com o botão x.


Consultar variações de preços:

Você pode verificar a variação de preço de um determinado produto, em um determinado concorrente e loja, selecionando o botão "Ver Publicações", "Variação de Preço".

Abra uma janela como a abaixo.

 O usuário deverá inserir o Sku, concorrente e loja (estarão disponíveis apenas os configurados pelo usuário). Todos os três campos são obrigatórios para esta pesquisa. Depois de inserir os filtros, pressione o botão da lupa.

Mostra os diferentes preços de um determinado Sku em uma determinada loja e concorrente, em um determinado intervalo de tempo.

O intervalo de tempo é configurado em Administration\ Configuration Information (Módulo: Business, Categoria: promo.common.security.policies, Chave: publishDays), campo: Número de dias de antiguidade dos preços publicados dos concorrentes.


Veja Comparar com a Concorrência:

Os últimos preços divulgados pela concorrência para um item podem ser consultados acessando Negócios\ Concorrentes\ Publicações de Preços, no filtro "Consultar Publicações", selecione a opção: "Comparar com a concorrência".

Abra uma janela como a abaixo.

Insira no filtro o SKU ou a descrição do item que deseja comparar com a concorrência e aperte o botão da lupa.

Mostra todos os concorrentes, com suas respectivas lojas, preços publicados e data de exibição, que possuem o SKU inserido no filtro e com data de exibição dentro do intervalo de tempo previamente configurado.



segmentos


Os clientes podem ser agrupados por segmentos.

No Menu Negócios/Segmentos, você pode criar novos segmentos, editar e visualizar segmentos existentes. Você pode pesquisar por Código e/ou por Nome.

Ao selecionar o botão "Ações" será possível acessar a edição ou definição dos segmentos.




Com o botão "Novo" você pode criar um novo segmento. Os dados a introduzir são os seguintes:

Código e Nome são obrigatórios e devem ser exclusivos, ambos são alfanuméricos.

Ao selecionar "Salvar e continuar", aparecerá a tela "Detalhe", onde é carregado o arquivo com os segmentos de "Navegar" e então deve-se pressionar o botão "Processar arquivo".

Os formatos válidos para upload são: csv (separados por vírgula), txt (separados por vírgula), xlsx (os itens devem estar um abaixo do outro, cada um é uma linha). Caso seja feito o upload de um arquivo com outro formato, aparecerá uma mensagem informando que o arquivo deve estar no formato csv, txt ou xlsx.

O sistema valida que o arquivo não possui códigos de clientes duplicados e se houver duplicados, levará apenas um.

Quando o registro do segmento é criado, o Código, Nome, Data de Criação e Data de Atualização são salvos. Após carregar os clientes, serão adicionados dados adicionais como: nome do arquivo e número de clientes carregados.


Uso do segmento:

Ao criar uma nova promoção em " Condições Simples " ou em " Condições por composição ", no elemento " Clientes ", quando é exibido, mostra o atributo “ Segmento ” quando selecionado, mostra: Igual ou diferente.



IMPORTANTE:

Os segmentos podem ser gerenciados a partir do Promo conforme detalhado acima ou você pode usar segmentos externos (não gerenciados pelo Promo) associando-os ao cliente do catálogo Cliente (catálogoCliente). Se você usar segmentos carregados do catálogo do cliente, eles serão considerados prioritários.




Capítulo 12 - Módulo de Administração


O módulo de administração permite fazer ajustes dentro do console como habilitar ou desabilitar funcionalidades, carregar catálogos, entre outros.

O acesso a este módulo só será autorizado a um utilizador administrador com as permissões correspondentes a este menu.


Menu de administração


Este menu permite gerir e configurar diferentes acessos ao PROMO.

        


Painéis

Ao pressionar o botão Dashboard, você pode gerenciar e reconfigurar os Dashboards que o console PROMO já traz por padrão ou pode gerar novos que serão visualizados posteriormente no menu Dashboard.

Ao clicar no botão "Dashboard" do menu Administração , será exibida a janela "Administração do Dashboard", onde serão listados os Dashboards padrão, bem como os Dashboards personalizados que possam ter sido gerados.


À esquerda de cada Dashboard está o botão "Ações" a partir do qual você pode Editar, Definir ou Visualizar os Painéis existentes.

Na parte inferior desta janela está o botão "Novo" a partir do qual novos Dashboards podem ser gerados.


Novo Dashboard

Pressionando o botão "Novo" aparecerá a seguinte tela onde você pode inserir o nome, código e formato de exibição do novo Dashboard, também há uma marca para habilitar ou desabilitar o Dashboard que está sendo gerado.


Após carregar os dados solicitados, você deve pressionar o botão "Salvar" e a tela de edição do Dashboard será exibida.


Editar Dashboard

Tanto se um novo Dashboard for gerado quanto se um existente estiver sendo editado, pressionando salvar, aparecerá a janela "DASHBOARD Edition: xxx" onde "xxx" corresponde ao nome do Dashboard que está sendo editado ou gerado.


Nesta tela serão propostos diferentes KPIs ou indicadores que podem ser selecionados para desenhar seu Dashboard

Existem botões "Cancelar" a partir dos quais você pode retornar à tela "Administração do Dashboard"; o botão "Editar" permitirá que você acesse a tela anterior "Editar Dashboard" novamente, com o botão "Salvar" você salvará as alterações e/ou gerará o novo Dashboard.

Pressionando "Salvar" aparecerá a tela do Dashboard que já estava sendo trabalhada a partir da opção "Dashboard" do menu "Opções do Menu". O mesmo acontecerá quando o botão de visualização de qualquer Dashboard for pressionado na janela "Administração do Dashboard".

Os seguintes KPIs estão disponíveis no produto base para geração de Dashboards:

  • Tipos de Elementos Ativados : Gráfico de barras mostrando o número de Tipos de Elementos de fidelidade Ativados.
  • Número de cupons emitidos por tipo de cupom : Gráfico de barras com emissões por tipo de cupom.
  • Percentagem total de cupões emitidos: Gráfico circular com distribuição das emissões por tipo de cupão.
  • Quantidade de cupons resgatados por tipo de cupom : Gráfico de barras com resgates por tipo de cupom.
  • Percentual total de cupons resgatados: Gráfico de pizza com distribuição dos resgates por tipo de cupom.
  • Ranking de benefícios (Ranking 10) : Aplicação de promoções para benefício monetário.
  • Ranking de promoções (Ranking 10) : Aplicação de promoções.
  • Vendas por categoria (Ranking 5): Vendas por categoria.
  • Vendas por hora (Nível 5): Vendas por hora.
  • Vendas por loja (Posto 5): Vendas por loja.
  • Vendas por meio de pagamento: Vendas por meio de pagamento.


Cupón Calculado

Quando os cupons calculados são emitidos e resgatados, seja por percentual, valor fixo ou valor externo, os movimentos serão refletidos nos painéis de cupons.


Importação de Catálogos

Catálogos são repositórios de dados fornecidos pelo cliente. Estes estarão relacionados com os atributos dos itens no PROMO Console, como os catálogos de códigos de itens, departamentos, marcas, etc., bem como clientes, lojas e atributos de cabeçalho.

O PROMO tem a funcionalidade de carregar um arquivo em formato de texto separado por "," (vírgula) para ser processado e importado manualmente. Este formato pode ser reconfigurado a partir do console, se necessário (Consulte Administração >> Informações de configuração - chave: " fileList.txt.Separator ")

Este capítulo fornecerá as informações necessárias para a administração e carregamento dos catálogos do console PROMO.


Carregando catálogos de um arquivo

Se você deseja carregar catálogos através de um arquivo, deve prepará-lo em formato de texto, separando os campos por " | " (Pipe).

Este formato pode ser reconfigurado a partir do console, se necessário (Consulte  Administração  >>  Informações de configuração  - senha: " Separador ")


Como exemplo, será detalhado  um registro pertencente a um catálogo de carregamento de itens ( catalogitem.catalog ).


Exemplo :
O catálogo de "produtos" é composto pelos campos:  "código", "nome", "preço unitário", "nível1", "nível2", "nível3", "nível4", "fornecedor", "marca" .

O arquivo catalogitem.catalog será constituído da seguinte forma:  1252|Jogo FIFA 10 para PS3|50|Elec|VGCo|PS3G|5|PR1|5


Para prosseguir com o upload, você deve pressionar o botão " Importar " na janela "Importação de catálogo" correspondente ao catálogo que está tentando processar.

Para o nosso exemplo, o botão " Importar " mostrado no catálogo " catalogitem " deve ser pressionado.


Será apresentado um pop-up a partir do qual você deve procurar o arquivo catalogitem.catalog gerado anteriormente e pressionar o botão "Executar importação de catálogo".


Depois que o arquivo foi processado, o número de registros processados ​​pode ser visualizado 

Um resumo dos registros importados também pode ser visualizado clicando na lupa que aparece à direita, na mesma linha de importação.


Contenido del catálogo

Na tela " Importação de Catálogo ", ao selecionar a lupa sobre um catálogo, mostrará os primeiros 25 registros do catálogo indicado. Não mostrará a paginação. Se houver mais registros, eles não serão mostrados nesta tela.


Os catálogos standard que a Promo apresenta são os seguintes: 

(Podem variar em função se estão registradas as propriedades dos elementos que se carregam por catálogo, neste caso, estes novos catálogos que se aplicam a estas propriedades serão mostrados na grade para poder importar).

Serão mostrados os catálogos dos 20 campos dinâmicos destinados aos campos informativos do cabeçalho:


Os catálogos de campos de cabeçalho adicionais serão apresentados com o seguinte identificador: Campo X adicional do cabeçalho da promoção (onde X representa o número do campo adicional que será importado. Eles irão variar de 0 a 19)

O nome do arquivo a ser importado deve ter o seguinte formato: catalogAdditionalFieldXX.catalog (onde X representa o número do campo adicional a ser importado. Eles irão variar de 00 a 19. Exemplo catalogAdditionalField05.catalog )

O formato dos registros neste catálogo deve ser código|descrição


CampoTipo de dadosObservações
códigocordaobrigatório
descriçãocordaobrigatório


Exemplo de registros de catálogo para campos de cabeçalho adicionais :

100|Dados A
101|Dados B
102|Dados C

IMPORTANTE

Para visualizar corretamente os catálogos que são carregados para os atributos de cabeçalho, os campos devem ser previamente habilitados em " Administração " >> " Atributos de Cabeçalho "

O nome do arquivo a importar deve ter o seguinte formato: card .catalog

O formato dos registros neste catálogo deve ser código|descrição


CampoTipo de dadosObservações
códigocordaCódigo ou não. elemento de fidelidade. Obrigatório
tipocordaTipo de elemento ao qual o elemento de fidelidade pertence. Obrigatório
valorDecordaVálido a partir de: Deve ser preenchido caso o tipo de elemento ao qual o elemento a ser registrado indique que o "tipo de vencimento" deve ser especificado por "Intervalo de datas". (formato de data AAAA-MM-DD)
valido paracordaVálido até: Deve ser preenchido caso o tipo de elemento ao qual o elemento a ser registrado indique que o "tipo de vencimento" deve ser especificado por "Intervalo de datas". (formato de data AAAA-MM-DD)
cvvcordaCódigo de validação. Deve ser preenchido se o tipo do elemento ao qual o elemento a ser registrado indicar "CVV obrigatório". (Campo numérico, comprimento máximo 5 dígitos)
clientecordaCliente associado ao item. deve ser preenchido com o Código, que pode ser visualizado na tela "Gestão de Clientes".
quantiacordaQuantidade a atribuir ao elemento. Se seu tipo indicar que é pré-carregado por arquivo, este campo é obrigatório.


Exemplo de registros de catálogo para Elementos :

541400002201|541|2019-01-01|2029-12-31|520|9595|500
541400002202|541|2019-01-01|2029-12-31|363|9655|1500
541400002203|541|2019-01-01|2029-12-31|218|1212|600

O nome do arquivo a importar deve ter o seguinte formato: catalogBrand.catalog

O formato dos registros neste catálogo deve ser código|descrição


CampoTipo de dadosObservações
códigocordaobrigatório
descriçãocordaobrigatório


Exemplo de registros de catálogo para Marca :

100|Marca A
101|Marca B
102|Marca C

O nome do arquivo a importar deve ter o seguinte formato: catalogChannel.catalog

O formato dos registros neste catálogo deve ser code|name


CampoTipo de dadosObservações
códigocordaobrigatório
inhamecordaobrigatório


Exemplo de registros de catálogo para Canal :

100|Canal A
101|Canal B
102|C-Canal

Para o carregamento dos catálogos País, Província e Cidade, deve-se respeitar uma ordem no carregamento destes três catálogos, pois existe uma dependência entre eles.

O catálogo do país deve ser processado primeiro ( catalogCountry.catalog ), depois a província/estado ( catalogState.catalog ) e finalmente a cidade ( catalogCity.catalog ).


O nome do arquivo a importar deve ter o seguinte formato: catalogCountry.catalog

O formato dos registros neste catálogo deve ser code|name


CampoTipo de dadosObservações
códigocordaobrigatório
inhamecordaobrigatório


Exemplo de registros de catálogo para País :

100|Argentino
101|Brasil
102|Chile

O nome do arquivo a importar deve ter o seguinte formato: catalogState.catalog

O formato dos registros neste catálogo deve ser código|nome|país


CampoTipo de dadosObservações
códigocordaobrigatório
inhamecordaobrigatório
statusstring - Dependência com o catálogo País. Corresponderá ao código definido no respectivo catálogo de País.obrigatório


Exemplo de registros de catálogo para Província/Estado :

200|BS.Ace|100
201|Neuquén|100
202|Chaco|100

O nome do arquivo a importar deve ter o seguinte formato: catalogCity.catalog

O formato dos registros neste catálogo deve ser código|nome|estado


CampoTipo de dadosObservações
códigocordaobrigatório
inhamecordaobrigatório
statusstring - Dependência com o catálogo da Província. Corresponderá ao código definido no respectivo catálogo da Província.obrigatório


Exemplo de registros de catálogo para Cidade :

300|Cidade A|200
301|B-Cidade|201
302|C-Cidade|201

O nome do arquivo a importar deve ter o seguinte formato: catalogCreditCampaignCode . Catálogo

O formato dos registros neste catálogo deve ser code|name


CampoTipo de dadosObservações
códigocordaobrigatório
inhamecordaobrigatório


Exemplo de registros de catálogo para Campanha de Crédito :

11|Campanha A
22|Campanha B
33|Campanha C

O nome do arquivo a importar deve ter o seguinte formato: CatalogCurrencyCode.catalog

O formato dos registros neste catálogo deve ser code|name


CampoTipo de dadosObservações
códigocordaobrigatório
inhamecordaobrigatório


Exemplo de registros de catálogo para Moeda :

10|Pesos
11 | dólares
12|Euro

Nesta seção serão detalhadas as diferentes opções disponíveis para importar o catálogo de clientes.


  • Validação do Catálogo do Cliente

Para o carregamento do catálogo do cliente ( catalogcustomer.catalog ) pode ser indicado por configuração, que a existência anterior de outros catálogos já carregados seja validada para processar o catálogo do cliente.

Este parâmetro de configuração é:


A existência dos respectivos catálogos será validada no momento da importação do cliente quando o seu valor for  verdadeiro . Para permitir entrada livre, o valor  false deve ser especificado .

Os catálogos que serão validados no momento do processamento serão:

  • país (catalogCountry.catalog)
  • província (catalogState.catalog)
  • cidade (catálogoCidade.catalog)
  • gênero (catálogoGênero.catálogo)
  • tipo de id (catalogIdType.catalog)
  • tipo de cliente (catalogcustomertype.catalog)


Quando o parâmetro de configuração "validateRelatedEntities" for true , esses catálogos listados devem ser carregados previamente, para carregar o catálogo do cliente.

O nome do arquivo a importar deve ter o seguinte formato: catalogGender.catalog

O formato dos registros neste catálogo deve ser code|name


CampoTipo de dadosObservações
códigocordaobrigatório
inhamecordaobrigatório


Exemplo de registros de catálogo para gênero :

1|Fenamina
2|Masculino

O nome do arquivo a importar deve ter o seguinte formato: catalogIdType.catalog

O formato dos registros neste catálogo deve ser code|name


CampoTipo de dadosObservações
códigocordaobrigatório
inhamecordaobrigatório


Exemplo de registros de catálogo para o tipo de ID do cliente :

01|CI
02|ID
03|CPF
04|Outros

O nome do arquivo a importar deve ter o seguinte formato: catalogCustomerType.catalog

O formato dos registros neste catálogo deve ser code|name


CampoTipo de dadosObservações
códigocordaobrigatório
inhamecordaobrigatório


Exemplo de registros de catálogo para tipo de cliente :

111|Consumidor Final
222|Empregado
333|Vip
444|Outros

O nome do arquivo a importar deve ter o seguinte formato: c atalogCustomer.catalog

O formato dos registros neste catálogo deve ser code|name|lastName|gender|birthDate|identificationType|identifier|identificationExpiration|nationality|email|customerType|address| endereçoC país| endereçoEstado | endereçoCidade | endereçoCódigo Postal | _ telefone|éAtivo|segmentos


IMPORTANTE - Campos requeridos para la importación de catalogo de cliente

Os seguintes campos são obrigatórios para o correto processamento do catálogo de clientes:

  • código ( código )
  • nome ( nome )
  • últimoNome ( últimoNome )
  • tipo de cliente ( clientType )
  • número do identificador ( identificador )
CampoTipo de dadosObservações
códigocordaCorresponde ao código que será atribuído ao cliente em Promo. (obrigatório)
inhamecordaNome do cliente. (obrigatório)
sobrenomecorda
Sobrenome do cliente. (obrigatório)
gênerocorda
Gênero do cliente (se " Validar catálogos relacionados ao catálogo do cliente " estiver definido como " verdadeiro", os dados definidos neste campo devem corresponder a um dos códigos de gênero " catálogoGender.catalog " carregados anteriormente .)
data de nascimentocorda
Data de nascimento do cliente. Formato: ano-mês-dia em que o ano tem quatro dígitos e o mês e o dia têm dois dígitos
tipo de identificaçãocorda
Tipo de identificação do cliente. (Se " Validar catálogos relacionados ao catálogo do cliente " estiver definido como " true ", os dados definidos neste campo devem corresponder a um dos códigos de tipo de identificação " catalogIdType.catalog " carregados anteriormente .) Obrigatório
identificadorcorda
Número de identificação do cliente. (obrigatório)
expiração de identificaçãocorda
Data de expiração do ID do cliente.
nacionalidadecorda
Nacionalidade do cliente
e-mailcorda
E-mail do cliente.
Tipo de Clientecorda
Tipo de cliente (obrigatório) / / (se " Validar catálogos relacionados ao catálogo do cliente " estiver definido como " true", os dados definidos neste campo devem corresponder a um dos códigos de tipo de cliente " catalogIdType.catalog carregados anteriormente.)
endereçocorda
Endereço do cliente.
endereçoPaís
corda
País do cliente. (Se " Validar catálogos relacionados ao catálogo do cliente " estiver definido como " true ", os dados definidos neste campo devem corresponder a um dos códigos de país " catalogCoutry.catalog carregados anteriormente .)
endereçoS estadocorda
Província de residência do cliente. (Se " Validar catálogos relacionados ao catálogo do cliente " estiver definido como " true", os dados definidos neste campo devem corresponder a um dos códigos de província " catalogState.catalog carregados anteriormente.)
Endereço Cidadecorda
Cidade de residência do cliente. (Se " Validar catálogos relacionados ao catálogo do cliente " estiver definido como " true", os dados definidos neste campo devem corresponder a um dos códigos de cidade " catalogCity.catalog carregados anteriormente.)
Endereço Código Postalcorda
Código postal
Telefonecorda
Telefone
está ativoboleanoEle indicará se no momento do cadastro o cliente estará Ativo ou Inativo. Deve ser definido como true ou false .
segmentoscorda
Segmento(s) associado(s) ao cliente


Exemplo de registros de catálogo para o cliente :

1001|juan|perez|2|03-05-1959|01|11552266||Arg|[email protected]|111|Av.Livertad 123|100|200|300|2321|1566558222|true|5500
1002|pablo|gonsalez|2|03-05-1970|02|10002565||Arg|[email protected]|111|Roca 555|100|200|300|2213|156632545|true|5500
1003|raul|fernandez|2|03-05-1983|02|50363221||Arg|[email protected]|111|Nuñez 111|100|200|300|2001|46613232|true|5500
1004|John|Promo|2|03-05-1950|01|527748512||Arg|[email protected]|111|Callao 999|100|200|300|7453|49872000|false|5500
1005|maria|gutierrez|1|03-05-1999|01|123456789||Arg|[email protected]|111|entre rios 656|100|200|300|4456|11548970701|true|5500
1006|ana|gomez|1|03-05-1998|03|951753000||Arg|[email protected]|222|aguero 540|100|200|300|6675|1145600000|true|5500
1007|laura|lopez|1|03-05-1981|01|55421957||Arg|[email protected]|333|palestina 333|100|200|300|6642|1174788884|true|5500
1008|carlos|martinez|2|03-05-1987|01|38546200||Arg|[email protected]|222|Av. Diretório 1587|100|200|300|1122|1166532032|true|5500
1009|roberto|garcia|2|03-05-1979|01|20159987||Arg|[email protected]|333|ramallo 3456|100|200|300|3346|46258130|true|2244
1010|jose|montes|2|03-05-1949|01|30665448||Arg|[email protected]|111|9 de julho 754|100|200|300|8864|123654789|true|2244

O nome do arquivo a importar deve ter o seguinte formato: catalogDepartment .catalog

O formato dos registros neste catálogo deve ser code|name


CampoTipo de dadosObservações
códigocordaobrigatório
inhamecordaobrigatório


Exemplo de registros de catálogo para Departamento :

111|Brancos
222|Frescos
333|Limpeza
444|Armazém

O nome do arquivo a importar deve ter o seguinte formato: catalogEventTransaction.catalog

O formato dos registros neste catálogo deve ser code|name


CampoTipo de dadosObservações
códigocordaobrigatório
inhamecordaobrigatório


Exemplo de registros de catálogo para Evento :

50|Evento 1
51|Evento 2
52|Evento 3
53|Evento 4

O nome do arquivo a importar deve ter o seguinte formato: catalogEventTransactionType.catalog

O formato dos registros neste catálogo deve ser code|name


CampoTipo de dadosObservações
códigocordaobrigatório
inhamecordaobrigatório


Exemplo de registros de catálogo para Tipo de transação :

101|Venda
202|Retorno

O nome do arquivo a importar deve ter o seguinte formato: catalogFamily.catalog

O formato dos registros neste catálogo deve ser code|name


CampoTipo de dadosObservações
códigocordaobrigatório
inhamecordaobrigatório


Exemplo de registros de catálogo para Família :

111|Laticínios
222|legumes
333|Frutas

O nome do arquivo a importar deve ter o seguinte formato: catalogCategory.catalog

O formato dos registros neste catálogo deve ser code|name|familyCode


CampoTipo de dadosObservações
códigocordaobrigatório
inhamecordaobrigatório
Código familiarstring - Dependência com o catálogo Família. Corresponderá ao código definido no respectivo catálogo da Família.


Exemplo de registros de catálogo para Categoria :

100|Categoria A|111
101|Categoria B|222
102|Categoria C|222

O nome do arquivo a importar deve ter o seguinte formato: catalogSubCategory.catalog

O formato dos registros neste catálogo deve ser code|name|categoryCode


CampoTipo de dadosObservações
códigocordaobrigatório
inhamecordaobrigatório
categoriaCódigostring - Dependência com o catálogo de categorias. Pode corresponder ao código definido no catálogo de Categoria relacionado.


Exemplo de registros de catálogo para Subcategoria :

222|Subcategoria A|100
333|Subcategoria B|100
444|Subcategoria C|102

O nome do arquivo a importar deve ter o seguinte formato: catalogFormat.catalog

O formato dos registros neste catálogo deve ser code|name


CampoTipo de dadosObservações
códigocordaobrigatório
inhamecordaobrigatório


Exemplo de registros de catálogo para Formato :

111|Formulário A
222|Formulário B
333|Formulário C

O nome do arquivo a importar deve ter o seguinte formato: catalogItem.catalog

O formato dos registros neste catálogo deve ser código|nome|preço unitário|nível1|nível2|nível3|nível4|fornecedor|marca|detalhe|detalhe2


CampoTipo de dadosObservações
códigocordaCódigo SKU do produto (obrigatório)
inhamecordaNome do produto (obrigatório)
preço unitárionuméricoPreço unitário do produto
nível 1cordadepartamento de produtos
nível 2cordaproduto familiar
nível 3cordaCategoria de Produto
level4cordaSubcategoria de produto
fornecedorescordafornecedor do produto
marcacordamarca do produto
detalhescordaDetalhe
detalhe2cordaDetalhe 2


Exemplo de registros de catálogo para itens :

11020|produto 1|1050|Dto1|flia1|Cat11|SubCat12|Prov21|Marca1||Det2
11021|produto 2|2000|Dto2|flia2|Cat12|SubCat13|Prov21|Marca1|Det1|
11022|produto 3|500|Dto1|flia1|Cat13|SubCat14|Prov21|Marca1|Det1|Det2
11023|produto 4|50200|Dto1|flia2|Cat14|SubCat15|Prov21|Marca1||
11025|produto 5|10540|Dto3|flia1|Cat15|SubCat11|Prov21|Marca1||Det2
25250|produto 6|980|Dto1|flia2|Cat16|SubCat12|Prov21|Marca1||
25251|produto 7|31500|Dto1|flia1|Cat17|SubCat13|Prov21|Marca1||Det2
25252|produto 8|456|Dto2|flia1|Cat18|SubCat14|Prov21|Marca1||
25253|produto 9|887|Dto1|flia1|Cat19|SubCat15|Prov21|Marca1|Det1|Det2

O nome do arquivo a importar deve ter o seguinte formato: catalogStore.catalog

O formato dos registros neste catálogo deve ser code|name


CampoTipo de dadosObservações
códigocordaobrigatório
inhamecordaobrigatório


Exemplo de registros de catálogo para Formato :

10|Compre A
11|Tenda B
12|Tenda C

O nome do arquivo a importar deve ter o seguinte formato: catalogItemStock.catalog

O formato dos registros neste catálogo deve ser store | código|nome


CampoTipo de dadosObservações
lojastore - Dependência com o catálogo da loja. Corresponderá ao código definido no catálogo da loja correspondente.obrigatório
códigocordaobrigatório
estoquenumérico - estoque na loja


Exemplo de registros de catálogo para Estoque :

10|778|10000
11|aaaa|600
12|788|3000

O nome do arquivo a importar deve ter o seguinte formato: catalogPaymentBank .catalog

O formato dos registros neste catálogo deve ser code|name


CampoTipo de dadosObservações
códigocordaobrigatório
inhamecordaobrigatório


Exemplo de registros de catálogo para Banco :

10|banco A
11|banco B
12|banco C

O nome do arquivo a importar deve ter o seguinte formato: catalogPaymentCode .catalog

O formato dos registros neste catálogo deve ser code|name


CampoTipo de dadosObservações
códigocordaobrigatório
inhamecordaobrigatório


Exemplo de registros de catálogo para Pagamento :

10|pagamento A
11|pagamento B
12|pagamento C

O nome do arquivo a importar deve ter o seguinte formato: catalogPaymentPrefix.catalog

O formato dos registros neste catálogo deve ser code|name


CampoTipo de dadosObservações
códigocordaobrigatório
inhamecordaobrigatório


Exemplo de registros de catálogo para prefixo :

10|Pref A
11|Pref B
12|Pref C

O nome do arquivo a importar deve ter o seguinte formato: catalogPaymentType.catalog

O formato dos registros neste catálogo deve ser code|name


CampoTipo de dadosObservações
códigocordaobrigatório
inhamecordaobrigatório


Exemplo de registros de catálogo para Tipo de Pagamento :

10|dinheiro
11|cartão
12|outros

O nome do arquivo a importar deve ter o seguinte formato: catalogPocket.catalog

O formato dos registros neste catálogo deve ser code|name


CampoTipo de dadosObservações
códigocordaobrigatório
inhamecordaobrigatório


Exemplo de registros de catálogo para Pocket :

10|Bolso 1
11|Bolso 2
12|Bolso 3

O nome do arquivo a importar deve ter o seguinte formato: catalogProfileCode.catalog

O formato dos registros neste catálogo deve ser code|name


CampoTipo de dadosObservações
códigocordaobrigatório
inhamecordaobrigatório


Exemplo de registros de catálogo para o Perfil do cliente :

10|Perfil 1
11|Perfil 2
12|Perfil 3

O nome do arquivo a importar deve ter o seguinte formato: catalogStoreChain.catalog

O formato dos registros neste catálogo deve ser code|name


CampoTipo de dadosObservações
códigocordaobrigatório
inhamecordaobrigatório


Exemplo de registros de catálogo para String :

10|Cadeia 1
11|Cadeia 2
12|Cadeia 3

O nome do arquivo a importar deve ter o seguinte formato: catalogSupplier.catalog

O formato dos registros neste catálogo deve ser code|name


CampoTipo de dadosObservações
códigocordaobrigatório
inhamecordaobrigatório


Exemplo de registros de catálogo para Fornecedor :

10|Provedor 1
11|Provedor 2
12|Provedor 3

O nome do arquivo a importar deve ter o seguinte formato: catalogZone.catalog

O formato dos registros neste catálogo deve ser code|name


CampoTipo de dadosObservações
códigocordaobrigatório
inhamecordaobrigatório


Exemplo de registros de catálogo para Zona :

10|Zona 1
11|Zona 2
12|Zona 3

O nome do arquivo a importar deve ter o seguinte formato: catalogSubZone.catalog

O formato dos registros neste catálogo deve ser code|name


CampoTipo de dadosObservações
códigocordaobrigatório
inhamecordaobrigatório


Exemplo de registros de catálogo para subzona :

10|Subzona 1
11|Subzona 2
12|Subzona 3

O nome do arquivo a importar deve ter o seguinte formato: catalogRedeemBenefit.catalog

O formato dos registros neste catálogo deve ser store|code|points|discountValue|discountType


CampoTipo de dadosObservações
lojacordaCódigo da loja. Obrigatório - Se aplicável a todas as lojas, o código da loja deve ser "-".
códigocorda
Código do produto. necessário .
pontosNumérico com decimais.Pontos necessários.
valor de descontoNumérico com decimais.Valor do desconto.
tipo de descontocorda
Tipo de desconto. Obrigatório. Aceita apenas os valores " perc " (porcentagem), " fix " (desconto fixo), ou " nprice " (novo preço)


Exemplo de registros de catálogo para Resgate de Pontos :

b320|1000|100|10|perc
-|3000|30|5|perc
b320|2000|60|27|consertar
a922|1001|80|1500|consertar
b320|1002|70|487.89|npreço

O nome do arquivo a importar deve ter o seguinte formato: c atalogProductCode.catalog

O formato dos registros neste catálogo deve ser code|name


CampoTipo de dadosObservações
códigocordaobrigatório
inhamecordaobrigatório

Exemplo de registros de catálogo para Código do produto :

1 | caneta
2|lápis
3|borracha
4|televisão

O nome do arquivo a importar deve ter o seguinte formato: c atalogProductBarcode.catalog

O formato dos registros neste catálogo deve ser code|name


CampoTipo de dadosObservações
códigocordaobrigatório
inhamecordaobrigatório

Exemplo de registros de catálogo para código de barras do produto :

1000177|grama
1000178|açúcar
1000179|café
1000180|te

O nome do arquivo a importar deve ter o seguinte formato: catalogBalance.catalog

O formato dos registros neste catálogo deve ser id | descrição

CampoTipo de dadosObservações
eu ianuméricoobrigatório
descriçãocordaobrigatório

Exemplo de registros de catálogo para Saldo :

Balance
1|Empregado


O diretório onde os arquivos do catálogo serão armazenados e importados automaticamente pelo processo de importação automática do catálogo é C:\synthesis\promo\catalog . ( Consulte o capítulo Administração > Informações de configuração. Promo.catalog >> fileDirectory ). Este diretório deve ser usado quando os arquivos de catálogo forem maiores que 1Mb.


Recepción de catalogos vía RabbitMQ

O Promo poderá receber atualizações do catálogo por meio da fila do Rabbit MQ que foi configurada para esse fim. O status desse processo pode ser visualizado na seção " Monitor de importação " no console Promo.

(Para obter mais informações sobre a configuração no console Promo, consulte Administração > Informações de configuração neste documento.)

(Para maiores informações sobre o processo e dados da integração com as filas do RabbitMQ, consulte o Manual de Integração Promo 7.1.)



informações de configuração

Existem parâmetros de configuração que podem ser modificados para personalizar o comportamento do PROMO.
Esses parâmetros são encontrados no Console PROMO,  Menu " Administração " >> " Informações de configuração " e são:



MóduloDicaValorDescrição
1cuponscaminho do código de barrasC:/synthesis/promo/images/barcode/Diretório de imagem de código de barras
2cuponscódigo de barrashttp://localhost:8080/promo/assets/barcode/URL de imagens de código de barras
3cuponsmáscara de cliente5
4



5promoçãodiretório de arquivosC:/síntese/promo/catálogos/napse\Importação do catálogo: diretório onde ficarão os arquivos
6NegóciosdinheiroSímbolo$símbolo de moeda
7Elementos de fidelidadequantidade máx.999Número máximo de cartões a serem gerados para cada operação de registro massivo
8Elementos de fidelidadeisEditableAfterCardsGenerationfalsoPermitir a edição do tipo de cartão após a geração de um cartão ativo
9Elementos de fidelidadeprefixo.ativofalsoUse prefixo numérico incremental para tipos de cartão
10Elementos de fidelidadecódigo.ativofalso

Use código numérico incremental para tipos de cartão

onzeElementos de fidelidadecard.nominated.default.optionNão

Tipo de cartões: Criar por padrão nomeado (padrão: falso = não)

12cuponsCÓDIGO128PPPSSSTTTnnnnnnnnnnnnnnnnnnnnFormato de código de barras CODE128
13cuponsEAN13PPPSSSTTTnnncFormato de código de barras EAN13
14cuponsUPCAPPSSSTTTnncFormato de Código de Barras UPCA
quinzecuponsquantidade máx.999Quantidade máxima de geração de cupons em massa por transação
16cuponsprefixo.ativoverdadeiroUse prefixo numérico incremental para tipos de cupom
17cuponsquantidadeFormato%.02fFormato em que os valores dos cupons são impressos
18promoçãométodo de aplicaçãoresumePromoções: valor padrão no método apply
19promoçãométodo de divisãoproporcionalPromoções: valor padrão no método split
vintepromoçãopreço da divisãopreço-benefícioPromoções: valor padrão o tipo de preço beneficiado
vinte e umpromoçãonomeInfoPos0indistintoNome do campo de informações adicionais da oferta no cupom de benefício.
22promoçãonomeInfoPos1campo 1Nome do campo de informações adicionais da oferta no cupom de benefício.
23promoçãonomeInfoPos2campo 2Nome do campo de informações adicionais da oferta no cupom de benefício.
24promoçãoobrigatórioAmbosfornecedoresfalsoPromoções: valor padrão se você precisar de ambos os provedores de benefícios
25promoçãofileList.txt.Separator,Importação de Catálogo: Guia
26promoçãofileList.xls.ColStart0Importação de Catálogo: Iniciar Coluna de Importação de Catálogo
27promoçãofileList.xls.DirectionverticalImportação de catálogo: método de importação
28promoçãofileList.xls.RowStart0Importação de Catálogo: Iniciar Linha de Importação de Catálogo
29promoçãoseparador|Importação de Catálogo: Separador de Colunas
30promoçãoatualizarTamanho100Importação do catálogo: tamanho do upload
31promoçãovalid.date.cuponTypeverdadeiro

Válido se a validade da promoção for contemplada dentro da validade do cupom

32promoçãovalidar.autocompletar.existentefalso

Valida se os campos de preenchimento automático do catálogo permitem APENAS valores existentes

33promoçãoisEditableCouponTypeDistributedfalsoPossibilita a edição de tipos de cupons no estado " Distribuído "
3. 4Negócioscaracteres Máximo Alfabético vinteNúmero máximo de caracteres alfabéticos
35Negócioscaracteres Máximo Numérico vinteNúmero máximo de caracteres numéricos
36NegócioscharsMaximumQuantity vinteNúmero máximo de caracteres totais
37Negócioscaracteres Máximo Especial vinteNúmero máximo de caracteres especiais
38NegócioscaracteresMinimumQuantity 7Número mínimo de caracteres totais
39NegócioscharsMinimumUser 3Número mínimo de caracteres no nome de usuário
40NegóciosmaximumLoginFailedCount 3Número máximo de tentativas sucessivas de login com falha
41NegóciosnúmeroQuantidade 1Número mínimo de caracteres numéricos
42NegóciospasswordExpirationDays 30Dias de expiração da senha do usuário
43Negóciosdias publicados 7

Número de dias de antiguidade dos preços publicados dos concorrentes

44NegóciosspecialCharsQuantity 0Número mínimo de caracteres especiais
Quatro cincoNegóciosstringQuantidade 1Número mínimo de caracteres alfabéticos
46NegóciosuserBlockDays 90Bloqueio de usuário - dias de inatividade
47NegóciosuserLockTime 30Período de bloqueio da conta do usuário (em minutos)
48promoçãoattribute.relationship.validation.requiredfalso

Requer validação dos dados de atributo do item na condição de promoções

49promoçãocliente.necessáriofalso

A promoção requer que o status de Cliente seja considerado completo

cinquentapromoçãodateTime.requiredfalso

A promoção requer uma data com condição de tempo para ser considerada completa

51promoçãotransação.obrigatóriofalsoA promoção requer uma condição de Transação para ser considerada completa
52Negóciosconcorrentes.imagens.caminhoC:\synthesis\promo\images\custom\concorrentes\

Diretório de armazenamento de imagem do concorrente

53NegóciosconcorrentesPricesItems.images.pathC:\synthesis\promo\images\custom\competitorsPricesItems\

Diretório para armazenamento de imagens de preços publicadas pelos concorrentes

54promoçãocaminhoC:/síntese/promo/importar/Diretório para a importação de Mapas de Promoções.
55promoçãobenefício.ativofalsoUse campo numérico incremental para benefícios
56promoçãopromoção.código.ativofalsoUse o campo numérico incremental para promoções
57promoçãopontos resgatados0

Determina os pontos mínimos para benefícios de resgate

58cuponspadrão.de[email protected]E-mail padrão com o qual os e-mails serão enviados
59cuponsdefault.insertImagesfalsoIndica se aceita ou não códigos de barras
60cuponsdefault.subjectCorreio de teste promocionalassunto padrão
61cuponshospedarsmtp.gmail.comHost do provedor de e-mail
62cuponssenha************Senha da conta de e-mail
63cuponsporta
porta de conexão
64cuponssmtp.authverdadeiroHabilitar Autenticação SMTP
65cuponssmtp.port587porta SMTP
66cuponssmtp.socketFactory.classjavax.net .ssl.SSLSocketFactorynome da classe SSLSocketFactory
67cuponssmtp.socketFactory.fallbackfalsofallback socketFactory
68cuponssmtp.socketFactory.port465porta SMTP socketFactory
69cuponssmtp.starttls.enableverdadeiroAtivar Iniciar TLS
70cuponssmtp.ssl.trust*Nome de host de certificado confiável (* todos)
71cuponsnome de usuário[email protected]Usuário ou nome da conta de e-mail
72promoçãousar.item.catálogo1Mapas: algoritmo de cálculo de colisão
73promoçãocleanEngineStatusHistory7Tempo em dias que o console manterá o histórico de status do motor
74promoçãoderrotadoEditável.enabled
verdadeiro

Permite a edição de promoções expiradas

75promoçãoimplantadoEditável.enabledfalsoHabilita a edição da promoção com o status Deployed.
76promoçãodataEditávelSeAtivoverdadeiro

Possibilita a edição da data efetiva da promoção

77promoçãoarquivo.xls.header.rowStart1Cadastro massivo de promoções: número da linha onde ficará localizado o cabeçalho do template da promoção
78promoçãomessage.printer.maxLength

Corta a mensagem para a impressora.

79promoçãopromoção.nome.códigofalso

Indica se o código de uma promoção deve ser concatenado ao nome da mesma

80promoçãopromoção.codeKeyfalso

Campo de código promocional chave

81promoçãopromoção.estadodomotor.comunicação600Tempo decorrido desde o último relatório de status do mecanismo ou do console para ser considerado offline. Se você não relatou nesse período, é considerado offline.
82promoçãopromoção.imagens.altura250Promoções: alto padrão de imagens
83promoçãopromoção.imagens.caminhoC:/síntese/promoção/imagens/promoção/Promoções: diretório para armazenamento de imagens
84promoçãopromoção.imagens.largura250Promoções: largura padrão das imagens
85cuponsrabbitMQ.couponHistory.endpointNamenome da fila rabbitMQ para exportar cupons

Nome da fila RabbitMQ para postagem de dados de movimento de cupom

86promoçãoRabbitMQ.cardhistory.endpointName

Nome da fila RabbitMQ para postagem de dados de movimentação de cartão

87promoçãoRabbitMQ.produtor.manual.promoção.enabled

Ativar postagem manual de dados da promoção

88promoçãoRabbitMQ.SSL.enabledfalso

ativar SSL

89promoçãorabbitMQ.enabledverdadeiroPropriedade que indica se o rabbitMQ está ativado
90promoção

RabbitMQ.date.UTC

habilitadoPermite que dados do tipo data estejam com o fuso horário do servidor e não GMT (padrão).
91promoçãoRabbitMQ.endpointName


nome da fila rabbitMQ

92promoçãoRabbitMQ.host

Endereço (host) do servidor RabbitMQ

93promoçãoRabbitMQ.limitstatus.endpointName

Nome da fila RabbitMQ para postagem de dados LimitStatus

94promoçãoRabbitMQ.senha

Senha para acessar o rabbitMQ

95promoçãoRabbitMQ.port

porta do servidor rabbitMQ

96promoçãoRabbitMQ.produtor.SSL.enabledfalso

Ativar SSL para postagem de dados

97promoçãoRabbitMQ.produtor.enabledfalso

Propriedade que indica se o rabbitMQ está habilitado para postagem de dados

98promoçãoRabbitMQ.produtor.host

Endereço do host do servidor RabbitMQ para postagem de dados

99promoçãoRabbitMQ.produtor.senha

Senha para acessar o servidor RabbitMQ para postagem de dados

100promoçãoRabbitMQ.produtor.port

Porta do servidor RabbitMQ para postagem de dados

101promoçãoRabbitMQ.produtor.uri

URI de conexão completa do servidor RabbitMQ para postagem de dados

102promoçãoRabbitMQ.produtor.nome de usuário

Usuário para acessar o servidor RabbitMQ para postagem de dados

103promoçãoRabbitMQ.produtor.virtualHost

Servidor Virtual Host RabbitMQ para postagem de dados

104promoçãorabbitMQ.promotion.endpointName

Nome da fila RabbitMQ para postagem de dados do tipo de promoção

105promoçãoRabbitMQ.uri

URI de conexão completa rabbitMQ

106promoçãoRabbitMQ.nome de usuário

Usuário para acessar o rabbitMQ

107promoçãoRabbitMQ.virtualHost

Host virtual para rabbitMQ

108promoçãoreportParticipantsfalsoPromoções: Valor global que determina se a promoção reporta participantes
109promoçãoreportParticipantsVisibleverdadeiroDetermina se a opção de participantes do relatório é exibida ou não
110promoçãobancoReembolsoBenefício.método.de.pagamento

ON_ITEMS_PAID = calcular promoções em itens pagos


ON_PAYMENT_MADE = Calcula promoções no pagamento feito

Reembolso bancário: opções de cálculo de reembolso

111promoçãobankRefundBenefit.method.of.payment.onItemsPaid.classcom.synthesis.promo.engine.partialPayment.hardcoded.promotion.BankRefundPartialPaymentGSPromotion

Saque bancário: classe de promoção baseada em itens

112promoçãobankRefundBenefit.method.of.payment.onItemsPaid.namePromoções baseadas em itens - Saque bancário

Retirada bancária: Nome da promoção com base nos itens

113promoçãobankRefundBenefit.method.of.payment.onItemsPaid.tenderMethodPropertyKey

promo.configuration.tenderMethod.itemMethod

Retirada bancária: Propriedade com base nos itens a serem usados

114promoçãobankRefundBenefit.method.of.payment.onPaymentMade.classcom.synthesis.promo.engine.partialPayment.hardcoded.promotion.BankRefundPartialPaymentSSPromotion

Retirada bancária: Classe de promoção baseada em pagamentos

115promoçãobankRefundBenefit.method.of.payment.onPaymentMade.namePromoções baseadas em pagamento - Retirada bancária

Retirada bancária: nome da promoção baseada em pagamentos

116promoçãobankRefundBenefit.method.of.payment.onPaymentMade.tenderMethodPropertyKeypromo.configuration.tenderMethod.paymentMethod

Levantamento bancário: Imóvel com base em pagamentos a utilizar

117promoçãométodo de pagamento

ON_ITEMS_PAID = calcular promoções em itens pagos


ON_PAYMENT_MADE = Calcula promoções no pagamento feito

Promoção codificada: NOTHING, ON_ITEMS_PAID, ON_PAYMENT_MADE
118promoçãotodo.de.pagamento.emItemsPaid.classcom.synthesis.promo.engine.partialPayment.hardcoded.promotion.PartialPaymentsGSPromotionPromoção Codificada: nome da promoção por meio de pagamento por itens.
119promoçãotodo.de.pagamento.emItemsPaid.namePromoções baseadas em itensPromoção Codificada: nome da promoção por meio de pagamento por itens.
120promoçãomethod.of.payment.onItemsPaid.tenderMethodPropertyKeypromo.configuration.tenderMethod.itemMethodPromoção Codificada: nome da promoção por meio de pagamento por itens.
121promoçãotodo.de.pagamento.onPaymentMade.classPagamentos ParciaisSSPromoçãoPromoção Codificada: nome da promoção por meio de pagamento por itens.
122promoçãotodo.de.pagamento.onPaymentMade.namePromoções baseadas em pagamentoPromoção Codificada: nome da promoção por meio de pagamento por itens.
123promoçãomethod.of.payment.onPaymentMade.tenderMethodPropertyKeypromo.configuration.tenderMethod.paymentMethodPromoção Codificada: nome da promoção por meio de pagamento por itens.
124promoçãoldapAuthenticationfalsoDetermina se deve autenticar em um serviço de diretório


125promoçãoldapAuthentication.autheticationModeDIGEST-MD5

É o modo de segurança que autentica, use "DIGEST-MD5" como valor padrão, pois esse modo criptografa as informações no serviço de diretório.

126promoçãoldapAuthentication.urlServer
URL do servidor no qual autenticar.
127promoçãotestEnginePORT3001Simulação: porta na qual o motor funciona para simulação
128promoçãotestEngineRetries2Simulação: novas tentativas de conexão do motor
129promoçãotestEngineSalesPathC:/síntese/promoção/motor/vendas/Simulação: caminho do motor
130promoçãotestEngineTimeout8000Simulação: timeout da conexão do motor
131Redes sociaisfacebook.appId1068803576479010id do aplicativo do facebook
132Redes sociaisfacebook.permissions[publish_actions, manage_pages]Permissões de aplicativos do Facebook
133Redes sociaisfacebook.secretdfa5ffe6aa6306fc49472dbcba3c16a9Chave secreta do aplicativo do Facebook
134Redes sociaisfacebook.segurohttpsProtocolo de conexão segura ao aplicativo do facebook
135Redes sociaistwitter.accessToken2848331890-D2geAfGVL9u2bD6TrD1LxH5fUsXlBnHLa3FOziKtoken de acesso do twitter
136Redes sociaistwitter.accessTokenSecretNHd6JbcoLaBK5QEfrKgmOaQwwxmbwlEtOYlQni3Fx6H3yToken secreto de acesso ao Twitter
137Redes sociaistwitter.consumerKeyHTPKOHdatasoDsm2Ud7ULnUapAKFXoCChave do consumidor do Twitter
138Redes sociaistwitter.consumersecretX1plqdQWK0nRCGz6KFxm37IZTzp4O7w9BjLSspIr4mYWLZsrOySenha secreta do consumidor do Twitter
139promoçãorequestMap.catalog.brand.importationDetail - continueOnErrorverdadeiroPermitir continuar a importação do catálogo da marca em caso de erro
140Elementos de fidelidaderequestMap.catalog.card.importationDetail - continueOnErrorverdadeiroPermitir continuar a importação do catálogo de fichas em caso de erro
141Elementos de fidelidaderequestMap.catalog.card.importationDetail - insertOptionINSERT_OR_UPDATEDescreve a opção de inserção para importação de catálogo de fichas
142promoçãorequestMap.catalog.category.importationDetail - continueOnErrorverdadeiro

Permitir que a importação do catálogo de categorias continue com erro

143promoçãorequestMap.catalog.channel.importationDetail - continueOnErrorverdadeiro

Permitir continuar a importação do catálogo de canais em caso de erro

144promoçãorequestMap.catalog.creditCampaignCode.importationDetail - continueOnErrorverdadeiro

Permitir que a importação do catálogo da empresa de crédito continue com erro

145promoçãorequestMap.catalog.customer.importationDetail - continueOnErrorverdadeiro

Permitir continuar a importação do catálogo do cliente em caso de erro

146promoçãorequestMap.catalog.customerType.importationDetail - continueOnErrorverdadeiro

Permitir continuar a importação do catálogo de tipos de clientes em caso de erro

147promoçãorequestMap.catalog.eventTransaction.importationDetail - continueOnErrorverdadeiro

Permitir que a importação do catálogo de transações continue com erro

148promoçãorequestMap.catalog.eventTransactionType.importationDetail - continueOnErrorverdadeiro

Permitir continuar a importação do catálogo de tipo de transação em caso de erro

149promoçãorequestMap.catalog.family.importationDetail - continueOnErrorverdadeiro

Permitir continuar a importação do catálogo da família em caso de erro

150promoçãorequestMap.catalog.format.importationDetail - continueOnErrorverdadeiro

Permitir continuar a importação do catálogo de formatos em caso de erro

151promoçãorequestMap.catalog.infoFinancial.importationDetail - continueOnErrorverdadeiro

Permitir continuar a importação do catálogo de informações financeiras da lista de preços em caso de erro

152promoçãorequestMap.catalog.item.importationDetail - continueOnErrorverdadeiro

Permitir continuar a importação do catálogo de itens em caso de erro

153promoçãorequestMap.catalog.itemStock.importationDetail - continueOnErrorverdadeiro

Permitir continuar a importação do catálogo de estoque em caso de erro

154promoçãorequestMap.catalog.level1.importationDetail - continueOnErrorverdadeiro

Permitir continuar a importação do catálogo level1 em caso de erro

155promoçãorequestMap.catalog.paymentBank.importationDetail - continueOnErrorverdadeiro

Permitir continuar a importação do catálogo do banco em caso de erro

156promoçãorequestMap.catalog.paymentCode.importationDetail - continueOnErrorverdadeiro

Permitir continuar a importação do catálogo de pagamentos (Código) em caso de erro

157promoçãorequestMap.catalog.paymentPrefix.importationDetail - continueOnErrorverdadeiro

Permitir continuar a importação do catálogo de prefixos em caso de erro

158promoçãorequestMap.catalog.paymentType.importationDetail - continueOnErrorverdadeiro

Permitir continuar a importação do catálogo de tipos de pagamento em caso de erro

159promoçãorequestMap.catalog.profileCode.importationDetail - continueOnErrorverdadeiro

Permitir continuar a importação do catálogo de perfil do cliente em caso de erro

160promoçãorequestMap.catalog.store.importationDetail - continueOnErrorverdadeiro

Permitir continuar a importação do catálogo da loja em caso de erro

161promoçãorequestMap.catalog.storeChain.importationDetail - continueOnErrorverdadeiro

Permitir continuar a importação do catálogo de strings em caso de erro

162promoçãorequestMap.catalog.subCategory.importationDetail - continueOnErrorverdadeiro

Permitir continuar a importação do catálogo de subcategorias em caso de erro

163promoçãorequestMap.catalog.subZone.importationDetail - continueOnErrorverdadeiro

Permitir continuar a importação do catálogo da subzona em caso de erro

164promoçãorequestMap.catalog.supplier.importationDetail - continueOnErrorverdadeiroPermitir continuar a importação do catálogo do fornecedor em caso de erro
165promoçãorequestMap.catalog.zone.importationDetail - continueOnErrorverdadeiro

Permitir que a importação do catálogo de zona continue em caso de erro

166transaçõescleanTransactions90Número de dias que os logs de transações permanecerão no banco de dados
167Lista de preçospriceList.distribution.force.offlinefalso

Habilita a ação de contingência de download em todos os momentos

168Lista de preçospriceList.job.cleanPriceListSchedule.time90Número de dias para manter os itens da lista de preços pendentes de impressão
169Lista de preçospriceList.lockForUpatequinzeMinutos para poder desbloquear a lista Zero no processo de descanso
170Lista de preçospriceList.mongo.bulk.insertOrUpdate200Número de registros a inserir por lote no processo restante
171Lista de preçospriceList.distribution.print.before300

Número de dias para manter os itens da lista de preços futuros processados

172Lista de preçospriceList.requiresActivationfalsoParâmetro a configurar se requer ativação de tabelas de preços
173cuponspromo.benefit.calculatedCoupon.externalAmountexternalAmountAttributeCodeOfitemAddAtributo a ser utilizado na tag item-add para indicar o valor externo do cupom
174promoçãopromo.catálogo.clientevalidarEntidades RelacionadasValidar catálogos relacionados ao catálogo do cliente
175promoçãodistribuiçãoThreadPool

10

Número de threads criados para distribuição simultânea
176promoçãoagendado.ativadofalsoGeração e distribuição programada de mapas
177promoçãoprogramado.filtro.ativarfalso

Filtrar promoções por loja para distribuição programada

178promoçãoched.mapVersionverdadeiro

Incrementar a versão do mapa para lançamento agendado

179promoçãoseparador decimal.Separador decimal, apenas para Tabela de Preços e para PromoLite. Para o resto, é retirado da configuração da máquina.
180

promoção







groupingSeparator







,







Separador de milhares, apenas para Lista de Preços e PromoLite. Para o resto, é retirado da configuração da máquina.

181promoçãodata.UTC.ativadoverdadeiroPropriedade que indica se as conversões de data para o formato UTC estão habilitadas nas interfaces de exportação.
182promoçãoengineLog.FileDirectoryEngine Log: Diretório onde ficarão os arquivos. C:\usuário\mxxxdxxxx\Desktop\ftp
183promoçãotestEngineADDRlocalhost. Simulação: simulação de direção do motor
184promoçãomicrosoft.crm.clientIdID do cliente do Microsoft Dynamics CRMIdeia de cliente do Microsoft Dynamics CRM
185promoçãomicrosoft.crm.clientSecretSegredo do Cliente do Microsoft Dynamics CRMSegredo do Cliente do Microsoft Dynamics CRM
186promoçãomicrosoft.crm.cupom.batch.size1000Quantidade de Cupons a serem enviados por lote para o Microsoft Dynamics CRM (Máximo 1000)
187promoçãomicrosoft.crm.cupom.endpoint/api/data/VxxxPonto de extremidade de cupom do Microsoft Dynamics CRM
188promoçãomicrosoft.crm.coupon.url.batc.create
configurationData.Microsoft.crm.coupon.url.batch.create.promo.export.label
189promoçãomicrosoft.crm.cupom.url.post
URL da carga útil da mensagem de postagem de exportação de cupom do Microsoft Dynamics CRM (enviada na mensagem (web api)).
190promoçãomicrosoft.crm.enabledfalsoHabilita a funcionalidade de exportação para o Microsoft Dynamics CRM
191promoçãomicrosoft.crm.hosthttps://te-xza-pepe.comURL do host do Microsoft Dynamics CRM
192promoçãomicrosoft.crm.tenantId
ID do inquilino do Microsoft Dynamics CRM
193promoçãomicrosoft.crm.urlAuthhttps://login.microsoftonline.com/



Importação de Promoções

PROMO facilita a ferramenta de importação de promoções dentro do console para agilizar os processos de atualização em caso de qualquer atualização de versão ou necessidade de regenerar dados.

Através desta ferramenta, as promoções encontradas em mapas que foram gerados com versões anteriores do console PROMO, bem como aquelas geradas pela mesma versão, mas de outro console, podem ser carregadas massivamente.

Ao clicar no menu “ Importação de Promoções ” “ Administração ” a seguinte tela será apresentada:


Os mapas com as promoções que você deseja importar para, por exemplo, um novo console, devem ser salvos no diretório C:\synthesis\promo\import

Uma vez que os mapas estejam no referido diretório, eles serão exibidos na lista de promoções de importação, mostrando os dados do nome, diretório e data do mapa que está prestes a ser importado.

Ao pressionar o botão " Importar Promoções ", os mapas da lista serão processados ​​e uma mensagem será exibida na tela informando se a operação foi bem-sucedida ou não.



Nota

Ao importar um mapa que contenha Promoções com tipo, subtipo e forma de aplicação, estes campos da promoção serão importados por serem propriedade do mapa.




Os mapas processados ​​podem ser vistos na aba " Resultados ", e para cada um deles o número de promoções importadas com sucesso e o número de promoções que não foram importadas desse mesmo mapa devido a algum erro de conformação.


Ao pressionar " Ver mais " à direita de cada mapa importado, é possível visualizar o nome de cada promoção importada, seu status e, em caso de erro na importação de alguma promoção, a mensagem de erro que deve ser enviado aos especialistas suporte para sua interpretação, juntamente com o mapa que contém a promoção que falhou.


Razões para alterar saldos:

Caso seja necessário efetuar uma alteração no saldo de um elemento desde a consola Promo, será necessário indicar o motivo ou causa que levou a tal alteração, quer se trate de adição ou remoção de saldos.

Primeiramente, será necessário registrar o motivo da alteração de saldo, acessando a seção Administração >> "Motivos de alteração de saldo" e a seguinte tela será apresentada a partir da qual poderão ser gerenciados os diferentes motivos de registro de alterações de saldo.


Ao clicar em "Novo" pode ser gerado um novo motivo, indicando os seguintes dados:


            • Código:  identificador interno do motivo da alteração do saldo, alfanumérico, 3 posições de comprimento.
            • Nome:  Nome do motivo da alteração do saldo, alfanumérico, 10 posições.
            • Descrição:  dados adicionais, opcionais.
            • Ativo:  Verificação a partir da qual será possível indicar se o motivo para se cadastrar está ativo ou inativo.



Uma vez gerados os motivos, ao alterar o saldo de um elemento de fidelização, podem-se selecionar no combo "Motivos" os diferentes motivos de alteração do saldo registado:

Os seguintes dados também serão necessários para identificar corretamente a alteração de saldo no console Promo:


            • Loja:  Loja a partir da qual se efetua a modificação do saldo. As lojas presentes no console Promo serão apresentadas em um combo.
            • Terminal:  Terminal a partir do qual se efetua a modificação do saldo. campo numérico
            • Transação:  Número da transação à qual está associada a alteração de saldo
            • Motivo  O combo será apresentado com os motivos da alteração do saldo cadastrado anteriormente.
            • Valor:   Valor que será adicionado ou subtraído do cartão, Campo Numérico (o valor resultante nunca pode ser menor que zero)


Registros de auditoria


                                             

                                               Esta vista permite consultar os registos de auditoria de dados associados aos diferentes módulos do Promo; onde os detalhes informativos das alterações são indicados 

                                                (criação/edição/exclusão) aplicadas pelos usuários. Ele pode ser acessado através da seção Administração >> "Logs de auditoria"

                                               O PROMO permite que você acompanhe as auditorias filtrando por:

Data de: Data de início da pesquisa. Por padrão, ele indicará 7 dias para trás a partir do dia atual.

Date To: Data final da busca, por padrão indicará o dia atual.

Código: Corresponde ao código do registro referente ao módulo selecionado.

                                               Por exemplo:

                                                 Se for selecionado Módulo -> Cupons, no campo Código você deve indicar o código de um cupom.

                                                Da mesma forma, se o módulo selecionado for Promoções, o código promocional deve ser indicado, por tipo de usuário, dependendo do módulo e da operação ou ação 

                                                feito.

                                             Usuário: Nome do usuário que fez a alteração.

                                             Módulo: Lista de funcionalidades auditáveis ​​em promo.

                                             Operação: Lista de operações realizadas nos registros.

                                             Para a pesquisa e navegação da vista deve ir a Paginado

Botões também foram adicionados:

  • Excel : permite extrair as informações que aparecem na tela, na visualização Registros de Auditoria, em formato .xls, 

    denominado Auditoria.xls, onde serão informados os seguintes dados:

  • Data
  • Papel
  • Do utilizador
  • Módulo
  • Código
  • Ação

                                            


  • Exportação Massiva: permite extrair informações de todos os Registros de Auditoria existentes.

Nesta seção você pode visualizar as ações realizadas pelos diferentes usuários do console de promoções, podendo acessar o detalhe de cada ação através do ícone localizado no final de cada linha. No detalhe você pode ver as Faixas de Prefixos carregados do Tipo de Elementos de fidelidade.




               Detalhes do registro de auditoria

                                           O usuário poderá visualizar todas as informações de cada registro de auditoria pressionando o botão localizado à direita de cada registro na grade de dados. O usuário

                                            exibirá as seguintes informações:


                                             Cabeçalho: Indica os seguintes dados:

                                                                                                           Nome e Sobrenome: do usuário que fez a alteração no registro.

                                                                                                           Operação: ação executada pelo usuário (Inserir, Atualizar ou Remover)

                                                                                                           Data: indica a data e a hora em que a ação foi realizada

                                                                                                           Botões com lista de datas: onde foram aplicadas alterações, esta seção permitirá que você 

                                                                                                            navegar entre versões de alterações feitas em uma data específica.

                                                    

                                             Anterior: Detalhes dos dados antes da ação. 

                                             Real: Detalhes dos dados após a execução da ação.

                                       

                                            


                                           

Información

Para fluxos de trabalho

Quando um fluxo de trabalho é criado, a ação deve aparecer como CREATE e quando for enviada para autorizar a ação será PROCESS. 

Quando a ação for PROCESSAR, o detalhe se o fluxo de trabalho foi aprovado ou rejeitado será mostrado no detalhe em "Etapas".


Propriedades de benefício

A partir desta opção de administração podem ser criados diferentes atributos informativos para cada classe de benefício que será informado no benefício quando este for aplicado.

Está disponível no  menu principal  >> Administração> “Propriedades dos Benefícios”.


Ao selecionar  "Propriedades do Benefício"  será exibida uma tela com esse nome, onde você verá os filtros: "Nome", "Classe do Benefício" e "Status". Abaixo você verá uma lista de Propriedades com as colunas: "Ativo", "Código", "Nome", "Descrição", "Classe de benefício", "Tipo", "É obrigatório". 

Ao inserir "Propriedades do Benefício" ele filtra automaticamente pelo primeiro valor que encontra no filtro "Classe do Benefício". Por exemplo, ele filtrará automaticamente por "Resgate de cupom calculado" por padrão, porque é o primeiro valor que encontra.

À direita dos filtros está o botão Lupa (para iniciar a busca) e o x (para limpar os filtros selecionados). Para realizar outra pesquisa, pressione o x para excluir os filtros, selecione o filtro desejado e, em seguida, o botão Lupa. À direita de cada Propriedade está o botão "Editar".

Como o sistema estará sempre filtrando automaticamente pelos primeiros dados que encontrar, pressionando x continuará realizando esta filtragem automática. Caso queira ver a lista completa sem filtrar pelo campo "Classe de Lucro", você deve selecionar o combo selecionável deste campo e selecionar a primeira opção: "[Classe de Lucro]" e em seguida apertar a lupa.

Abaixo da lista de imóveis à esquerda está o botão "Novo", que abre a tela " Novo imóvel de benefício ", a partir da qual você pode criar um novo imóvel.


Nova propriedade de benefício:


Detalhe dos campos: 

          • "Código": obrigatório, alfanumérico de 200 caracteres.
          • "Nome": obrigatório, alfanumérico de 200 caracteres.
          • "Descrição": não obrigatório, alfanumérico de 500 caracteres.
          • “Tipo de dado”: ​​é obrigatório, combo selecionável, mostra as opções: Número com decimais, Número inteiro, Preenchimento automático por catálogo, Alfanumérico e Verdadeiro/Falso.


          •  Classe de benefício ”: é obrigatório, combo selecionável.
          •  É obrigatório ”: caixa de seleção, para indicar se esta propriedade é obrigatória ou não.
          • “Ativo”: caixa de seleção, para indicar se aquela propriedade está ativa ou não.


Editar Propriedade Perk:

Detalhe dos campos: 

          • "Código": este campo ficará acinzentado e não poderá ser modificado.
          • “Nome”: será editável e é um campo obrigatório.
          • "Descrição": será editável, não é obrigatório.
          • "Tipo de dados": pode ser selecionado em um combo, é obrigatório, mostrará as opções Número com decimais, Número inteiro, Preenchimento automático por catálogo, Alfanumérico e Verdadeiro/Falso.
          •  Classe Beneficente ”: este campo ficará esmaecido e não poderá ser modificado, é obrigatório.
          •  É necessário ”: é um cheque, pode ser ativado ou desativado.
          • “Ativo”: As propriedades do benefício não podem ser excluídas. Eles podem ser ativados ou desativados com esta verificação.


Propriedade do benefício preenchida automaticamente por catálogo

Quando for definido um novo imóvel para um benefício ou editado um já existente, pode-se indicar que este imóvel será auto-preenchido por catálogo, podendo nesse momento indicar se um catálogo existente deve ser reaproveitado ou se um novo catálogo dinâmico deve ser criado ( o formato do novo catálogo que será gerado no caso de usar esta opção será,  catalogbenefit[código de atributo].catalog por exemplo catalogbenefitcolour.catalog)


> Seleção do catálogo:


Aplicação de uma nova propriedade de benefício:

Ao criar uma Nova Promoção, em: "Operação", botão "Nova Promoção", primeiro insira os dados da nova promoção e pressione o botão Salvar. Em seguida, na próxima tela (Definir Promoção), na seção "Benefícios a serem concedidos", selecionando o botão "Novo Benefício" abre-se a  tela "Novo Benefício" . Para carregar os benefícios a serem concedidos nessa promoção. Caso a "Classe de Benefício" selecionada possua uma nova propriedade associada a ela, ao selecionar aquela classe de benefício, neste exemplo: "Resgate de Cupom Calculado", ela mostrará os novos campos sob aquele campo, neste exemplo: "cor  " .



Uma vez salvo o novo benefício da promoção, se você selecionar: Operação > Promoções, botão "Ações", selecionando "Definir". Ele exibirá a nova propriedade do benefício como parte da "Definição principal" do benefício:



Importante

As promoções existentes não são afetadas por alterações nas propriedades de benefícios.

Se uma nova propriedade de um benefício já estiver em uso e estiver desabilitada: ela é mantida nas promoções que a utilizam até o momento de salvar uma edição do benefício que a continha.



atributos do elemento

Esta opção permite gerir desde a  consola PROMO  os atributos de todos os elementos disponíveis ao registar promoções desde a consola PROMO.


IMPORTANTE

A administração dos Atributos Dinâmicos é feita entrando no console MAIN PROMO com o Usuário Principal .

A partir daí, novos atributos podem ser cadastrados para todas as empresas presentes no console.

O " Element Attribute Management " poderá ser habilitado para uma empresa, somente quando esta não compartilhar a instalação do Promo com outra empresa no mesmo servidor .

Se o Usuário Principal ativar o "Gerenciamento de Atributos do Elemento", o usuário com a função para a qual as permissões foram atribuídas poderá ver e gerenciar os "Atributos do Elemento" no console Promo no menu Administração.


O usuário com função habilitada para gerenciamento de atributos do elemento poderá definir e/ou editar novos atributos para todos os elementos presentes no Promo. Os próprios atributos da promoção não podem ser editados.


Novo atributo:

Quando pretender registar um novo atributo para algum dos elementos Promo, deverá clicar no botão "Novo" e será apresentado o seguinte ecrã:


Quando o cadastro de uma promoção for processado após o cadastramento ou edição de um atributo dinâmico que seja obrigatório, caso este atributo não seja carregado para a promoção ele será mostrado como incompleto e ao posicionar na legenda "Incompleto" a mensagem deverá ser exibida indicando qual atributo é necessário para concluir a promoção.


            • Registro manual

No menu Administração >> Importar, após cadastrar um novo atributo, será exibida uma nova opção que permitirá selecionar e processar um catálogo que associará dados ao atributo recém-gerado.

Aqui, como exemplo, o novo atributo "cor" será registrado.


O arquivo "catalogColor.catalog" deve ser processado clicando no botão "Importar".

Os detalhes do catálogo processado podem ser visualizados clicando na "lupa" que aparece à direita, no final da linha.


            • Adicionar via Job > "Importação de catálogo" ( sts.console.job.CatalogJob )


O catálogo associado a um novo atributo pode ser processado através do processo  " Importação de Catálogo" ( sts.console.job.CatalogJob ) . Para isso, será necessário definir, desde a empresa na qual você está logado, o caminho de onde devem ser retirados os arquivos .catalog para serem processados.

Isso é feito em Administração >> Informações de configuração. Por padrão, o caminho definido será C:/synthesis/promo/catalogs/"company"

O caminho padrão pode ser usado ou editado e colocado lá o caminho onde serão armazenados os arquivos .catalog a serem processados.

O processo será executado a cada determinado período de tempo e procurará nesse diretório por quaisquer arquivos .catalog deixados lá e os processará. Os novos catálogos que correspondem a novos atributos devem ser processados ​​da mesma forma que os catálogos atuais.


Geração, distribuição e download do arquivo de definição de novos atributos:

Quando pelo menos um novo atributo tiver sido cadastrado para um dos elementos do console, o botão " Baixar arquivo de definição " será habilitado.

Este arquivo conterá a definição de todos os novos atributos cadastrados até aquele momento.

Também será possível a partir desta janela distribuir o arquivo de definição "entities.xml" aos motores conectados ao console quando qualquer modificação tiver sido feita em algum dos novos atributos, clicando no botão "Distribuir arquivo de definição " .

Para que os engines aceitem corretamente as alterações no arquivo "entities.xml", será necessário reiniciá-los.

Uma vez concluído o processo de distribuição ou download, a mensagem verde usual será exibida indicando que a operação foi concluída com sucesso. Caso contrário, ele relatará o erro no pop-up vermelho usual e registrará a mensagem de erro no log do console, fornecendo detalhes do que aconteceu.


Importante

Botão Distribuir arquivo de definição : Este botão será habilitado quando qualquer um dos atributos dinâmicos cadastrados for editado. Pressioná-lo distribui o arquivo entity.xml para todos os motores conectados ao console a partir do qual a distribuição é feita.


Validação de atributo entre elementos:

Pode-se definir que ao cadastrar uma promoção, ao inserir uma condição para o elemento “ produto ”, atributo “ SKU ”, valida-se que na estrutura desta, é definido outro atributo, portanto ao inserir como condição, o “ SKU-Code" exigirá a entrada do(s) atributo(s) associado(s), bem como a validação de que o(s) atributo(s) associado(s) está(ão) definido(s) na estrutura do "SKU-Code". Para que o Promo realize essa validação, as seguintes configurações devem ser feitas:

            • Em Administration \ Configuration Information , procure a palavra-chave " attribute ", para a chave: " attribute.relationship.validation.required " atribua o valor " true ".
            • Em Administração \ Atributos do elemento , crie o(s) atributo(s) que deseja relacionar ao elemento "SKU-Code".
            • Em Administração \ Atributos do elemento, procure o atributo "SKU-Code", selecione o botão Editar na empresa correspondente e no campo " Validates against Attribute ", selecione o atributo ou atributos contra os quais deseja validar o "SKU-Code ". SKU"


Quando um dos atributos do elemento produto for selecionado, a validação do código (SKU) será configurada contra o(s) atributo(s) indicado(s) no campo " Válido contra atributo ".

Ao pressionar editar, no atributo "Código - SKU", será exibida a seguinte tela:

            • Ao cadastrar uma  condição simples  ou  de composição , através do elemento " Produto ", será validado que o sku informado possui o(s) atributo(s) a ele relacionado definido em sua estrutura. A promoção não é considerada completa até que o(s) atributo(s) relacionado(s) tenha(m) sido definido(s).

              Caso os dados inseridos no(s) atributo(s) relacionado(s) não correspondam ao "SKU-Code" inserido, será exibida a mensagem "O valor "levelX" inserido não corresponde ao definido em "levelY " onde LevelX e LevelY são os atributos definidos para validação interna. Ou seja, LevelX deve existir dentro da definição do item que foi definido no atributo LevelY.

            • Obs .: Deve-se selecionar a linha de definição do Código (SKU) e em seguida adicionar a condição do atributo relacionado para que a validação do conjunto seja realizada corretamente.



IMPORTANTE

Tanto o Código do Elemento (SKU) quanto o atributo relacionado devem ser carregados por catálogo.

O catálogo de itens contendo atributos dinâmicos utilizados nesta validação deve ser carregado via Rest Service ou Rabbit MQ Queue para que a validação seja realizada corretamente (Ver Promo - Manual de Integração - Serviços)




Tipo de Promoções

A partir da tela " Gerenciamento do Tipo de Promoção " localizada no menu Administração, você pode criar um novo Tipo de Promoção, editá-lo e ver  as Promoções Associadas  a esse tipo.

A tela terá os seguintes filtros:

              • Código : Você pode filtrar pelo código do tipo de promoções.
              • Nome : Você pode filtrar pelo Nome do tipo de promoção.
              • Status:  Você pode filtrar pelo status do tipo de promoções Ativas/Inativas

As colunas que serão apresentadas na tela serão:

              • Código
              • Nome
              • Descrição
              • Valor padrão
              • Estado

Haverá um  botão "Novo",  a partir do qual se acessará a tela  " Novo tipo de promoções " e poderão ser cadastrados novos tipos de promoções.

Para cadastrar um novo tipo de promoção, os seguintes campos devem ser preenchidos:

              • Código:  Código de identificação único do tipo de promoções. 
              • Nome:  Nome de identificação único do tipo de promoções.
              • Descrição:  Detalhes ou observações do tipo de promoções.
              • Por padrão : Se esta verificação estiver ativada, indicará que este será o tipo de promoção atribuída automaticamente ao registrar uma promoção.
              • Ativo:  Indicará se o tipo de promoções estará ativo ou não para ser associado a uma promoção.




NOTA

Sempre haverá apenas um tipo de promoção por padrão, esta será "Geral" até que o operador cadastre um novo tipo de promoção com a verificação "padrão" ativa.



Pressionar  "Salvar" adicionará uma nova linha com o tipo de promoção recém-criado  à grade da tela " Gerenciar tipos de promoções ". Se  for pressionado "Cancelar"  nenhum dado será registrado no banco de dados e a tela " Gerenciamento de tipos de promoções " retornará sem nenhuma alteração.


Na tela "Gerenciamento de tipos de promoção" haverá o botão " Ações " a partir do qual você pode:

              • Edite  um tipo de promoção. Ao clicar em Editar, será exibida a tela "Editar Tipo de Promoções", onde você poderá modificar o nome, a descrição e o status de um tipo de promoção. Um tipo de promoção pode ser editado, desde que não esteja associado a uma promoção distribuída. O campo de código não será editável. 
              • Ver  Promoções Associadas  ao tipo de promoções selecionadas. Ao selecioná-lo, a tela será redirecionada para a  seção Relatórios  >> " Promoções/Mapas " >>  "promoções".   Ali serão mostradas as promoções associadas ao tipo de promoção selecionado, sem discriminar por  sub-Tipo de promoção , os filtros não podem ser editados. O relatório pode ser baixado em Excel.

Caso o Tipo de Promoção não esteja associado a nenhuma promoção, a opção " Promoções Associadas " do menu  <Ações>  ficará desabilitada.



Subtipo de promoções

Ao selecionar " Sub-tipos de promoções " será apresentado o ecrã " Gestão de Sub-tipos de promoções " .

A tela terá os seguintes filtros:

              • Código : Você pode filtrar pelo código do subtipo de promoções.
              • Nome : Você pode filtrar pelo Nome do subtipo de promoções.
              • Tipo de Promoção:  Você pode filtrar entre os tipos de promoções ativas, sejam elas associadas ou não a um subtipo de promoção.
              • Status:  Você pode filtrar pelo status do subtipo de promoções Ativas/Inativas.

As colunas que serão apresentadas na tela serão:

              • Código
              • Nome
              • Tipo de Promoção
              • Estado

Haverá um  botão "Novo",  a partir do qual será acessada a tela " Novo subtipo de Promoções " e poderão ser cadastrados novos subtipos de promoções. 

Quando um subtipo de promoção é registrado, o valor indicado por padrão será exibido por padrão no campo "tipo de promoção".

Aqui também será possível indicar se o valor definido para o subtipo de promoção será o valor padrão que será exibido automaticamente ao cadastrar uma promoção.

Para cadastrar um novo subtipo de promoções, os seguintes campos devem ser preenchidos:

              • Code:  Código de identificação único do subtipo de promoções
              • Nome:  Nome de identificação exclusivo do subtipo de promoções
              • Descrição:  Detalhes ou observações do subtipo de promoções.
              • Tipo de Promoção:  Pode-se indicar por meio de um combo a qual Tipo de Promoção será associado o subtipo de promoção que está sendo cadastrado.
              • Valor padrão:  Se esta verificação estiver ativada, estará indicando que se o usuário não selecionar o subtipo de promoção ao criar a promoção, esta opção será exibida por padrão.
              • Active:  Indicará se o subtipo de promoção estará ativo ou não será associado a uma promoção.



NOTA

Sempre haverá apenas um subtipo de promoção por padrão por tipo de promoção, até que o operador cadastre um novo subtipo de promoção com a verificação "padrão" ativa.



Ao clicar em  "Salvar",  o subtipo de promoção recém-criado será exibido na grade da tela " Gerenciamento  de subtipo de promoção " .

No  botão Ações  , você pode:

              • Editar  um Subtipo de Promoção: Ao clicar em Editar, será exibida a tela "Editar Subtipo de Promoção", onde você poderá modificar o nome, a descrição e o status de um Subtipo de promoção. Um subtipo de promoção pode ser editado, desde que não esteja associado a uma promoção distribuída. O campo de código não será editável. 
              • Desativar  um Subtipo de Promoção: Subtipos de promoção inativos não estarão disponíveis para serem associados em promoções.
              • Ver  Promoções Associadas  ao subtipo de promoções selecionado. Ao selecioná-lo, a tela será redirecionada para a  seção Relatórios  >> " Promoções/Mapas " >>  "promoções".  Lá serão exibidas as promoções associadas ao subtipo de promoção selecionado, sem discriminar por tipo de promoção, os filtros não podem ser editados. O relatório pode ser baixado em Excel.

Caso o Subtipo Promoção não esteja associado a nenhuma promoção, a opção " Promoções Associadas " do menu  <Ações>  ficará desabilitada.



Formas de aplicação de promoções

Ao clicar em " Formulário de Inscrição de Promoção " será exibida a tela " Gerenciamento  de Formulário de Inscrição " .

A tela terá os seguintes filtros:

              • Código : Você pode filtrar pelo código do formulário de solicitação da promoção.
              • Nome : Você pode filtrar pelo Nome do formulário de inscrição da promoção.
              • Tipo de Promoção:  Você pode filtrar entre os tipos de promoções ativas, sejam elas associadas ou não a um subtipo de promoção.
              • Subtipo de Promoção:  Você pode filtrar entre os subtipos de promoção ativos que pertencem ao Tipo de Promoção selecionado no combo anterior.
              • Status:  você pode filtrar pelo status do formulário de inscrição de promoção Ativo/Inativo.

As colunas que serão apresentadas na tela serão:

              • Código
              • Nome
              • Tipo de Promoção
              • Subtipo de Promoção
              • Estado

Haverá um  botão “Novo”,  a partir do qual você acessará a tela “ Nova Forma de Aplicação de Promoções ” e poderá cadastrar uma nova forma de aplicação de promoções. 

Quando um formulário de inscrição é registrado, os valores indicados por padrão serão exibidos por padrão nos campos "tipo de promoção" e "Sub-tipo de promoção".

Aqui também será possível indicar se o valor definido para o formulário de inscrição será o valor padrão que será exibido automaticamente ao cadastrar uma promoção.

Para cadastrar uma nova forma de aplicação de promoções, os seguintes campos devem ser preenchidos:

              • Código:  Código de identificação único para a forma de aplicação das promoções
              • Nome:  nome de identificação exclusivo do formulário de inscrição da promoção
              • Descrição:  Detalhes ou observações da forma de aplicação das promoções.
              • Tipo de Promoção:  Poderá ser indicado por meio de um combo a qual Tipo de Promoção será associado o tipo de aplicativo de promoção que está sendo cadastrado.
              • Subtipo de promoção:  Se esta verificação for ativada, será indicado que esta será a forma de aplicação da promoção atribuída automaticamente no momento do registro de uma promoção, que dependerá do Subtipo de promoção selecionado por padrão
              • Por padrão:  Se esta verificação estiver ativada, estará indicando que se o usuário não selecionar o Formulário de Solicitação de Promoção ao criar a promoção, esta opção será exibida por padrão.
              • Ativo:  Será indicado se o formulário de solicitação de promoção estará ativo ou não para ser associado a uma promoção.





NOTA

Sempre haverá apenas uma forma de aplicar a promoção por padrão por subtipo de promoção, até que a operadora cadastre uma nova forma de aplicá-la com a caixa "padrão" ativa.




Ao clicar em  "Salvar"  o formulário de solicitação de promoção recém-criado será exibido na grade da tela " Gestão  de Formulários de Solicitação de Promoção " .

No  botão Ações  , você pode:

              • Editar  formulário de solicitação de promoção: Ao clicar em Editar, será exibida a tela " Editar formulário de solicitação de promoção ", onde você poderá modificar o nome, a descrição e o status de um formulário de solicitação de promoção. O formulário de candidatura a uma promoção pode ser editado, desde que não esteja associado a uma promoção, se tentar desactivar será apresentada uma mensagem de erro a informar que não é possível desactivar. O campo de código não será editável. 
              • Desativar  um formulário de inscrição de promoção: Os formulários de inscrição de promoção inativos não estarão disponíveis para serem associados em promoções.
              • Consulte  Promoções Associadas  ao formulário de inscrição da promoção selecionada. Ao selecioná-lo, a tela será redirecionada para a  seção Relatórios  >> " Promoções/Mapas " >>  "promoções".  Lá serão mostradas as promoções associadas ao formulário de solicitação da promoção selecionada, sem discriminar por Tipo ou Sub-Tipo de promoção, os filtros não podem ser editados. O relatório pode ser baixado em Excel.

Se o formulário de candidatura à Promoção não estiver associado a nenhuma promoção, a opção " Promoções Associadas " do menu  <Acções>  ficará desactivada.


Modelos de mapa

A opção " Modelos de Mapa" estará disponível no  Menu Opções , dentro de  <Administração> , a partir da qual poderão ser definidos os modelos, utilizando os tipos, subtipos e forma de aplicação das promoções previamente cadastradas. Este modelo deve ser selecionado ao distribuir um mapa. 

Clicar em " Modelos de mapa " exibirá a tela " Gerenciamento de modelos de mapa ".



Ao clicar em  "Novo"  será exibida a tela " Novo Modelo de Mapa " onde será definido o  Código  e  o Nome  do modelo e a forma como a  sugestão irá operar  nos mapas gerados a partir desse modelo.


No caso de  editar  um modelo de mapa existente, o código não pode ser alterado.

Ao pressionar  " Salvar",  você irá para a tela " Definir modelo de mapa ". Se for pressionada a tecla " Cancelar ", retornará à  tela "Gerenciamento de modelo de mapa ", sem ter salvado nenhuma alteração.


Na  tela Definir Modelo de Mapa  ,  serão apresentadas as Formas de Aplicação de promoções definidas anteriormente  e devem poder ser arrastadas para montar a estrutura de etapas e funções de convivência, para posteriormente adicionar as formas de aplicação de promoções que foram definidas. 

Os passos serão arrastados primeiro e depois as funções de coexistência. Em seguida, os Formulários de Solicitação de Promoção serão adicionados de acordo com a ordem em que devem ser avaliados.

Enquanto o template não tiver pelo menos uma etapa, uma função de coexistência e um subtipo de promoção, ele não será "Completo" e não poderá ser utilizado para gerar um mapa a partir dele.


Definindo um template de mapa será possível continuar a partir daí com a geração do mapa a partir do template que está sendo cadastrado.

Quando o modelo de mapa estiver no status " Concluído ", o botão " Gerar mapa " será habilitado .

Ao pressionar o botão " Gerar Mapa ", você irá para a tela " Publicação de Mapa (POS) ". 

Se o Modelo de Mapa estiver  "Incompleto" a  opção " Gerar Mapa " será desativada.


PopUp do resumo de um modelo de mapa.


Uma vez definido o modelo, você pode pressionar " Retornar " para retornar à tela " Gerenciamento de modelo de mapa " e visualizar o modelo recém-criado na grade.

Um máximo de 25 linhas de grade serão exibidas na tela. Se houver mais de 25 linhas a serem exibidas, a paginação será habilitada.


Distribuição de mapa agendada

O processo de distribuição específico e agendado permitirá e configurará desde a consola Promo a possibilidade de gerar os mapas e distribuí-los à loja ou lojas correspondentes de forma automática.


Pré-condições do Processo:

            • Os mapas serão distribuídos automaticamente apenas para as lojas que tiverem pelo menos um motor associado e a distribuição estiver definida como AUTO.

            • Na construção automática de mapas, serão consideradas apenas as promoções com status "COMPLETO".
            • Para o processo, será utilizado o último modelo de mapa editado em estado completo e ativo.


Processo de distribuição do mapa


              1. Ao iniciar o Trabalho de Geração e Distribuição Agendada de Mapas, buscará as lojas definidas na empresa e os mapas serão distribuídos apenas para as lojas que estiverem ativas, com tipo de conexão AUTO e pelo menos um motor associado.
            1. Em seguida, o processo irá procurar o último modelo de mapa editado no estado COMPLETO.
            2. Concluídas as etapas 1 e 2 com sucesso, as promoções Completas e Atuais serão adicionadas ao template do mapa, tomando como referência a definição de “transação” que cada promoção possui, e assim agrupar por mapa, as promoções que se aplicam a cada promoção. cada uma das lojas. As promoções que não tiverem condição de "transação" definida serão distribuídas para todas as lojas. A ordem das promoções dentro do mapa dependerá da estrutura de etapas, tipos, subtipos e formas de aplicação fornecidas no modelo de mapa.
            3. Assim que os mapas completos de cada uma das lojas estiverem disponíveis, os .xml são distribuídos.


NOTA

Caso duas lojas tenham o mesmo motor associado, o mapa gerado através deste processo conterá as promoções que se aplicam a ambas as lojas.

O processo, por padrão, será executado diariamente às 00:00:00 hrs.


IMPORTANTE

Os atributos do elemento "Transação" considerados para a construção de um mapa serão os padrões (zona, subzona, canal, cadeia). Os atributos dinâmicos que podem ser adicionados ao elemento Transaction não serão levados em consideração para este processo.


Atributos do grupo

A partir da consola Promo será possível gerir a forma como os atributos dos elementos são apresentados na consola ao definir as condições de uma promoção.

Para isso, você deve acessar a seção " Administração ", " Atributos do grupo " e a tela " Atributos do grupo " será exibida.

Lá você pode cadastrar os diferentes grupos que conterão os atributos selecionados para cada elemento.


Adicionar novo grupo de atributos

Para gerar um novo grupo de atributos, clique em " Novo " e a tela " Novo Grupo de Atributos " será exibida.


Nesta tela, você deve indicar:

          • Código : campo alfanumérico, deve-se indicar o código único que identificará o grupo de atributos que está sendo cadastrado.
          • Nome : campo alfanumérico, deve-se indicar o nome único que identificará o grupo de atributos que está sendo cadastrado.
          • Elemento : Um dos elementos pelos quais uma condição é definida deve ser indicado no combo.



            Ao selecionar qualquer um dos elementos, os atributos disponíveis serão exibidos abaixo, criando um grupo de atributos.

            Exemplo: Se for selecionado " Produtos ", a seguinte tela será exibida:


            Se algum dos atributos do elemento selecionado não for exibido na lista, pode ser porque já está atribuído a algum outro grupo. O mesmo atributo não pode pertencer a dois grupos de atributos simultaneamente.

Após selecionar os atributos a serem adicionados ao novo grupo de atributos, você pode clicar em " Salvar ", e o agrupamento criado será exibido na tela " Atributos do Grupo " .

À direita de cada grupo de atributos, será exibido o botão " Ações " a partir do qual os grupos de atributos existentes poderão ser editados ou excluídos.


Ao definir uma promoção, para qualquer um dos atributos que foram incorporados a um grupo de atributos, estes serão vistos da seguinte forma:



GRUPO DE PREFIXOS

Ao entrar na seção " Grupos  de Prefixos ", será exibida a tela " Gerenciamento de Grupos  de Prefixos " , onde serão listados todos os grupos cadastrados. A partir daí você pode consultar, editar e criar grupos de prefixos.

Filtros propostos:

              • Código:  Grupos de prefixos podem ser pesquisados ​​por seu código. 
              • Nome:  você pode pesquisar grupos de prefixos por nome. 
              • Número de prefixos : será possível pesquisar com base em uma faixa de prefixos, quais grupos o contêm.
              • Status:  você pode filtrar entre grupos de prefixos ativos ou não ativos.

O  botão "Ações"  terá as  opções "Editar", "Resumo"  e " Promoções Associadas "



Ao clicar em " Editar " aparecerá a tela " Edição de Grupo de Prefixos ", onde você poderá editar faixas de prefixos, alterar o nome ou desativar o grupo. O código do grupo de prefixos não pode ser editado.


Ao clicar em " Sumário " será exibido um pop-up com o resumo do grupo de prefixos selecionado.


Clicar em " Promoções Associadas " direcionará o console para a tela de relatório de Promoções onde serão exibidas apenas as promoções atuais e ativas que contenham o grupo de prefixos selecionado entre suas condições.


Registro de um novo grupo de prefixos

Ao clicar no  botão "Novo"  será exibida a tela " Novo grupo de prefixos " .


Lá deve ser indicado:

              • Código : Será o código identificador do grupo de prefixos que está sendo cadastrado. O código será alfanumérico  (Promo Bridge, Numérico)  para entrada manual e deve ser validado que o código não foi cadastrado anteriormente.
              • Nome:  Será o nome que representa o grupo de prefixos que está sendo cadastrado. O nome será alfanumérico.
              • Descrição : Você pode inserir algum detalhe ou informação adicional do grupo de prefixos que está sendo criado.
              • Botão " Adicionar Prefixos":  No popup que é exibido, é possível definir manualmente as faixas de prefixos que farão parte do grupo de prefixos que estão sendo cadastrados. Deve ser validado que o número inserido para identificar um prefixo não é inferior a 6 posições nem superior a 9 posições. (Limitações por configuração).




            • Botão "Selecionar arquivo": Os grupos de prefixos podem ser registrados de forma massiva importando um arquivo que contém a referida definição. Quando um arquivo contendo intervalos de prefixos for importado, os dados antigos serão substituídos pelos novos intervalos de prefixos importados. Os intervalos de prefixos podem ser editados manualmente após serem importados (remova o intervalo de prefixos importados ou adicione novos). Caso a quantidade de dados importados ultrapasse o máximo permitido para edição manual, será exibida a mensagem informando que caso haja erro no upload, o arquivo deverá ser recarregado com as devidas correções. Os possíveis formatos de importação de arquivos serão excel (.xlsx), onde as faixas de prefixos serão definidas uma abaixo da outra, e os prefixos separados por um hífen ( - ); e texto (.txt), onde os intervalos de prefixo serão separados por vírgulas ( , ) e os prefixos serão separados por um hífen ( - ). O comprimento dos prefixos também deve ser validado quando eles são carregados por arquivo.

            • Ativo:  Indicará se o grupo de prefixos em cadastro estará ativo ou não. Por padrão, os grupos de prefixos serão registrados como "Ativos".


Deve-se validar que ao pressionar  "Salvar",  o grupo de prefixos contém pelo menos um intervalo de prefixo válido definido.

A mesma faixa de prefixos poderá estar presente em mais de um grupo de prefixos.


Edição de grupos de prefixos

Quando um grupo de prefixos for editado, o botão " Baixar Prefixos " será exibido; pressioná-lo fará o download de um arquivo contendo a definição da faixa de prefixo atual do grupo selecionado, para que o operador possa editá-lo e recarregá-lo, se necessário.

O código do grupo não pode ser editado.

Caso pretenda desactivar um grupo de prefixos, deverá validar que o grupo não se encontra na definição de condições de nenhuma promoção activa. Caso um grupo de prefixos esteja dentro das condições de uma promoção ativa, será exibido um pop-up indicando  "O grupo de prefixos não pode ser desativado, pois está associado a promoções ativas. Desvincule os grupos de prefixos das promoções que os contêm e tente novamente".



Deve-se validar que ao pressionar  "Salvar",  o grupo de prefixos contém pelo menos um prefixo válido definido.


DEFINIÇÃO DE PROMOÇÃO POR "GRUPO DE PREFIXOS"

Quando pretender definir uma promoção através de " Grupos de Prefixos " deverá selecionar o elemento " Meio de Pagamento " e o atributo  "Grupo de Prefixos"

Pode ser selecionado entre os  comparadores "Mesmo"  ou  "Diferentes"


No pop-up de definição " Grupos de prefixos ", você pode inserir os grupos por nome ou por código, e eles serão preenchidos automaticamente com os grupos de prefixos que estão cadastrados no console e correspondem ao que está sendo escrito. Assim que o grupo de prefixo for selecionado, o código do grupo de prefixo será adicionado ao pop-up.

O atributo " Grupos de Prefixos " estará disponível para a definição de condições simples e por composição.

Você só pode definir grupos de prefixos que foram registrados no console.


GERAÇÃO DE MAPAS >> PROMOÇÕES COM CONDIÇÃO DEFINIDA POR "GRUPO DE PREFIXOS"

As promoções que contenham entre suas condições " Grupos de Prefixos " poderão ser incluídas em qualquer etapa e função de convivência do mapa.


CONSULTA E AVALIAÇÃO DE "GRUPO DE PREFIXOS"

Somente o atributo "Prefixo" será recebido do PDV no elemento <payment/>

A engine avaliará a qual grupo de prefixos pertence o prefixo informado pelo PDV no pagamento; e informará ao PDV. O TPV deverá reinjectá-lo na mensageria, de forma a poder consultar as promoções que se aplicam aos grupos de prefixos a que pertence o prefixo consultado.

O atributo "Grupo de prefixos" deve poder avaliar lista de atributos, pois um mesmo prefixo pode pertencer a vários grupos de prefixos.

Quando uma alteração é feita em um grupo de prefixo, o console Promo deve distribuir notícias sobre os grupos atualizados para os mecanismos.



atributos de cabeçalho

Esta opção permite adicionar novos campos informativos ao nível do cabeçalho da promoção, que podem ser carregados como texto livre ou por catálogo.

Selecionar Administração\Headend Attributes exibirá a tela " Headend Attribute Management ".

A partir daí você pode gerenciar os campos de informação que deseja adicionar ao cabeçalho da promoção.

Até 20 novos campos podem ser definidos no cabeçalho. Por padrão, os 20 campos estarão inativos e não serão exibidos no cabeçalho das promoções. 


Quando pressionado para qualquer um dos campos, o botão " Editar " exibirá a tela " Editar Atributos do Cabeçalho ".

Lá você pode indicar o nome a ser exibido no campo, o tipo de dado que será aceito, se é obrigatório (ou seja, se será obrigatório carregá-lo) e pode ser ativado.


No campo "Tipo", você deve selecionar o tipo de dados que este campo terá, as opções serão: "Preenchimento automático por catálogo" e "Texto".


Se a marca "Ativar" foi colocada e as alterações foram salvas; Ao criar uma nova promoção , ou ao editar o header de uma promoção existente, na seção "Header Attributes" da promoção serão mostrados os atributos ativos:

Ao lado do nome do atributo, mostrará um * se a verificação "É obrigatório" foi ativada ao criar o atributo. Neste caso, este campo deve ser preenchido para salvar o cabeçalho da promoção e continuar. Caso essa verificação não tenha sido ativada, será opcional o preenchimento desse campo.

Se o tipo de dado selecionado para o atributo for do tipo "Texto", poderá ser inserido texto livre. Se "Autocompletar por catálogo" foi selecionado quando você começou a digitar nesse campo, ele sugerirá de acordo com o conteúdo do catálogo carregado anteriormente.


Para poder usar o tipo de dados "Preenchimento automático por catálogo", você deve executar as seguintes etapas:

Selecione Administração \ Importação de Catálogo

Na tela "Importação de catálogo", será exibida uma linha referente a cada um dos atributos do cabeçalho. Por exemplo: o atributo do cabeçalho com o código "campo00" será relacionado à linha "Campo adicional 0 do cabeçalho da promoção". O formato e as etapas para importar são detalhados na seção Importando Catálogos. 


Nota:

Uma vez ativado o atributo de cabeçalho desejado, ao criar ou editar uma promoção , ele exibirá o atributo como parte do cabeçalho da promoção na tela "Definir promoção" e também no resumo da promoção.





Capítulo 13 - Módulo de Segurança


Menu de segurança


A partir desta opção de menu, você pode atribuir acesso às funções disponíveis e gerenciar os usuários.




Gerenciamento de usuários

Dentro deste módulo você pode configurar cada um dos usuários fornecidos por PROMO por padrão, bem como a criação de novos usuários.

Você pode configurar: nome, senha, autorização, políticas de segurança e atribuir funções para cada um dos usuários.

A partir do menu Segurança > Administração de Usuários, acessa-se a seguinte tela:

 

A partir do botão "Ações" localizado no final de cada linha que descreve um usuário, pode-se editar o perfil do usuário ou alterar a senha.

Novos usuários poderão se registrar pressionando o botão "Novo" . A seguinte tela será apresentada:

                • Username: será o login do usuário para acessar o console.
                • Senha: Será a senha que deverá ser digitada para acessar o console. Uma senha deve ter entre 6 e 16 caracteres e conter pelo menos uma letra minúscula, uma letra maiúscula e um número.
                • Confirmar senha: repita a senha digitada no passo anterior.
                • Nome e Sobrenome : O nome real e sobrenome do usuário que está se registrando deve ser indicado.
                • E-mail: Você pode inserir um e-mail válido para o usuário que está se registrando.
                • Expiração de senha : aqui você pode indicar se a senha expira após um determinado período de tempo, configurável, contado a partir da primeira vez que você acessou o console.
                • Ele bloqueia sem atividade?  : Indica se o usuário está bloqueado após um determinado período de tempo configurável, devendo então efetuar login novamente.
                • Você deve alterar a senha? : Indica se o usuário deve alterar a senha no primeiro login no console.
                • Habilitado: deve ser marcado para que o usuário que está sendo criado possa acessar o console PROMO.
                • Desativar a partir de : pode ser indicado aqui a partir de que data o usuário não poderá mais acessar o console PROMO.
                • Funções disponíveis: uma das seguintes funções disponíveis pode ser atribuída:
                • Administrador - Tem acesso e permissões a todos os módulos de console adquiridos.
                • Operador : você pode ver promoções, mapas, cupons. (O acesso para criar, editar e definir promoções e benefícios deve ser habilitado para que o perfil do operador possa realizar estas ações - Entre em contato com o administrador.)
                • Administrador de negócios : você poderá acessar o módulo de negócios e relatórios.
                • TicketSender:  usuário exclusivo de comunicação Engine <> PROMO Console.
                • Associação a Workflows: Podem ser atribuídos os Workflows aos quais o utilizador terá acesso.
                • Lojas disponíveis : À esquerda mostrará as lojas disponíveis e à direita refletirá as lojas que o usuário que está registrando ou editando terá associado. O usuário administrador (que está criando ou modificando) poderá atribuir ou desatribuir lojas, o que será visto à direita.

                   

                                                                                          

                                                                                 



NOTA

Os parâmetros de configuração do usuário e da política de segurança podem ser editados em "Administração" > "Informações de configuração". Para maiores detalhes consulte o Manual de Instalação, seção "Informações de Configuração".

                                                             

Também nesta seção você pode redefinir as senhas dos usuários presentes no console.

A partir do botão Ações, localizado à direita de cada usuário na tela "Administração de Usuários", será possível acessar a opção "Alterar Senha" e a seguinte tela será exibida:


Para a definição da nova senha, devem ser consideradas as políticas de segurança que regem a senha (Alfanumérico, mínimo estabelecido, mínimo um número e uma letra maiúscula, etc.)



Configuração de função


Ao selecionar Segurança/Configuração de Função, as permissões podem ser atribuídas para as diferentes Funções de Usuário. O usuário principal poderá criar novas funções a partir desta tela (consulte o Manual do Usuário Principal). Dependendo das permissões da função que está sendo usada, você pode ou não acessar esta tela. Por exemplo, o usuário administrador verá uma tela como a seguinte:



Configuração de acesso:

Ao selecionar " Configuração de acesso " será exibida uma tela como a seguinte: 


Na  seção "Detalhes da função",  mostrará o código, a descrição e as permissões de edição da função selecionada.

Quando você está logado em uma empresa, você só pode alterar as permissões dessa empresa na qual você está logado e se tiver permissão para isso. O usuário principal poderá alterar as permissões de uma função para várias empresas (consulte o Manual do Usuário Principal).


Na  seção "Permissões atribuídas" mostrará o campo de busca "Permissão" e os combos selecionáveis: "Categoria" e "Subcategoria". Conforme você digita no campo "Permissão", o sistema irá mostrar abaixo uma lista com as permissões com aquele nome. Se você deseja limpar a pesquisa de Permissões digitada para realizar outra, pode pressionar o X à direita no campo de pesquisa "Permissão". Se for selecionada uma Categoria, no campo Subcategoria mostrará aquelas contidas na categoria selecionada e na lista mostrará apenas as autorizações contidas naquela Categoria e/ou Subcategoria. À direita de cada permissão, você encontrará uma seleção selecionável para habilitar ou desabilitar cada permissão. Na parte superior da coluna onde as verificações são exibidas, a verificação "Selecionar.


IMPORTANTE

Depois que as permissões são alteradas para um usuário existente, ele deve ser desconectado e conectado novamente para que as permissões entrem em vigor.


Nota

Atributos de Elemento ABM: Apenas o usuário principal pode atribuir acessos de atributo de elemento a qualquer papel.


Tener en cuenta

Ao habilitar as permissões, você deve levar em conta as permissões de visualização. Por exemplo, se você deseja conceder à função de operador acesso à permissão "Criar promoções", também deve habilitar a permissão "Visualizar promoções" para poder ver a lista de promoções existentes.

Cada função deve ter pelo menos uma permissão de visualização ativa. Se você não selecionar nenhuma permissão de visualização, será exibida a mensagem "Selecione pelo menos uma permissão de visualização".




Configurações de acesso padrão

O acesso do usuário será configurado por padrão da seguinte forma:

1Módulo (categoria)Item (subcategoria)subitemO que habilita?Ativo em funções por padrão
2Dashboard (encontrado na categoria Administração)promoções
Permite visualizar o Dashboard de PromoçõesAdministrador
Permite modificar o Dashboard de PromoçõesAdministrador
Vendas
Permite que você veja o Dashboard de VendasAdministrador
Permite modificar o Dashboard de VendasAdministrador
cupons
Permite visualizar o Dashboard de CuponsAdministrador
Permite modificar o Dashboard de CuponsAdministrador
Unid
Permite que você veja o Dashboard de Elementos de fidelidadeAdministrador
Permite que você modifique o Dashboard de Elementos de fidelidadeAdministrador
Criado pelo usuário
Permite visualizar os Dashboards criados pelo usuárioAdministrador
Permite modificar os Dashboards criados pelo usuárioAdministrador
3Operaçãocampanhas
Menu Display Operation > Campanhas e uso de filtros de buscaAdministrador, Operador
Permite criar uma nova campanhaAdministrador
Permite editar uma campanhaAdministrador
Condições Gerais
Exibir menu Operação > Condições gerais, uso de filtros de pesquisa, consulte o Resumo, consulte o Histórico do WFAdministrador, Operador
Permite enviar para aprovação condições geraisAdministrador
Permite editar e definir condições geraisAdministrador
Permite criar condições geraisAdministrador
Permite cancelar condições geraisAdministrador
promoções
Permite visualizar promoções e usar os filtros de buscaAdministrador, Operador
Permite criar e copiar promoçõesAdministrador
Permite cancelar promoçõesAdministrador
Permite editar e definir promoções.Administrador
Permite adicionar uma imagem à promoçãoAdministrador, Gerente de Negócios
Permite remover uma imagem da promoçãoAdministrador, Gerente de Negócios
 Permite enviar para aprovar uma promoçãoAdministrador
Modelos de promoção
Permite ver a lista de modelos de promoção, usar os filtros de pesquisa e ver o ResumoAdministrador, Operador
Permite editar modelos de promoçãoAdministrador
Permite criar modelos de promoçãoAdministrador
Permite cancelar modelos de promoçãoAdministrador
Permite gerar excel a partir de modelos de promoçãoAdministrador, Operador
Promoções a Aprovar
Permite visualizar a lista, resumo e histórico do WF de promoções com aprovação/rejeição pendenteAdministrador, Operador
Permite aprovar ou rejeitar promoçõesAdministrador
Condições Gerais para Aprovar
Permite que você veja a lista e o histórico do WF de condições gerais pendentes de aprovação/rejeiçãoAdministrador, Operador
Permite aprovar ou rejeitar condições geraisAdministrador
Registo Massivo de Promoções
Permite visualizar a lista de templates disponíveis para cadastrar promoções de forma massiva.Administrador, Operador
Pesquisa das últimas operações realizadas.Administrador, Operador
Permite-lhe aceder aos detalhes do processamento do ficheiro para registo massivo de promoçõesAdministrador, Operador
Permite carregar e processar o arquivo Excel. Consulte o Relatório e Detalhe dos erros após serem processados.Administrador
Cancelamento em massa de promoções
Possibilita a visualização da lista de promoções disponíveis para cancelamento, a utilização de filtros de pesquisa, a seleção de uma ou de todas as promoções, o motivo do cancelamento e o cancelamento massivo de promoções.Administrador
Limita promoções
Permite ver a lista de Limites de Promoção e realizar buscasAdministrador, Operador
Ativa a edição de limites. Salvar uma edição de limite é salvar uma edição de uma promoção, portanto, você deve ter permissão para editar promoções.Administrador
4fluxo de trabalhofluxo de trabalho
Permite que você veja a lista de fluxos de trabalhoAdministrador, Operador
Permite criar um novo fluxo de trabalho, adicionar e excluir etapasAdministrador
Permite editar um fluxo de trabalhoAdministrador
5DistribuiçãoMapas (POS)
Permite visualizar a lista de mapas, realizar buscas e visualizar o resumo.Administrador, Operador
Vamos baixar o mapaAdministrador
Permite distribuir um mapa, publicá-lo nas lojasAdministrador
Permite editar e definir.Administrador
Permite criar novos mapas, Copiar mapaAdministrador
Simulação
Permite visualizar a simulaçãoAdministrador, Operador
Edição, definiçãoAdministrador, Operador
SimularAdministrador, Operador
Permite criar, visualizar a lista, editar e definir simulaçõesAdministrador, Operador
Redes sociais
Permite ver a lista de promoções a publicar nas redes sociais.Administrador, Operador
Permite publicar a promoção nas redes sociais e ver um resumo das publicaçõesAdministrador
6Preçoslista de preços
Veja a lista de listas de preços, detalhes e histórico do WF. Ativar pesquisasAdministrador, Operador
Permite Criar Tabelas de Preços Geradas e Derivadas; editar, distribuir, baixar distribuição, remover listaAdministrador
Tabelas de preços a aprovar
Permite ver a lista de listas de preços pendentes de aprovação, permite ver o histórico do WF e aprovar ou rejeitar a lista.Administrador
modelos de etiquetas
Permite a criação, edição e pesquisa de modelos de etiquetasAdministrador
Impressão de etiqueta pendente
Permite gerar e selecionar etiquetas para imprimir, fazer buscas e ver detalhes das impressões feitasAdministrador, Operador
Impressão de etiquetas sob demanda
Permite gerar e selecionar etiquetas para imprimir, fazer buscas e ver detalhes das impressões feitasAdministrador, Operador
7Fidelidademodelos de cupom
Permite que você veja a lista de modelos de cupom disponíveis e use os filtros de pesquisaAdministrador, Operador
Permite a criação de novos modelos de cupomAdministrador
Ativar a edição de modelos existentesAdministrador
tipos de cupons
Permite consultar a lista com os tipos de cupões existentes, utilizar os filtros de pesquisa, ver o resumo, as promoções associadas e pré-visualizar.Administrador, Operador
Permite criar tipos de cuponsAdministrador
Permite editar, copiar e definir tipos de cupons
cupons
Ativar pesquisa de cupomAdministrador, Operador
Permite cadastrar cupons de forma massiva e ver o relatório com os resultadosAdministrador
Tipos de itens de fidelidade
Permite ver a lista de tipos de elementos de fidelidade, realizar pesquisas e ver o resumoAdministrador, Operador
Permite a criação, edição e cópia de tipos de itens de fidelidadeAdministrador
Permite a criação, edição e cópia de tipos de itens de fidelidade
Elementos de fidelidade
Permite pesquisar elementos de fidelidadeAdministrador, Operador
Permite registar massivamente elementos de fidelização e visualizar o relatório com os resultados ou detalhes de erros e permite cancelarAdministrador
Permite modificar e transferir o saldo dos elementos de fidelização
Permite ativar elementos de fidelidadeAdministrador
Veja movimentos de elementos de fidelidadeAdministrador, Operador
Acordo
Permite consultar a lista de convênios existentes e realizar buscasAdministrador, Operador
Permite criar um novo contrato ou editar um existenteAdministrador
Clientes

Permite visualizar a lista de clientes, realizar pesquisas, visualizar detalhes do cliente e cupons e cartões associados

Excluir dados do cliente (a partir da versão 7.0.18)

Administrador, Operador


Administrador

8RelatóriosPromoções/MapasPromoções-AtualAtivar o relatório de promoções atuaisAdministrador, Gerente de Negócios, Operador
promoçõesAtivar o relatório de promoçõesAdministrador, Gerente de Negócios, Operador
Promoções por SKUAtivar promoções de relatório por SKUAdministrador, Gerente de Negócios, Operador
Mapas (POS)Ativar relatório de mapas (POS)Administrador, Gerente de Negócios, Operador
Limites por promoçãoHabilitar Relatório > Promoções/Mapas > Limites por promoçõesAdministrador, Gerente de Negócios, Operador
Histórico de limitesHabilitar o Relatório de Histórico de LimitesAdministrador, Gerente de Negócios
Distribuição: Redes SociaisHabilitar o relatório de distribuição socialAdministrador, Gerente de Negócios, Operador
Distribuição: LojasHabilitar Relatório > Promoções/Mapas > Distribuição: LojasAdministrador, Gerente de Negócios
transaçõesIndicadores OperacionaisHabilita o Relatório de Indicadores OperacionaisAdministrador, Gerente de Negócios
Detalhes da TransaçãoHabilitar o relatório de detalhes da transaçãoAdministrador, Gerente de Negócios
Classificação do clienteAtivar o relatório de classificação do clienteAdministrador, Gerente de Negócios
Limites TransacionaisHabilitar o Relatório de Limites TransacionaisAdministrador, Gerente de Negócios
Erros em reversõesAtivar o relatório de erros em reversõesAdministrador, Gerente de Negócios
Relatório de transaçõesHabilitar Relatório > Transações > Relatório de TransaçõesAdministrador, Gerente de Negócios
Relatório de promoçõesAtivar relatório > Transações > Relatório de promoçõesAdministrador, Gerente de Negócios, Operador
cuponsTipos de Cupons
Administrador, Gerente de Negócios, Operador
cupons
Administrador, Gerente de Negócios
Cupons expirados
Administrador, Gerente de Negócios
Extrato de CuponsAtivar Relatório > Cupons > Extrato de cupomAdministrador, Gerente de Negócios
UnidTipos de elementos de fidelidade
Administrador, Gerente de Negócios, Operador
Elementos de fidelidade
Administrador, Gerente de Negócios
Pontos/Valores Vencidos
Administrador, Gerente de Negócios
Elementos de fidelidade sem movimentosAtivar Relatório > Elementos de fidelidade > Elementos de fidelidade sem movimentosAdministrador, Gerente de Negócios
Extrato de Pontos/ValoresAtivar relatório > Elementos de fidelidade > Extrato de pontos/valoresAdministrador, Gerente de Negócios
relatórios programados
Ativar relatório > Relatórios programadosAdministrador, Administrador de empresas, Principal
Lista de preçosLista de preços ativosAtivar relatório > Lista de preços > Lista de preços ativaAdministrador, Gerente de Negócios, Operador
Lista de preços do produtoAtivar Relatório > Lista de preços > Lista de preços por produtoAdministrador, Gerente de Negócios, Operador
Evolução de preçosAtivar Relatório > Lista de preços > Evolução de preçosAdministrador, Gerente de Negócios
Recuperação de fornecedoresAtivar Relatório > Lista de preços > Recuperação do fornecedorAdministrador, Gerente de Negócios
Monitor de exportação (a partir de v7.0.3)
Visualizando/Criando Relatórios de ExportaçãoAdministrador
9NegóciosLojas
Permite ver a lista de Lojas e realizar pesquisasAdministrador, Gerente de Negócios
Permite editar lojas.Administrador, Gerente de Negócios
Permite criar, ativar ou desativar lojas. Adicione, modifique ou exclua conexões e associe motores a elas.Administrador, Gerente de Negócios
ConcorrentesConcorrentesPossibilita visualizar a lista de Concorrentes, pesquisar, criar, editar e definir concorrentesAdministrador, Gerente de Negócios
Publicações de preçosPermite a criação, edição e pesquisa de Publicações de PreçosAdministrador, Gerente de Negócios
segmentos
exibição de segmentoAdministrador, Gerente de Negócios
Permite criar segmentos e realizar buscasAdministrador, Gerente de Negócios
Permite editar e definir segmentos e realizar pesquisasAdministrador, Gerente de Negócios
empresas
Permite criar, editar, definir, ativar, desativar e pesquisar empresasPrincipal
10AdministraçãoAtividades agendadas
Executar, parar e agendar tarefas agendadas manualmentePrincipal
Painéis
Permite criar painéisAdministrador
Permite editar, definir, ativar e desativar painéisAdministrador
Exibir painéisAdministrador
Importação de Catálogo
Possibilita a exibição da lista de catálogos e visualização dos primeiros 25 registros do conteúdo dos catálogos. Ativar a exibição do catálogo também permite o preenchimento automático por catálogo. No caso de desabilitar a visualização, os cadastros por catálogo não serão autocompletados.Administrador, Operador
Permite importar catálogosAdministrador
informações de configuração
Permite visualizar, pesquisar e editar parâmetros de configuraçãoAdministrador, Principal
Importação de promoções
Permite importar promoções e ver o resultado das importações feitasAdministrador, Operador
Razões para alterações de saldo
Permite criar, editar, pesquisar Motivos para alteração de saldos, visualizar a lista e detalhes e desativá-los.Administrador
trilha de auditoria
Possibilita a exibição da lista, busca e visualização do detalhamento dos Registros de AuditoriaAdministrador, Principal
propriedades de benefício
Habilita a exibição da lista de Propriedades do BenefícioAdministrador, Operador
Permite criar, editar, ativar e desativar propriedades de benefícios e realizar pesquisasAdministrador
atributos do elemento
Permite visualizar a lista de atributos do elemento, pesquisar e baixar o arquivo de definiçãoPrincipal
Permite criar, editar, ativar e desativar atributos de elementoPrincipal
Tipo de promoções
Habilita a exibição da lista de Tipos de Promoções, busca e permite Visualizar Promoções AssociadasAdministrador, Operador
Permite criar e editar Tipos de promoçõesAdministrador
Subtipo de promoções
Possibilita a visualização da lista de Sub-tipo de Promoções, pesquisa e permite Consultar as Promoções AssociadasAdministrador, Operador
Permite criar e editar Subtipos de PromoçõesAdministrador
Forma de aplicação das promoções
Possibilita a visualização da lista de Formulário de candidatura de Promoções, pesquisa e permite Consultar as Promoções AssociadasAdministrador, Operador
Permite que você crie e edite o Formulário de Solicitação de PromoçõesAdministrador
modelo de mapa
Possibilita a visualização da lista de Templates de Mapas, a pesquisa, o resumo e ver as promoções associadasAdministrador
Permite criar, editar, definir e copiar modelos de mapasAdministrador
atributos de grupo
Habilita a exibição da lista de grupos de atributos e a pesquisaAdministrador, Operador
Permite criar, editar e excluir grupos de atributosAdministrador
grupo de prefixo
Possibilita a Visualização da lista do Grupo de Prefixos, a pesquisa, visualização do resumo e das promoções associadas. O botão de promoções associado será visto se você tiver permissão para visualizar as promoções. Também se aplica a Tipo, subtipo, forma de aplicação e modelos de mapaAdministrador, Operador
Permite criar, editar, ativar, desativar e excluir Grupos de Prefixos; adicione prefixos e baixe o arquivo de prefixo.Administrador
atributos de cabeçalho
Habilita a exibição e busca de Atributos de CabeçalhoAdministrador, Operador
Permite editar, ativar e desativar atributos de cabeçalhoAdministrador
onzeSegurançaGerenciamento de usuários
Habilita a visualização e busca da Lista de UsuáriosDiretor, Administrador
Permite criar e editar usuários, alterar senhas, habilitar e desabilitar usuáriosDiretor, Administrador
Configuração de função
Criar, editar, excluir.Principal
Listar e configurar acessos.Administrador (se houver apenas 1 empresa*), Principal
12alarmesContexto
Possibilita a exibição da lista de alarmes e busca e visualização do detalheAdministrador, Operador
Permite criar e desativar alarmesAdministrador
notificações
Permite ver a lista de notificações de alarme, realizar pesquisas e ver o detalheAdministrador
Permite confirmar notificações.Administrador
13Médioinicializar configurações
Permite inicializar o console e as configurações de permissõesPrincipal
Gerenciador de backup de banco de dados
Permite gerar e restaurar backupsDiretor, Administrador
estado do motor
Permite consultar o estado dos motores configurados, efetuar pesquisas e descarregar um ExcelAdministrador
registro do console
Permite ver a lista de logs do console, realizar pesquisas e baixar os logsDiretor, Administrador
importar monitor
Possibilita a visualização da lista com o estado das diferentes importações, pesquisa, visualização do detalhe e reprocessamento dos registosAdministrador
14Outrosmonitor de exportação
Possibilita a visualização da lista com o status das diferentes exportações e registros de reprocessamentoAdministrador


Aclaración

*Em Segurança\ Configuração de funções\ Listar e configurar o acesso, se houver 2 ou mais empresas configuradas no Promo, o usuário administrador não terá acesso por padrão à tela "Configuração de funções".

Caso haja apenas uma empresa configurada no Promo, o usuário administrador deverá ter acesso à tela "Configuração de função".




Capítulo 14 - Módulo de Alarme

A partir do console Promo podem ser configurados alarmes que monitorarão determinadas transações que são reportadas ao console, e com base neles podem ser registradas notificações e enviadas para diferentes usuários do Promo. 

Podem ainda ser configurados alarmes, relacionados com o Módulo de Preços, que permitirão aos utilizadores serem notificados das tarefas que têm pendentes, relativamente aos tarifários:

Menu de Alarmes

Este menu permite a criação e configuração dos diversos gerenciamentos de Alarmes e Notificações disponíveis no Promo.



Contexto

Ao acessar o menu "Configurações" dos Alarmes, será exibida a tela "Configurações dos Alarmes", onde serão exibidos os alarmes cadastrados até o momento.

Existem os seguintes filtros que facilitarão a busca dos alarmes configurados no console:

            • Tipos de Alarmes (relativos a transações) 

Eles podem ser filtrados aqui entre as seguintes opções de alarme para configurar:

>> Pontos Atribuídos por transação : Avalie se o número de pontos atribuídos a cada transação registrada no console PROMO não ultrapassa o número de pontos definido no Alarme. Se for atingido ou excedido, o alarme correspondente será registrado.

>> Pontos   Atribuídos por Período  Avalia  se o número de pontos concedidos nas transações  registradas no console PROMO durante um determinado período  não ultrapassa o número de pontos definido no Alarme. Se for atingido ou excedido, o alarme correspondente será registrado. 

>>  Pontos   Resgatados por transação :  Avalia  que o número de pontos resgatados para cada  transação registrada no console PROMO não ultrapassa o número de pontos definido no Alarme. Se for atingido ou excedido, o alarme correspondente será registrado. 

>>  Pontos Resgatados por período:  Avalia  que o número de pontos resgatados nas transações  registradas no console PROMO durante um determinado período  não ultrapassa o número de pontos definido no Alarme. Se for atingido ou excedido, o alarme correspondente será registrado.

>>  Modificação de saldo por período : Controla que os valores que são modificados desde o console  para um elemento de fidelidade, não  atinjam ou ultrapassem os valores definidos no alarme durante o período de tempo determinado.

>>  Saldo negativo no cartão por transação : Avalia que um elemento de fidelidade após a transação não está com saldo negativo, caso esta situação ocorra, a notificação correspondente será gerada e enviada.

>> Venda abaixo do custo : Controla que as vendas não sejam feitas abaixo do custo do produto.

>>  Modificação de saldo por transação : Controla que os valores que são modificados desde o console para um elemento fidelidade em uma única operação, não atinjam ou ultrapassem os valores definidos no alarme.

>> Promoções distribuídas pelas lojas:   Ao distribuir um mapa, este alarme enviará um relatório em formato .XLS para os usuários e/ou grupos de usuários definidos no alarme, com as promoções que acabaram de ser distribuídas para a loja. O assunto do e-mail informará a loja a que pertencem os dados que estão sendo incluídos no e-mail.

>> Alteração em % de Benefícios:   Este alarme será acionado quando for gerada uma promoção em estado completo igual ou superior ao percentual de desconto estabelecido no alarme. Ou quando uma promoção for modificada e seu benefício após a modificação for igual ou superior ao percentual de desconto estabelecido no alarme.

Alarma Modificación en % de Beneficios

Nesta versão, o tipo de Alarme Modificação em % de Benefícios é adicionado ao criar um novo alarme e selecionar este tipo de benefício:



Você pode selecionar o Tipo de benefício que aplicará o alarme que está sendo gerado:


  • Monetário
  • não monetário


Ao selecionar o Tipo de Benefício Monetário , serão propostos os seguintes campos onde deverá ser indicado a qual Classe de benefício se aplicará o alarme que está sendo gerado:

  • desconto de acordo
  • desconto percentual

Ao selecionar o Tipo de Benefício Não Monetário , serão propostos os seguintes campos onde você deverá indicar a qual Classe de benefício se aplicará o alarme que está sendo gerado:

  • Cupom Calculado/Porcentagem
  • porcentagem de fidelidade

A seguir, será exibido o campo que permite informar o percentual a partir do qual será aplicado o alarme que está sendo gerado. Este limite deve ser incluído como um parâmetro dentro do Promo para que o usuário possa inserir o valor desejado. Ou seja, o desconto deve ser igual ou superior ao percentual indicado:

Você também pode adicionar uma descrição, definir a prioridade do alarme e se ele requer ou não confirmação.

Por fim, deve-se indicar o Tipo de Notificação, Funções e Usuários caso a notificação seja por e-mail e se o alarme estiver Ativo.


Na tela " Configuração de alarmes ", o combo " Tipo de alarmes " deve apresentar o alarme " Modificação em % de benefícios "

>> Monitoramento de Limites: Possibilitará a visualização das unidades ou valores ($) utilizados nas promoções onde foram definidos limites, de forma a manter a rastreabilidade dos benefícios concedidos.   

>> Transações que atribuem pontos por períodos:   Alertará sobre a quantidade de transações que atribuem pontos, em um determinado período.

Alarma: Transacciones que otorgan puntos por período

Para evitar fraudes, nesta versão é adicionado o alarme Transações que concedem pontos por períodos , que alertará sobre o número de transações que concedem pontos, em um determinado período.

Este alarme deve alertar os usuários, quando o número de transações que concedem pontos configurados for ultrapassado, no período configurado.

O alarme deve notificar apenas o número de transações (que atribuem pontos) que são geradas após a criação do alarme, e não as pré-existentes.

A seleção deste tipo de alarme exibirá a seguinte visualização:

onde o usuário deve configurar o número de dias que será realizada a contabilização das transações que concedem pontos fidelidade e o número de transações a partir das quais o alarme deve ser acionado.

Quando for registado um número de transações que atribuem pontos superior ao configurado, o alarme enviará um e-mail a informar desta situação, no seguinte formato :


No relatório da transação, serão observados os detalhes da mesma.

Importante

Este tipo de alarme não se aplica a transações que acumulam pontos de fidelidade com cartões externos.

Importante

Esses alarmes não confirmados impedirão que os usuários recebam novas notificações de transações de clientes. Uma vez confirmados os alarmes, as notificações chegarão corretamente, para cada transação do cliente.

Nota

Aqueles alarmes que não requerem confirmação, uma vez que o cliente tenha atingido o número configurado de transações que concedem pontos, o usuário receberá notificações para cada transação que envolve o cliente e atribui pontos.



Nota Promociones Distribuidas por Tiendas

Caso a notificação tenha sido definida apenas para ser visualizada na tela, o número do mapa e a(s) loja(s) para a qual foi distribuído devem ser informados no registro do alarme.


Se a notificação for por tela e por e-mail, quando o alarme for acionado, a notificação deverá ser exibida no console do Promo e também deverá ser enviado um e-mail para os usuários definidos no alarme com o seguinte formato:


Um arquivo excel com as promoções distribuídas para essas lojas será anexado a este e-mail.

O nome do arquivo deve ser " número do mapa_loja onde foi distribuído_data e hora da distribuição.xml " e terá as seguintes colunas:

>>  Aprovação de Workflow:   Este tipo de alarme informa sobre as alterações feitas nos Workflows (WF) definidos no console para que a(s) pessoa(s) envolvida(s) na aprovação de promoções seja(m) notificada(s) de que uma promoção requer uma ação no workflow que tenha associado


Nota: Alarma Aprobación Workflow

Este tipo de alarme não permitirá que você selecione os fluxos de trabalho de 1 etapa (não mostrará o fluxo de trabalho geral). No combo Workflow selecionável mostrará todos os workflows que possuem mais de uma etapa. Ao associar o alarme a um Workflow, ele estará disponível para a geração de alertas que enviem notificações sobre alterações de status nas promoções que tenham aquele WF associado.


Se o combo " Tipo de Notificação " indicar " Cadastro de Notificação e Mailing " será possível selecionar entre os cargos e usuários que foram incluídos entre as etapas definidas no WF para que sejam notificados sobre mudanças de status de uma promoção associada a o WF para o qual o alerta está sendo gerado. As funções e usuários ativos no console também serão propostos caso seja necessário incluir mais destinatários que não foram incluídos na aprovação do WF.


MODIFICAÇÕES NO FLUXO DE TRABALHO:

Se um WF for modificado, adicionando ou removendo etapas, os papéis envolvidos não serão modificados nos alarmes associados a este WF. O alarme deve ser editado adicionando ou removendo as funções e/ou usuários que correspondem ao envio da notificação.


ESTRUTURA DO E-MAIL A ENVIAR QUANDO O ALARME DE WORKFLOW FOR ATIVADO:

O e-mail enviado quando um alarme é ativado conterá os seguintes dados:

  • Nome do alarme que está sendo relatado
  • Descrição fornecida no momento do registro do alarme
  • Resumo da promoção que ativa o alarme
  • Link para a página "Promoções a aprovar" ( Uma vez recebido o e-mail, você pode clicar no link para acessar a seção " Promoções a aprovar ")


Considerações :

Os usuários selecionados para receber a notificação devem ter o campo "E-mail" carregado.

Os dados do servidor de e-mail devem estar configurados corretamente.




          • Tipos de Alarmes (relativos a Listas de Preços) : 

Eles podem ser filtrados aqui entre as seguintes opções de alarme para configurar:

>>  Impressões de preços pendentes:

Avalie se há produtos que mudaram de preço devido à interface restante. Se houver algum nesta situação, a notificação correspondente será acionada.

>>  Distribuições de lista de preços pendentes:

Avalie se existem Tabelas de Preços aprovadas e completas do tipo Gerado ou Derivado (não do tipo Zero), que ainda não foram distribuídas para as lojas correspondentes. Se houver algum que atenda a essas condições, a notificação correspondente será acionada.

>> Listas de preços prestes a expirar:

Uma vez por dia, o sistema avaliará se existem Tabelas de Preços do tipo Gerado ou Derivado (não do tipo Zero), e que estejam no estado Completo, que encerram sua validade no dia da data. Se houver algum que atenda a essa  condição,  a notificação correspondente será acionada.

>>  Tabelas de preços em breve válidas:

Avalia que existem Tabelas de Preços do tipo Gerado ou Derivado (não do tipo Zero) que estão completos,  que entram em vigor no dia da data. Se houver algum que atenda a essa condição, a notificação correspondente será acionada.

>> Listas de preços para redistribuir após modificação:

Avalia se existe alguma tabela de preços do tipo Gerada ou Derivada (não do tipo Zero) que foi modificada, está no estado Completo e deve ser distribuída, a notificação correspondente será acionada.

>> Lista de preços base importada com erros:

Avalia se ocorreram erros na interface de atualização de preço da Lista 0. Caso esta situação exista,  a notificação correspondente será acionada.


Prioridade de Alarme : Filtrará se o alarme é de prioridade Alta, Média ou Baixa.

Tipo de Notificação:   Irá filtrar os alarmes que irão apenas registrar uma notificação no console Promo ou os alarmes que juntamente com a notificação do console enviarão um e-mail para os usuários cadastrados no alarme.



NOTA

Configuração de e-mail

Para que os e-mails de notificação sejam enviados corretamente, o usuário deve ter um e-mail válido configurado e o console Promo deve ter o serviço de e-mail de saída configurado.

Ele é configurado em: Administração\ Informações de configuração. Na tela "Informações de configuração", no filtro "Palavras a serem pesquisadas", escreva: mail e depois pressione a lupa. Deve ser configurado, por exemplo, com os seguintes parâmetros de acordo com o e-mail que você possui:

Parâmetro

gmail

ao vivo/hotmail

yahoo

Intercâmbio

padrão.de

[email protected]

[email protected]

[email protected] ou [email protected]

[email protected]

default.insertImages

verdadeiro

falso

falso

falso

default.subject

e-mail de teste

e-mail de teste

e-mail de teste

e-mail de teste

hospedar

smtp.gmail.com

smtp.live.com

smtp.mail.yahoo.com

pod51009.outlook.com

senha

senha do e-mail

senha do e-mail

senha do e-mail

senha do e-mail

porta

465

587

587

587

smtp.auth

verdadeiro

verdadeiro

verdadeiro

verdadeiro

smtp.port

587



587

smtp.socketFactory.class

javax.net.ssl.SSLSocketFactory



javax.net.ssl.SSLSocketFactory

smtp.socketFactory.fallback

falso



verdadeiro

smtp.socketFactory.port

465



587

smtp.starttls.enable

verdadeiro

verdadeiro

verdadeiro

verdadeiro

nome de usuário

[email protected]

[email protected]

[email protected]

[email protected]
smtp.ssl.trust *


*

Depois de fazer as alterações, você deve salvá-las pressionando o botão "Salvar".


*Esclarecimento: smtp.ssl.trust:

Com este valor, o console Promo que vai enviar o e-mail é instruído a confiar nos certificados do servidor (por exemplo, no caso da empresa xx, os certificados são autoassinados e não possuem uma autoridade de certificação válida).

Você pode colocar '*' (asterisco) para confiar em todos os certificados que vêm do servidor ou do host que assina os certificados, por exemplo ' xx.com.uy ' se o departamento de segurança de TI da empresa quiser ser mais específico ou em algum ponto decidem trocar o certificado e colocar outro gerado em outro servidor.

Caso utilizassem certificados válidos gerados por entidade autorizada, não seria necessário configurar este valor, ou seja, deixar em branco.


Para contas yahoo e google, essas caixas devem ser configuradas para que possam ser acessadas a partir de aplicativos menos seguros, isso permite o envio de e-mails de aplicativos externos.


Para alarmes: o utilizador Administrador deverá configurar na consola Promo, o endereço de e-mail correspondente ao utilizador que gere os alarmes (este será o endereço de e-mail que receberá os alarmes).


Status : Você pode filtrar entre Alarmes ativos e inativos.



NOTA

Somente os Alarmes Inativos podem ser editados.





Cada alarme cadastrado terá um botão de "ações" a partir do qual poderá ser desativado, editado, ativado e/ou ver os detalhes de cada um deles. Somente os alarmes que estiverem inativos terão a opção de editar.

Ao clicar em " Detalhe " será exibida a seguinte mensagem:


Se você deseja desativar um alarme, será solicitado que você indique um motivo com o seguinte PopUp, após inserir o motivo, pressione Continuar e o alarme permanecerá Inativo.


Ao reativar um alarme, será necessária a confirmação através do seguinte PopUp:

                           

                           

              • Alarme de Movimentos em Limites :  A partir desta versão, adiciona-se este novo alarme que permitirá  visualizar as unidades ou valores ($) utilizados em promoções onde foram definidos limites, de forma a manter a rastreabilidade dos benefícios concedidos.

                Este alarme deve ser acionado quando o saldo do limite atingir o valor em percentual (%) ou em valor ($) definido no alarme. Se for definido em 100%, será emitido o alarme de limite total de consumo.

                Ex:

                Caso a promoção seja definida, por exemplo, pelo número de aplicativos por loja e o alarme seja definido em 80%, se o limite definido na promoção for 10, quando o contador atingir 8 aplicativos, um alarme deverá ser emitido .

                O mesmo acontecerá se a promoção for definida por $ 1.500 em dinheiro por cliente e o alarme for definido em um valor de $ 1.000, quando o contador atingir $ 1.000, um alarme deverá ser acionado.

                Aplica-se ao âmbito dos limites (loja, geral) e a todos os tipos de limites (quantidade de aplicações, produtos beneficiados, montante em dinheiro, cupões e/ou pontos atribuídos, etc.).

                Para isso, ao criar um novo alarme, deve-se selecionar a opção Monitoração de Limite .

   Ao selecionar o item Monitoramento de limite , o aplicativo exibirá o seguinte formulário:

   

   No campo Limite, você pode selecionar o escopo dos limites (loja, geral) sobre os quais deseja monitorar os movimentos a serem alertados.

   

   No campo "Limite por", você pode selecionar os tipos de limites nos quais deseja monitorar os movimentos a serem alertados.

   

No campo "Ativar tipo" será possível selecionar se o alarme será avaliado por % ou por quantidade consumida no limite para acionar o alarme correspondente.

No campo "Ativar Valor", será indicado o número a ser avaliado com base no que for definido no filtro "Ativar Tipo".

As restantes opções de definição de alarme continuarão a funcionar da mesma forma que todos os alarmes são operados (Descrição, Prioridade, Requer confirmação, Tipo de notificação e Ativo)

                                                             

                                                            

Novo Alarme :

Para cadastrar um novo alarme, pressione o botão "Novo" localizado na tela "Configuração do Alarme" e o seguinte formulário será exibido:

Os dados solicitados para o registo de um novo alarme são os seguintes:

                • Nome : Campo obrigatório, deve ser indicado um nome para o novo alarme que está sendo definido. (campo alfanumérico). 
                • Tipo de alarme : Deve-se selecionar um dos tipos de alarmes propostos pelo Promo. Dependendo do tipo de alarme que está sendo gerado, os campos serão propostos:

>> " Número de dias ": Caso o alarme a ser configurado avalie a ocorrência de um evento em um determinado período, será proposto este campo onde deverá ser indicado o número de dias que o período compreenderá, e após o referido número de dias em que o contador será zerado. Caso o alarme seja ativado e não exija confirmação, o contador será zerado automaticamente, caso seja necessária a confirmação, o contador será inicializado quando o usuário habilitado confirmar a notificação correspondente.

>> " Número de pontos ": deve ser indicado o número de pontos que devem ser alcançados para ativar o alarme. Caso o alarme seja ativado e não exija confirmação, o contador será zerado automaticamente, caso seja necessária a confirmação, o contador será inicializado quando o usuário habilitado confirmar a notificação correspondente.

                • Descrição : Campo opcional, onde será possível inserir alguns dados adicionais do alarme que está sendo definido.
                • Prioridade : Deve ser indicado se o alarme que está sendo definido tem prioridade Alta, Média ou Baixa. 
                • Requer confirmação : será possível indicar se o alarme que está sendo definido requer ou não a confirmação de um usuário. Por padrão, a confirmação sempre será necessária.
                • Tipo de notificação : Deve ser selecionado se a notificação que será gerada quando as condições de alarme forem atendidas, será apenas registrada no console ou se também será enviado um e-mail aos usuários envolvidos para relatar o referido evento.
                • Funções : Você pode selecionar as funções que receberão o alarme.
                • Usuários : Podem ser selecionados os usuários que receberão o alarme.
                • Ativo : indicará se o alarme que está sendo criado estará ativo ou não.



notificações

Ao acessar o menu "Notificações" do módulo Alarmes, será exibida a tela "Notificações de Alarme", onde serão exibidas as notificações geradas ao atingir os limites definidos nos alarmes ativos.

Existem os seguintes filtros que facilitarão a busca pelas notificações presentes no console:

              • Data de e Data até : você pode filtrar pelas notificações que surgiram em um determinado intervalo de datas.
              • Tipos de alarmes: Você pode indicar qual dos tipos de alarmes presentes no Promo deseja filtrar.
              • Prioridade de alarme : você pode indicar se deseja filtrar por notificações de prioridade alta, média ou baixa.
              • Confirmação : Você pode filtrar entre notificações, confirmadas, não confirmadas ou não deseja notificação.
              • Descrição : será possível filtrar pelo detalhe definido em cada alarme.




IMPORTANTE

Cada vez que uma notificação for gerada, daqueles alarmes que requerem confirmação, no canto superior direito do console, aparecerá um ícone de campanha com um ponto de exclamação vermelho, informando ao usuário que existem notificações pendentes de revisão (devem ser confirmadas). ).





Cada notificação terá um botão "Ações" à direita a partir do qual as notificações que o requerem podem ser confirmadas e ver o detalhe de cada notificação.

Detalhe :


Confirmação :




Capítulo 15 - Módulo de Suporte


Menu de Suporte


Nesta seção, você pode reiniciar as configurações e gerenciar backups de banco de dados.





Gerenciador de Backup

IMPORTANTE

O BACKUP/RESTORE (Por empresa) não serve para migrar dados para outro ambiente, pois depende dos dados do ambiente onde é gerado. A restauração do backup serve para recuperar os dados caso tenha ocorrido algum erro e você queira ter as informações anteriores; afeta apenas a empresa que o fabrica.

de bancos de dados

O gerenciador de backup permite gerar cópias de segurança de todas as ações que são geradas dentro do console da empresa, essas cópias serão feitas uma vez ao dia às 00:00.

Para realizar esta tarefa; tanto com o usuário administrador ( desde que haja apenas uma empresa; se houver mais de uma empresa, o administrador deve associar essa permissão à função correspondente ), quanto com o Superusuário, eles devem primeiro ser configurados em Administração, Informações de configuração, o endereço onde estão armazenados os backups e o endereço onde está armazenado o aplicativo que executará a importação.

Na próxima janela, você pode restaurar os backups gerados, se necessário.

IMPORTANTE

O BACKUP/RESTORE (Por empresa) não serve para migrar dados para outro ambiente, pois depende dos dados do ambiente onde é gerado. A restauração do backup serve para recuperar os dados caso tenha ocorrido algum erro e você queira ter as informações anteriores; afeta apenas a empresa que o fabrica.


Status do sistema

O status dos componentes (console ou mecanismo) que são relatados ao console PROMO pode ser visualizado na seção "Status do sistema".

A seguinte tela será apresentada:

Nela é possível visualizar o status da comunicação com o motor, sua última comunicação, seu ID, nome, com qual mapa está operando e em qual loja. Bem como a validade do mapa informado.

No caso de um mecanismo associado ao console não relatar a cada determinado período de tempo (seja devido a uma falha de conexão ou queda), o mecanismo aparecerá Offline, relatando os últimos dados recebidos.

Com o filtro "[Componente]" você pode selecionar se deseja ver os "Consoles" ou os "Motores" na tela. Na coluna "Componente" o ícone será exibido para indicar se está sendo mostrado um motor nessa linha, e se for um console vai mostrar .

Ao entrar, mostrará todo o status online e offline (não virá pré-filtrado no filtro que diz "[Selecionar]").

Filtros de navegação podem ser usados. Veja detalhes em Paginação .

                                                              Console

Se Console for selecionado na caixa de combinação de componentes, o aplicativo exibirá a seguinte visualização:

Se você baixar o Excel, verá como o seguinte. A coluna com o título: Console, mostrará o conteúdo com verdadeiro ou falso.


O botão "Exportação em massa" o levará à tela "Mecanismo de exportação de relatórios" e, na coluna Descrição, você poderá baixar o arquivo .csv com todos os registros da visualização "Status do sistema".



Motor

Se Engine for selecionado na caixa de combinação de componentes, o aplicativo exibirá a seguinte visualização:

Se você selecionar o botão Ações , poderá fazer o download dos logs do mecanismo.

Ao selecionar a opção de download de Logs, o aplicativo exibirá os logs disponíveis na visualização de Logs do sistema. Através do checkBox você deve selecionar aqueles que deseja baixar e pressionando o botão de download, no arquivo correspondente será obtido o arquivo .zip. com os logs indicados.

                 

Importante

Quando novas empresas são criadas; se já existe um motor associado a um já existente, o novo não verá o estado desse motor em Support, System Status. Quando um mapa atual é distribuído manualmente em uma loja da nova empresa; O motor já pode ser associado a ele e esta nova empresa poderá ver seu status em Suporte, Status do Sistema; item do motor selecionado.

 Monitor  de Importação


No menu Suporte > Monitor de importação, você pode acessar a tela de administração do monitor de importação.

Nesta seção será possível visualizar o status das importações de registros desde a interface de recebimento de preços das Listas 0 (que requerem atualização na loja correspondente), bem como o status das importações e exportações de arquivos feitas via RabbitMQ Queues que são configuradas em o console Promocional.

Você pode ver o status das diferentes importações, por exemplo, se o processo de importação foi concluído com sucesso ou se ocorreu um erro.


A partir de cada registro de importação, o botão "Ações/Conteúdo" exibirá o conteúdo da solicitação de serviço:


A partir da opção "Ações/Detalhe" pode ver o detalhe do resultado do processo de cada elemento do pedido:


Se algum elemento da requisição estiver COM ERRO, e alguns estiverem OK, o resultado do arquivo aparecerá como "PARCIAL", e se todos foram processados ​​com erro, o resultado do arquivo será "ERRO":


Para ver o resultado, você deve clicar em "Ações > Detalhe":


E será exibida a seguinte tela, onde indica o registro onde ocorreu o erro, e qual foi o erro produzido:


Os registros que devem ser reprocessados ​​podem ser reprocessados ​​a partir do botão Ações > Reprocessar ou marcando a caixa de seleção à esquerda do item e clicando no botão "Reprocessar selecionados".

                              

                              

Importante

Ao realizar uma importação de catálogo via filas rabbitmq, se a mensagem a importar estiver vazia, ao executar o job correspondente, na visualização Suporte, Monitor de Importação, o campo Tipo terá o valor "Tipo inválido".       

                             

                              

                             Ao pressionar Actions, Detail, o conteúdo é exibido sem tradução

                             

Configuração do motor

Importante

IMPORTANTE

A Configuração dos Motores é feita entrando no console MAIN PROMO com o Usuário Principal .

A partir daí você pode definir todas as configurações necessárias dos diferentes motores que interagem com o console.


Mostra uma lista de opções  que podem ser alteradas em massa  e são encontradas no arquivo config.xml.

Ao entrar, aparecerá uma tela como a seguinte:

Se você exibir o combo para selecionar, ele mostrará as seguintes opções:


Se ao fazer uma alteração for digitado um valor que não corresponda, mostrará um sinal vermelho indicando o campo de erro:

image2021-5-3_12-26-40.png

Uma vez realizada a alteração e pressionado o botão Salvar, aparecerá um sinal verde indicando o número de parâmetros modificados com sucesso. O sistema  postará apenas as alterações feitas  (não reenviará todas as informações) e as deixará prontas para o upload da engine. 

image2021-5-3_12-32-17.png

No log do console, por exemplo, foi gerada uma notificação para um mecanismo dessas 3 propriedades. (Nenhum alarme é enviado). 

Até que seja enviado para o motor, as alterações feitas são acumuladas. Em seguida, aplica as alterações na ordem feita.

IMPORTANTE

Você tem que salvar cada página onde as alterações são feitas.

Ao utilizar esta funcionalidade (ou seja, ao fazer uma alteração a partir desta tela e salvá-la) automaticamente é criado um novo arquivo: config.properties que é salvo no mesmo caminho onde está o config.xml do motor.

Este novo arquivo é gerado automaticamente pelo Promo e sobrescreve as propriedades do config.xml , ou seja, sobrescreve o que está indicado no config.xml. Assim, por exemplo, se o motor quiser saber quantas casas decimais tem para arredondar, ele primeiro levanta o config.xml e depois lê o config.properties e se houver outra configuração ele pega esta última. Não é necessário reiniciar o(s) motor(es) para que as alterações sejam realizadas. 





 Apêndice I

Perguntas frequentes


https://share.linx.com.br/pages/viewpage.action?pageId=262805281#PROMO-ManualdeUsuario7-Ap%C3%A9ndices-Espa%C3%B1ol-_Toc103590049_Toc471373811_Toc513717135 Dúvidas Frequentes


 Apêndice II

Sugestões de Promoções


PROMO - Manual do Usuário 7 - Apêndices - Espanhol#ManualdeUsuario7-Ap%C3%A9indices-Espa%C3%B1ol-_Sugestões_Ref232232521_Ref232232529_Ref232232711_Ref232232714_Ref232232778_Ref232232785_ Ref f232232823_Ref232232825_Ref232232853_Ref232232855_Ref232232886_Ref232232888_Toc471373814_Sugestões_para_Promoções_Toc51


 Apêndice III

Promoções por meio de pagamento


PROMO - Manual do Usuário 7 - Apêndices - Espanhol#ManualdeUsuario7-Ap%C3%A9indices-Espa%C3%B1ol-_Ref240274964_Ref240274970_Toc471373713_Toc513717142Promocionespormedioddepago


 Apêndice IV

 Considerações - Módulo Fidelidade

                       PROMO - Manual do Usuário 7 - Apêndices - Espanhol#ManualdeUsuario7-Ap%C3%A9indices-Espa%C3%B1ol-_Toc513717146Considerações-FidelityModule


 Apêndice V

Configuração de Verificação de Colisão

                        PROMO - Manual do Usuário 7 - Apêndices - Espanhol#ManualdeUsuario7-Ap%C3%A9indices-Espa%C3%B1ol-_Configuraci%C3%B3n_de_Chequeo_Toc513717151Configuraci%C3%B3ndeChequeodeColisiones


 Apêndice VI

Considerações - Registro Massivo de Promoções

PROMO - Manual do Usuário 7 - Apêndices - Espanhol#ManualdeUsuario7-Ap%C3%A9indices-Espa%C3%B1ol-Considerations-AltaMasivadePromociones

 Apêndice VII

Modelo Promoções

                       PROMO - Manual do Usuário 7 - Apêndices - Espanhol#ManualdeUsuario7-Ap%C3%A9indices-Espa%C3%B1ol-_Toc471373810_Toc513717134Ap%C3%A9ndiceVII-PromocionesModelo

 Apêndice VIII

Cache de Promoções

                       PROMO - Manual do Usuário 7 - Apêndices - Espanhol#ManualdeUsuario7-Ap%C3%A9indices-Espa%C3%B1ol-Ap%C3%A9ndiceVIII-CachedePromociones

                                                                                                                                

  • Apêndice IX

    Alarme de limites

          PROMO - Manual do Usuário 7 - Apêndices - Espanhol#Ap%C3%A9indexIX-AlarmeMovementsinL%C3%ADmites





  • Sem rótulos