VISÃO GERAL

A funcionalidade "Cálculo de Comissão Online" é um recurso integrado ao ERP Winthor, projetado para oferecer aos usuários do TOTVS CRM - SFA uma maneira intuitiva e eficaz de visualizar as comissões associadas a produtos durante o processo de vendas.

    OBJETIVO

Aprimorar vendas com visualização imediata das comissões, aumentando transparência e eficiência.

  ANTES DE COMEÇAR

Requisitos

• Versão padrão da solução TOTVS CRM - SFA.
• ERP Winthor configurado e integrado.
• Permissões de configuração habilitadas para o usuário.
• Parâmetros específicos de comissão corretamente definidos.

  DETALHES FUNCIONAIS

Funções

• Visualização de Comissão: Exibe percentuais de comissão para produtos, aprimorando a compreensão do ganho.
• Cálculo Online: Botão "Calcular Comissão" oferece cálculos instantâneos e precisos.
• Integração ERP: Integra-se perfeitamente ao ERP Winthor cx para cálculos confiáveis.
• Configuração Flexível: Ative ou desative o cálculo online conforme necessário.
• Atualização Automática: Refaz cálculos quando itens do pedido são modificados.

  COMO USAR?

Passo a Passo

• No carrinho de vendas, selecione um produto e toque nele para visualizar os detalhes.
• Junto às informações do produto, você verá o botão "Calcular Comissão" na cor amarela.
• Toque no botão "Calcular Comissão" para obter o cálculo instantâneo da comissão do produto.
• Observe como o botão muda para verde após o cálculo, indicando que a comissão foi calculada.
• Ao ajustar a quantidade, preço de venda, descontos ou inserir novos produtos, o sistema reprocessará automaticamente as comissões.
• Na listagem de produtos do carrinho, você verá os percentuais e valores de comissão ao lado de cada item.
• Ao finalizar o pedido, a comissão total será resumida, proporcionando uma visão clara dos ganhos.

 EXEMPLO PRÁTICO

Caso de uso

Rafael, vendedor, utiliza "Cálculo de Comissão Online" no TOTVS CRM - SFA para visualizar instantaneamente suas comissões por produto durante as vendas.

Rafael gastava tempo calculando comissões manualmente ou esperando informações de finanças, atrasando negociações.

Agora, com a funcionalidade de Cálculo de Comissão Online, Rafael pode obter instantaneamente os valores de comissão associados a cada produto durante o processo de vendas.

  DETALHES TÉCNICOS

03. Escopo Técnico

Para atender à funcionalidade de comissão no Winthor, os seguintes parâmetros serão criados e estarão disponíveis na opção 18 do menu "Tools".

• Chave: sim3g.pedido.comissao.usaPcTabComisao
• Descrição: Indica se o cliente usa a tabela PcTabComiss.
• Valor: 0
• Observação: Parâmetro que indica o uso da tabela PcTabComiss.
• Módulo: Venda
• Contexto: Pedido
• Ambiente: Todos

• Chave: sim3g.pedido.comissao.UsaPcComissaoUsur
• Descrição: Parâmetro que indica se o cliente usa a tabela UsaPcComissaoUsur
• Valor: 0
• Observação: Parâmetro que indica se o cliente usa a tabela UsaPcComissaoUsur
• Módulo: Venda
• Contexto: Pedido
• Ambiente: Todos

• Chave: sim3g.pedido.comissao.UsaPCComissaoPlPag
• Descrição: Parâmetro que indica se o cliente usa a tabela UsaPCComissaoPlPag
• Valor: 0
• Observação: Parâmetro que indica se o cliente usa a tabela UsaPCComissaoPlPag
• Módulo: Venda
• Contexto: Pedido
• Ambiente: Todos

• Chave: sim3g.pedido.comissao.UsaPCComissaoRegiao
• Descrição: Parâmetro que indica se o cliente usa a tabela UsaPCComissaoRegiao
• Valor: 0
• Observação: Parâmetro que indica se o cliente usa a tabela UsaPCComissaoRegiao
• Módulo: Venda
• Contexto: Pedido
• Ambiente: Todos

• Chave: sim3g.pedido.comissao.UsaPCComissaoFilial
• Descrição: Parâmetro que indica se o cliente usa a tabela UsaPCComissaoFilial
• Valor: 0
• Observação: Parâmetro que indica se o cliente usa a tabela UsaPCComissaoFilial
• Módulo: Venda
• Contexto: Pedido
• Ambiente: Todos

Será criada a opção "HABILITAR_COMISSAO_ONLINE" na página "Configuração -> Configuração Pedido -> Geral" com as seguintes opções:

• Campo: HABILITAR_COMISSAO_ONLINE
• Situação: Booleano (por padrão inativo)
• Label: standard.pedidoconfig.comissao.calculo.online (valor padrão: 'Calcular Comissão')
• Descrição: Habilita o cálculo de comissão online.

Quando o campo "HABILITAR_COMISSAO_ONLINE" estiver ativo, o botão "Calcular Comissão" será exibido no menu superior do pedido.

Ao realizar um pedido, os usuários poderão calcular a comissão online para obter o percentual de comissão gerado pelo produto.

O botão "Calcular Comissão" estará inicialmente amarelo, indicando que a comissão será calculada. Após o cálculo, a cor do botão será atualizada para verde.

                      DECLARE
                         p_codcomissao      number;
                         p_rotinacomissao   varchar2;
                         p_LetraComiss      varchar2;
                         p_mensagem         varchar2;
                      
                      BEGIN
                         FUNCOESVENDAS.DEFINIR_COMISSAO_ITEM_VENDIDO(
                            :p_NumRegiao, :p_perluc, :p_perdesc, :p_UsaPcTabComiss, 
                            :p_UsaPcComissaoUsur, :p_UsaPCComissaoPlPag, 
                            :p_UsaPCComissaoRegiao, :p_UsaPCComissaoFilial, 
                            :p_usacomissaoporrca, : p_OrdemAvaliacaoComissaoRCA, 
                            :p_usacomissaoporcliente, :p_USACOMISSAOPORLINHAPROD, 
                            :p_comissaorcatipovenda, :p_tipovend, :p_percent, 
                            :p_percent2, :p_codprod, :p_pcomint1, :P_PCOMEXT1, 
                            :P_PCOMREP1, :p_codlinhaprod, :p_tipocomissao, :p_codepto, 
                            :p_codsec, :p_classeproduto, :p_tipovenda, :p_codplpag, 
                            :p_data, :p_codfilial, :p_codusur, :p_considerarcomissaozero, 
                            :p_tipoavaliacaocomissao, :p_percomcli, :p_codcli, 
                            :p_coddesconto, :p_codauxiliar, :p_pcomint1_emb, 
                            :P_PCOMEXT1_emb, :P_PCOMREP1_emb, :p_utilizavendaporembalagem, 
                            :p_tabela, :p_venda, :p_numcasasdecvenda
                         );
                         dbms_output.put_line(p_codcomissao || ',' || p_rotinacomissao || ',' || p_LetraComiss || ',' || p_mensagem);
                      END;
                    

Acesse o link: https://docs.oracle.com/cd/A84870_01/doc/java.816/a81354/samapp2.htm

Abaixo, encontre o mapeamento dos campos a serem enviados:

    :p_NumRegiao=tabelapreco.codigoerp (codigoerp da tabela de preço selecionada NO cabeçalho),
    :p_perluc=(precovenda - precocusto)/precocusto*100,
    :p_perdesc=pedidoproduto.percentualdesconto,
    :p_UsaPcTabComiss=parametro.valor do parâmetro sim3g.pedido.comissao.usaPcTabComisao,
    :p_UsaPcComissaoUsur=parametro.valor do parâmetro sim3g.pedido.comissao. UsaPcComissaoUsur,
    :p_UsaPCComissaoPlPag= parametro.valor do parâmetro sim3g.pedido.comissao. UsaPCComissaoPlPag,
    :p_UsaPCComissaoRegiao=parametro.valor do parâmetro sim3g.pedido.comissao. UsaPCComissaoRegiao,
    :p_UsaPCComissaoFilial=parametro.valor do parâmetro sim3g.pedido.comissao. UsaPCComissaoFilial,
    :p_usacomissaoporrca=(SELECT usacomissaoporrca FROM PCCONSUM p),
    :P_ORDEMAVALIACAOCOMISSAORCA=(SELECT ordemavaliacaocomissaorca FROM PCCONSUM p),
    :P_USACOMISSAOPORCLIENTE=(SELECT usacomissaoporcliente FROM PCCONSUM p),
    :P_USACOMISSAOPORLINHAPROD=(SELECT usacomissaoporlinhaprod FROM PCCONSUM p),
    :P_COMISSAORCATIPOVENDA=(SELECT comissaorcatipovenda FROM PCCONSUM p),
    :P_TIPOVEND=(SELECT tipovend FROM pcusuari WHERE codusur = (SELECT codigoerp FROM usuario WHERE idusuario = :Profissional_selecionado_no_Pedido))
    :P_PERCENT=(SELECT PERCENT FROM pcusuari WHERE codusur = (SELECT codigoerp FROM usuario WHERE idusuario = :Profissional_selecionado_no_Pedido))
    :P_PERCENT2=(SELECT PERCENT2 FROM pcusuari WHERE codusur = (SELECT codigoerp FROM usuario WHERE idusuario = :Profissional_selecionado_no_Pedido))
    :P_CODPROD = (SELECT codigoerp FROM produto WHERE produto= :PRODUTO_INSERIDO_NO_CARRINHO), --codigoerp do produto
    :P_PCOMINT1=(SELECT pcomint1 FROM pcprodut WHERE codprod=(SELECT codigoerp FROM produto WHERE produto= :PRODUTO_INSERIDO_NO_CARRINHO)),
    :P_PCOMEXT1=(SELECT pcomext1 FROM pcprodut WHERE codprod=(SELECT codigoerp FROM produto WHERE produto= :PRODUTO_INSERIDO_NO_CARRINHO)),
    :P_PCOMREP1=(SELECT pcomrep1 FROM pcprodut WHERE codprod=(SELECT codigoerp FROM produto WHERE produto= :PRODUTO_INSERIDO_NO_CARRINHO)),
    :p_codlinhaprod=(SELECT codlinhaprod FROM pcprodut WHERE codprod=(SELECT codigoerp FROM produto WHERE produto= :PRODUTO_INSERIDO_NO_CARRINHO)),
    :p_tipocomissao=(SELECT tipocomissao FROM pcprodut WHERE codprod=(SELECT codigoerp FROM produto WHERE produto= :PRODUTO_INSERIDO_NO_CARRINHO)),
    :p_codepto=    (SELECT codepto FROM pcprodut WHERE codprod=(SELECT codigoerp FROM produto WHERE produto= :PRODUTO_INSERIDO_NO_CARRINHO)),
    :p_codsec=(SELECT p_codsec FROM pcprodut WHERE codprod=(SELECT codigoerp FROM produto WHERE produto= :PRODUTO_INSERIDO_NO_CARRINHO)),
    :p_classeproduto=(SELECT p_classeproduto FROM pcprodut WHERE codprod=(SELECT codigoerp FROM produto WHERE produto= :PRODUTO_INSERIDO_NO_CARRINHO)),
    :p_tipovenda= (SELECT tipovenda FROM pcplpag WHERE codplpag=:CONDICAOPAGAMENTO_SELECINADA_NO_PEDIDO),
    :p_codplpag= (SELECT codigoerp FROM condicaopagamento WHERE idcondicaopagamento=:CONDICAOPAGAMENTO_SELECINADA_NO_PEDIDO),
    :p_data=(SELECT datapedido FROM pedido WHERE idpedido=:pedido_selecionado),
    :p_codfilial=(SELECT numeromatricula FROM LOCAL WHERE idlocal = (FILIAL_SELECIONADA_NO_PEDIDO),
    :p_codusur=(SELECT CODIGOERP FROM USUARIO WHERE IDUSUARIO=:PROFISSIONAL_SELECIONADO_NO_PEDIDO),
    :p_considerarcomissaozero=(SELECT considerarcomissaozero FROM pcfilial WHERE codigo= (SELECT numeromatricula FROM LOCAL WHERE idlocal = (FILIAL_SELECIONADA_NO_PEDIDO)),                                     
    :p_tipoavaliacaocomissao=(SELECT tipoavaliacaocomissao FROM pcfilial WHERE codigo= (SELECT numeromatricula FROM LOCAL WHERE idlocal = (FILIAL_SELECIONADA_NO_PEDIDO)),
    :p_percomcli=(SELECT percomcli FROM pcclient WHERE codcli = (SELECT codigoerp FROM parceiro WHERE idparceiro=:CLIENTE_SELECIONADO_PEDIDO)),
    :p_codcli=(SELECT codcli FROM pcclient WHERE codcli = (SELECT codigoerp FROM parceiro WHERE idparceiro=:CLIENTE_SELECIONADO_PEDIDO)),
    :p_coddesconto=(SELECT CODIGOERP FROM DESCONTO WHERE iddesconto = desconto_aolicado_automaticamente_no_item),
    :p_codauxiliar= (SELECT codigobarra FROM produtoembalagem WHERE idproduto =:PRODUTO_SELECONADO AND idembalagem=:Emabalagem_seleconada),
    :p_pcomint1_emb= NULL,                                                   
    :P_PCOMEXT1_emb=NULL,
    :P_PCOMREP1_emb=NULL,                                                  
    :p_utilizavendaporembalagem = parametro.valor do parâmetro sim3g.pedido.embalagem.utilizavendaporembalagem,
    :p_tabela=pedidoproduto.precooriginal do produto seleconado,
    :p_venda=pedidoproduto.precovenda do produtoselecionado,
    :p_numcasasdecvenda= (SELECT numcasasdecvenda FROM pcconsum)               

Os valores de comissão serão inseridos em campos específicos:

Perc_comissao:

• ANDROID_CARD_PERCENTUAL_COMISSAO
• ANDROID_CARRINHO_PERCENTUAL_COMISSAO
• ANDROID_NEGOCIACAO_PERCENTUAL_COMISSAO
• WEB_GRID_PERCENTUAL_COMISSAO

Vlr_comissao:

• ANDROID_CARD_VALOR_COMISSAO
• ANDROID_CARRINHO_VALOR_COMISSAO
• ANDROID_NEGOCIACAO_PERCENTUAL_COMISSAO
• WEB_GRID_VALOR_COMISSAO

• Esses valores e percentuais de comissão serão armazenados nos campos pedidoproduto.valorcomissao e pedidoproduto.percentualcomissao, respectivamente.
• No resumo do pedido, a comissão será calculada assim:
• VALOR_COMISSAO = SOMA(item."Vlr_comissao")
• Quando o botão "HABILITAR_COMISSAO_ONLINE" estiver ativo e houver mudanças na quantidade, preço de venda, % de desconto ou valor de desconto do item, a função de comissão deverá ser marcada para reprocessamento obrigatório (botão de cálculo amarelo). Isso também acontecerá ao adicionar um novo produto ao carrinho após o cálculo da comissão para itens anteriores. Esse comportamento é similar à simulação de impostos online.