Liberação:04/11/2026
#Faturamento
Objetivo da mudança:
Implementar suporte à integração do módulo de Cashback com a plataforma parceira Efice através do consumo de APIs do WebService. A alteração cria uma estrutura técnica dedicada com tipo de cashback específico (WS) para acumular e consultar saldos externos, permitindo que os clientes utilizem os saldos de cashback concedidos pela Efice diretamente no fechamento de vendas no sistema desktop.
Rotinas / Telas:
- Principal > Manutenção de Cadastros > Auxiliares > Cashback , tela : Manutenção de Cadastro de Cashback (frmCadCashback)
- Principal > Faturamento > Emissão de Faturamento > Pedido , tela : Vendas – Pedido (frmFatVendas)
Instruções sobre o que configurar
CFG_CBKUTI — “CASHBACK – Utilizar esta rotina ?”: é obrigatório definir esta configuração como “Sim” no Configuração do Sistema (frmCfgSistema) para ativar o uso dos saldos no faturamento;
Cadastro do Tipo “WS”: O tipo de cashback WS será gerado e inserido automaticamente pelo WebService no primeiro envio efetuado pela Efice;
É necessária a atualização do executável AUTCOM.EXE e do serviço de WebService API.
Instruções sobre como utilizar:
1. Fluxo de Integração via WebService (Plataforma Efice)
-
A plataforma Efice consulta os pedidos emitidos pelo sistema através de endpoint do WebService;
-
A Efice efetua o cálculo dos benefícios e envia a inclusão do saldo para o cliente via API, gravando a pontuação na tabela VENCSH sob o tipo de cadastro WS (CADCSH.CSH_TIPCSH = ‘WS’);
-
A Efice pode utilizar os novos endpoints para consultar o saldo disponível (VENCSH) e o histórico de utilização de créditos pelo cliente (UTICSH).
2. Tratamento no Sistema Desktop (AUTCOM)
-
Regra de Exibição em Tela: Registros de cadastro de cashback com o tipo WS são mantidos restritos à integração e não serão exibidos, carregados, alterados ou incluídos manualmente na tela de Manutenção de Cadastro de Cashback (frmCadCashback);
-
Cálculo de Concessão Interna: O motor de cálculo de cashback do sistema ignora o tipo WS, garantindo que não ocorra duplicidade na geração de novos créditos para regras internas;
-
Resgate e Utilização: Ao realizar uma venda no faturamento, caso o cliente possua saldo disponível gerado pela Efice, o sistema permitirá o resgate do valor de cashback na tela de fechamento. Os saldos consumidos serão deduzidos de VENCSH e registrados em UTICSH.