MANUAL DE USUÁRIO FINAL

PROMO 7.0

Índice 

Capítulo 1 - Sobre o manual

Propósito e alcance

O apresente manual de usuário tem como finalidade capacitar o usuário que deseje utilizar o PROMO para a administração de suas promoções.

Fornece instruções detalhadas passo a passo que te ajudarão a criar e administrar promoções através do console de administração do PROMO, como também detalha conceitos e definições de 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 do produto PROMO e sua composição.

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

Capítulo 4 – Módulo de Dashboard
É descrita a operação para a utilização do Dashboard.

Capítulo 5 – Módulo de Operação 
É descrita a operação para a criação e administração de Departamentos, Campanhas, Promoções, Modelos das Promoções, Registro massivo de promoções e Workflow.

Capítulo 6 – Módulo de Workflow
É descrita a operação para a criação e administração de Workflow, para Promoções e Listas de Preços.

Capítulo 7 – Módulo de Distribuição
É descrita a operação para criar, modificar e distribuir mapas, simular promoções e mapas e a distribuição em redes sociais.

Capítulo 8– Módulo de Preços
É descrita a operação para a criação e administração de Listas de Preços.

Capítulo 9– Módulo de Fidelidade
É descrita a operação para a criação, edição e administração dos elementos de Loyalty (Cupons e Cartões).

Capítulo 10 – Módulo de Informes
Descreve os informes que podem ser gerados dentro do PROMO.

Capítulo 11 - Módulo de Negócio
Contém aquelas configurações especiais que poderão ser realizadas através do console de administração do PROMO tais como registros de Unidades departamentais, Companhias, Regiões e Lojas.

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

Capítulo 13 – Módulo de Segurança
É descrita a operação de administração e configuração de usuários e acessos.

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

Capítulo 15 – Módulo de Suporte
É descrita a operação de administração das opções de gestão de base de dados e suporte. Fornece informação sobre perguntas consideradas como frequentes.

Capítulo 16 – Promoções Modelo

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

Referências práticas

Documentação do PROMO

O PROMO fornece a seguinte documentação:

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

• “Manual de Usuário Final” - (“MANUAL DE USUÁRIO FINAL - PROMO v7”). 
  O apresente manual de usuário tem como finalidade servir de referência e ferramenta de consulta para todo usuário que deseje utilizar o PROMO para a administração de suas promoções, cupons e listas de preços.
  
  
  

 Capítulo 2 - Introdução

O que é o PROMO?

O PROMO é uma solução que permite separar o gerenciamento de promoções do ponto de venda. Ele permite definir uma ampla gama de promoções e é extensível sem a necessidade de realizar modificações nos pontos de venda.

O PROMO elimina a codificação e a dependência da manutenção, reduz os tempos de implementação e de teste. Conta com uma interface gráfica à qual chamaremos Console de Administração - PROMO, que facilita o registro de uma promoção convertendo-a em um processo rápido e intuitivo. Esta qualidade acelera o processo de saída de uma promoção.
O PROMO está pensado como uma ferramenta altamente útil e simples de usar, orientada aos varejistas para que administrem, de forma centralizada, as promoções vigentes nas diferentes regiões e locais.

No PROMO poderão ser construídas promoções por composição de condições (combos), promoções definidas por condições simples, criar benefícios, conceder cupons e pontos de fidelidade, podendo configurar os parâmetros correspondentes a cada promoção conforme seja exigido.

Também permite a montagem de modelos das Promoções que poderão ser utilizados para o carregamento massivo de promoções no console do Promo, economizando tempo de criação e maior confiança na coerência da promoção.
Será possível definir regras de convivência e ordens de aplicação entre promoções vigentes. Estes parâmetros serão utilizados, mediante algoritmos de registro eficácia, para determinar o conjunto de promoções que participam de uma determinada venda. Estas promoções serão informadas ao ponto de vendas, que será o encarregado de aplicar as promoções informadas pelo PROMO no ticket.

O PROMO oferece a possibilidade de administrar cupons de maneira centralizada, registrando as transações que os emitem e levando estatísticas (KPI) das transações registradas e cupons, como também é possível administrar cartões de fidelidade de maneira centralizada gerindo os diferentes perfis de cartão, e suas movimentações.

O PROMO permite registrar estornos de elementos de fidelidade decorrentes de devoluções ou notas de créditos realizadas no ponto de venda onde haja cupons e cartões.

No console de administração do PROMO também poderão ser geridos e configurados alarmes que servirão de aviso diante de determinados eventos, como também se conta com um módulo de Preços, a partir do qual poderão ser administradas listas de preços diferenciais para os itens presentes na transação independentemente das promoções que possam vir a ser aplicadas.

Componentes do PROMO

• Console de administração:

Ferramenta WEB para a administração de promoções, cupons e cartões de fidelidade, como também alarmes e listas de preços. É o componente encarregado de gerar o arquivo de definição de regras de negócio (mapa de promoções) que será utilizado pelo motor de promoções para sua avaliação. É o encarregado de gerir a emissão e resgate de cupons de maneira centralizada, encarregando-se da gestão dos cartões de fidelidade, podendo criá-los, associá-los a clientes, visualizar seu histórico e gerir saldos.

• Motor de promoções:

É o componente do PROMO encarregado de resolver e informar as promoções participantes em um Ticket conforme as definições (promoções) que tenham sido geradas através do console. Também é o nexo entre o ponto de vendas e o console de administração central para todo o referente à gestão de elementos de Loyalty.

Arquitetura

Funcionalidade

As funções realizadas pelo PROMO:

• Definir e administrar promoções. Componente responsável: o console de administração. 
• Definir e administrar modelos de promoções. Componente responsável: o console de administração. 
• Definir e administrar cupons. Componente responsável: o console de administração. 
• Definir e administrar cartões de fidelidade. Componente responsável: o console de administração. 
• Definir e administrar papéis de usuário do console de promoções. Componente responsável: o console de administração.
• Definir e administrar KPI. Componente responsável: o console de administração.
• Publicação em Redes Sociais. Componente responsável: o console de administração. 
• Resultar promoções e informá-las. Componente responsável: o motor de promoções.
• Definir e administrar Alarmes. Componente responsável: o console de administração. 
• Administrar listas de preços. Componente responsável: o console de administração. 

Limitações

• O PROMO não aplica as promoções senão informa ao ponto de venda como tem que aplicá-las.
• O PROMO não é um POS.
• O PROMO delega a impressão e o cálculo do IVA e impostos ao ponto de venda.
• O PROMO delega a impressão de cupons ao ponto de venda.
• O PROMO delega a impressão de etiquetas ao varejista.
  
  

Capítulo 3 - Console de Administração

Introdução

O PROMO, através do Console de Administração, permite definir promoções mediante combinação de componentes: condições simples, de faixa horária, combos e benefícios.

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

No PROMO será possível gerar e gerir cupons a serem emitidos e resgatados por intermédio de uma transação.

Também é possível gerar cartões de fidelidade, e pode-se registrar diferentes perfis de cartões de fidelidade, como, por exemplo, GiftCard, porta-moedas ou cartões de ponto, será possível gerir o saldo, associá-los a clientes e permitir sua participação em promoções para aumentar ou diminuir seu saldo, conforme a promoção que se aplique.

Com o PROMO é possível gerir alarmes, os quais servirão para alertar a determinados usuários sobre eventos relevantes que aconteçam no console e/ou transação, como também se conta com a possibilidade de administrar listas de preços e gestão de etiquetas a partir do console de promoções.

Nesta nova versão do PROMO são incorporadas ferramentas que melhorarão a experiência de usuário agilizando a gestão de promoções e mapas, junto com a possibilidade de customizar o console de uma maneira ágil e simples conforme os requerimentos de cada Varejo.

Conexão ao console

O console de administração é uma ferramenta Web, portanto a conexão poderá ser remota ou local, através do uso de um browser como Chrome ou Firefox.

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

• IP-SERVIDOR: deverá ser substituído pelo endereço IP da máquina na qual se encontre em execução o servidor de aplicações.

• PORT_INSTALACION: é o porto de conexão (Ex.: 8080)

Uma vez conectado ao console, dever-se-á colocar o nome de usuário, senha e companhia à qual se deseja conectar.

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

• Nome de Usuário: admin
• Senha: Promo2020
• Companhia: “Companhia”

Integração com autenticação de Usuários Externos (SAML2)

Por meio da implementação no PROMO de SAML2 será conseguida a integração do PROMO com um sistema de autenticação externa de usuários. Deve-se levar em conta que dentro do console existem papéis de usuário que permitem entrar nas diferentes funcionalidades que deverão ser mantidas dentro do console. É necessário sempre ter o usuário criado na base de dados para poder acessar o console e realizar a autenticação.

Quando o Promo operar com tal integração, a tela de login proposta neste manual não será mostrada, senão se verá o login que cada varejista tenha integrado com SAML2.

Ao logar e autenticar corretamente, será possível ver a tela principal do PROMO de “Gestão das Promoções”.

Para mais informações sobre a integração de SAML2 no Promo Ver Manual de Integração Promo 7.0.

Menu de Navegação PROMO

Considerações gerais

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

• Nome: por meio deste dado, será possível identificar o componente que está sendo criado e será o nome mostrado nas diferentes listas nas quais possa ser utilizado. O campo nome em todos os casos é um dado do tipo string de até 255 caracteres.
• Descrição: por meio deste dado, será possível colocar uma breve explicação esclarecedora do conteúdo do componente que está sendo criado. O campo descrição é em todos os casos um dado do tipo string de até 255 caracteres, cujo entrada não é obrigatório.

Nota: As mensagens padrão ganham a linguagem do sistema (não do Promo).

Botões

Nas telas do console do PROMO poderão ser encontrados os seguintes botões:

• Voltar: botão que permite voltar à tela anterior.
• Cancelar: botão cuja funcionalidade é a de cancelar o fluxo operacional que o usuário estava realizando. O usuário poderá cancelar a qualquer momento o procedimento que estava em curso 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 será possível criar.
• Editar: botão que permite editar todos os registros do componente selecionado da tela na qual o botão esteja localizado.
• Salvar: botão que permite confirmar o procedimento realizado.
• Pesquisar ou Filtrar: botão que permite efetuar uma pesquisa indicando os valores desejados para um conjunto de filtros.

Paginação

Em todas as telas nas quais se revele grande quantidade de registros, contar-se-á com a paginação da informação, para facilitar sua navegação.

Na parte inferior de cada tela serão mostrados os números das páginas que se encontram disponíveis para poder navegar entre elas.

A partir do Promo 7.0.3 está sendo mudado de pouco em pouco esse tipo de navegação pela seguinte: 

Debaixo dos filtros de pesquisa serão mostrados dois campos para navegar os registros, são os filtros de paginação que por default, ao entrar no informe ou na tela, mostrarão 1 (um) e 50 (cinquenta), dessa maneira, mostrará por tela os primeiros 50 registros, partindo do primeiro registro.

Se quiser ver os dois registros anteriores deverá pressionar a flecha dupla que se encontra à esquerda. O sistema automaticamente modificará o valor do campo no qual realiza a pesquisa.

Quando se estiver buscando a partir de 1 a flecha dupla da esquerda estará desabilitada (se passar o cursor do mouse sobre esse botão mostrará o sinal proibido). Quando se chegue ao final da lista a flecha dupla da direita será desabilitada (se passar o cursor do mouse sobre esse botão mostrará o sinal proibido). Dessa forma será possível navegar o informe vendo em tela, a partir do registro indicado, a quantidade de registros colocada. Será possível ver, no máximo, 1.000 (mil) registros por tela.

Capítulo 4 - Módulo de Dashboard

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

Os Dashboards no PROMO permitirão fazer um acompanhamento do grau de aplicação e alcance das diferentes promoções, cupons e cartões com base nos diferentes indicadores predefinidos.

 Menu de Dashboard

Neste Menu será possível visualizar os KPIs de Vendas, promoções, cartões e cupons.

 Dashboard de Vendas

Nesta seção serão mostrados os indicadores referentes às transações de Vendas impactadas na base de dados do PROMO.

Os registros serão mostrados com base na faixa de datas selecionada e os KPIs representaram os valores de diferentes aspectos das vendas realizadas.

O gráfico de Vendas por Loja: mostra por loja, o total das vendas realizadas menos os descontos aplicados.

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

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

O gráfico de Vendas por Meio de Pagamento: mostra o total da venda (sem aplicar o desconto) por meio de pagamento.

 Dashboard das Promoções

Nesta seção serão mostrados os indicadores referentes às Promoções concedidas no ponto de vendas impactadas na base de dados do PROMO.

Estes registros serão mostrados com base em uma faixa de datas selecionada e os KPIs representaram nos diagramas o fluxo das promoções aplicadas.

Nota: Ao posicionar o mouse sobre as barras de cores serão mostradas duas cifras, no seguinte exemplo mostra: $179k,2. A primeira cifra indica o valor que se quer representar no gráfico, a segunda indica a posição da barra que está sendo olhada contando do eixo cartesiano x até acima. Neste exemplo, por ser a segunda barra, mostra 2:

 Dashboard de Cupons

Nesta seção serão mostrados os indicadores referentes a cupons concedidos no ponto de vendas impactadas na base de dados do PROMO.

Os registros serão mostrados com base no faixa de datas selecionada e os KPIs representaram nos diagramas o fluxo dos cupons Emitidos e/ou resgatados conforme for configurado.

 Dashboard de Cartões

Conta-se com os indicadores referentes a cartões ativos.
Os registros são mostrados com base na faixa de datas selecionada e os KPIs representaram os cartões ativadas na faixa indicada.

Cada um desses Dashboards poderá ser editado tanto em seu formato como assim também os dados que se mostram.

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

Menu de Operação

Neste Menu poderão ser criadas Campanhas, definidas Condições Gerais, criadas Promoções e Modelos de promoção, aprovadas promoções, Condições Gerais, Canceladas promoções de forma massiva e/ou modificados os limites das promoções.

Campanhas

Esta opção se encontra dentro do menu “Operação” do console do PROMO e permite administrar diferentes campanhas.

Por default, ao instalar o console é carregada como exemplo a campanha “BLACK FRIDAY”, a qual poderá ser reutilizada ou desativada conforme seja exigido.

As campanhas poderão ser classificadas conforme a finalidade ou objetivo das promoções que tenham agrupado.

Por exemplo, “Campanha Promo”, onde poderão ser agrupadas todas as promoções de eletrodomésticos.

Outro exemplo poderia ser “Campanha Natalina”, onde as promoções agrupadas sob esta campanha são as que estarão vigentes durante a temporada natalina.

As campanhas poderão ser definidas conforme as necessidades do varejista, e só terão como finalidade a organização das promoções dentro do console.

O botão “Novo” deve-se pressionar e aparecerá a seguinte tela para completar os dados da campanha:

Deverão ser colocados os seguintes dados:

• Nome: nome mediante o qual a campanha será identificada.
• Descrição: este campo pode ser utilizado pelo usuário para colocar toda a informação necessária com respeito à campanha que está sendo definida, para poder estender sua descrição e identifica-la de forma mais simples. Este campo não é de caráter obrigatório.
• Data inicial: indica a data na qual a campanha entra em Vigência.
• Data de finalização: indica a data na qual será finalizada a vigência da campanha.
• Canais de publicação: Será possível selecionar entre os diferentes canais de publicação definidos. (Aparecerão mais ou menos opções conforme os módulos adquiridos pelo cliente.)
• Ponto de venda
• Facebook
• Twitter
• Ativo: Por meio deste check pode-se indicar se a campanha que está sendo criada se encontra Ativa (Marcado) ou não (Desmarcado). Por padrão todas as campanhas são criadas em estado Ativo.

Uma vez carregados os dados deve-se pressionar o botão “Salvar” r.

Condições Gerais

Esta opção se encontra dentro do menu “Operação” do console do PROMO e permite definir condições onde se possa indicar quais itens ficam incluídos ou excluídos na avaliação das promoções vigentes no mapa que as contenha.

Estas “Condições Gerais” serão incluídas dentro do mapa do Promo e serão o primeiro que o motor considerará, de forma tal que ao se avaliar o contexto, os elementos incluídos em tais condições sejam incluídos ou excluídos da avaliação de promoções.

Ao clicar na nova seção “Condições Gerais”, será gerada a tela “Gestão de Condições Gerais”

Dá para pesquisar tanto por nome como por código da condição geral.

A grade da tela “Gestão de Condições Gerais” mostrará as condições geradas.

Ao clicar no botão “Nova Condição” será gerada a tela “Nova Condição Geral”, onde serão apresentados os seguintes dados para registrar uma nova condição:

• Nome: nome único da condição. Não poderá ser repetido. Alfanumérico máximo 200 caracteres.
• Código: código único da condição. Não poderá ser repetido. Alfanumérico máximo 20 caracteres.
• Descrição: Alfanumérico máximo 200 caracteres. 
• Workflow: Será possível selecionar entre os múltiplos workflows ou passos de aprovação definidos para dar como aprovada uma Condição Geral.

Quando se pressionar “Salvar” será gerada a tela “Definir Condição”. Caso se pressione “Cancelar”, voltará para a tela “Gestão de Condições Gerais”, sem salvar nenhuma mudança.

Na tela “Definir Condição” só serão mostradas as seções “Cabeçalho”, “Condições de Faixa Horária” e “Condições Simples”.

Será possível gerar Condições Gerais com uma vigência determinada ou que aplique com uma frequência definida por meio da definição das condições de Faixa Horária.

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

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

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

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

• Por Produto:
  Será possível incluir ou excluir itens, sejam definidos por SKU, marca ou qualquer outro atributo do produto, da avaliação de promoções.

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

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

• 
  

• 
  

• 
  

• 
  

• 
  

• • Por Cupons:

  > Se na transição for colocado o cupom com tipo “Igual a” 111, as promoções serão avaliadas.

  > Se na transição for colocado o cupom com tipo “Diferente de” 111, as promoções serão avaliadas.

  • Por Clientes:

  > Se na transação for colocado um cliente com tipo “Igual a” VIP, as promoções serão avaliadas.

  > Se na transação for colocado um cliente com tipo “Diferente de” VIP, as promoções serão avaliadas.

  • Por Meios de Pagamento:

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

  > Se na transação for colocado um meio de pagamento com banco “Diferente de” RIO, as promoções serão avaliadas.

  • Por Cartões de Fidelidade:

  > Se na transação for colocado um cartão de fidelidade com tipo “Igual a” Pontos, as promoções serão avaliadas.

  > Se na transação for colocado um cartão de fidelidade com tipo “Diferente de” Pontos, as promoções serão avaliadas.

  • Por Transação:

  > Se a transação é realizada em uma loja “Igual a” 658, as promoções serão avaliadas.

  > Se a transação é realizada em uma loja “Diferente de” 658, as promoções serão avaliadas.

  
  

• 
  

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

  
  

  As Condições Gerais poderão ser Simuladas somente quando participarem de um mapa. Ao simular um mapa que contenha uma Condição Geral deverá ser mostrado por tela que a Condição Geral aplicou, e qual foi o resultado, tenham as promoções sido aplicadas ou não. Não poderão ser simuladas na opção das Promoções já que não possuem benefícios.

  
  Promoções

Uma promoção é uma ferramenta de marketing utilizada para informar, persuadir e lembrar da existência de um produto ou serviço aos consumidores potenciais, com a esperança de influir nos sentimentos, crenças ou comportamento do destinatário e estimular assim a demanda.

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

Para o PROMO, uma promoção é uma função que adota um contexto (Contexto: são todos os elementos que formam parte de uma transação (produto, cupons, clientes, eventos, meios de pagamento) e os dados próprios da transação (número de loja, terminal, data e hora).) como entrada e devolve um novo contexto (com os benefícios resultantes e elementos beneficiados) como saída e os informa à aplicação do ponto de venda.

Para que uma promoção seja considerada “Completa” deverá ser definida nela, pelo menos, uma “Condição” e um “Benefício”.

Uma “Condição” pode ser conformada por elementos ou uma coleção de elementos relacionados que cumprem com certas características definidas. Denominaremos conjuntos à conformação desses elementos.

Os conjuntos também poderão ser conformados com todos os elementos do tipo que tenham sido selecionados, sem necessidade de configurar por algum tipo de atributo em especial.

Para acessar tela de “Gestão das Promoções” deve-se selecionar dentro do menu “Operação” a opção “Promoções”.

Será apresentada a seguinte tela, onde serão listadas as promoções já geradas indicando seu estado, como também poderão ser geradas novas promoções no botão “Nova Promoção”.

A tela de Gestão das Promoções mostrará os seguintes filtros não obrigatórios de pesquisa de promoções: Código, Nome de promoção, Tipo de promoções, Subtipo de promoções, Formas de aplicação, Estado, Campanha e Vigência.

A partir da versão 7.0.15, debaixo dos filtros de pesquisa serão mostrados dois campos para navegar os registros, são os filtros de paginação, que por default ao entrar mostrarão 1 (um) e 50 (cinquenta), dessa maneira, mostrará por tela os primeiros 50 registros partindo do primeiro registro.

Se quer ver os dois registros anteriores deverá pressionar a flecha dupla que se encontra à esquerda. O sistema automaticamente modificará o valor do campo no qual realiza a pesquisa. 

Quando se estiver buscando a partir de 1 a flecha dupla da esquerda estará desabilitada (se passar o cursor do mouse sobre esse botão mostrará o sinal proibido). Quando se chegar ao final da lista a flecha dupla da direita será desabilitada (se passar o cursor do mouse sobre esse botão mostrará o sinal proibido). Dessa forma será possível navegar o informe vendo em tela, a partir do registro indicado, a quantidade de registros colocada. Será possível ver, no máximo, 1.000 (mil) registros por tela.

Menu Ações

À direita de cada Promoção, independentemente desta se encontrar em estado Incompleto, completa ou distribuída, aparecerá o botão “Ações”, no qual poderão ser realizadas diferentes ações sobre uma promoção.

Essas ações são:

• Editar: Nesta opção poderá ser acessado o cabeçalho da promoção. Só estará disponível caso a promoção esteja em estado “incompleto” ou “completo”. Caso esteja em estado “Distribuído”, com a habilitação de edição dada por configuração (deployedEditable.enabled) também estará disponível a opção editar.
• Definir: Nesta opção poderá ser acessado o corpo da promoção. Só estará disponível caso a promoção esteja em estado “incompleto” ou “completo”. Caso esteja em estado “Distribuído”, com a habilitação de edição dada por configuração (deployedEditable.enabled) também estará disponível a opção definir.
• Mudar imagem: Será possível carregar ou trocar por uma imagem associada à promoção.
• Resumo: Mostra um pop-up com o detalhe da promoção.
• Histórico WF: Será possível visualizar o circuito de Workflow pelo qual a promoção passou.
• Copiar: Será possível realizar uma nova promoção a partir da cópia de uma existente.
• Distribuir: (a partir de 7.0.2) Será possível realizar uma distribuição imediata da promoção. Os requisitos para que esta opção apareça no menu são:
  
  

• Que a promoção tenha sido distribuída a uma loja de Produção.
• Que a opção de Editar promoções distribuídas esteja habilitada por configuração no console do Promo (deployedEditable.enabled).
• Que tenha sido feita alguma mudança sobre a promoção em sua definição (condições e/ou benefícios).
  
  

Nova Promoção

 Deve-se levar em conta que uma promoção deve estar composta por ao menos uma condição e um benefício para que seja considerada “Completa”.

• Condições Simples e/ou por composição: São as restrições definidas para uma promoção. Estas restrições devem ser cumpridas para poder acessar o benefício que a promoção conceda.
  
  Simples: são os requisitos que devem ser cumpridos para a obtenção de um benefício. As condições simples serão definidas por meio de elementos que podem estar presentes dentro de uma transação como ser Produtos, Cupons, Clientes, Eventos, Meios de pagamento, Cartões de fidelidade, Benefício Externo e/ou dados próprios da transação (Loja, Terminal, Canal, Cadeia, Formato, Zona, Subzona). Cada um desses elementos terá atribuídos atributos ou característica que os elementos deverão cumprir para fazer mais específica a configuração da condição. Os atributos indicados neste manual são os do produto base, pelo qual deve-se ter em conta que cada cliente pode estender e adaptar os atributos conforme 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 sobre cada um desses conjuntos de elementos. Uma condição por composição pode estar formada por N conjuntos de Produtos, Cupons, Clientes, Meios de Pagamento e/ou Cartões de fidelidade.

• IMPORTANTE

  Nas promoções por combo, o(s) elementos a beneficiar DEVEM estar definidos dentro da mesma condição por composição ou combo.

  • Benefícios: É uma vantagem econômica ou material concedida a um cliente diante do cumprimento de certas condições. 
    
    

• Registro de Nova Promoção

  Deve-se pressionar o botão “Nova Promoção” na janela de “Gestão de promoções”, e serão mostradas as seguintes seções:

  Cabeçalho: nesta seção deverão ser colocados os seguintes dados:

  • Nome: nome mediante o qual a promoção será identificada (obrigatório).
  • Código: indica o código interno da promoção (é opcional e pode-se configurar que seja obrigatório).
    
    
    

• Descripción: este campo puede ser utilizado por el usuario para ingresar toda la información necesaria respecto de la Promoción que se está definiendo. (opcional)
• Workflow: Podrá seleccionarse entre los múltiples workflows o pasos de aprobación definidos para dar como aprobada una promoción.
• Campaña: se deberá seleccionar alguna de las campañas definidas para promociones.
• Canales de publicación: se deberá seleccionar entre los distintos canales de publicación definidos.

• • Punto de venta
  • Facebook
  • Twitter

• Avaliar condição em combo: ao marcar esta opção, indica-se que a promoção que está sendo definida terá ao menos uma condição simples e uma condição composta (combo). Ao serem avaliadas as promoções com esta marcação, será verificado que cada combo conformado na transação cumpra com a condição simples definida. Do contrário, se a promoção é definida sem este check ativo, a(s) condições serão avaliadas de maneira independente umas das outras.

• Reportar Participantes: Ao marcar este check, quando for avaliada a promoção, será informado ao ponto de venda todos os elementos que participarão da condição e benefícios.

• Tipo de promoções: deverá ser selecionado o tipo de promoção entre as opções propostas. (obrigatório).

• Subtipo de promoções: deverá ser selecionado o subtipo da promoção entre as opções propostas (obrigatório).

• Formas de aplicación de promociones: deberá seleccionarse la forma de aplicación de promociones entre las opciones propuestas. (obligatorio).

Sugestão 

• Habilita sugestões: será possível ativar esse quadrado caso se queira sugerir uma promoção em especial.
• Mensagem do POS: Caso se marque a opção anterior, deverá ser colocada a mensagem para mostrar na tela do POS quando a promoção for sugerida.

Imagem associada

• Descrição: este campo pode ser utilizado pelo usuário para colocar toda a informação necessária a respeito da imagem carregada.
• Imagem associada: Mostrará a imagem selecionada.
• Subir Imagem: Pode-se carregar uma imagem de um diretório específico.

Uma vez carregados esses campos conforme corresponda, deve-se pressionar o botão “Salvar” e será gerada a tela de “Definição de promoção”.

Definir uma Promoção

Para concluir o processo de geração de uma promoção devem ser completados os seguintes dados na tela “Definir Promoção”.

Cabeçalho: Mostra os dados colocados na tela anterior. Os dados mostrados na caixa vermelha serão trazidos pelo sistema (a partir da versão 7.0). Dispõe-se de um botão “Editar” (permite voltar a editar o cabeçalho) e um botão “Resumo”.

Resumo de promoção:

O Resumo mostrará os dados principais da promoção, suas condições e benefícios. Os dados mostrados na caixa vermelha serão mostrados pelo sistema a partir da versão 7.0)

Imagem associada: Caso não tenha sido carregado uma anteriormente, será possível realizar o carregamento na opção “Adicionar imagem”.

Definir Condições por Faixa Horária: 

As condições do tipo Faixa Horária são aquelas que avaliam características próprias da transação em curso, permitindo criar condições baseadas em dados próprios tais como data com hora, hora e periodicidade. 

• Condição Data com hora: Dentro desta condição pode-se definir uma condição por “data e hora” indicando desde e até.

• • Condição de hora: Aqui pode ser definida uma condição de horário, definindo nos campos desde e até, horas e minutos.

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

Em Data início, vai trazer por default a data atual. Neste campo será indicada a data que dará início à frequência que será indicada a seguir. No campo Aplica a cada, deve deixar em suspenso o combo dia/s para selecionar o tipo de frequência desejada.

Pode selecionar as seguintes frequências:

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

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

(Em Dias que aplica, pode selecionar vários dias pressionando a tecla Ctrl e clicando com o mouse).

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

Cabe esclarecer que para este caso deve ser definida com antecedência uma faixa horária, onde seja dada uma data inicial e fim na qual será aplicada cada x dia do mês. Se não for definida uma faixa horária a aplicação da promoção cada x dia do mês selecionado será repetida de forma indefinida. Por este motivo, a Data inicial fica cinza e não pode-se editá-la nesta tela.

• Aplica a cada x dia 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 anterior a “dia do mês”, mostrará como opções todos os números, de 1 a 31.

Antes de criar este tipo de frequência é necessário que adicione a condição de data com hora. Nesta tela não será habilitada a edição da Data inicial porque se adota a de data com hora.

Caso o usuário selecione o dia 31 de um determinado mês, na faixa de meses que tenha selecionado nem todos terão 31 dias, por isso o Promo aplicará a promoção no último dia de cada mês, conforme corresponda.

Se for selecionado, por exemplo, o dia 31 de janeiro, ao aplicar a promoção em fevereiro, como este só tem 28 ou 29 dias, o PROMO aplicará no último dia desse mês.

Definir Condições simples

Elementos

Chamaremos Elementos aos diferentes tipos de componentes que poderão fazer parte de uma promoção. Estes componentes serão parte tanto da condição da promoção como também do benefício.

Deve-se selecionar o(s) tipos de elementos sobre o qual se definirá a condição utilizando os seguintes botões:

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

• • • • • Produtos:
        • Código (SKU): Utilizado para determinar a seleção dos artigos através de seu código SKU.
        • Preço Unitário: Atributo utilizado para determinar se o item integra o conjunto pelo preço do mesmo.
        • Marca: Utilizado para determinar a seleção dos artigos através da marca do item.
        • Fornecedor: Utilizado para determinar a seleção dos artigos através do fornecedor do item.
        • Departamento: Utilizado para determinar a seleção dos artigos através de seu departamento, é definido como o primeiro nível dentro de uma hierarquia de produtos.
        • Família: Utilizado para determinar a seleção dos artigos através da família à qual o item pertence, é definido como o segundo nível dentro de uma hierarquia de produtos.
        • Categoria: Utilizado para determinar a seleção dos artigos através da categoria à qual o item pertence, é definido como o terceiro nível dentro de uma hierarquia de produtos.
        • Subcategoria: Utilizado para determinar a seleção dos artigos através da subcategoria a qual o item pertence, é definido como o quarto nível dentro de uma hierarquia de produtos.
        • Aplicável para TODOS: Caso esta opção seja selecionada estarão sendo incluídos no conjunto da condição todos os itens que possam postos na transação, sem considerar os atributos particulares de cada um.
         
        • Cupons:
        • Tipo: pode ser utilizado para definir o tipo de cupom que se deseje que integre o conjunto.
        • Id: é utilizado para definir o id ou número de cupom que se deseje que integre o conjunto.
        • Aplicável para TODOS: Caso esta opção seja selecionada estarão sendo incluídos no conjunto da condição todos os cupons que possam ser postos na transação, sem considerar os atributos particulares de cada um.

• Clientes

• Tipo: é possível utilizar para definir o tipo de cliente que integrará o conjunto (Ex.: funcionário, cliente normal, cliente frequente etc.).
• Id: é utilizado para definir o id ou número de cliente que se deseje que integre o conjunto.
• Montante restante: para promoções especiais nas quais seja necessário limitar o valor sobre o qual aplicar um X desconto, relacionado com o cliente que tenha sido colocado no ticket.
• Segmento: Será possível indicar se o cliente participante da promoção que está sendo definida pertence a algum segmento ou faixa de cliente em particular.
• Perfil do Cliente: é utilizado para definir uma categoria de cliente.
• Campanha De Crédito: é utilizado para indicar a campanha que o cliente pode utilizar.
• Aplicável para TODOS: Caso esta opção seja selecionada estarão sendo incluídos no conjunto da condição todos os clientes que possam ser postos na transação, sem considerar os atributos particulares de cada um.

• Importante

  Em Administração\ Informação de Configuração pode-se configurar que seja ou não obrigatória a entrada de Cliente.

  Requer condição de Cliente (default=false)

  
  

  
  

  • Eventos: Um evento é uma ocorrência ou acontecimento produzido dentro da transação que pode determinar uma ação a seguir a partir de sua ocorrência. Por Exemplo, o cliente número 10.000. 
    
    
    • Número: é utilizado para definir o id ou número de evento.
    • Tipo de transação: pode-se utilizar para definir o tipo de evento.
    • Valor: é utilizado para definir um possível valor que o evento deveria ter.
    • Aplicável para TODOS: Caso esta opção seja selecionada estarão sendo incluídos no conjunto da condição todos os eventos que possam ser postos na transação, sem considerar os atributos particulares de cada um.
   
  • Meios de Pagamento:
  • Código: é utilizado para definir o id ou código de meio de pagamento que se deseja que integre o conjunto.
  • Tipo: pode-se utilizar para definir o tipo de pagamento que se deseja que integre o conjunto.
  • Banco: pode-se utilizar para definir o banco emissor do meio de pagamento que se deseja que integre o conjunto.
  • Plano: é utilizado para definir o(s) planos que o meio de pagamento deveria cumprir para integrar o conjunto.
  • Parcelas: é utilizado para definir a quantidade de parcelas do plano.
  • Prefixo: é utilizado para definir o prefixo que o meio de pagamento deveria cumprir para integrar o conjunto.
  • Bolso: Poderá indicar qual bolso ou subtipo de cartão será avaliado como condição. Exemplo, Cartão A, Bolso Combustível. Quando for definida uma condição pelo atributo “Bolso” será exigido o carregamento prévio de uma condição pelo atributo “Prefixo” do elemento Meio de Pagamento.
  • Grupo de prefixos: pode-se utilizar para definir o Grupo de prefixo, registrado no Promo, que se deseja que integre o conjunto.
  • Campanha De Crédito: é utilizado para definir uma campanha relacionada com um meio de pagamento.
  • Aplicável para TODOS: Caso esta opção seja selecionada estarão sendo incluídos no conjunto da condição todos os meios de pagamento que possam ser postos na transação, sem considerar os atributos particulares de cada um.
    
    
    
  • Cartões de Fidelidade:
  • Id: é utilizado para definir o id ou número da ou os cartões de fidelidade que se deseje que integre o conjunto.
  • Tipo: é utilizado para definir o tipo da ou os cartões de fidelidade que se deseje que integre o conjunto.
  • Convênio: é utilizado para definir o convênio ao qual pertencerá o cartão que se deseje que integre o conjunto.
  • Aplicável para TODOS: Caso esta opção seja selecionada estarão sendo incluídos no conjunto da condição todos os cartões de fidelidade que possam ser postos na transação, sem considerar os atributos particulares de cada um.
    
    
  • Benefício Externo: é um benefício informado pelo POS e o motor do Promo o devolverá como próprio.
  • Id: é utilizado para definir o Identificador do benefício.
  • Tipo: é utilizado para definir o Tipo de benefício.
    
    
    
  • Transação:
  • Terminal: é utilizado para definir o id ou número de terminal que se deseja que integre o conjunto.
  • Loja: é utilizado para definir o id ou número de loja que se deseja que integre o conjunto
  • Canal: via ou canal no qual está sendo realizada a venda.
  • Cadeia: cadeia ou linha no qual está sendo realizada a venda.
  • Formato: é um atributo que será aplicado ao tipo de varejo que tenha que avaliar. Por exemplo: hipermercado, mercado, supermercado, atacadista. Estes são exemplos, já que cada cliente poderá utilizá-lo conforme suas necessidades.
  • Zona: zona geográfica a partir da qual é feita a transação.
  • Subzona: subzona geográfica a partir da qual é feita a transação.
  • Moeda: será possível utilizar multimoeda. Será permitida a escolher para qual tipo de moeda a promoção será aplicada. No momento de fazer a transação no POS será possível escolher a moeda, essa informação chegará à Promo e dependendo do tipo de moeda recebido a promoção será ou não aplicada.
  
  
  

Utilizando as flechas presentes na definição de cada elemento se colocará em modo suspenso a lista de atributos e dentro de cada atributo será visualizada uma lista de comparadores.

Comparadores

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

• IGUAL
• DIFERENTE
• MAIOR
• MENOR

Por exemplo, pode ser gerada uma condição pelo elemento “Produto”, selecionando o atributo “Código (SKU)” e o comparador “IGUAL”, onde será apresentada a seguinte tela:

Aqui também é possível carregar os dados da condição por meio de um arquivo, pressionando o botão “Selecionar Arquivo”. O arquivo a carregar poderá ser um .xls ou um arquivo de texto plano separado pelo delimitador configurado.

Nesta tela poderá ser selecionado o tipo de “Operações entre os elementos”. Com eles poderão ser relacionados elementos através dos seguintes operadores lógicos: 

• “E” ALÉM DO MAIS QUE SEJA CUMPRIDO: Os elementos definidos sob este operador deverão ser cumpridos sempre. Permite combinar duas ou mais condições em uma condição composta que será dada como cumprida se todas as condições integrantes o forem.
• “OU” QUE SEJA CUMPRIDO: Os elementos definidos sob este operador podem ser cumpridos ou não. Permite combinar duas ou mais condições em uma condição composta que será dada como cumprida se ao menos uma das condições integrantes o for.

Exportação de dados de uma Condição Simples ou Condição por Composição no Excel (“a partir de vEP2.2”):

No momento de definir uma Condição Simples ou uma Condição por Composição, poderá exportar os dados colocados para um arquivo Excel, selecionando na tela anterior o botão “EXCEL”. Esta opção será apresentada em todos os pop-ups de todos os atributos de elementos, seja definido por “Igual” ou “Diferente”. Ao pressionar o botão “EXCEL” será baixado um arquivo .xlsx de uma só folha, com os dados presentes no pop-up. Serão apresentados na mesma ordem na qual foi posto o pop-up e localizados na coluna A, um debaixo do outro. O nome do arquivo conterá o código da promoção, o tipo de condição, o elemento e o atributo que está sendo baixado. 

Exemplo:

• Promo_2655_CondiçãoSimples_Produto_SKU

Exportação de dados quando o pop-up de edição estiver bloqueado por quantidade de dados (“a partir de vEP2.2”):

Quando forem carregados no pop-up de condições mais de “500” posições será bloqueada a possibilidade de edição manual do pop-up, e, caso tenha que editar os dados colocados, o sistema solicitará eliminar todos os dados e voltar a carregá-los.

O botão marcado em vermelho na seguinte tela permitirá que se baixe o Excel com os dados da condição quando esta superar a quantidade de dados permitidos. Este botão só aparecerá quando a opção de edição da condição estiver bloqueada por exceder a quantidade de dados permitida para a edição.

Será possível selecionar a quantidade de atributos que deseje para definir na condição. Por exemplo, produtos com Grupo igual a Eletrônica, e que além disso sejam de Marca igual a SONY, WHIRLPOOL, HITACHI, PANASONIC e PHILIPS.

Cada elemento tem a opção de poder selecionar “Aplicar a TODOS” e, ao fazê-lo, a condição será aplicada a todo o conjunto do elemento selecionado.

   Condições Simples - Agrupamento

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

Para definir um critério de agrupamento, deve-se clicar no ícone de “Lápis” apresente à direita do elemento que se quer agrupar (neste exemplo, o elemento Produtos).

Será apresentado o pop-up “Condições simples (agrupamento)” com um menu suspenso que mostrará opções de agrupamento.

Para cada atributo de aplicação são utilizados os seguintes comparadores:

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

Se for selecionado, por exemplo, “Maior que”, será colocado em modo suspenso o pop-up com as seguintes opções:

Neste exemplo, será possível indicar para o elemento “Produto” os critérios de agrupamento por “Quantidade”, “Medida” ou “Preço Total”, como se mostra na seguinte imagem:

Se em vez do elemento “Produto” ter sido selecionado o elemento “Clientes”, os critérios de agrupamento a serem mostrados serão “Saldos” e “Pontos”.

O PROMO permite gerenciar conjuntos por agrupamento dos seguintes elementos:

• Produto
• Quantidade: É utilizado para determinar uma determinada quantidade de determinado artigo.
• Medida: Atributo utilizado para determinar uma medida, como:

• peso (para artigos pesáveis: alimentos etc.)
• comprimento (para artigos comercializados por metro: telas, tapetes etc.)
• volume (para artigos comercializados a granel ou por volume - metro cúbico ou metro quadrado – Ex.: areia, cerâmicos etc.).
  
  
• Preço Total: É utilizado para definir o preço total de todos os elementos definidos.
  
  
• Cupom
• Quantidade: é utilizado para definir a quantidade de cupons que se deseja que integrem o conjunto.
• Montante: é utilizado para definir o valor que os cupons que integram o conjunto deverão adicionar.
• Meios de Pagamento
• Montante.

• • • • Clientes 
      • Saldos
      • Pontos
      • Cartões de fidelidade
      • Montante
        
        

    Outros exemplos de agrupamento poderiam ser:

    
    

    • A quantidade dos produtos na transação for maior que 10 unidades.

• • • • A compra mínima for de 1500 pesos.

Definir Condições por composição

As promoções por composição, combo ou pacotes são aquelas aplicadas ao ser cumprida a formação de um subticket com os dados do contexto recebidos do POS. Esta forma de definição das Promoções terá em consideração as interações no cumprimento da condição definida. Por exemplo: “2X1 em Fanta”. (A cada duas Fantas vendidas será aplicado 100% de desconto em uma)

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

Um combo pode estar composto por N componentes.

Para poder criar estas promoções deve-se adicionar um ou vários elementos na seção “Condições por composição”.

Cada componente de um combo está integrado por um elemento, os quais terão cada um sua própria configuração. 

Os “Combos” são agrupamentos ou subtickets dentro do contexto da transação e os benefícios serão aplicados ao serem cumpridas as condições indicadas em tais subtickets, como se fosse um ticket completo.

Para adicionar um componente de combo deve-se selecionar o botão “Adicionar” e serão colocados em modo suspenso os elementos com os quais poderão ser definidos os combos, como se mostra na seguinte imagem: 

Ao selecionar um dos elementos será mostrado o seguinte pop-up: (para este exemplo foi selecionado o elemento “Produtos”)

Em um Componente Combo são associados os seguintes dados:

• Limite de aplicação: Indica o limite máximo de combo a se formar dentro de uma transação. Este parâmetro não admite como valor o 0 (zero), mas se não for definido um Limite (deixando o quadrado em branco) poderão ser formados quantos combos sejam possíveis por transação. O campo não é obrigatório.
• Tipo de elementos: Elementos com os quais serão preparados os combos, e são definidos na primeira instância da definição de condição por composição (produtos, cupons, clientes, meios de pagamento e cartões de fidelidade).
• 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 admite como valor o 0 (zero).
• Ocorrências Máximas: Valor real que representa a quantidade máxima necessária para compor a condição. Este parâmetro não admite como valor o 0 (zero).

• Unidade de medida: Este parâmetro define o critério com o qual será realizada o agrupamento do conjunto. 

Se o “Tipo de Elementos” selecionado é “Produto”, o combo suspenso de Unidade de medida mostrará as opções “Quantidade”, “Magnitude”, “Preço Total”.

Se o “Tipo de Elementos” selecionado é “Cupons”, o combo suspenso de Unidade de medida mostrará as opções “Quantidade” e “Montante”.

Se o “Tipo de Elementos” selecionado é “Meios de pagamento”, o combo suspenso de Unidade de medida mostrará a opção “Montante”.

Se o “Tipo de Elementos” selecionado é “Clientes”, o combo suspenso de Unidade de medida mostrará as opções “Saldo” e “Pontos”.

Se o “Tipo de Elementos” selecionado é “Cartões de fidelidade”, o combo suspenso de Unidade de medida mostrará a opção “Montante”.

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

• Critério de ordem: Indica o critério de ordenamento dos elementos do conjunto definido. (Os mais caros primeiro, Um mais caro por combo, Os mais baratos primeiro, Um mais barato por combo).

• Critério de equivalência: Este tipo de parâmetro indicará os atributos pelos quais poderá ser definida uma equivalência ou igualdade entre os elementos que conformarão o conjunto, por exemplo, “Levando dois sucos do mesmo sabor, 2X1 em sucos de Marca X”, neste caso o critério de equivalência seria o código dos Sucos da marca X, já que vai agrupar cada dois do mesmo sabor.

• Critério de não equivalência: Este tipo de parâmetro indicará os atributos pelos quais poderá ser definida uma não equivalência ou desigualdade entre os elementos que conformarão o conjunto, por exemplo, “Levando dois sucos de sabor diferente, 2X1 em sucos de Marca X”, neste caso o critério de não equivalência seria o código dos Sucos da marca X, já que vai agrupar cada dos sucos de sabor diferente.

Exportação no Excel de dados carregados nas condições

Será possível tanto nas definições de condições simples como em condições por composição exportar para o excel os dados carregados. Para isso deve-se pressionar no botão “EXCEL” que se localiza na margem inferior direita dos pop-ups.

Esse botão só estará ativo quando houver ao menos um elemento carregado na condição.

Ao pressionar o botão “EXCEL” será baixado um modelo com todos os dados contidos na condição.

No nome do arquivo serão detalhados a promoção e o tipo de condição a que pertence. Exemplo: “10001_condição_simples_produtos_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 concedida a um cliente diante do cumprimento de certas condições.

Os benefícios são aplicados sobre todo o conteúdo do ticket ou sobre os subtickets conforme tenham sido preparados por condições simples ou condições por composição.

As promoções definidas por condições simples entregam o benefício com apenas o cumprimento da(s) condição(ções) definida(s).

As promoções com condições por composição entregam o benefício sobre cada pacote ou combo definido.

Deve-se pressionar “Novo benefício” para acessar janela de definição do benefício.

Será apresentada a tela “Novo Benefício”, onde são mostradas as seguintes opções:

• Promoção: Mostra o nome da promoção.
• Aplica sobre condições?: Por padrão, este quadrado se encontrará marcado, pelo qual o benefício será aplicado sobre os mesmos elementos definidos na condição. Se for desmarcado no momento de registrar o benefício, o universo de aplicação do benefício deverá ser definido manualmente, podendo indicar outro(s) elemento(s) que não fazem parte da condição. Caso se opte por utilizar os mesmos elementos para a definição do universo de aplicação, este último poderá ser editado, mas ao fazê-lo, o check “Aplica sobre condições” será filtrado automaticamente, já que o conjunto beneficiado deixará de ser o mesmo que o conjunto da condição. Na edição dos benefício este check permanecerá cinza.
• Tipo de benefício: Refere-se se o benefício é Financeiro ou Não Financeiro. Deste valor dependerá o comportamento do benefício.

Benefícios Financeiros:

Caso seja selecionada em Tipo de Benefício a opção Financeiro, em “Classe de Benefício” poderão ser selecionados:

• Reembolso de Voucher Calculado: será aplicado o montante de desconto informado pelo cupom colocado para a transação. (Para visualizar esta opção o cliente deverá ter adquirido o módulo de fidelidade do PROMO).

• Benefício Externo: é um benefício informado pelo POS e que o motor do Promo devolve como próprio. Deve-se indicar o ID do benefício externo que será aplicado.

• Reembolso com Opções: Nesta classe de Benefício, será possível indicar, com base nos pontos apresentados pelo cliente, quais opções de benefícios monetários poderá acessar, entre os quais estão: “Desconto Fixo”, “Desconto Porcentagem” e “Novo Preço”. Estas opções de benefício serão informadas ao POS, para que o cliente escolha e conforme o escolhido, e será aplicado o benefício correspondente.

• Pontos de Fidelidade + Desconto Monetário

Exemplo: “Apresentando 10 Pontos de fidelidade Vermelhos” obtém 50% de desconto em refrigerantes

• Desconto Fixo: é aplicado um desconto de um montante fixo sobre o preço dos elementos do conjunto item que tenha sido selecionado. Pode ser aplicado sobre cada unidade (sobre a quantidade ou sobre a magnitude) ou sobre todos os elementos do conjunto.

• Desconto Porcentagem: é aplicado um porcentagem de desconto sobre o preço dos elementos do conjunto item que tenha sido selecionado. Pode ser aplicado sobre cada unidade (sobre a quantidade ou sobre a magnitude) ou sobre todos os elementos do conjunto.

• Novo Preço: é atribuído um Novo Preço aos elementos do tipo produto que tenha sido selecionado e aplica-se como desconto a diferença entre o preço original e o novo preço. Pode ser aplicado sobre cada unidade (sobre a quantidade ou sobre a magnitude) ou sobre todos os elementos do conjunto. Por exemplo: se o produto vale $10 e o novo preço é $8, é dado um desconto de $2. Quando deve ser aplicado um novo preço, o motor calculará a diferença ente o preço do produto e o novo preço informado pelo benefício, e aplicará como desconto ou recarga, conforme corresponda.

• • Reembolso de Pontos: aplica-se um desconto calculado pela promoção, com base na quantidade de pontos, dinheiro, montantes etc. Colocados na transação ao apresentar o cartão de fidelidade que os contém. (Para visualizar esta opção o cliente deverá ter adquirido o módulo de fidelidade do PROMO).
    
    
  • Desconto por convênio: será aplicado uma porcentagem de desconto sobre o preço dos elementos do conjunto de itens participantes. Pode ser aplicado sobre cada unidade (sobre a quantidade ou sobre a magnitude) ou sobre todos os elementos do conjunto. Este benefício operará da mesma forma que o “Desconto por porcentagem”, só que quando for definido um limite nele, este só poderá ser por Clientes e acumulará somente Dinheiro. Nos casos nos quais este benefício seja aplicado e tenha sido identificado na transação um cliente, sobre ele se acumulará o montante do desconto aplicado e este se ajustará o desconto ao limite definido sem possuir uma margem para exceder (Estes tipos de benefício só poderão ser aplicado sobre os elementos do tipo produto.)

• Definição de “Balanço” em Benefício Monetário “Desconto por Convênio”"

  Será possível indicar, no momento de definir o benefício Monetário, Desconto por Convênio, se o limite do cliente a considerar para o cálculo do montante do desconto a ser aplicado neste benefício é o gerido pelo Promo ou se o saldo do cliente será informado no POS.

  Caso seja informado pelo Pos, deve-se indicar no campo “Balanço”, podendo selecionar entre “Balanço 1” ou “Balanço 2”, conforme tenha sido integrado com o Pos.

  

  (Para mais informação, Ver Manual de Integração Promo 7.0 - Benefícios)

  
  
  

  • Reembolso de Pontos por Catálogo: aplica-se um desconto Percentual, Fixo ou Mudança de Preço de acordo com uma tabela predefinida para determinados produtos (ver Catálogos) em troca de uma quantidade de pontos também definida na mesma tabela. 

  (Estes tipos de benefício só poderão ser aplicados sobre os elementos do tipo produto.)

Para cada um dos benefícios Monetários também deve-se indicar:

• Montante, Porcentagem ou Preço, conforme corresponda ao benefício monetário selecionado.
• Unidade de medida sobre a qual aplicar. Este parâmetro permite definir sobre o que será aplicado o benefício, podendo selecionar entre Cada unidade de quantidade, Cada unidade de magnitude Todo.
• Porcentagem, quantidade e tipo, se é que se trata de um cupom calculado.
• Tipo e Fator: Caso se trate de um benefício de reembolso de pontos.
• Valor de Recuperação: é utilizado para indicar o valor que vai concorrer com outra promoção na análise do mapa, caso seja utilizada esta promoção com uma função de “Desconto máximo combinado”, e é dado como benefício o mesmo valor que outra promoção nesse mesmo mapa sob a mesma função. Será concedida a promoção que neste campo tenha o maior valor. Por ex.: se duas promoções dão $5 de benefício e ambas se encontram em um mapa sob a função “Desconto máximo combinado”, se o promo A tem um “Valor de recuperação” de 3 e “Tipo de Recuperação” é por ex. porcentagem e o promo B tem um “Valor de recuperação” de 5 e “Tipo de Recuperação” também é porcentagem, será concedido o benefício do promo B.
• Tipo de Recuperação: permite selecionar se o valor indicado no campo anterior é de tipo porcentagem ou montante fixo.
• Ratear entre participantes: (a partir de 7.0.3) será possível indicar se o montante do desconto concedido pelo benefício monetário definido será rateado entre os participantes da condição da promoção. Ex.: “Comprando umas batatas, um hambúrguer e um refrigerante, será beneficiado o mais barato a 100% e o montante do desconto é distribuído proporcionalmente entre os 3 itens que participam da condição”. (Disponível a partir do Promo V7.0.3).

<?xml version="1.0" encoding="UTF-8"?>
<message companyId="napse" store="1" terminal="1" date-time="2021-03-01 10:35:22" init-tck="true" messageId="1" void-trx="false" response="true" limitBalances="true" status="sales" evaluate="true" map-version="7" tckpath="Y" suggest="true">
<item-add seq="1" qty="1" code="123" level1="1121" magnitude="0" brand="Kumho" xprice="150" unitprice="150" />
<item-add seq="2" qty="1" code="456" level1="1121" magnitude="0" brand="Kumho" xprice="90" unitprice="90" />
<item-add seq="4" qty="1" code="789" level1="1121" magnitude="0" brand="Kumho" xprice="75" unitprice="75" />
</message>

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<message ack="0" companyId="napse" engine="7.0.0-SNAPSHOT#78" mapversion="7" messageId="1" store="1" terminal="1">
  <optional>
    <promo id="Prorratear entre Participantes" nro="603afe841082e836908173d1">
      <benefit TLOGMessage="Prorratear entre Participantes" account="" applicationMethod="resume" baseAmount="75.0000" benefitType="PercentageDiscount" discountPercentage="100.0000" displayMessage="Prorratear entre Participantes" name="603afe841082e836908173d1" nro="603afed81082e836908173e1" order="1" printerMessage="Prorratear entre Participantes" prorateBCP="true" prorationMethod="PROPORTIONAL" unit="qty">
        <apply>
          <item magnitude="0.000" qty="1.000" seq="1" value="35.71" valueWithTaxes="150.00" xprice="150.00"/>
          <item magnitude="0.000" qty="1.000" seq="2" value="21.43" valueWithTaxes="90.00" xprice="90.00"/>
          <item magnitude="0.000" qty="1.000" seq="4" value="17.86" valueWithTaxes="75.00" xprice="75.00"/>
        </apply>
      </benefit>
    </promo>
  </optional>
</message>

Benefícios NÃO Monetários:

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

• Benefício Geral: a aplicação do benefício é a entrega de um ou mais benefícios gerais que deverão ser interpretados pelo POS conforme corresponda a integração. (Exemplos de integração: Devolução do IVA - Caso Sucesso - O POS é quem calculará o montante do IVA dos itens e Promo, com base na aplicação deste benefício, indicará sobre quais itens aplicará benefício).
• Porta-moedas (a partir da versão 7.0.18): para poder vê-lo, deve ser ativada a funcionalidade Porta-moedas pelo Usuário Principal. Por default, a funcionalidade Porta-moedas vem desativada. É um benefício só informativo.

• Cupom: a aplicação do benefício é emitir cupons.
  
  

• Cupom calculado: a aplicação do benefício é emitir cupons por um determinado montante de desconto calculado com base no total da transação. (Para visualizar esta opção o cliente deverá ter adquirido o módulo de fidelidade do PROMO).

• • Coeficiente de fidelização: a aplicação do benefício é conceder um fator de multiplicação para a unidade utilizada para os sistemas de fidelidade.
  • Porcentagem de fidelização: aplica-se a porcentagem de pontos sobre o preço dos elementos do conjunto item que tenha sido selecionado. Permite calcular os pontos que correspondem conceder com base na porcentagem e no preço estendido dos artigos sobre os quais se aplica.
  • Pontos de fidelização: a aplicação do benefício é conceder pontos, milhas, pesos a um porta-moedas eletrônico ou à unidade utilizada para os sistemas de fidelidade. O motor de promoções calcula os pontos que concede este benefício, o qual pode ser aplicado sobre cada unidade (sobre a quantidade ou sobre a magnitude) ou sobre todos os elementos do conjunto. Isto é, agora será possível definir, mediante este benefício, vantagens como: concede pontos por cada artigo do departamento X ou concede P pontos na compra de artigos do departamento X.

<?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">
  <optional>
    <promo code="4280468" id="Canje con opciones - Redime puntos" nro="61545e4116f79a304cced688">
      <benefit TLOGMessage="Canje con opciones" a789="1" account="" applicationMethod="lineByLine" baseAmount="43900" benefitType="RedeemWithOptionsBenefit" displayMessage="Canje con opciones" name="61545e4116f79a304cced688" nro="6154627416f79a304cced6a8" order="1" printerMessage="Canje con opciones" prorationMethod="PROPORTIONAL" usedPoints="0">
        <apply>
          <item magnitude="0.000" qty="1.000" seq="1" value="0" valueWithTaxes="0" xprice="43900"/>
        </apply>
        <redeemOptions>
          <option benefitType="percentageDiscount" cardPoints="0.0" cardType="-" id="6154627416f79a304cced6a8_0" requiredPoints="500.0" unit="qty" value="20.0"/>
        </redeemOptions>
      </benefit>
    </promo>
    <promo code="4280467" id="Otorga Puntos" nro="6153983116f79a304cced625">
      <benefit TLOGMessage="Otorga Puntos de Fidelidad" account="" applicationMethod="lineByLine" baseAmount="43900" benefitType="FactorLoyaltyBenefit" displayMessage="Otorga Puntos de Fidelidad" name="6153983116f79a304cced625" nro="61545cc816f79a304cced685" factor="0" order="2" printerMessage="Otorga Puntos de Fidelidad" totalpoints="62" type="external">
        <apply>
          <item magnitude="0.000" points="62.71" qty="1.000" seq="1" value="0" valueWithTaxes="0" xprice="43900"/>
        </apply>
      </benefit>
    </promo>
  </optional>
</message>

<?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">
  <optional>
    <promo code="4280468" id="Canje con opciones - Redime puntos" nro="61545e4116f79a304cced688">
      <benefit TLOGMessage="Canje con opciones" a789="1" account="" applicationMethod="lineByLine" baseAmount="43900" benefitType="RedeemWithOptionsBenefit" displayMessage="Canje con opciones" name="61545e4116f79a304cced688" nro="6154627416f79a304cced6a8" order="1" printerMessage="Canje con opciones" prorationMethod="PROPORTIONAL" usedPoints="500">
        <apply>
          <item benefitTypeOption="percentageDiscount" benefitUnitOption="qty" cardType="-" cardUsedPoints="0" magnitude="0.000" nominalDiscount="8780" percentageDiscount="20" priceinPoints="6271" qty="1.000" redeemOption="6154627416f79a304cced6a8_0" seq="1" usedPoints="500" value="5280" valuePoints="3500" valueWithTaxes="5280" xprice="43900"/>
        </apply>
      </benefit>
    </promo>
    <promo code="4280467" id="Otorga Puntos" nro="6153983116f79a304cced625">
      <benefit TLOGMessage="Otorga Puntos de Fidelidad" account="" applicationMethod="lineByLine" baseAmount="35120" benefitType="FactorLoyaltyBenefit" displayMessage="Otorga Puntos de Fidelidad" name="6153983116f79a304cced625" nro="61545cc816f79a304cced685" factor="0" order="2" printerMessage="Otorga Puntos de Fidelidad" totalpoints="50" type="external">
        <apply>
          <item magnitude="0.000" points="50.17" qty="1.000" seq="1" value="0" valueWithTaxes="0" xprice="43900"/>
        </apply>
      </benefit>
    </promo>
  </optional>
</message>

<?xml version="1.0" encoding="UTF-8"?>
<message channel="T" cia="1" ciudad="58" companyId="napse" date-time="2021-08-30 18:23:17" evaluate="true" format="H" init-tck="false" limitBalances="true" localidad="1" map-version="712"
 status="sale" store="0013" storeChain="S" subZone="1" terminal="022" tipologia="hi" zonaprecio="E22" zone="1">
<payment-add amount="35120" balance="true" itemamount="35120" pointsType="external" seq="2" type="11"/>
</message>

<?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">
  <optional>
    <promo code="4280468" id="Canje con opciones - Redime puntos" nro="61545e4116f79a304cced688">
      <benefit TLOGMessage="Canje con opciones" a789="1" account="" applicationMethod="lineByLine" baseAmount="43900" benefitType="RedeemWithOptionsBenefit" displayMessage="Canje con opciones" name="61545e4116f79a304cced688" nro="6154627416f79a304cced6a8" order="1" printerMessage="Canje con opciones" prorationMethod="PROPORTIONAL" usedPoints="500">
        <apply>
          <item benefitTypeOption="percentageDiscount" benefitUnitOption="qty" cardType="-" cardUsedPoints="0" magnitude="0.000" nominalDiscount="8780" percentageDiscount="20" priceinPoints="6271" qty="1.000" redeemOption="6154627416f79a304cced6a8_0" seq="1" usedPoints="500" value="5280" valuePoints="3500" valueWithTaxes="5280" xprice="43900"/>
        </apply>
      </benefit>
    </promo>
    <promo code="4280467" id="Otorga Puntos" nro="6153983116f79a304cced625">
      <benefit TLOGMessage="Otorga Puntos de Fidelidad" account="" applicationMethod="lineByLine" baseAmount="35120" benefitType="FactorLoyaltyBenefit" displayMessage="Otorga Puntos de Fidelidad" name="6153983116f79a304cced625" nro="61545cc816f79a304cced685" factor="0" order="2" printerMessage="Otorga Puntos de Fidelidad" totalpoints="50" type="external">
        <apply>
          <item magnitude="0.000" points="50.17" qty="1.000" seq="1" value="0" valueWithTaxes="0" xprice="43900"/>
        </apply>
      </benefit>
    </promo>
    <promo id="PromotionPaidInPoints" nro="0">
      <benefit TLOGMessage="" account="" applicationMethod="" baseAmount="35120" benefitType="LoyaltyBenefit" displayMessage="" order="3" printerMessage="" totalpoints="-5" type="external" unit="" value="-5">
        <apply>
          <item magnitude="0.000" points="-4.99" qty="1.000" seq="1" value="0" valueWithTaxes="0" xprice="35120"/>
        </apply>
      </benefit>
    </promo>
  </optional>
</message>

• • Presente: a aplicação do benefício é conceder um presente de algum artigo ou prêmio extra (geralmente são artigos ou serviços não comercializados pela companhia, por exemplo: dar de presente entradas para o cinema, oferecer serviço de táxi grátis).
    
    
  • Plano de pagamentos: a aplicação do benefício é conceder planos de pagamento. Deve ser habilitada, para a correta aplicação do benefício “Plano de pagamento”, a opção de “Promoção Codificada” em Administração >> Informação de Configuração.

• Restituição Bancária: a aplicação do benefício é conceder uma restituição bancária. Para a correta aplicação do benefício “Plano de pagamento”, deverá ser habilitada a opção de “Promoção Codificada” em Administração >> Informação de Configuração.
  
  
  

Para cada uma das classes de benefícios Não Monetários, também deverão ser indicados:

• Coeficiente de Pontos de Fidelização, indica o Tipo de Pontos e Fator.
• Cupom, podendo indicar “quantidade” e “Tipo/Identificador”. (Se foi adquirido o Módulo de Fidelidade. será apresentado para a seleção um combo com os tipos de cupons ativos).
• Plano de Pagamento, podendo selecionar entre Plano de Pagamento, Tipo de Pagamento, Meio de Pagamento, Contas, Banco, Montante Limite, Prefixo, Porcentagem, Desconto/Sobretaxa.
• Porcentagem de Fidelização, podendo selecionar entre Porcentagem do preço em pontos e Tipo.
• Pontos de Fidelização, podendo selecionar entre Quantidade, Tipo e Por cada unidade de.
• Presente, podendo selecionar entre Quantidade, Id e Tipo.
• Cupom Calculado, podendo selecionar entre Porcentagem, Quantidade e Tipo.

Deve-se indicar no momento de definir o benefício os campos presentes em “Informação de Aplicação”.

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

• Aplicação máxima (medida): naqueles casos nos quais se deseja limitar a aplicação do benefício, será possível selecionar o atributo sobre o qual limitá-lo. As opções são: Quantidade, preço e magnitude.
• Desconto mínimo a aplicar: valor mínimo a ser aplicado no benefício. É só por montante e como “mínimo” se concede esse montante, sempre que não supere o valor do produto. Exemplos: Se o valor mínimo está definido em: 1.0. Se o benefício é 0.5 é dado 1 (ou seja, dá como mínimo o valor mínimo configurado). Se o benefício é 1.2 é dado 1.2 (dá o benefício porque como mínimo dá o valor mínimo configurado, se o benefício é 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 artigos 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 do maior ao menor os produtos beneficiados e nessa ordem aplicar o desconto.
• Mais barato primeiro: Refere-se a ordenar do menor ao maior os produtos beneficiados e nessa ordem aplicar o desconto.

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

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

• Aplicar sobre: Indica sobre qual preço do item será feito o cálculo do benefício. As opções de preços serão:
• Original: Refere-se a ser aplicado o benefício sobre o preço original do artigo.
• Beneficiado: Refere-se a ser aplicado o benefício sobre o preço já beneficiado do artigo.

• Critério de ordenamento: permite selecionar um critério para ordenar os itens sobre os quais será aplicado o benefício. Pode-se escolher entre:
• os mais caros primeiro: Refere-se ao ordenamento dos itens beneficiados com base no seu preço. Preços do maior ao menor.
• os mais baratos primeiro: Refere-se ao ordenamento dos itens beneficiados com base no seu preço. Preços do menor ao maior.
• indiferente: Sem ordenamento especifico dos itens beneficiados.

Limites de Aplicação:

Dependendo do tipo de benefício que está sendo definido, poderão ser geridos nesta seção diferentes “Limites” que indicarão quando será entregue ou não, um benefício com base em um estoque, seja geral do varejista, por loja ou por Cliente, permitindo levar ter controle mas geral das vezes em que foi concedido um determinado benefício ao longo de um determinado período.

O limite de aplicação de um benefício pode estar definido pela quantidade de Dinheiro, quantidade de benefícios concedidos por cliente, dia, lojas etc. e será configurado em cada benefício que aplique uma promoção. 

Em um mesmo benefício poderão ser definidos um ou mais limites, mas esses deverão ser sempre diferentes, isto é, não será permitido definir um mesmo tipo de limites, por exemplo, por loja que acumule dinheiro, em um mesmo benefício. Ao definir mais de um limite, quando tenha sido alcançado ao menos um deles a promoção não aplicará mais o benefício limitado.
Se uma promoção possui vários benefícios definidos e só um desses tem um limite de aplicação definido, alcançado tal limite esse benefício deixará de ser aplicado, mas os demais benefícios da promoção (sem limites) continuarão sendo aplicados enquanto a promoção e/ou mapa estejam vigentes. 

Para cada um dos benefícios disponíveis no PROMO poderá ser definida a aplicação de um benefício, ficando fora de alcance o benefício Monetário Cupom Calculado e o 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, é mostrada a seção “Limites de Aplicação” na definição do benefício:

No combo “Adicionar” estarão disponíveis as seguintes Opções:

• • • Geral: Indica que todas as lojas do varejista serão somadas ao limite que está sendo definido. Por Exemplo, “2x1 em Termos, até esgotar estoque de 1000 unidades” (Independentemente da loja onde se venda ou do cliente que o adquiri, durante a vigência da promoção, termos poderão ser beneficiados até alcançar as 1000 unidades.)
    • Loja: Indica que cada loja do varejista levará um contador independente do limite definido a este benefício. Dessa forma, pode acontecer o caso de que em uma loja tenha sido alcançado o limite do benefício definido e não possa aplicar mais o benefício, e que outra loja ainda possa seguir operando, já que ainda não alcançou seu limite. O limite definido aqui é o herdado igualmente por todas as lojas. Por exemplo: “2x1 em Termos até esgotar estoque de 100 unidades por loja”. (Durante a vigência da promoção, poderão ser beneficiados até 100 termos por loja, se a loja A esgota seu estoque a promoção não será aplicada nem será mais sugerida, mas se a loja B ainda tem estoque disponível poderá seguir operando com tal promoção.)
    • Cliente: Indica que o limite será acumulado por cada cliente informado na transação. Por exemplo, “2x1 em termos até esgotar estoque de 1000 unidades, um por cliente”. (Durante a vigência da promoção, os termos poderão ser beneficiados até 1000 unidades, mas só poderá ser entregue um por cliente.)

Selecionando um dos critérios de agrupamento mencionados anteriormente, será mostrado o seguinte pop-Up:

Será possível indicar uma Descrição do Limite, esta não terá efeito algum sobre a gestão dos limites, é somente informativa.

A cada um dos critérios de acumulação (Geral, Loja ou Clientes) poderá ser definido um “Período” no campo “Período a Contabilizar”. O Período indicará a cada quanto será resetado o contador de acumulados durante a vigência da promoção. Exemplo: “2x1 em termos até esgotar estoque de 10 unidades por dia”. 

Aqui, seja o limite por Geral, Loja ou Clientes, será avaliado que em um dia não se supere o limite de 10 termos beneficiados. Se for alcançado o limite de 10 termos beneficiados por dia, a promoção não será aplicada nem será mais sugerida nesse dia. No dia seguinte, o contador voltará a zero e poderá ser aplicada a promoção até alcançar novamente o limite de 10 termos diários.

Deve-se considerar que, dependendo do benefício que está sendo definido, poderão ser utilizados diferentes critérios de acumulação para a definição do limite. No campo “Limita por”, deve-se indicar este critério de acumulação. Pode-se escolher entre os seguintes acumuladores:

• Quantidade de Dinheiro
• Quantidade de Aplicações
• Quantidade de Produtos beneficiados
• Quantidade de Cupons emitidos (só disponível quando esteja sendo definido um benefício Não Monetário, Cupom)
• Quantidade de Unidades de Fidelidade Concedidas (só disponível quando esteja sendo definido um benefício Não Monetário, Pontos/Porcentagem ou Coeficiente de nacionalização)
• Quantidade de Presentes Concedidos (só disponível quando esteja sendo definido um benefício Não Monetário, Presente)

Tendo sido 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 poderá ser interpretado como um tipo de Limite Geral que reinicia o contador diariamente e que acumula aplicações do benefício definido até um máximo de 100. Tendo sido alcançado o limite, o benefício não será mais aplicado até o próximo dia. Caso o limite não tenha sido alcançado no momento em que se reseta o contador, este será reiniciado igualmente, voltando a 0 para voltar a acumular até 100 no próximo dia.

Limites ao Definir Cupom Calculado:

• Quando se define um benefício Não monetário, da classe Cupom Calculado, definido por Porcentagem, poderão ser definidos limites por “Varejo”, “Loja” e/ou “cliente” limitando por quantidade de dinheiro, aplicações ou produtos beneficiados.
• Quando se define um benefício Não monetário, da classe Cupom Calculado, definido por Montante Fixo, poderão ser definidos limites por “Varejo”, “Loja” e/ou “cliente” limitando por quantidade de dinheiro, aplicações ou produtos beneficiados.
• Quando se define um benefício Não monetário, da classe Cupom Calculado, definido por Montante Externo, poderão ser definidos limites por “Varejo”, “Loja” e/ou “cliente” limitando por quantidade de aplicações ou produtos beneficiados.

Adicionados os limites e salvo o benefício, ao voltar à página de definição de promoção os limites definidos serão vistos da seguinte forma:

Definição de Escalonadas:

A partir de 7.1 é incorporada no Promo a possibilidade de aplicar descontos escalonados. Será possível indicar na definição do benefício qual é o valor do desconto quando se alcance uma determinada quantidade, magnitude ou preço total dos produtos participantes.

Ao definir um benefício, será mostrada no formulário a seção “Definição de Escalonadas”

Deverá seja definido, sobre qual tipo de unidade será aplicado a escala que está sendo definida. Para isso, no combo “Unidade de Escalonada” poderá selecionar entre “Quantidade”, “Magnitude” ou “Preço Total”.

Ao pressionar “Adiciona”, serão propostos os seguintes campos a fim de indicar as condições de aplicação da escala que está sendo definida.

Para salvar a escala definida, deve-se pressionar “Continuar”, mostrando a escala adicionada da seguinte forma:

         Ao pressionar novamente “Adicionar escala” e incorporar uma 2ª escala, será mostrada a grade e a escala já definida, da seguinte forma.

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

• Uma vez definida uma escala, não poderão ser trocados o tipo e a classe de benefício. Estes aparecerão em cinza. Deverão ser eliminadas as escalas para poder editar esses campos.
• Critério de ordenamento ao definir um benefício escalonado:será aplicado para os elementos sobre os que se conceda a escala a ser cumprida.
• Os benefícios aplicados sobre escalas serão contabilizados para os limites que o benefício da promoção escalonada será aplicado, seja limitado por cliente, loja ou geral, em produtos beneficiados, quantidade de dinheiro ou quantidade de aplicações. 
• Todos os campos referentes à informação de adicional de um benefício serão aplicados para o benefício que conceda a escala a ser cumprida.

• No benefício que se aplicar a escalonada, deverá ser definido o valor de desconto por padrão, que será aplicado quando não se cumpra com alguma das escalas definidas.
• O valor e tipo de recuperação definido no benefício que operar com escalonada serão aplicados para o benefício que conceder a(s) escala(s) cumpridas na transação.
• O rateio entre participantes, ao ser habilitado, levará para todos os elementos que sejam aplicados no cumprimento da escala definida.

• Aplicação Máxima (Valor/Medida) ao definir um benefício escalonado: os valores definidos serão aplicados para o benefício que conceda a escala a ser cumprida.
• Desconto Mínimo a ser aplicado ao definir um benefício escalonado: será aplicado para o benefício que conceda a escala a ser cumprida.
• Método de Rateio ao definir um benefício escalonado: será aplicado para o benefício que conceda a escala a ser cumprida.
• Definição do campo “Aplica sobre” ao definir um benefício escalonado: será aplicado para o benefício que conceda a escala a ser cumprida.

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

Por último, será solicitado que sejam completados os campos da seção “Informação Adicional” para terminar a definição do benefício.

• Método de aplicação: representa a forma pela qual o POS emitirá as promoções (seja em tela ou comprovante de venda). Por exemplo, mostrar em detalhe o desconto dado a cada artigo ou mostrar um resumo de todo o desconto aplicado antes do total. As opções que poderão ser selecionadas são:
• Resumo
• Linha a linha
• Conta contábil: coloca-se a conta contábil para a qual será imputado o benefício no POS. Não é um campo obrigatório.
• Fornecedor do bem e Fornecedor financeiro: será possível indicar aqui a quem será imputado o montante do desconto a aplicar, indicando o montante ou porcentagem correspondente.

Pode-se configurar que seja obrigatório completar os dois campos (Fornecedor do bem e Fornecedor financeiro) caso sejam postos valores em um deles. Deve-se configurar o seguinte:

• • Se essa configuração está em: 

    • • true= requer carregar ambos (Fornecedor do bem e Fornecedor financeiro) caso se carregue ao menos um.
      • false = não requer o carregamento de ambos (Fornecedor do bem e Fornecedor financeiro), pode-se carregar um apenas.
        
        Tanto caso se defina em true ou em false pode-se não carregar nenhum (nem Fornecedor do bem, nem Fornecedor financeiro).

     

    

 Nos campos “Fornecedor do bem” e “Fornecedor financeiro” pode-se colocar texto de até 250 caracteres. Ambos campos, à medida que se vá escrevendo, mostram sugestões selecionáveis do catálogo “Fornecedor”.

A soma dos valores definidos para ambos fornecedores não poderá superar 100% quando esses sejam definidos por porcentagem. No caso de ambos os fornecedores serem definidos por montante, não será realizada validação sobre os montantes colocados em um ou outro fornecedor. Por montante, é permitido colocar valores com dois decimais. Se o fornecedor financeiro for definido por %, o fornecedor de crédito deverá ser definido também por % e o mesmo quando algum seja definido por valor. Ambos os campos são opcionais, mas ao ser carregado um ou outro deverá ser definido, ainda que seja com % ou $ em zero ( 0 ).

• Mensagem no POS: este texto será enviado para o POS para ser visualizado no display quando uma Promoção que inclua este Benefício tenha sido aplicada em um contexto determinado. Não é um campo obrigatório.
• Mensagem para a impressora: este texto será enviado para o POS para ser impresso no comprovante de venda quando uma Promoção que inclua este Benefício tenha sido aplicada em um contexto determinado. Não é um campo obrigatório.

• • Mensagem para o TLOG: este texto será enviado para o POS para ser registrado no TLOG quando uma Promoção que inclua este Benefício tenha sido aplicada em um contexto determinado. Não é um campo obrigatório.
  
  
  

Postagem das Promoções na RabbitMQ sob demanda

(a partir do Promo 7.1.4)

Pode-se configurar no console do Promo a possibilidade de postar as promoções em estado “completo” nas filas RabbitMQ que tenham sido configuradas.

O processo por default posta de maneira automática nas filas RabbitMQ, as promoções que passam ao estado “Completo”, e todas as modificações realizadas nesta, enquanto não seja mudado seu estado de “Completo” quando a funcionalidade esteja habilitada e configurada. 

Também pode-se configurar que este envio não seja automático, senão que se encarregue o usuário de realizar esta postagem quando a promoção fique em estado automático.

Esta funcionalidade poderá ser habilitada em “Administração” >> “Informação de Configuração”, na opção de configuração “rabbitMQ.producer.manual.promotion.enabled”, que por padrão estará em “false”. Ao colocá-la em “true”, passa à modalidade de postagem de promoções sob demanda.

Se uma promoção se torna completa ou distribuída, ou é editada e mantém seu estado completo, será apresentado o botão “Postar na RabbitMQ”. Uma vez pressionado, os dados da promoção editada e completa serão postados para que sejam enviados via RabbitMQ e o botão já não será mostrada até que seja realizado uma nova edição.

Considerações: 

• As promoções incompletas ou canceladas não poderão ser postadas de forma manual.
• Quando uma promoção passe ao estado “Cancelado”, a postagem na fila RabbitMQ correspondente será automática.
• Nas promoções registradas de forma massiva, ou via serviço, a postagem na fila RabbitMQ correspondente será automática.

Modificação de promoções com base na sua vigência

Será possível indicar por configuração se uma promoção pode ou não ser editada logo após vencida, para isso deve-se acessar Administração > Informação de Configuração e habilitar ou desabilitar a opção “dataEditableIfAtive”.

Também será possível indicar por configuração que não se pode editar a data inicial de vigência de uma promoção quando tenha sido alcançada. (Para mais informação Ver Administração >> Informação de Configuração).

As promoções registradas ou editadas, quando passam ao estado “Completos” e o WorkFlow (WF) está “Aprovado”, poderão ser enviadas a um sistema externo via fila Rabbit-MQ para que esses dados possam ser adotados por sistemas externos.

Por default, esta funcionalidade estará desativada e deverão ser configurados os dados da fila Rabbit-MQ que corresponda para ativar a funcionalidade. Será possível realizar as configurações necessárias para o envio das Promoções no Console do Promo entrando no menu Administração >> Informação de Configuração.

No campo de pesquisa: “Palavra a pesquisar”, colocar a palavra-chave: “Producer”. Como resultado, serão mostradas as variáveis de configuração para o envio das Promoções via Filas Rabbit MQ.

O estado deste processo poderá ser visualizado na seção “Monitor de Importações”, no console do Promo.

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

(Para mais informação sobre o processo do envio das Promoções Via Rabbit MQ, ver Manual de Integração Promo 7.0).

Monitor de Exportação

No caso de existir registros de postagens no server RabbitMQ com ERRO, será mostrado um aviso (banner) no cabeçalho do Promo, indicando de forma geral a incidência.

Banner com detalhe da incidência.  - Para conhecer o detalhe da incidência, pressione Ver mais detalhe.

1. Lista de processos de exportação falhados.
   
   - No campo Descrição: será possível visualizar a causa do erro
   - Uma vez corrigido o erro que ocasiona a falha na postagem das mensagens no server RabbitMQ, deve-se pressionar o botão Reprocessar:
   
   
   
   
2. Se o processamento das falhas relacionadas à postagem de dados via RabbitMQ é bem-sucedido, a grade deverá ficar sem registros por Reprocessar.
   

Modelos de promoções

O que é um Modelo das Promoções?

Nesta seção do console do Promo, será possível registrar diferentes modelos de Modelos das Promoções que permitirão logo baixar os excels para que o usuário ou sistema encarregado gere, modifique ou cancele promoções conforme o definido no modelo, e assim poder gerir promoções de maneira massiva ao processar os excels.

Em cada modelo, poderão ser indicado critérios de definição do cabeçalho, condições e benefícios que serão comuns para as promoções geridas a partir deste modelo.

Por meio deste modelo pode-se indicar quais elementos serão exigidos carregar no Excel que logo será processado.

Para a definição dos campos que compõem um modelo poderão ser utilizadas variáveis definidas da seguinte forma: @[ variável ]. Também poderá ser definido um valor fixo para algum dos campos do modelo da promoção, e ao não se carregar nenhum outro dado para esse campo ao definir o excel, o valor definido será o adotado para a definição da promoção.

Para poder acessar a criação de um modelo de promoção, deve-se acessar através da opção “Modelos de promoção”:

Ao acessar “Modelos de promoções”, será mostrada a tela “Gestão de Modelos das Promoções”, onde são listados os diferentes modelos de promoções já gerados e onde será possível registrar novos modelos ou editar os existentes. Também pode-se filtrar aqui pelo Estado ou Nome dos modelos existentes.

Em cada Modelo apresentado nesta grade, é proposto o botão “Ações”, no qual um modelo poderá ser editado ou definido, como também ver um resumo, cancelá-lo ou gerar um Excel a partir dele.

Para registrar um novo Modelo das Promoções, deve-se clicar em “Novo Modelo”.

Novo Modelo das Promoções

Ao pressionar “Novo Modelo” será mostrada a tela “Novo Modelo do Promoção”, onde será possível indicar um Nome e uma Descrição para o modelo que se quer criar.

Uma vez identificado o modelo da promoção, deve-se carregar os campos do Cabeçalho, Condições e Benefícios que se quer incluir no modelo e que definirão a estrutura das promoções definidas a partir deste modelo de promoções.

Também será possível indicar se o modelo se encontra ativo ou não. Se um modelo de promoção se encontra “Inativo” (sem o check em Ativo), não poderão ser gerados arquivos excels a partir destes modelos.

Definição do Cabeçalho de Modelo da Promoção

Na mesma tela de definição do cabeçalho do modelo estará a seção de definição do Cabeçalho do Promoção. Aqui deverão ser colocados os campos exigidos para a gestão de promoções. Esses campos serão as colunas apresentadas no excel para o processo de registro, baixa e/ou modificação de promoções por arquivo.

Haverá campos de entrada obrigatórios e outros campos poderão ser substituídos por variáveis a fim de ajudar o usuário final a interpretar, conforme necessite, os dados a carregar nesse campo para uma promoção.

Nesta seção não é proposta a entrada de uma variável para o “Nome” e para o “Código” das promoções a gerir a partir deste modelo. Isto se deve pelos campos de entrada obrigatório, que sempre estarão no modelo excel para serem carregados.

Os campos que poderão ser colocados por variável serão os de entrada Não obrigatória e, caso se queira defini-lo, deverá ser indicada a variável que se quer ver na coluna onde será definido esse campo na promoção.

Esta definição de campos variáveis se aplica aos campos dinâmicos do cabeçalho e à descrição da promoção. Só poderão ser definidos os campos que se encontrem habilitados por configuração, e caso se coloque uma variável, a coluna que corresponde ao carregamento desse campo será mostrada com a variável de usuário definida no modelo.

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

Exemplo: visualização da tela completa de Registro de Novo Modelo.

Ao ser gerado um arquivo Excel com esta definição de cabeçalho do Promoção, será mostrado da seguinte forma:

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

As colunas “Workflow”, “Campanha”, “Canais de Publicação”, “Tipo das Promoções”, “Subtipo das Promoções” e “Forma de aplicação de promoções” sempre estarão presentes no Excel, mas não são de carregamento obrigatório. Se forem deixadas em branco, ao ser processado o excel a promoção gerada adotará os valores definidos no modelo de promoção, em troca, se for colocado algum valor em algum dos campos, a promoção gerada adotará este valor colocado e não o definido no modelo.

As colunas “Description” e “sugest” correspondem às variáveis colocadas nos campos “Descrição” e “Mensagem do POS” na seção “Sugestão para o POS”, respectivamente. Neste exemplo, a descrição não será de entrada obrigatória, e ao ser deixada em branco a promoção gerada a partir dessa fila não terá descrição. Para o caso da mensagem de sugestão, será de entrada obrigatória, já que ao ser habilitada a sugestão é exigida a mensagem para o POS.

Estas validações são realizadas no momento de processar o arquivo Excel.

Tendo sido carregados os dados correspondentes ao cabeçalho do modelo da promoção, pode-se pressionar “Salvar” e seguirá a definição das condições e benefícios que se queira incluir no template de promoções.

Definir modelo

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

Também será visualizado um detalhe do cabeçalho do modelo de promoção que está sendo definido. Nesta seção poderá ser acessado um resumo do modelo que está sendo gerado, e será possível gerar o excel correspondente quando o modelo esteja completo.

Condições de Faixa Horária

Devido à natureza dos campos associados às Condições de faixa horária, não poderão ser indicadas variáveis (@[variable..]), pelo qual, ao definir alguma condição deste tipo, a mesma será adicionada às colunas com os seguintes cabeçalhos: Condição de data com hora, Condição de hora, Condição por periodicidade.

Condições Simples

Caso o modelo a definir deva conter condições simples, deve-se definir as variáveis que representarão os atributos dos elementos por meio dos quais serão indicados essas condições.

O formato dessas variáveis será @[variable_condition_1], onde “variable_condition_1” deverá ser substituído pelo valor que se quer ver na coluna correspondente ao atributo no excel. 

Esta definição de variáveis será só para condições com campos tipo Completar_automaticamente, que permitem a entrada de valores alfanuméricos.

A definição do nome das variáveis não pode ser separada com espaços, é sugerido o uso de hífen ou sublinhado (-, _), por exemplo: @[variable_condition_1] ou @[variable-condition-2].

Caso algum atributo seja definido com um valor literal e não por meio de uma variável, o atributo que o contenha não será mostrado como uma coluna no excel, mas será adotado como uma definição fixa para esse atributo e será incluído em todas as promoções geradas a partir desse modelo.

Condições Por Composição

Caso se queira definir as promoções por meio de condições por composição, serão adotadas como variáveis todos os campos com valores definidos pelo usuário (A), como também todas as variáveis (@[variable_test]) definidas dentro dos 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 à qual 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 mínimas (Cond. por composição: 1)
4. Ocorrências máximas (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 mínimas (Cond. por composição: 2)
4. Ocorrências máximas (Cond. por composição: 2)
5. Critério de equivalência (Cond. por composição: 2)
6. Critério de não equivalência (Cond. por composição: 2)
7. tipo_cliente (Cond. por composição: 2. Clientes)

Exemplo de cabeçalhos no modelo excel:

Benefício 

No momento de definir um benefício no modelo das Promoções, deve-se ter em conta que os campos “Tipo de benefício” e “Classe de benefício” não serão mostrados como variáveis dentro do excel, já que de ambos dependem os demais campos que identificam o benefício.

Só os campos associados a “Tipo de benefício” e “Classe de benefício”, que sejam de tipo alfanuméricos, permitirão a declaração de variáveis (@[variable_test]).

Tampouco será válida a entrada de variáveis (@[variable_test]) os campos de tipo auto-complete, que por mais que permitam a entrada de um dado alfanumérico, não são válidos para a entrada de variáveis, já que deve-se validar, nos casos que corresponda, em relação aos catálogos.

Exemplo - Benefício Monetário

Exemplo - Benefício Não Monetário

>  Informação de aplicação

Serão adotados como variáveis aqueles campos com valores definidos pelo usuário. Da mesma forma, aqueles campos que permitam a entrada de valores alfanuméricos permitirão a definição de variáveis (@[variable]).

As variáveis a serem adotadas para mostrar no excel serão:

1. Aplicação máxima (valor)
2. Aplicação máxima (medida)
3. Método de rateio
4. Aplicar sobre…

> Limites da aplicação

Ao indicar algum limite dentro do benefício do modelo, o usuário poderá visualizar no excel a variável Limites de aplicação, onde poderá indicar os dados correspondentes ao limite entre colchetes ([]) ou, em seu padrão, indicar vários limites, separando-os com vírgulas ( , ).

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

[Tipo de limite, Período a contabilizar, quantidade de dias, Limitar por, Valor]

Caso o usuário não indique dados dentro da coluna Limites de aplicação ... do excel, durante a importação serão adotados como valores dos limites os definidos no modelo.

> Informação adicional

Serão adotados como variáveis todos aqueles campos onde o usuário defina um valor e, no caso de alguns dos campos permitirem a definição de variáveis, como em Conta contábil, Mensagem no POS, Mensagem na impressora, Mensagem no TLOG, será mostrado como cabeçalho da coluna o nome indicado em tal variável.

Gerar modelo em formato excel

Uma vez completado o modelo de promoção, poderá ser baixado em formato excel, pressionando o botão Gerar excel localizado no cabeçalho da tela Definir.

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

Será possível indicar por configuração qual será a fila do arquivo excel que fará a vez de cabeçalho, caso se deseje que não fosse a fila um (default). Para isso, deverá ser editado o parâmetro de configuração em Administração → Informação de configuração e editar a variável file.xls.header.rowStart.

Registro Massivo das Promoções

Ao entrar no menu Operação -> Registro massivo, pode-se visualizar a lista de modelos disponíveis para o processo (gerados previamente, ver “Modelos de promoções”). A grade de dados mostrará o nome do modelo, assim como a quantidade de promoções inseridas, atualizadas, canceladas e com erro, junto com a data da última execução do processo de registro massivo associado a esse modelo.

Ao pressionar o botão Ver detalhe, será visualizada a janela de “Registro massivo de promoções”, onde serão mostrados os dados de cabeçalho do modelo e o resumo dos dados associados. 

Nesta seção, poderá ser gerado o excel do modelo da promoção que esteja completa e ativa, assim como a seleção e processamento do arquivo (Processar arquivo).

Quando o processo termina de forma satisfatória, será mostrado o estado Processado à esquerda do registro indicado em “Últimas Operações realizadas”, e poderá ser visualizado um informe das promoções geradas pressionando no botão “Ver Informe”.

Caso durante o processo tenham surgido erros, será mostrado o estado Erro à esquerda do registro indicado em “Últimas Operações realizadas”, e poderá ser visualizado um informe detalhado dos registros que apresentaram inconvenientes no processamento.

Cancelamento Massivo 

No console do Promo será possível realizar o cancelamento de muitas promoções ao mesmo tempo, para isso deve-se acessar, no menu Operações, a opção “Cancelamento Massivo”.

Apresenta-se a tela “Cancelamento Massivo das Promoções”, onde poderão ser selecionadas as promoções que se deseja cancelar.

Nesta tela poderão ser executados os seguintes filtros a fim de poder identificar as promoções que se deseja cancelar:

• Código 
• Nome do Promoção
• Estado
• Campanha
• Vigência

Na grade são mostradas todas as promoções, mas só poderão ser canceladas aquelas em estado “Completos” ou “Incompletos”. As promoções em estado “Distribuído” não poderão ser canceladas.

Ao selecionar uma ou mais promoções, deve-se pressionar o botão “Cancelar Promoções Selecionadas”, e será mostrada a tela “Cancelar Promoções”, onde se deve indicar um motivo para o cancelamento de promoções.

Limites Promoções

Nesta opção do menu, pode-se mudar o limite (ou os limites) de qualquer promoção que se encontre em estado completo e vigente, já operando em uma loja. O POS receberá esses limites sem necessidade de voltar a distribuir um mapa. Se as promoções estão em estado Incompleto, será possível mudar seu limite editando-as.

Edição de Limites:

No menu principal, ao selecionar: Operação> Limites Promoções, o sistema mostrará a tela “Limites Promoções”.

Debaixo do título serão vistos os campos “Código” e “Nome de promoção”, pelos quais é possível pesquisar promoções.

Debaixo dos filtros se verá uma lista com todas as promoções ativas em um mapa que transacionaram e que têm um limite definido (ou vários) e não estão em estado Incompleto, sem importar sua vigência. Será possível modificar tanto as promoções vigentes como as vencidas ou sem vigência definida.

A lista mostrará as seguintes colunas:

• “Estado” (estado da promoção), 
• “Código” (Código da promoção), 
• “Nome” (nome da promoção), 
• “Campanha”, 
• “Canais”, 
• “Vigência”, 
• “Classe de Benefício”, 
• “Benefício”

Na tela de “Limites Promoções”, à direita de cada promoção listada, será mostrado o botão “Editar”, no qual poderá ser acessada a seção de edição de limites de cada promoção.

Ao selecionar o botão “Editar”, o sistema mostrará todos os limites configurados no ou os benefícios da promoção, e ali será possível modificar (aumentar ou diminuir) qualquer um dos limites existentes.

Editar Limite:

Os seguintes campos não poderão ser editados:

Nome da promoção: mostrará o nome da promoção.

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

Classe de benefício: mostrará a classe à qual pertence o benefício (por ex. Desconto porcentagem).

Benefício: mostrará o número de benefício (por ex. Benefício N°1).

Na seção “Limites Configurados” será mostrado: Geral, Loja e Cliente, e dentro de cada um poderá ser mostrado: “Quantidade de dinheiro”, “Quantidade de aplicações”, “Quantidade de produtos beneficiados”, dependendo dos campos que contenham limites configurados. Poderá ter até 9 limites para um benefício. À direita de cada Tipo de Limite será mostrado um campo editável, onde será possível colocar um número sem decimais maior ou igual a 0. Não será possível colocar um número negativo. Por default, aparecerá o valor configurado na promoção ou o último modificado nesta tela.

Motivo: Neste campo é obrigatório selecionar alguma das opções que se mostra no combo suspenso, caso se modifique algum limite a colocar na tela “Editar Limite” para ver/modificar os limites existentes de uma promoção. No campo Motivo, sempre mostrará “[Motivo]”, não mostrará o último motivo colocado. Este campo é utilizado para levar um registro de auditoria, que será possível ver no Informe “Histórico Limites” (ver também “Motivos de Modificação de Saldo”).

Ao ser editado o limite, a mudança se verá refletida tanto na definição do benefício na promoção como no pop-up de resumo da promoção.

Capítulo 6 - Módulo de Workflow

O Workflow descreve os passos necessários para aprovar uma promoção, mostrando sua estrutura e sua ordem correlativa. Os passos representam as etapas de aprovação de uma promoção ou lista de preços e o papel associado a cada uma delas.

Por default, conta-se com um workflow por default (Workflow general), que possui um único passo para a aprovação de uma promoção ou lista de preços. O universo de aplicação de um workflow poderá ser editado uma vez que tenham sido associadas promoções ou listas de preços.

Múltiplos Workflows

No PROMO conta-se com a possibilidade de definir mais de um Workflow para a aprovação de promoções e listas de preços. Dessa forma, poderão ser gerenciados de maneira independente os passos para aprovar um determinado grupo de promoções ou listas de preços.

Por exemplo, as promoções aplicáveis sobre uma determinada rubrica ou que dão um determinado benefício poderão ser aprovadas no Workflow A, que tem 4 passos definidos, enquanto que outro grupo de promoções aplicáveis sobre outro grupo ou segmento de itens ou sobre outra margem de benefício será aprovado pelo Workflow B, que tem 2 passos definidos.

O mesmo acontece com os Workflows de Listas de Preços.

Os WF poderão ser aplicados a:

• Promoções
• Listas de Preços

Para a definição desses Workflows deve-se clicar no botão “Novo” da janela “Workflows”.

Será apresentada a tela de “Novo Workflow”, onde deve-se colocar um nome e uma descrição. 

São mostrados 2 checkboxs, que indicam se o Workflow aplica as promoções, as listas de preços ou ambas. Por default, os 2 checkboxs estão marcados. 

Ao clicar em “Salvar”, será mostrada a tela com a lista “Workflow”, onde poderão ser indicados os passos que hão de compor esse Workflow, e quais papéis serão os encarregados em cada passo de realizar a aprovação. 

Por padrão, o passo 1 estará já definido sob o nome “Captura”, e terá atribuído o papel Administrador. 

Ao clicar no botão “Novo”, poderão ser definidos novos passos dentro dele, associando o papel correspondente para sua aprovação: 

Ao clicar em “Salvar”, mostrará os passos que compõem o WF: 

Passos de Um Workflow  

Ao criar uma promoção, esta é atribuída a um Workflow determinado (na definição de cabeçalho da promoção) e uma vez completa pode ser enviada para aprovação. 

Se definimos mais de um passo para o workflow selecionado, a promoção deverá ser aprovada por todos os passos integrantes do Workflow ao qual pertence para participar logo após um mapa. 

Para enviar uma promoção para revisão ou aprovação, deve-se clicar no botão “Enviar para aprovação”, como se mostra na imagem a seguir: 

Promoções para Aprovar 

Uma vez enviada uma promoção para aprovar, esta permanecerá na tela “Gestão de promoções” com o estado “Revisão/Aprovação”, por sua vez aparecendo na tela “Promoções para Aprovar”, onde o usuário, com o papel definido para esse passo no workflow ao qual pertence a promoção, aprova ou rejeita a promoção enviada. 

Para acessar as promoções a serem aprovadas deve-se colocar no menu “Operação”, e no menu suspenso deve-se apertar “Promoções para Aprovar”, como se mostra na seguinte imagem: 

No caso de ter entrado com um usuário com licenças de administrador, será visualizado à direita do título “Promoções para Aprovar” o contador indicando “n” quantidade de promoções enviadas para aprovar (neste caso, seguindo com o exemplo, será “1”, como se indica na imagem). 

No caso de ter entrado sem licenças de administrador (com o usuário “Operador”), será visualizado no submenu o título “Promoções para Aprovar”, mas com o valor de quantidade que está à direita em zero “0”. 

Cada papel verá as promoções a serem aprovadas dos workflows nos quais participe. 

Uma vez que se aperte a opção “Promoções para aprovar”, um usuário pertencente ao papel definido poderá revisar e aprovar / rejeitar a promoção. 

O sistema o conduzirá à tela seguinte, onde ao apertar o botão “Ações” será colocado em modo suspenso o submenu com as seguintes opções: 

1. Histórico WF 

1. Resumo 

1. Aprovar/Rejeitar 

 
Para aprovar ou rejeitar uma promoção deve-se apertar a opção “Aprovar/Rejeitar” e, uma vez feito isso, o sistema mostrará o seguinte quadro de diálogo: 

Ali será possível rejeitar ou aprovar uma promoção, apertando “Rejeitar” ou “Aprovar”, além de poder registrar informação (texto) no quadro vazio “Nota” em relação à ação realizada. 

Uma vez aprovada ou rejeitada, a promoção figurará com o estado correspondente, na página “Gestão de promoções”, na coluna de Workflow que aparece com o nome do workflow ao qual pertence. 

Ao finalizar o ciclo de revisão, a promoção se encontrará aprovada completamente e será possível incorporá-la a um mapa. 

Histórico do Workflow 

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

Exemplo: 

1. O operador captura as promoções e envia para seu aprovação. 

1. O supervisor valida a promoção carregada e as aprova ou rejeita de acordo com seu critério. 

As promoções que foram aprovadas completamente poderão ser adicionadas a um mapa e distribuídas às lojas. 

 
Para acessar o histórico do workflow será possível entrar em: 

• “Promoções para Aprovar” como se detalha na imagem, apertando no submenu suspenso, no botão “Ações”, a opção “Histórico WF”. 

• “Gestão das Promoções” apertando o botão “Ações” à direita da tela sobre a promoção que se escolha e no submenu suspenso, apertando “Histórico WF”. 

 
No histórico do workflow será possível visualizar: 

1. Os passos realizados com cada promoção 

1. O usuário que realizou cada um deles 

1. A data e a hora no qual foram realizados 

1. Se foram realizados com sucesso 

Na imagem só pode-se observar os passos detalhados do Workflow em ordem ascendente (de baixo para cima), com a informação especificada: 

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

Menu de Distribuição  

Nesta opção o PROMO permite criar e distribuir mapas, simular tickets com promoções e mapas, como também distribuir promoções nas diferentes redes sociais. 

Mapas 

Um mapa é um grupo de promoções, com uma vigência e regras que conviverão no motor de promoções em um determinado momento. 

O mapa deve-se definir para poder especificar regras de convivência entre as promoções que o integram e para especificar a ordem de aplicação e consumo que existirá entre elas. 

Para gerar um mapa deve-se acessá-lo através do menu Distribuição > Mapas (POS). 

Criar Mapas

Para poder criar Mapas deve-se pressionar o botão “Novo”. 

Quando for definido um novo mapa, pode-se optar por utilizar um dos Modelos de Mapas completos, criados previamente no menu Administração> Modelos de Mapa. 

Na tela “Publicações Mapa (POS)” deverão ser colocados os seguintes dados exigidos: 

• Publicação: nome mediante o qual será identificado o mapa quando ele seja listado para gerar os arquivos de definição. 

• Início de vigência: indica a data inicial a partir da qual o mapa se encontrará em vigência uma vez que seja distribuído. Toma como hora inicial a 00:00h do dia. A data deve ser a atual ou superior. 

• Fim de vigência: indica a data na qual será finalizada a vigência do mapa. Toma como hora final às 23:59h do dia. 

Aqui também poderá ser configurado o comportamento da sugestão em nível Mapa. Este campo também é exigido, por default salva “Não sugerir”. 

Os campos que a configuram serão: 

• Sugestões: as opções para este campo são: 

• NÃO sugerir: Não serão realizadas sugestões para nenhuma das promoções que integram o mapa, independentemente do valor de “sugerir” que cada promoção tenha configurado. 

• Sugerir SEMPRE: Serão avaliadas sugestões para todas as promoções que integram 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 conforme a configuração de sugestão que tenha sido em nível promoção. 

• Dias para a devolução: indica a quantidade de dias porque o mapa se encontrará disponível após finalizada sua vigência, só para as transações de devoluções.  

Este dado permite ao sistema determinar a quantidade de dias que o uso do mapa se encontrará disponível para resolver as promoções nas transações de devolução assim como foram realizadas na compra original. Se não for colocado um valor neste campo considera-se que não existe limitação de dias. É opcional completar este campo. 

Se em Administração > Modelos de Mapas, na tela “Gestão de Modelos de Mapas” foi pressionado o botão “Gerar Mapa”, será gerada a tela “Publicações Mapa (POS)”, onde o campo de “Modelo de mapa” mostrará pré-carregado o nome do modelo que está sendo registrado e não poderá ser editado. 

No campo “Publicação” deve-se colocar o nome com o qual o mapa será publicado. 

As datas inicial e fim de vigência do mapa apresentarão os valores por default e poderão ser editadas. O campo sugestão adotará os valores configurados no modelo e o campo dias para devolução será apresentado vazio, como se faz habitualmente. 

Logo, ao pressionar “Salvar” será mostrada a tela “Definir mapa (POS)”, onde já serão mostradas na composição do mapa as promoções pertencentes aos tipos, subtipos e formas de aplicação definidos no modelo de mapa que foi registrado. 

Se foi selecionado um Modelo de mapa:  

Mostrará uma opção mais na parte inferior da tela: “Distribuição programada”. É um check que por default vem sem marcar. 

Foi ativada a Distribuição programada: há um processo que é executado automaticamente uma vez ao dia para distribuir os mapas que têm este check ativo. Esses mapas devem ter um modelo associado e devem ser automáticos. (Ver mais abaixo CONFIGURAÇÃO E FUNCIONAMENTO DE DISTRIBUIÇÃO AUTOMÁTICA E PROGRAMADA DE MAPAS). 

Ao se pressionar “Salvar” na tela “Publicação de mapa (POS)” será gerada a tela “Definir mapa (POS)”, onde serão mostradas, na composição do mapa, as promoções pertencentes aos tipos, subtipos e formas de aplicação definidos no modelo de mapa. 

 Se não foi selecionado um Modelo de mapa: 

Uma vez que todos os dados do mapa tenham sido colocados, pressiona-se o botão “Salvar”. 

Será mostrada a tela “Definir Mapa (POS)”, na qual deverão ser selecionadas as promoções que integrarão o mapa. 

Essa tela se encontra dividida em dois setores: 

O cabeçalho onde serão visualizados os dados carregados previamente junto com as opções de Checar colisões, Geração Automática, Resumo, Baixar, Distribuir, Editar e Voltar. 

Os dados de composição do mapa, onde serão mostrados os Passos, Funções, Promoções e Cond Grais (Condições Gerais) disponíveis. 

Na área esquerda poderão ser definidos os passos, funções, promoções e condições gerais selecionando o elemento que se quer criar e arrastando-o até a janela direita do painel. Deve-se criar um passo selecionando o botão “Novo passo” e arrastando-o até a janela direita. 

Passos 

Quando o mapa é definido, cada uma das promoções integrará um dos Passos e, se coexistirem várias promoções dentro do mesmo passo, serão combinadas mediante funções de convivência. 

A existência de passos dentro do mapa permite reestabelecer os elementos consumidos pelas promoções entre um passo e outro. 

O procedimento de avaliação e aplicação de benefícios presentes no mapa atuará do seguinte modo: 

1. Avalia-se a função de convivência integrante do primeiro passo (lembrar que a função é sempre única e que pode estar composta por promoções ou por outras funções). 

1. Dependendo do tipo de função, uma vez avaliada, consumidos os elementos do contexto recebido entre as promoções e aplicados os benefícios, passa ao próximo passo reestabelecendo os elementos do contexto que tenham sido consumidos ao serem aplicadas as diferentes promoções e com os preços estendidos modificados pela aplicação dos benefícios. 

1. Continua avaliando os seguintes passos do mapa conforme o explicado nos pontos 1 e 2. 

   
   

Uma promoção só poderá existir dentro de um único passo, não podendo ser encontrada em mais de um passo. 

Funções de convivência 

Chamaremos de “função de convivência” a expressão que determina a ordem de processamento entre promoções dentro de um mesmo passo. 

Também será determinado como será o “consumo de elementos”. 

Chamaremos “Consumo de elementos” quando uma promoção utiliza um ou vários elementos do contexto para aplicar um benefício. 

Os elementos que receberam um benefício dentro de um passo já não serão encontrados disponíveis para ser utilizados em uma próxima promoção, a menos que a função de convivência o permita. 

As funções de convivência disponíveis são: 

• SEQUENCIAL (CONSUME) 

Dentro da função SEQUENCIAL cada promoção integrante é processada na ordem na qual a função foi configurada. 
A promoção processada consumirá os elementos que tenham participado dela, não podendo ser utilizados nas próximas promoções integrantes dessa função SEQUENCIAL.  
É muito importante a ordem na qual é definida cada promoção dentro da função, dado que esta ordem é a que será utilizada para realizar o consumo de elementos. Do processo de todas as promoções da função será obtida uma coleção de benefícios composta pela soma dos benefícios obtidos de cada uma das promoções da função. 

• TODAS (ALL) 

Dentro da função TODAS as promoções que intervêm são processadas de forma independente com base no mesmo contexto recebido pela função, gerando-se uma coleção de benefícios independentes os quais serão somados entre si ao finalizar o processo. Neste caso, não será tão importante a ordem na qual as promoções se encontrem definidas dentro da função TODAS, já que seu processo é independente. 

• OPÇÕES (OPTION) 

Neste tipo de função cada promoção é processada de forma independente e é gerada uma coleção de opções das quais o cliente poderá optar. De cada opção se obterá uma coleção de benefícios que será aplicada de acordo com a opção selecionada pelo cliente. No caso da função OPÇÕES, a quantidade de opções a que responderá o motor dependerá da quantidade de promoções que a integrem, aplicáveis ou não. 

• EXCLUIR (EXCLUDE) 

Com este tipo de função as promoções são avaliadas em ordem (conforme como foi definida a função), diante da primeiro promoção que cumpra com sua condição e possa ser aplicada se detém a avaliação do resto das promoções integrantes da função, com o qual, diante da primeiro promoção que aplica, o resto das promoções já fica excluído de avaliação. 

• AVALIA SE (IF) 

Esta função consta de uma série de promoções, que serão denominadas “condicionantes”, e uma que será a promoção “condicionada”. Dessa forma, só será aplicada a promoção condicionada sobre os artigos que tenham sido beneficiados por ao menos uma das promoções condicionantes. As promoções condicionantes pertencem a passos anteriores ao passo onde aparece a função AVALIA SE. É por isso que a função AVALIA SE aparecerá em um segundo passo ou passos superiores, mas nunca no primeiro passo. A promoção condicionada será a última a aparecer na lista, enquanto que as condicionantes, portanto, serão todas as que se encontrem primeiro. Caso se queira que exista mais de uma promoção condicionada, todas elas deverão estar dentro de alguma função de convivência. 

Exemplo: 

• Promo-A: avalia a existência de itens com código 111 e que sejam da família “Eletro”. 

• Promo-B: avalia a existência de itens que sejam da família “Eletro”. 

O mapa ficará conformado da seguinte forma: 

São postos na transação 1 item que cumprem com o Promo-A (“111”) e outro item que cumpre com o Promo-B (“333”). 

Ao serem avaliados os itens com o mapa que contém a função “Avalia Se”, são aplicadas sobre o item “111” o Promo-A e o Promo-B, enquanto que o item “333” não obterá benefícios, já que por definição só será aplicada a promoção condicionada (Promo-B) sobre os itens que tenham sido beneficiados pela promoção condicionante (Promo-A).  

• AVALIA SE NÃO (IFNOT) 

Esta função consta de uma série de promoções, que serão denominadas “condicionantes”, e uma que será a promoção “condicionada”. Dessa forma, e ao contrário da função anterior, só será aplicada a promoção condicionada sobre os artigos que não tenham sido beneficiados por nenhuma das promoções condicionantes. 
As promoções condicionantes pertencem a passos anteriores ao passo onde aparece a função AVALIA SE NÃO. É por isso que a função AVALIA SE NÃO aparecerá em um segundo passo ou em passos superiores, mas nunca no primeiro passo. Exemplo: Se a função AVALIA SE NÃO está no terceiro passo, as promoções integrantes dos passos 1 e 2 podem ser utilizadas como condicionantes. 
Tal como na função anterior, a promoção condicionada será a última a aparecer na lista, enquanto que as condicionantes, portanto, serão todas as que se encontrem primeiro. Caso se queira que exista mais de uma promoção condicionada, todas elas deverão estar dentro de alguma função de convivência.