Entidade COMISSOES_CONTRATADAS

COMISSOES.COMISSOES_CONTRATADAS

Descrição

A comissão contratada estabelece um valor de comissão a pagar ou a receber para/de alguém (pessoa comissionada) e que está vinculado a alguma entidade (pedido, documento ou título). Esta entidade permite que um mesmo elemento tenha várias comissões a pagar e/ou a receber para diferentes pessoas.
Uma comissão contratada pode ser gerada automaticamente a partir das Regras de comissionamento.

Atributos

AtributoDomínioRegrasDescrição
IDID(18)Rqd PK Id:
Chave de identificação interna
ITEM_PEDIDO_IDID(18)UK FK Item de pedido:
Indica o item de pedido para o qual esta comissão está vinculada.

Referência para ITENS_PEDIDOS
PEDIDO_IDID(18)FK Pedido:
Quando informado, indica o pedido para o qual esta comissão está definida.

Referência para PEDIDOS
DOCUMENTO_IDID(18)FK Documento:
Quando informado, indica o documento para o qual esta comissão está definida.

Referência para DOC_ENTRADAS_SAIDAS
TITULO_IDID(18)FK AK Título:
Quando informado, indica o título para o qual esta comissão está definida.

Referência para TITULOS
ENTIDADEOPCAO(1)Rqd Entidade:
Indica o nome da entidade (tabela) que está sendo alterada.

Valores permitidos:
  • I - Item de pedido
  • P - Pedido
  • O - Item de documento
  • D - Documento
  • T - Títulos
  • M - Manual
REFERENCIA_IDID(18)Rqd UK Referencia:
Identifica o elemento ao qual esta comissão está vinculadas. Pode ser um pedido, documento OU título.
REGRA_COMISSIONAMENTO_IDID(18)Rqd UK FK Regra de comissionamento:
Vinculo com a regra de comissionamento que foi utilizada para criação deste registro de comissão.

Referência para REGRAS_COMISSIONAMENTO
COMISSIONADO_IDID(18)Rqd UK FK Pessoa comissionada:
Pessoa para a qual a comissão deverá ser paga ou recebida.

Referência para PESSOAS
BASE_COMISSAOOPCAO(8)Base da comissão:
Indica o que será utilizado como base para o cálculo da comissão.

Valores permitidos:
  • BALANCO - Balanço (do pedido) - O valor da comissão será calculado a partir de um percentual sobre o balanço (rentabilidade) do respectivo processo comercial (pedido).
  • BRUTO - Valor bruto do item - O valor de base para o cálculo da comissão é o valor bruto do item (quantidade x preço unitário x percentual).
  • LIQUIDO - Valor líquido do item - O valor base é o valor líquido do item (preço bruto - descontos - impostos - frete, etc.).
  • PESO_KG - Peso (Kg) - O valor da comissão será calculado a partir do peso das mercadorias comercializadas. Nesta caso, deverá ser informado um valor de comissão a ser paga por quilograma.
  • PESO_TON - Peso (ton) - A comissão será calculada com base no peso em toneladas das mercadorias comercializadas. Neste caso, deverá ser informado um valor de comissão a ser paga por tonelada.
PERCENTUAL_COMISSAOPERCENT(18)Percentual de comissão:
Percentual do valor de base a ser pago em comissão. Note que este percentual é um calculado e não informado.
VALOR_BASE_COMISSAODECIMAL_VALUEValor base de comissão:
Valor líquido, bruto ou balanço da operação que está sendo comissionado ou, caso a base seja por peso, o peso dos produtos comercializados em KG ou TON.
VALOR_COMISSAO_PESODECIMAL_VALUEValor comissão por peso:
Valor de comissão a ser pago para cada KG ou TON de produtos comercializados. Utilizado apenas quando a comissão é definida por peso.
VALOR_COMISSAODECIMAL_VALUERqd Valor de comissão:
Valor total de comissão a ser lançado. É uma prévia do que será pago de comissão para esta pessoa.
VALOR_DEVIDODECIMAL_VALUERqd Valor confirmado:
Valor confirmado de comissão. Valor de comissão que já está liberado para ser lançado no conta-corrente da pessoa.

Valor padrão = 0
VALOR_PROCESSADODECIMAL_VALUERqd Valor já processado:
Valor de comissão já processado. O processamento da comissão é realizado conforme definido pela respectiva regra de comissionamento. Um valor processado indica que o respectivo valor já foi lançado no respectivo conta-corrente OU repassado para o documento/título onde o mesmo será pago. Quando a condição de lançamento da comissão for atendida, o valor processado deverá se igualar ao valor total de comissão.

Valor padrão = 0
A_PROCESSARFLAG(1)Rqd AK A processar:
Indica quando o registro precisa ser processado. É automaticamente marcado como "S" quando o valor devido é diferente do valor processado.

Valor padrão = N
ESTABELECIMENTO_IDID(18)Rqd FK Estabelecimento:
Indica o estabelecimento ao qual esta comissão está vinculada. Este atributo é calculado automaticamente através do elemento ao qual a comissão está vinculada (pedido, documento, título, etc.) e cria um vinculo direto facilitando processos que dependem do estabelecimento.

Referência para ESTABELECIMENTOS
CONTA_CORRENTE_IDID(18)FK Conta-corrente:
Conta corrente a ser utilizada para os lançamentos desta comissão. Calculado automaticamente de conforme a regra e o comissionado.

Referência para CAIXAS
DATA_CREDITODATEData de crédito:
Data em que a comissão foi liberada para crédito. Quando esta data for informada, ele será utilizada como data do lançamento de crédito da comissão. Caso ela não esteja informada, o sistema utilizará a data do sistema no momento do processamento das comissões.
Esta data é importante para processamento de comissões de eventos passados, tais como, inclusão de regras ou parâmetros de comissão DEPOIS da emissão/faturamento/pagamento.
Esta data é preenchida pelos métodos de calculo das comissões. Para pedidos, será a data de emissão ou de entrega (ultima) de um pedido. Para documentos, será a data de emissão ou entrega do documento. Para títulos será a data do último pagamento do título.
MEMORIALWIKIMemória de cálculo:
Memorial descritivo do cálculo utilizado para justificar a comissão contratada. Este texto é gerado automaticamente pelas rotinas que calculam a comissão contratada. Em geral, ele é composto por uma lista de itens que somados

Exemplo:
Item Valor % Comissão
001 120,00 5% 6,00
002 230,00 5% 11,50
MANUALFLAG(1)Rqd Manual:
Indica se esta comissão foi inserida ou alterada manualmente. Comissões inseridas ou alteradas manualmente não são recalculadas a não ser que o usuário volte a desmarcar esta opção.

Valor padrão = N
ORIGEM_NEGOCIADA_IDID(18)FK AK Origem negociada:
Quando informado, indica que esta comissão foi originada de uma outra comissão através de um processo de negociação. Este atributo facilita o processo de atualização das comissões dos títulos negociados.
Normalmente, este atributo somente será informado para comissões vinculadas a um título.

Referência para COMISSOES_CONTRATADAS

Regras

Calcular estabelecimento

(Antes de inserir, Antes de alterar)
Caso o estabelecimento não seja informado, assume o do objeto relacionado (pedido, documento ou título).

Calcular a processar

(Antes de inserir, Antes de alterar)
Verifica se é necessário processar este registro.

Calcular percentual

(Antes de inserir, Antes de alterar)
Calcula o percentual com base no valor de comissão sobre o valor de base.

Extornar lançamentos ao excluir

(Antes de excluir)
Caso uma comissão contratada que já havia sido processada for excluída, o sistema deve criar um lançamento de estorno da comissão já processada.

Calcular conta corrente

(Antes de inserir, Antes de alterar)
Caso a regra seja por conta-corrente, então preenche o atributo que indica a conta-corrente a ser utilizada.

Recalcular quando desmarcar opção manual

(Depois de alterar)
Caso uma comissão manual seja desmarcada, as comissões de todo o elemento deverão ser recalculadas.

Gerar títulos

(Depois de inserir, Depois de alterar)
Quando o controle é realizado através de títulos, o registro irá gerar títulos previstos.

Verificar se comissão foi negociada

(Antes de excluir)
Verifica se a comissão passou por um processo de negociação. Isso é realizado, buscando comissões contratadas cujo atributo "origem negociada" aponta para esta comissão.

Calcular valor de base a ser comissionado

(Antes de inserir, Antes de alterar)
Calcula o valor de base. O valor dependerá da base informada:

Vincular a entidade correta

(Antes de inserir)
Caso não informada, vincula a comissão a um pedido, documento ou título conforme a referência informada.

Atualizar contas correntes

Atualiza as contas correntes dos comissionados com os valores confirmados de cada comissão contratada. Este método é utilizado apenas no caso de regras de comissionamento que são apuradas por conta-corrente. Somente são processados registros que estão com o campo "A processar" marcado (valor devido diferente do valor processado).

Este método deve ser chamado quando se deseja garantir que as contas correntes de comissão sejam atualizadas. Sugere-se que ele seja executado através de um JOB todas as noites.

Buscar conta corrente

Busca a conta-corrente (caixa) onde os lançamentos desta comissão terão de ser realizados. Caso não encontrar, cria esta conta corrente automaticamente conforme preferencia COMISSOES.COMISSOES_CONTRATADAS.NOME_CONTA_CORRENTE.

Processar

Processa esta comissão contratada gerando, quando necessário, um lançamento de crédito ou débito na respectiva conta-corrente do comissionado.

Processar comissões pendentes

Método que executa os lançamentos pendentes de comissões devidas. O processo é executado da seguinte forma:
  1. Localizar todos os registros de comissões contratadas que possuem alguma pendência de processamento (valor devido é diferente do valor processado)
  2. Executar o lançamento na respectiva conta-corrente do comissionado. Pode ser tanto um lançamento de crédito (valor devido maior que o valor já processado) como um lançamento de débito (valor devido menor que o valor já processado).
  3. Atualizar a comissão contratada, copiando o valor devido para o valor processado (e consequentemente zerando a pendencia de processamento).

Este processo pode ser disparado em inúmeras ocasiões. Pode-se programar um job para processar as comissões diariamente em um determinado horário ou chamá-lo em eventos específicos (troca da situação do pedido, emissão de documentos, movimento em títulos, etc.).

Record identification

Referencia

Retorna um texto com a referência para a qual esta comissão está contratada: