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

ScanntechEllo ERPCaixa .PDV.ScanntechEllo ERPCaixa (PDV)ScanntechEllo ERPCaixa (PDV)(1) Envia promocoes ativas(2) Aplica desconto automaticamente(3) Registra a venda(4) Envia relatorio de vendas e resumo diario

  1. A Scanntech publica promoções em sua plataforma.
  2. O Ello ERP busca e armazena essas promoções automaticamente.
  3. Quando um produto participante é vendido no PDV, o desconto é calculado e aplicado na hora.
  4. 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:

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.

Ello ERPScanntechEllo ERPScanntechEllo ERPScanntechloop[Sincronizacao periodica]Solicita lista de promocoesRetorna promocoes com produtos e condicoesSalva promocoes localmenteSomente promocoes comestado "Aceita" saoaplicadas no PDV

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.

Produto escaneado no caixaProduto participa de promocao aceita e vigente?simnaoVerifica quantidade minima exigidaQuantidade atingida?simnaoCalcula o desconto conforme o tipoAplica desconto no item da vendaProduto sem desconto por enquantoItem vendido pelo preco normal

O desconto só é aplicado se todas as condições forem atendidas:

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.

Ello ERPScanntechEllo ERPScanntechEllo ERPScanntechEnvia dados da venda(produtos, quantidades, descontos, formas de pagamento)Confirmacao de recebimentoEnvia resumo diario do caixa(total de vendas, cancelamentos, quantidade de operacoes)Confirmacao de recebimentoO resumo diario so e enviadoapos o fechamento do caixa

Formas de pagamento reconhecidas ao enviar para a Scanntech:

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

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

  1. Verifique se a opção Participa no Clube de Promoções está marcada nas configurações.
  2. Confirme que os campos URL Principal, Código da empresa, Usuário e Senha estão preenchidos.
  3. Acesse a tela EST 619 e pressione F7 para forçar uma sincronização. Observe se aparece alguma mensagem de erro.
  4. 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

  1. Confirme que as promoções estão com estado Aceita e situação Vigente.
  2. Verifique se o produto está cadastrado com o mesmo código de barras que consta na promoção na Scanntech.
  3. Confirme que a quantidade mínima exigida pela promoção foi atingida na venda.

As promoções aparecem com estado "Pendente"

  1. 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

  1. Verifique os registros de eventos do sistema para identificar possíveis erros de comunicação com a Scanntech.
  2. Confirme que o servidor Scanntech está acessível a partir do computador onde o PDV está instalado.
  3. 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.
  4. 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.