====== 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 ===== participant Scanntech participant "Ello ERP" as ERP participant "Caixa (PDV)" as PDV Scanntech -> ERP : (1) Envia promocoes ativas ERP -> PDV : (2) Aplica desconto automaticamente PDV -> ERP : (3) Registra a venda ERP -> Scanntech : (4) Envia relatorio de vendas e resumo diario - 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. participant "Ello ERP" as ERP participant Scanntech loop Sincronizacao periodica ERP -> Scanntech : Solicita lista de promocoes Scanntech --> ERP : Retorna promocoes com produtos e condicoes ERP -> ERP : Salva promocoes localmente end note right of ERP Somente promocoes com estado "Aceita" sao aplicadas no PDV end note 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. start :Produto escaneado no caixa; if (Produto participa de promocao aceita e vigente?) then (sim) :Verifica quantidade minima exigida; if (Quantidade atingida?) then (sim) :Calcula o desconto conforme o tipo; :Aplica desconto no item da venda; else (nao) :Produto sem desconto por enquanto; endif else (nao) :Item vendido pelo preco normal; endif stop 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. participant "Ello ERP" as ERP participant Scanntech ERP -> Scanntech : Envia dados da venda\n(produtos, quantidades, descontos, formas de pagamento) Scanntech --> ERP : Confirmacao de recebimento ||| ERP -> Scanntech : Envia resumo diario do caixa\n(total de vendas, cancelamentos, quantidade de operacoes) Scanntech --> ERP : Confirmacao de recebimento note right of ERP O resumo diario so e enviado apos o fechamento do caixa end note **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.