software‎ > ‎módulos‎ > ‎comissão e meta‎ > ‎manuais técnicos‎ > ‎

manual de comissão (em atualização)


Conceitos

Comissão

A comissão representa um percentual ou valor fixo a ser pago as entidades escaladas de acordo com os valores de uma venda. Em uma venda podemos ter diversas entidades comissionadas e cada uma delas pode ter um cálculo diferente do valor da comissão que será definido de acordo com os cadastros de Regra, Tabela e Fator de comissão.

Configurações

Comissão habilitada

Define que a comissão está habilitada no Sistema UNUM

O motivo da existência da configuração é performance, uma vez que não será necessário perder tempo de processamento com cálculo de comissão caso não seja necessário.

Tipo de configuração: por script
Propriedade: this.habilitado
Valor padrão: false
Localização: /Configuração/Operações/Comerciais/Comissão/0300 INTEQcommerce.ic

Tipos de operações que calculam comissão

Define os tipos de operações que calculam comissão.

O motivo de sua existência é de restrição e também perfomance haja visto que com ela restringimos as operações que calculam comissão evitando cálculos em operações desnecessárias.
Abaixo exemplo de alguns tipos de operações que podem calcular comissão.
Ex: TipoOperacaoPedido.PEDIDO, TipoOperacaoPedido.BAIXA_DE_PEDIDO, TipoOperacaoPedido.BAIXA_AUTOMATICA_DE_PEDIDO

Tipo de configuração: por script
Propriedade: this.tipoOperacaoCalculaComissao
Valor padrão: [ TipoOperacaoPedido.PEDIDO,
                      TipoOperacaoPedido.BAIXA_AUTOMATICA_DE_PEDIDO,
                      TipoOperacaoPedido.BAIXA_AUTOMATICA_DE_DEVOLUCAO,
                      TipoOperacaoPedido.PREBAIXA_AUTOMATICA_DE_PEDIDO,
                      TipoOperacaoPedido.PREBAIXA_AUTOMATICA_DE_DEVOLUCAO ]
Localização: /Configuração/Operações/Comerciais/Comissão/0300 INTEQcommerce.ic

OBS: Se a comissão estiver habilitada as operações de devolução (TipoOperacaoPedido.DEVOLUCAO) sempre calculam comissão independente de estarem configuradas para tal.

Tipos de operações que efetivam comissão

Define os tipos de operações que efetivam comissão. Ao efetivarmos a comissão de uma operação serão gerados eventos que ficarão localizados na tabela de EVENTO.

O motivo de sua existência é de restrição, haja visto que com ela restringimos as operações que efetivam a comissão no Sistema UNUM.
Ex: TipoOperacaoPedido.PEDIDO, TipoOperacaoPedido.BAIXA_DE_PEDIDO, TipoOperacaoPedido.BAIXA_AUTOMATICA_DE_PEDIDO

Tipo de configuração: por script
Propriedade: this.tipoOperacaoEfetivaComissao
Valor padrão: [ TipoOperacaoPedido.PEDIDO,
                      TipoOperacaoPedido.BAIXA_AUTOMATICA_DE_PEDIDO,
                      TipoOperacaoPedido.BAIXA_AUTOMATICA_DE_DEVOLUCAO,
                      TipoOperacaoPedido.PREBAIXA_AUTOMATICA_DE_PEDIDO,
                      TipoOperacaoPedido.PREBAIXA_AUTOMATICA_DE_DEVOLUCAO ]
Localização: /Configuração/Operações/Comerciais/Comissão/0300 INTEQcommerce.ic

OBS: Se a comissão estiver habilitada as operações de devolução (TipoOperacaoPedido.DEVOLUCAO) sempre efetivarão comissão independente de estarem configuradas para tal.

Situações das operações que efetivam comissão

Define as situações que efetivam comissão.

O motivo de sua existência é de restrição pois com ela podemos escolher quais situações da operação efetivam comissão.
Abaixo exemplo de algumas situações de operações que podem efetivar comissão.
Ex: SituacaoPedido.APROVADO, SituacaoPedido.NAO_APROVADO.
OBS: O sistema ainda não esta preparado quando está configuração está setada para SituacaoPedido.NAO_APROVADO. Portanto, todas as efetivações, atualmente, acontecem na aprovação da operação.

Tipo de configuração: por script
Propriedade: this.situacaoOperacaoEfetivaComissao
Valor padrão: [ SituacaoPedido.APROVADO ]
Localização: /Configuração/Operações/Comerciais/Comissão/0300 INTEQcommerce.ic

Comportamento no Pedido

Quando configurado para comissionar no pedido a comissão é efetuada de acordo com a situação da operação (Aprovada ou não aprovada). Atualmente as efetivações das comissões ocorrem somente em pedidos com situação aprovada.
Se o pedido estiver configurado para efetivar comissão também deverá estar configurado para pesquisar escala e calcular comissão.
Existe também a possibilidade de configurarmos o pedido para pesquisar escala, calcular comissão e não efetivar comissão. Deixando assim o pedido preenchido com as escalas identificadas e seus respectivos valores de comissão para uso posterior na baixa. Outra possibilidade é de o pedido não pesquisar escala, não calcular e não efetivar, deixando essas responsabilidades para acontecerem somente na hora baixa.

Comportamento na Baixa do Pedido

A baixa pode estar configurada para pesquisar escala, calcular e efetivar comissão. Neste caso as efetivações da comissão só irão acontecer na baixa do pedido. Outra possibilidade é que a mesma esteja configurada somente para efetivar comissão, logo a pesquisa da escala e o calculo inicial da comissão terá sido feito no pedido de origem, neste caso é resgatado quais entidades foram escaladas e quais valores de comissão foram calculados no pedido de origem, logo a comissão é efetuada proporcionalmente de acordo com o número de itens baixados e com o campo quantidade existente no item do pedido da baixa.

Comportamento na Devolução do Pedido

Quando a comissão estiver habilitada as operações de devolução (TipoOperacaoPedido.DEVOLUCAO) sempre irão estornar a comissão independente de estarem configuradas para tal. A devolução resgata quais entidades foram escaladas e quais valores de comissão foram calculados no pedido baixado. O cáculo de estorno da comissão também é feito proporcionalmente de acordo com o número de itens devolvidos e com o campo quantidade existente no item do pedido de devolução.

Telas Envolvidas

Tabela de Comissão

Tabela: TABELA
Classe de Configuração:: -1894334219 /* Tabelas de comissões */
Classe de Dados: -1894334216 /* Tabelas de comissões */
Caminho: Ir Para > Comissão > Cadastros > Tabelas de Comissões

Ao realizar a pesquisa da Regra de Comissão encontramos a Tabela de Comissão antes de realizar o cálculo é feito uma verificação em relação a vigência da tabela, caso esteja válida serão utilizados um dos fatores definidos na tabela.

Fator de Comissão

Tabela: FATOR
Classe de Configuração:: -1894334210 /* Fatores de comissões */
Classe de Dados: -1894334231 /* Fatores de comissões */
Caminho: Ir Para > Comissão > Cadastros > Tabelas de Comissões

O cálculo da comissão é feito de acordo com o cadastro feito no Fator de Comissão.
Os fatores de comissão estão relacionados a uma tabela de comissão. Portanto são cadastrados na mesma tela do cadastro
da tabela de comissões.

Dados do pedido que definem a escolha da Regra de Comissão
  • Recurso (Recurso e Classe de Recurso)
  • Eficiência (Inicial e Final)

Regras de Comissão

Tabela: VINCULA
Classe de Configuração: -1894334212 /* Regras de Comissão */
Classe de Dados: --1894334221 /* Regras de Comissão */
Caminho: Ir Para > Comissão > Cadastros > Regras de Comissão
Padrão de desenvolvimento: Padronização de Cadastro de Regras

Ao realizar uma venda será feita uma pesquisa para encontrar a regra de comissão que será utilizada no cálculo da comissão. Nesta pesquisa só poderá ser encontrada uma única regra de comissão válida e nela terá a chave da Tabela de Comissão que será utilizada. 

Dados do pedido que definem a escolha da Regra de Comissão
  • Classe de Operação
  • Entidade (Nome, Função e Classe Função)
  • Estabelecimento (Nome e Classe)
  • Local de Escrituração (Nome e Classe)
  • Cliente (Nome, Classe, UF e Local de Entrega)
  • Núcleo (Nome e Classe)
  • Zona de Representante (Nome e Classe)

Modelo de Dados

Um pedido pode ter N escalas de trabalho, logo os campos de comissão referente aquela escala também são gerados dinamicamente de acordo com a configuração de Máximo de Entidades por Escala de Trabalho (Ver maior detalhes no manual de Escalas de Trabalho)
  • Tabela: PEDIDO
    • Campos: COMISSTABFATOR1, COMISSTABFATOR2, COMISSTABFATOR3, ......, COMISSTABFATORN
      • São campos no pedido que contém as chaves da tabela da fator utilizada.
    • Campos: COMISSFATOR1, COMISSFATOR2, COMISSFATOR3, ......, COMISSFATORN
      • São campos no pedido que contém o fator utilizado para aquela comissão
    • Campos: COMISSBC1, COMISSBC2, COMISSBC3, ......, COMISSBCN
      • São campos no pedido que contém as bases de cálculos que foram utilizadas para calculo das comissões que serão efetivadas.
    • Campos: COMISSVALOR1, COMISSVALOR2, COMISSVALOR3, ......, COMISSVALOR3
      • São campos no pedido que contém os valores das comissões que serão efetivadas.

Scripts Envolvidos

-1894333862 /products/INTEQcommerce/library/objects/comissao/Comissao.ijs
-1894333868 /products/INTEQcommerce/library/objects/comissão/ComissaoDAO.ijs
-1894333859 /products/INTEQcommerce/library/objects/comissao/BaixaComissao.ijs
-1894333858 /products/INTEQcommerce/library/objects/comissao/BaixaComissaoDAO.ijs
-1894333869 /products/INTEQcommerce/library/objects/EscalaComissaoMetaFacade.ijs
-1894333791 /products/INTEQcommerce/library/objects/EscalaComissaoMetaFacadeProporcional.ijs
-1894334226 /Configuração/Operações/Comerciais/Comissão/0100 INTEQcommerce.ic
-1894333953 /Configuração/Operações/Comerciais/Comissão/0200 INTEQcommerce.ic
-1894333875 /Configuração/Operações/Comerciais/Comissão/0300 INTEQcommerce.ic