Clube de Promoções — Integração com a Scanntech
O Clube de Promoções é uma integração com a plataforma Scanntech que permite ao estabelecimento receber e aplicar promoções automaticamente no caixa (PDV).
As promoções são criadas e gerenciadas pela Scanntech. O Ello ERP as busca periodicamente e aplica os descontos no momento da venda — sem necessidade de ação manual do operador de caixa. Ao final do período, o sistema envia à Scanntech um resumo das vendas e dos cancelamentos para acompanhamento e relatórios.
Visão Geral
- A Scanntech publica promoções em sua plataforma.
- O Ello ERP busca e armazena essas promoções automaticamente.
- Quando um produto participante é vendido no PDV, o desconto é calculado e aplicado na hora.
- As vendas são enviadas à Scanntech para acompanhamento e geração de relatórios.
Tipos de Promoção
A Scanntech suporta seis tipos de promoção. Cada tipo define como o desconto é calculado:
| Tipo de Promoção | Como funciona | Exemplo |
|---|---|---|
| Leve X, Pague Y | O cliente leva uma quantidade maior de itens, mas paga apenas por uma quantidade menor. | Leve 6 unidades, pague apenas 5. |
| Desconto Adicional (%) | Comprando uma quantidade mínima de um produto (produto de condição), o cliente recebe um desconto percentual em outro produto (produto de benefício). | Comprando 2 unidades do produto A, ganhe 30% de desconto no produto B. |
| Brinde / Item Grátis | Comprando uma quantidade mínima de um produto, o cliente recebe outro produto de graça. | Leve 2 shampoos e ganhe 1 condicionador. |
| Preço Fixo | Uma quantidade específica de um produto é vendida por um preço total fixo. | 3 unidades por R$ 10,00. |
| Desconto Variável (%) | Desconto percentual que varia conforme a quantidade comprada. | Compre acima de 3 unidades e receba 10% de desconto. |
| Desconto Fixo (R$) | Um valor fixo em reais é deduzido do total da promoção. | Desconto de R$ 5,00 na compra de 2 unidades. |
Produtos de condição e de benefício
Algumas promoções envolvem dois grupos de produtos:
- Produto de condição: o produto que o cliente precisa comprar para ativar a promoção.
- Produto de benefício: o produto que receberá o desconto ou será entregue de graça.
Nas promoções do tipo “Leve X, Pague Y” e “Preço Fixo”, geralmente há apenas um grupo de produtos.
Sincronização das Promoções
O sistema verifica periodicamente se há promoções novas ou alteradas na Scanntech e as salva localmente. Essa verificação acontece de forma automática, sem necessidade de intervenção do usuário.
Cada promoção pode estar em um de três estados:
| Estado | Significado |
|---|---|
| Pendente | A promoção foi recebida pela Scanntech, mas ainda não foi aceita nem recusada. |
| Aceita | A promoção está ativa e será aplicada automaticamente nas vendas. |
| Recusada | A promoção foi rejeitada e não será aplicada. |
Apenas as promoções com estado Aceita são aplicadas no PDV.
Aplicação de Desconto no PDV
O operador de caixa não precisa fazer nada — o sistema identifica automaticamente se o produto tem promoção e aplica o desconto na hora.
O desconto só é aplicado se todas as condições forem atendidas:
- A promoção estiver com estado Aceita.
- A data atual estiver dentro do período de validade da promoção.
- O produto estiver cadastrado na promoção (pelo código de barras).
- A quantidade mínima exigida pela promoção for atingida.
Envio de Dados para a Scanntech
Após cada venda finalizada, o sistema envia os dados para a Scanntech automaticamente. Em caso de falha temporária, o sistema tenta reenviar automaticamente nas próximas verificações.
Formas de pagamento reconhecidas ao enviar para a Scanntech:
- Dinheiro
- Cartão de crédito
- Cheque
- Vale / Voucher
- Cartão de débito
Tela de Promoções (EST 619)
A tela Promoções — Scanntech (EST 619) permite consultar todas as promoções recebidas da Scanntech e realizar uma sincronização manual quando necessário.
Filtros disponíveis
- Estado: filtra por Pendentes, Aceitas, Recusadas ou Todas.
- Situação: filtra por Vigentes (dentro do prazo), Futuras (ainda não iniciadas), Vencidas (fora do prazo) ou Todas.
Colunas da listagem
| Coluna | Descrição |
|---|---|
| Estado | Ícone indicando se a promoção está Pendente, Aceita ou Recusada. |
| Código | Identificador da promoção na Scanntech. |
| Título | Nome da promoção. |
| Limite | Quantidade máxima de vezes que a promoção pode ser aplicada por cupom fiscal. “Sem limite” indica que não há restrição. |
| Benefício | Resumo da condição e do benefício da promoção. |
| Início | Data de início da promoção. |
| Fim | Data de término da promoção. |
| Situação | Ícone indicando se a promoção está Vigente, Futura ou Vencida. |
Sincronização manual
Para forçar uma atualização imediata das promoções, pressione F7 ou clique no botão Sincronizar na parte superior da tela. O sistema buscará as promoções atualizadas na Scanntech e atualizará a listagem.
Atenção: o botão de sincronização só fica disponível se a integração com o Clube de Promoções estiver ativada nas configurações do sistema.
Como Ativar e Configurar
A integração é configurada pelo administrador do sistema em Configurações > Clube de Promoções.
Configurações obrigatórias
| Configuração | Descrição |
|---|---|
| Participa no Clube de Promoções | Deve ser marcado para ativar a integração. Sem isso, nenhuma promoção é baixada nem aplicada. |
| Endereço do servidor (URL Principal) | Fornecido pela Scanntech. É o endereço principal de comunicação. |
| Código da empresa | Código de cadastro do estabelecimento na Scanntech. |
| Usuário | Credencial de acesso fornecida pela Scanntech. |
| Senha | Senha de acesso fornecida pela Scanntech. |
Configurações opcionais
| Configuração | Padrão | Descrição |
|---|---|---|
| Endereços alternativos (URL I e URL II) | — | Endereços de backup caso o principal esteja indisponível. O sistema tenta os três automaticamente. |
| ID da loja | 1 | Identifica a filial dentro da Scanntech. Útil para empresas com múltiplas lojas. |
| Intervalo de sincronização | 10 minutos | Com que frequência o sistema busca promoções atualizadas. |
| Data de início do envio | 01/01/2021 | Data a partir da qual as vendas serão enviadas à Scanntech. Útil em implantações onde há histórico anterior. |
| Tempo limite de resposta | 3 segundos | Tempo máximo aguardado por resposta do servidor Scanntech antes de considerar falha e tentar novamente. |
Diagnóstico e Suporte
A integração não está funcionando
- Verifique se a opção Participa no Clube de Promoções está marcada nas configurações.
- Confirme que os campos URL Principal, Código da empresa, Usuário e Senha estão preenchidos.
- Acesse a tela EST 619 e pressione F7 para forçar uma sincronização. Observe se aparece alguma mensagem de erro.
- Verifique se há promoções listadas com estado Aceita na tela EST 619.
As promoções aparecem na tela, mas não são aplicadas no PDV
- Confirme que as promoções estão com estado Aceita e situação Vigente.
- Verifique se o produto está cadastrado com o mesmo código de barras que consta na promoção na Scanntech.
- Confirme que a quantidade mínima exigida pela promoção foi atingida na venda.
As promoções aparecem com estado "Pendente"
- Promoções pendentes precisam ser aceitas pela Scanntech (ou pelo responsável na plataforma). Entre em contato com o suporte da Scanntech para verificar e aceitar as promoções pendentes.
Vendas não estão sendo enviadas à Scanntech
- Verifique os registros de eventos do sistema para identificar possíveis erros de comunicação com a Scanntech.
- Confirme que o servidor Scanntech está acessível a partir do computador onde o PDV está instalado.
- O sistema tenta se comunicar com até três endereços de servidor configurados (Principal, Alternativo I e Alternativo II). Confirme que ao menos um está correto nas configurações.
- O resumo diário só é enviado após o fechamento do caixa — verifique se o período do caixa foi encerrado corretamente.
Como funciona a redundância de conexão
O sistema tenta se comunicar com até três endereços de servidor configurados (Principal, Alternativo I e Alternativo II). Se o principal falhar, tenta automaticamente o próximo, realizando até quatro tentativas no total. Isso garante maior disponibilidade mesmo que um dos servidores esteja temporariamente fora do ar.