Produto da comanda por representante — Comissão por Produto NT 0582/2026

Resumo da Nota Técnica

Na versão anterior, o relatório Representantes Por itens da Comanda (REL_COMANDAREPRESENTANTEPORITEM) apresentava, por representante, o total dos produtos da comanda, sem detalhar item a item a base de comissão cadastrada no produto.
A partir desta versão, foi disponibilizado o relatório Produto da comanda por representante - Comissão por Produto (REL_COMISSAOPRODUTOCOMANDAPORREPRESENTANTE), que lista os produtos lançados pelo representante em cada comanda, com valor total do item, percentual de comissão (PRODUTO.PRO_COMISSAO) e valor da comissão calculado. Também foram incluídos os filtros de Hora Fechamento Inicial e Hora Fechamento Final, no mesmo conceito operacional do relatório de Comandas Resumidas com Taxa

Detalhes da Nota Tecnica

Objetivo

Permitir a apuração de comissão por produto nas comandas, vinculada ao representante informado no item, com visão analítica abaixo de cada comanda.

Onde acessar

• Menu: Relatórios Fast > Operações > Comanda

• Relatório: Produto da comanda por representante - Comissão por Produto

• Arquivo: REL_COMISSAOPRODUTOCOMANDAPORREPRESENTANTE.FR3

• Local típico de instalação: C:\SINCO\ATUALIZACOES\FONTE PADRAO - COMERCIO\RELATORIOS\ (ou pasta de relatórios configurada no Gerenciamento de Relatórios)

Comportamento funcional

1. O relatório agrupa as informações por representante e por tipo de comanda.

2. Em cada comanda fechada (COM_STATUS = 'F'), é exibida a linha-resumo da comanda (empresa, número, data, hora de abertura, totais).

3. Abaixo da comanda, é apresentada a banda de produtos do representante, com as colunas:

o Código do produto

o Descrição

o Valor total do item (COMI_TOTAL)

o % Comissão (PRODUTO.PRO_COMISSAO)

o Valor da comissão (COMI_TOTAL × PRO_COMISSAO / 100)

4. Somente os itens lançados com o representante daquele agrupamento são listados na banda de detalhe.

5. Os totais de comissão são acumulados nos rodapés de tipo de comanda, representante e geral.

Regra do filtro de data e hora de fechamento

O período informado monta um intervalo contínuo:

• Início: Data Inicial + Hora Fechamento Inicial

• Fim: Data Final + Hora Fechamento Final

A seleção utiliza a data/hora de fechamento da comanda (COM_DATA + COM_HORAFECHAMENTO).

A coluna Hora exibida no corpo do relatório corresponde à hora de abertura (COM_HORAABERTURA), e por isso pode diferir da faixa de fechamento filtrada.

Comandas com hora de fechamento igual a 00:00:00 (não preenchida) não entram no resultado quando o filtro de fechamento é aplicado.

Em turnos que cruzam a meia-noite, quando a hora de fechamento é maior que zero e menor que a hora de abertura, o sistema considera a virada de dia no cálculo do momento de fechamento.

Relatório de referência

O desenvolvimento partiu do relatório Representantes Por itens da Comanda (REL_COMANDAREPRESENTANTEPORITEM), evoluindo o detalhe de produtos e a apuração de comissão, e reutilizando o conceito de filtros de hora de fechamento introduzido na OS 013027 (REL_COMANDASRESUMIDASCOMTAXA).

Configuração

1. Disponibilizar os arquivos

Copiar para a pasta de relatórios da instalação:

• REL_COMISSAOPRODUTOCOMANDAPORREPRESENTANTE.FR3

• REL_COMISSAOPRODUTOCOMANDAPORREPRESENTANTE.SQL

2. Cadastrar o relatório no menu

No Integrado:

1. Acessar o Gerenciamento de Relatórios (Relatórios Fast).

2. Localizar Operações > Comanda.

3. Incluir o item Produto da comanda por representante - Comissão por Produto.

4. Informar o caminho físico do .FR3.

5. Liberar o acesso aos usuários necessários.

image

3. Configurar os parâmetros no CPSql

Garantir os parâmetros (nomes técnicos):

• EMPRESA

• DATAINICIAL / DATAFINAL (obrigatórios)

• HORAFECHAI / HORAFECHAF (tipo Hora)

• REPRESENTANTE

• HORAABERTURA

• TIPOCOMANDA / COMANDA / CAIXA

• MOSTRARPRODUTOS (no relatório a listagem de produtos permanece ativa)

46788d10_image

fc0c2ecd_image

6cdae7ff_image

30c84813_image

2ab912d9_image

42b142bd_image

Questões:

1. Qual é o caminho de menu para acessar o novo relatório de comissão por produto da comanda?

A) Relatórios Fast > Operações > Comissões
B) Relatórios Fast > Operações > Comanda
C) Relatórios Fast > Cadastros > Produtos
D) Utilitários > Parâmetros > Comanda

2. No detalhe do relatório, o valor da comissão de cada produto é obtido por qual regra?

A) Percentual fixo do representante cadastrado em REPRESE
B) Valor total da comanda dividido igualmente entre os itens
C) Valor total do item multiplicado pelo percentual PRO_COMISSAO e dividido por 100
D) Taxa de serviço da comanda aplicada sobre o item

3. Sobre os filtros de Hora Fechamento Inicial e Final, assinale a alternativa correta:

A) Filtram a coluna Hora do relatório, que é a hora de abertura da comanda
B) São obrigatórios e, se em branco, o relatório não é gerado
C) Montam o intervalo com Data Inicial/Final + horas informadas e consideram a data/hora de fechamento da comanda
D) Consideram apenas comandas abertas (COM_STATUS diferente de fechada)

Vídeo
https://youtu.be/ZQiOimf87n8
  

Parâmetros Envolvidos

Não há parâmetros envolvidos.

» Nota Técnica