1. Objetivo da tela
A tela Relação de Custo/Lucro por Contrato gera um relatório consolidado do resultado financeiro de cada contrato de vendas e serviços. Para cada contrato, o relatório reúne os diferentes tipos de movimento vinculados — ordens de serviço e compras diretas, materiais de uso/serviço detalhados por produto, pedidos de compra, contas a pagar/pagas e contas a receber/recebidas — apresentando subtotais por tipo, um total por contrato e uma página final de Resumo com o Total Geral.
O relatório é gerado em formato retrato (A4), com uma capa inicial, um "card" por contrato (contendo número, status, razão social, contato e valor) e um contrato por página.
2. Pré-requisitos de acesso
O item de menu Relação de Custo/Lucro por Contrato só fica disponível quando o parâmetro de controle de contratos está habilitado.
- Parâmetro obrigatório: Diversos/CES OS/Utiliza controle de contratos de vendas e serviços
Com o parâmetro desabilitado, o item não aparece no menu. Habilite-o e grave para liberar o acesso.
- Há também um parâmetro que influencia o custo dos materiais exibido no relatório, quando a OS é de itens para consumo: Diversos/CES OS/Lançar itens de consumo
Marcado: o sistema usa o CUSTO_VENDA do produto.
Desmarcado: o sistema usa o custo de compra do produto.
É esse custo que alimenta a coluna VLR.UNITÁRIO dos materiais no relatório.
3. Como acessar a tela
1. Confirme que o parâmetro de controle de contratos de vendas e serviços está habilitado.
2. No menu principal, acesse Relatórios | Relatório de contratos | Relatório de custos e lucros do contrato.
3. Selecione o item Relatório de custos e lucros do contrato.
4. A tela do relatório será exibida.

4. Filtros disponíveis
A tela oferece filtros para restringir os contratos e os períodos considerados no relatório. Os filtros de período atuam de forma independente por tipo de movimento: cada filtro marcado limita apenas o seu próprio tipo, mantendo os demais inalterados.
4.1. Filtro por contrato
Informe o número de um contrato específico para gerar o relatório apenas daquele contrato. Sem informar nada, o relatório traz todos os contratos.
4.2. Filtro por situação
Permite restringir os contratos por situação: Aberta ou Fechada. Apenas os contratos no status escolhido são incluídos.
4.3. Filtros de período por tipo de movimento
Marque o filtro do tipo desejado e informe Data inicial e Data final. Cada filtro afeta somente o seu tipo:

Observações sobre os filtros:
- Filtro de período é obrigatório
- É possível marcar mais de um filtro de período ao mesmo tempo — cada um filtra apenas o seu tipo, simultaneamente.
- Ao desmarcar todos os filtros, os campos de data são limpos.
5. Gerando o relatório
5. Defina os filtros desejados (contrato, situação e/ou períodos por tipo).
6. Para o relatório completo, não marque nenhum filtro.
7. Acione a geração do relatório.
8. O relatório será exibido para visualização e impressão.

6. Entendendo a estrutura do relatório
6.1. Capa
A primeira página do relatório é uma capa.
6.2. Card do contrato
Cada contrato é apresentado em um card com: Nº, Status, razão social, contato e valor.

6.3. Seções por tipo e colunas dinâmicas
Dentro de cada contrato, os movimentos aparecem em seções por tipo, e os títulos de coluna mudam conforme o tipo:
- Materiais uso serviço: colunas O.S, COD.PRODUTO, NOME PRODUTO, QUANTIDADE, VLR.UNITÁRIO e VALOR, com uma linha por produto e contagem exibida como "item(s)".
- Ordem de compra e compras diretas: a coluna DOCUMENTO aparece como PEDIDO. Em Ordem de compra, VENCIMENTO aparece como DT. ENTREGA.
- Contas a receber/recebidas: a coluna FORNECEDOR aparece como CLIENTE.

6.4. Subtotais e total do contrato
Cada seção exibe um subtotal. Em seções de materiais com vários produtos, o subtotal corresponde à soma dos produtos. O total do contrato corresponde à soma dos subtotais de todas as seções.
6.5. Página de Resumo e Total Geral
Ao final do relatório, a página de Resumo apresenta, por tipo, a soma de todas as linhas daquele tipo (incluindo materiais com vários produtos), e o Total Geral, que corresponde à soma dos totais de todos os contratos.

Artigo gerado pelo time de Qualidade - C&S Sistemas | Julho/2026