Integração FidelizeC

1. Objetivo

Permitir que clientes de postos de combustíveis utilizem o aplicativo FidelizeC diretamente no PDV Petroshow, para:

• Acumular pontos em suas compras;

• Utilizar cashback como desconto no pagamento;

• Garantir comunicação automática entre PDV e FidelizeC via API.

O que é FidelizeC?

A FidelizeC é uma plataforma de fidelização e engajamento de clientes que oferece um aplicativo próprio e exclusivo para gerenciar programas de fidelidade. Com ela, é possível utilizar cashback, pontos ou brindes, além de realizar campanhas inteligentes, automação de notificações e pesquisas de satisfação. A plataforma também se integra com diversos sistemas para facilitar a gestão de fidelidade das empresas.

Vídeo explicativo sobre a FidelizeC: Funcionamento FidelizeC

2. Pré-requisitos e rotinas envolvidas

• Versão mínima do sistema:

  • PS Gerencial e PDV atualizados para versão 2.0.2511.1000 ou superior - versão que inclui a aba “FidelizeC” nas Configurações do PDV e os novos botões no pagamento.

• Conexão com a Internet:

  • A integração funciona somente em ambiente online, não é permitido o uso de tokens FidelizeC em vendas offline.

• Conta ativa na plataforma FidelizeC:

  • O estabelecimento deve possuir cadastro e credenciais válidas na plataforma FidelizeC, com acesso liberado à API.

  • As credenciais são fornecidas pela equipe FidelizeC e devem conter:

    • URL da API

    • Usuário

    • Senha

    • Código da empresa (CNPJ vinculado)

    • Ambiente de homologação ou produção

• Configuração no PS Gerencial:

  • A integração deve estar ativa em: PS Gerencial >> Cadastros Específicos >> Conf. PDV >> Configurações PDV >> Aba Integrações >> FidelizeC.

  • Preencher todos os campos obrigatórios e sincronizar com o PDV antes de iniciar o uso.

• PDV sincronizado:

  • Após ativar a integração no Gerencial, o PDV deve ser reiniciado e sincronizado, para carregar os parâmetros da FidelizeC.

• Aplicativo FidelizeC instalado e configurado no celular do cliente:

  • O cliente que vai realizar a compra e uso dos pontos, precisa possuir o app FidelizeC instalado, logado e com saldo de pontos ou cashback disponível.

  • Para resgate, o cliente deve gerar o Token/QR Code pelo aplicativo antes de informar no PDV.

• Regras fiscais configuradas:

  • Em vendas com imposto retido, o cashback da FidelizeC não será permitido, pois o desconto interfere na base tributária.

• Sincronização de relógio do PDV:

  • O horário do sistema deve estar atualizado corretamente, pois a autenticação dos tokens FidelizeC depende do timestamp.

3. Passo a passo das rotinas

Configuração:

Em PS Gerencial >> Cadastros Específicos >> Conf. PDV >> Configurações PDV >> Aba Integrações >> FidelizeC, informe:

Open

• Ambiente: 2 – Homologação / 1 – Produção

• URL da Integração: conforme fornecido pela FidelizeC

• Usuário: conforme fornecido pela FidelizeC

• Senha: conforme fornecido pela FidelizeC

• Código da Empresa: conforme cadastrado na FidelizeC

Após a configuração, salve e sincronize o PDV para que a integração seja ativada.

Funcionamento no PDV

Com a integração ativa, novas opções serão exibidas durante o pagamento:

Botões e Campos:

• “Acum. Pontos/CashBack”: abre a leitura ou digitação do QR Code da FidelizeC.

Open

• Campo “CashBack”: exibe o valor do cashback resgatado.

Open

• Campo “CashBack”: exibe o valor do cashback resgatado.

Open

Esses controles aparecem apenas se a integração estiver habilitada.

Operações no PDV

Acúmulo de pontos

1. No app FidelizeC, gere o QR Code de acúmulo.

2. No PDV, clique em “Acum. Pontos/CashBack” e escaneie o QR Code.

3. O sistema exibirá no rodapé do campo CashBack a mensagem:

   “Cód. Acúm. Pts.: XXXXX”

Open

4. Conclua a venda normalmente. A FidelizeC receberá automaticamente a informação para acumular os pontos.

Regra Técnica: Não há desconto neste caso. apenas registro de acúmulo é enviado à FidelizeC.

Resgate de cashback

1. No app FidelizeC o cliente informa o valor que deseja usar.

2. O aplicativo gera um Token/QR Code para uso único.

3. No PDV:

   • Acesse Pagamento >> Descontos.

   • Clique em “Acum. Pontos/CashBack” e informe o token.

4. O sistema valida o código via API e exibe:

   “Cód. Cashback: XXXXX”

Open

5. O valor do cashback será automaticamente aplicado como desconto no pagamento.

Regras:

• Só é possível utilizar um token por compra; para trocar, exclua o anterior.

• O desconto não pode ultrapassar o valor total da venda; o sistema bloqueia e exibe alerta.

• No XML da NF, o cashback aparece no campo de desconto e é rateado entre os itens.

Cancelamento / estorno

• Ao cancelar um cupom fiscal, o PDV chama a API FidelizeC para estornar pontos ou cashback.

• Caso a comunicação falhe, o cancelamento da venda não é bloqueado, apenas será exibida uma mensagem de erro informativa.

Situações especiais

Regras e cuidados

• O resgate é sempre tratado como desconto, impactando o valor final do cupom.

• Cashback e pontos não se acumulam na mesma venda.

• Nenhuma informação da FidelizeC é impressa no cupom fiscal.

• Se houver erro de comunicação após emissão do cupom, o PDV não interrompe o processo (por segurança fiscal).

Solução de problemas

4. Validação e próximos passos

• Realize uma venda teste

  • Após ativar a integração e sincronizar o PDV, faça uma venda de teste utilizando o QR Code de acúmulo gerado pelo aplicativo FidelizeC.

  • Em seguida, realize outra venda utilizando o QR Code de cashback para confirmar se o desconto é aplicado corretamente no PDV.

• Valide os resultados no aplicativo

  • Verifique se o cliente recebeu os pontos ou cashback no app FidelizeC.

  • Confirme também se o valor do cashback utilizado foi debitado corretamente.

• Treine sua equipe

  • Mostre aos operadores do PDV:

    • Onde informar o QR Code ou Token do cliente;

    • Como visualizar o valor de cashback aplicado;

    • O que fazer em caso de erro de conexão ou token inválido;

    • Que em vendas com imposto retido o FidelizeC não será habilitado.

• Divulgue o programa aos clientes

  • Incentive seus clientes a baixarem o app FidelizeC e utilizarem os pontos e cashback nas próximas compras.

  • A fidelização ajuda a aumentar o retorno de clientes e o ticket médio.

• Acompanhe as primeiras movimentações

  • Monitore no painel FidelizeC o volume de pontos acumulados e cashback resgatado.

  • Utilize essas informações para entender o comportamento de compra e ajustar campanhas.

• Monitore o PDV

  • Verifique nas vendas se o campo CashBack está sendo exibido e atualizado corretamente.

  • Caso alguma venda não comunique com a FidelizeC, aguarde a reconexão da internet e repita o processo.

• Em caso de dúvidas

  • Entre em contato com o suporte Viasoft Petroshow ou com o suporte FidelizeC informando o CNPJ e o problema encontrado:

    • Viasoft: suporte@viasoft.com.br

    • FidelizeC: https://www.fidelizec.com.br/