Integração DermaClub
O DermaClub é um programa de benefícios voltado ao segmento de skincare, que oferece descontos exclusivos e um sistema de fidelização baseado no acúmulo de pontos.
Configuração da Integração
A configuração é realizada pelo caminho: Funções Operacionais > Integrações > DermaClub > Configurações. Ao acessar esse menu, a tela de configuração é apresentada:
Na seção superior é definida a Base URL, que é a URL da API da DermaClub fornecida pela equipe do parceiro. Essa URL é compartilhada entre todas as filiais. O sistema preenche automaticamente a URL de produção padrão:
https://gateway.zicardapi.com.br/trackingsales/v03/autorizador
Na grade de Configuração por Filial são preenchidas as credenciais exclusivas de cada filial, também fornecidas pela equipe da DermaClub:
| Campo | Descrição |
|---|---|
| Filial | Identificação da filial |
| Login | Login de acesso à API DermaClub |
| Senha | Senha de acesso à API DermaClub |
| Habilitado | Indica se a integração está ativa para aquela filial |
| Filial Sinc. | Filial responsável por realizar as sincronizações. Se zero, a própria filial assume essa responsabilidade |
Após salvar as configurações, é necessário reiniciar o serviço Monitor - Automatiza Sistemas para que as novas configurações entrem em vigor.
Sincronização via Monitor Windows Service
O serviço de monitoramento executa três rotinas automáticas de sincronização em segundo plano:
Sincronização de Projetos (Campanhas)
Executada uma vez por dia, essa rotina conecta-se à API da DermaClub e baixa a tabela atualizada de projetos e campanhas promocionais vigentes para cada filial habilitada. Os dados recebidos incluem:
- Produtos participantes de cada campanha com seus descontos (fixo ou por faixa de quantidade)
- Kits promocionais
Sincronização de Vendas
Executada a cada 1 minuto, essa rotina envia ao DermaClub os dados das vendas que tiveram descontos autorizados no programa.
Caso uma venda não consiga ser enviada, o registro é marcado como não sincronizado e pode ser reenviado manualmente pela tela de sincronizações.
Sincronização de Devoluções
Executada a cada 1 minuto, essa rotina envia ao DermaClub as devoluções de vendas que continham desconto do programa, seguindo o mesmo fluxo de controle e retry da sincronização de vendas.
O menu Funções Operacionais > Integrações > DermaClub > Sincronizações permite acompanhar o status das sincronizações por filial. A tela exibe, para cada filial habilitada, o estado de cada tipo de sincronização (Vendas, Devoluções e Projetos), a data da última execução bem-sucedida e os registros que não foram enviados.
Quando existem registros não sincronizados, é possível selecioná-los e utilizar o botão Reenviar Registros Não Enviados para forçar uma nova tentativa de envio.
Promoções Ativas
O menu Funções Operacionais > Integrações > DermaClub > Promoções exibe as campanhas DermaClub vigentes no sistema, conforme a última sincronização de projetos realizada pelo serviço.
A tela apresenta duas grades:
- Filiais: lista as filiais habilitadas e indica se existem pendências (produtos participantes não vinculados ao cadastro do sistema).
- Campanhas: ao selecionar uma filial, exibe todas as campanhas ativas para aquela filial com seus respectivos produtos participantes e kits.
Na coluna Código Mercadoria dos produtos participantes, é possível clicar no código zero para vincular manualmente o produto da campanha DermaClub a um produto cadastrado no sistema, resolvendo as pendências de vínculo.
Funcionalidades na Venda
A integração DermaClub atua diretamente no fluxo de venda do PDV.
Para iniciar o fluxo de autorização de descontos, é necessário informar os itens da venda e pressionar [CTRL + O].
Ou, caso a venda possua produtos participantes das campanhas, o fluxo será sugerido automaticamente ao finalizar a venda.
Identificação do Cliente
- O sistema exibe a caixa de solicitação do CPF do cliente
- Após o preenchimento, envia o CPF para a API e valida o status da credencial
Se o CPF for válido e estiver cadastrado no programa, a sessão DermaClub é aberta e os descontos do programa ficam disponíveis para consulta nos itens da venda.
Consulta e Aplicação de Descontos
Com o cliente identificado, o sistema consulta os descontos disponíveis para os produtos presentes na venda. A API retorna, por produto, os descontos aprovados com base nas campanhas vigentes. Os descontos são aplicados automaticamente nos itens da venda, caso sejam melhores que os atuais.
