Objetivo da mudança:

O objetivo foi aplicar na versão do cliente a funcionalidade de integração completa com a API do “Clube do Pintor” da Sherwin-Williams, desenvolvida no requisito 385748. Esta implementação permite o registro de pontuações e o resgate de vouchers, englobando: a pontuação automática de vendas com produtos participantes; a funcionalidade de resgate de vouchers durante a venda; e as configurações necessárias no sistema para habilitar e parametrizar a integração, bem como marcar os produtos participantes.

Rotinas / Telas:

• Configuração do Sistema (frmCfgSistema);

• Principal > Manutenção de Cadastros > Produtos > “Cadastro de Produtos” (frmCadProdutos);

• Principal > Operações Ref. a Produtos > “Alteração Global/Individual de Preços“ (frmAltPrecoIndividual);

• Principal > Faturamento > Emissão de Faturamento > “Emissão de Venda” (frmFatVendas);

• Principal > Faturamento > Emissão de Faturamento > “Pedido“ e “Brinde” (frmFatVendas).

Instruções sobre o que configurar:

1. Acessar a rotina Configuração do Sistema (frmCfgSistema), no novo grupo “Integração de Sistemas – Clube do Pintor”;

2. Habilitar a opção CFG_CDPHAB – “Utilizar integração Clube do Pintor?” como “Sim”;

3. Preencher os campos CFG_CDPURL – “Base URL” e CFG_CDPAPK – “API-Key” com as credenciais fornecidas pela plataforma;

4. No “Cadastro de Produtos” (ou via alteração global), marcar como “Sim” o novo campo “Permite pontuar no Clube do Pintor?” para todos os produtos participantes do programa.

Instruções sobre como utilizar:

• Para Pontuar:

  1. Realize o faturamento de uma nota fiscal contendo produtos marcados para pontuar. O sistema enviará os dados para a API automaticamente.

• Para Resgatar Voucher:

  1. Inicie uma venda de “Brinde” ou um “Pedido” com itens marcados como brinde;

  2. No fechamento da venda [F10], uma nova tela solicitará a digitação do voucher;

  3. Informe o código do voucher. O sistema irá validá-lo na plataforma;

  4. Confirme o uso. O voucher será registrado e impresso nos dados adicionais da nota fiscal.