Relatorio 3011 Apuracao Comissao Representante
De Touch ERP
Objetivo
O relatório 3011 - Relatório Apuração Comissão Representante tem como objetivo apresentar a apuração detalhada das comissões de representantes, utilizando como base os dados gerados no recurso 324 - Apuração Comissão Representante.
O relatório permite consultar os valores apurados para o representante, os títulos considerados no cálculo da comissão, os lançamentos manuais vinculados à apuração e os totalizadores finais de crédito, débito e valor líquido.
Essa consulta é utilizada principalmente para conferência financeira, validação de comissões, auditoria dos valores calculados e acompanhamento dos títulos que compõem a apuração.
Origem dos Dados
Os dados apresentados no relatório são originados da rotina 324 - Apuração Comissão Representante.
No recurso 324 são definidos os dados da apuração, como representante, período, critérios de cálculo, valores por faturamento, pagamento ou vencimento, lançamentos manuais e título gerado.
O relatório 3011 utiliza o campo Identificador Apuração Comissão Representante para localizar e apresentar os dados da apuração previamente gerada.
Quando Utilizar
Utilize este relatório quando for necessário:
- Conferir os valores de comissão calculados para um representante.
- Validar quais títulos participaram da apuração.
- Consultar valores de comissão por pagamento, vencimento ou emissão.
- Verificar lançamentos manuais vinculados à apuração.
- Conferir créditos, débitos e valor líquido da comissão.
- Rastrear o título financeiro gerado pela apuração.
- Apoiar análises de divergência entre comissão esperada e comissão apurada.
Filtros Disponíveis
| Filtro | Descrição | Observação | Referência Técnica |
|---|---|---|---|
| Filtrar Data | Define se o relatório deve aplicar filtro por período. | Quando marcado como Sim, os campos Data Inicial e Data Final passam a ser obrigatórios. | P_FILTRAR_DATA |
| Data Inicial | Informa a data inicial utilizada para limitar os dados apresentados no relatório. | Obrigatória quando o filtro Filtrar Data estiver ativo. | P_DATA_IN |
| Data Final | Informa a data final utilizada para limitar os dados apresentados no relatório. | Obrigatória quando o filtro Filtrar Data estiver ativo. | P_DATA_FI |
| Filtrar Pessoa (Cliente) | Define se o relatório deve filtrar os dados por cliente/pessoa. | Quando marcado como Sim, o campo Identificador Pessoa (Cliente) passa a ser obrigatório. | P_FILTRAR_PESSOA |
| Identificador Pessoa (Cliente) | Permite informar uma ou mais pessoas/clientes para restringir os dados do relatório. | Utilizado somente quando o filtro Filtrar Pessoa (Cliente) estiver ativo. | P_ID_PESSOA |
| Filtrar Título | Define se o relatório deve filtrar os dados por título. | Quando marcado como Sim, o campo Identificador Título passa a ser obrigatório. | P_FILTRAR_TITULO |
| Identificador Título | Permite informar um ou mais títulos para restringir os dados apresentados. | Utilizado somente quando o filtro Filtrar Título estiver ativo. | P_ID_TITULO |
| Opções Relatório | Agrupa opções adicionais utilizadas para emissão do relatório. | Quando ativo, exige a informação da apuração de comissão e da opção de exibição de lançamentos manuais. | P_OPCOES |
| Identificador Apuração Comissão Representante | Informa qual apuração de comissão de representante será utilizada como base para o relatório. | Deve corresponder a uma apuração previamente gerada no recurso 324 - Apuração Comissão Representante. | P_ID_APURACAO |
| Exibir Lançamentos Manuais | Define se os lançamentos manuais vinculados à apuração serão exibidos no relatório. | Quando marcado como Sim, o relatório apresenta a seção de lançamentos manuais. | P_EXIBIR_LANC_MANUAIS |
Regras de Obrigatoriedade dos Filtros
| Condição | Campos obrigatórios | Referência Técnica |
|---|---|---|
| Quando Filtrar Data estiver marcado como Sim | Data Inicial e Data Final devem ser informadas. | P_FILTRAR_DATA, P_DATA_IN, P_DATA_FI |
| Quando Filtrar Pessoa (Cliente) estiver marcado como Sim | Identificador Pessoa (Cliente) deve ser informado. | P_FILTRAR_PESSOA, P_ID_PESSOA |
| Quando Filtrar Título estiver marcado como Sim | Identificador Título deve ser informado. | P_FILTRAR_TITULO, P_ID_TITULO |
| Quando Opções Relatório estiver marcado como Sim | Identificador Apuração Comissão Representante e Exibir Lançamentos Manuais devem ser informados. | P_OPCOES, P_ID_APURACAO, P_EXIBIR_LANC_MANUAIS |
Campos Corpo
| Campo | Descrição | Observação | Referência Técnica |
|---|---|---|---|
| Ident. Apuração | Exibe o identificador da apuração de comissão do representante. | É o principal vínculo entre o relatório 3011 e o recurso 324. | P_ID_APURACAO |
| Data Inicial | Exibe a data inicial do período da apuração. | Representa o início do período considerado na apuração selecionada. | Dados da apuração |
| Data Final | Exibe a data final do período da apuração. | Representa o fim do período considerado na apuração selecionada. | Dados da apuração |
| Representante | Exibe o representante vinculado à apuração. | Normalmente apresentado com identificador e nome. | Dados da apuração |
| Faturamento | Exibe o valor apurado com base em faturamento. | Apresentado no quadro de valores da apuração. | Valores da apuração |
| Pagamento | Exibe o valor apurado com base em pagamento. | Apresentado quando a comissão é calculada considerando baixas ou liquidações. | Valores da apuração |
| Vencimento | Exibe o valor apurado com base em vencimento. | Apresentado quando a comissão é calculada considerando o vencimento dos títulos. | Valores da apuração |
| Ident. Título Gerado | Exibe o identificador do título gerado pela apuração de comissão. | Utilizado para rastrear o título financeiro originado pela apuração. | Título gerado |
| Data Venc. Título Gerado | Exibe a data de vencimento do título gerado. | Utilizado para conferência do vencimento financeiro da comissão. | Título gerado |
Campos - Valores no Pagamento
| Campo | Descrição | Observação | Referência Técnica |
|---|---|---|---|
| Id. Título | Exibe o identificador do título considerado no cálculo da comissão. | Campo utilizado para rastrear o título financeiro. | Consulta de títulos da apuração |
| Parcelas | Exibe a parcela do título. | Pode indicar parcela atual e quantidade total de parcelas. | Consulta de títulos da apuração |
| Núm. Nota | Exibe o número da nota fiscal relacionada ao título. | Utilizado para rastreabilidade fiscal. | Consulta de títulos da apuração |
| Emissão Nota | Exibe a data de emissão da nota. | Ajuda a validar o período de origem da operação. | Consulta de títulos da apuração |
| Id. Pedido | Exibe o identificador do pedido relacionado. | Permite rastrear a origem comercial do título. | Consulta de títulos da apuração |
| Cód. Pedido | Exibe o código do pedido. | Utilizado para conferência operacional. | Consulta de títulos da apuração |
| Pessoa | Exibe a pessoa/cliente relacionada ao título. | Normalmente apresentado com identificador e nome. | Consulta de títulos da apuração |
| Valor Título | Exibe o valor original do título. | Utilizado como referência para conferência financeira. | Consulta de títulos da apuração |
| Base Cálculo | Exibe o valor utilizado como base de cálculo da comissão. | Pode ser diferente do valor total do título, conforme regra da apuração. | Consulta de títulos da apuração |
| Comissão (%) | Exibe o percentual de comissão aplicado. | Utilizado para validar o cálculo da comissão. | Consulta de títulos da apuração |
| Comissão ($) | Exibe o valor monetário da comissão calculada. | Resultado do cálculo da comissão para o título. | Consulta de títulos da apuração |
| Data Liquid. | Exibe a data de liquidação do título. | Relevante quando a apuração considera valores por pagamento. | Consulta de títulos da apuração |
| Valor Baixa | Exibe o valor baixado do título. | Utilizado para conferência da base considerada no pagamento. | Consulta de títulos da apuração |
Campos - Lançamentos Manuais
| Campo | Descrição | Observação | Referência Técnica |
|---|---|---|---|
| Id. Lançamento | Exibe o identificador do lançamento manual. | Apresentado quando a opção Exibir Lançamentos Manuais estiver marcada como Sim. | Lançamentos manuais da apuração |
| Data Lançamento | Exibe a data do lançamento manual. | Utilizada para conferência do período do ajuste. | Lançamentos manuais da apuração |
| Débito / Crédito | Indica se o lançamento manual é de débito ou crédito. | Créditos aumentam o valor da apuração; débitos reduzem o valor líquido. | Lançamentos manuais da apuração |
| Observação | Exibe a descrição ou justificativa do lançamento manual. | Utilizada para explicar ajustes e complementos de comissão. | Lançamentos manuais da apuração |
| Valor Lançamento | Exibe o valor do lançamento manual. | Compõe os totalizadores de crédito, débito e líquido do lançamento. | Lançamentos manuais da apuração |
Totalizadores
| Totalizador | Descrição | Observação | Referência Técnica |
|---|---|---|---|
| Totalizadores da Apuração | Consolida os valores da apuração. | Exibido após os títulos considerados na apuração. | Totalizadores da apuração |
| Total de Créditos do Lançamento | Soma os lançamentos manuais de crédito. | Apresentado quando existem lançamentos manuais de crédito. | Lançamentos manuais |
| Total de Débitos do Lançamento | Soma os lançamentos manuais de débito. | Apresentado quando existem lançamentos manuais de débito. | Lançamentos manuais |
| Total Líquido do Lançamento | Exibe o resultado líquido dos lançamentos manuais. | Considera créditos menos débitos dos lançamentos manuais. | Lançamentos manuais |
| Total de Créditos da Apuração | Exibe o total de créditos considerados na apuração. | Inclui valores apurados e créditos manuais, quando existentes. | Totalizadores finais |
| Total de Débitos da Apuração | Exibe o total de débitos considerados na apuração. | Utilizado para reduzir o valor líquido final. | Totalizadores finais |
| Total Líquido da Apuração | Exibe o valor líquido final da comissão. | Valor final a ser considerado para conferência e/ou pagamento. | Totalizadores finais |
Como Utilizar
- Acesse a rotina de emissão de BI/relatórios.
- Localize o relatório 3011 - Relatório Apuração Comissão Representante.
- Informe os filtros desejados, como período, pessoa/cliente ou título, quando necessário.
- No grupo Opções Relatório, informe o Identificador Apuração Comissão Representante.
- O identificador informado deve corresponder a uma apuração previamente gerada no recurso 324 - Apuração Comissão Representante.
- Defina se os Lançamentos Manuais devem ser exibidos.
- Clique em Gerar BI para emitir o relatório.
- Confira os dados da apuração, os títulos considerados, os lançamentos manuais e os totalizadores finais.
Exemplo de Uso
Um usuário deseja conferir a comissão de um representante referente a uma apuração já realizada.
Para isso, deve acessar o relatório 3011 - Relatório Apuração Comissão Representante, informar o identificador da apuração de comissão gerado no recurso 324 - Apuração Comissão Representante e gerar o BI.
O relatório apresentará o período da apuração, o representante, os valores calculados, os títulos considerados, eventuais lançamentos manuais e o total líquido da apuração.
Boas Práticas
- Sempre conferir se o identificador da apuração informado no relatório corresponde à apuração correta no recurso 324.
- Validar o período da apuração antes de analisar os valores.
- Quando houver divergência de comissão, conferir os títulos listados no relatório.
- Comparar os valores de comissão com as baixas, vencimentos ou emissões utilizadas na apuração.
- Ativar a opção de exibir lançamentos manuais quando for necessário validar ajustes, créditos ou débitos adicionais.
- Conferir o título gerado pela apuração para garantir rastreabilidade financeira.
- Utilizar os filtros de pessoa e título apenas quando for necessário restringir a análise.
Problemas Comuns e Como Resolver
| Situação | O que fazer |
|---|---|
| O relatório não retorna dados. | Verifique se o identificador da apuração foi informado corretamente e se a apuração existe no recurso 324. |
| Mensagem solicitando Data Inicial ou Data Final. | Verifique se o filtro Filtrar Data está ativo. Quando estiver ativo, informe Data Inicial e Data Final. |
| Mensagem solicitando Identificador Pessoa. | Verifique se o filtro Filtrar Pessoa (Cliente) está ativo. Quando estiver ativo, informe ao menos uma pessoa/cliente. |
| Mensagem solicitando Identificador Título. | Verifique se o filtro Filtrar Título está ativo. Quando estiver ativo, informe ao menos um título. |
| Lançamentos manuais não aparecem no relatório. | Verifique se a opção Exibir Lançamentos Manuais foi marcada como Sim. |
| Valor líquido diferente do esperado. | Confira os títulos considerados, os valores de comissão, os lançamentos manuais de crédito/débito e os totalizadores finais. |
| Apuração correta, mas representante divergente. | Acesse o recurso 324 e valide o representante vinculado à apuração selecionada. |
| Título gerado não localizado. | Verifique no relatório o campo Ident. Título Gerado e utilize o identificador para rastrear o título no financeiro. |
Observações Técnicas
O relatório possui parâmetros específicos para controle de filtros por data, pessoa, título, opções do relatório, apuração e exibição de lançamentos manuais.
As validações do relatório exigem que determinados campos sejam preenchidos conforme o respectivo filtro esteja ativo. Isso evita a emissão do relatório com parâmetros incompletos.
A estrutura do relatório permite consolidar informações relacionadas à apuração por baixa/pagamento, vencimento, emissão e lançamentos manuais.
Referências Técnicas dos Parâmetros
| Parâmetro | Finalidade |
|---|---|
| P_FILTRAR_DATA | Controla se o relatório aplica filtro por data. |
| P_DATA_IN | Armazena a data inicial informada. |
| P_DATA_FI | Armazena a data final informada. |
| P_FILTRAR_PESSOA | Controla se o relatório aplica filtro por pessoa/cliente. |
| P_ID_PESSOA | Armazena os identificadores de pessoa/cliente informados. |
| P_FILTRAR_TITULO | Controla se o relatório aplica filtro por título. |
| P_ID_TITULO | Armazena os identificadores de título informados. |
| P_OPCOES | Controla o grupo de opções adicionais do relatório. |
| P_ID_APURACAO | Armazena o identificador da apuração de comissão representante. |
| P_EXIBIR_LANC_MANUAIS | Controla se os lançamentos manuais serão exibidos. |
Resumo Funcional
O relatório 3011 - Relatório Apuração Comissão Representante é utilizado para conferência da apuração de comissão de representantes.
A principal informação para emissão do relatório é o Identificador Apuração Comissão Representante, gerado no recurso 324 - Apuração Comissão Representante.
Com esse identificador, o relatório apresenta os dados do representante, período da apuração, valores calculados, títulos considerados, lançamentos manuais e totalizadores da comissão, permitindo rastreabilidade e validação dos valores antes da análise financeira ou pagamento.
