Nota Técnica

Resumo da Nota Técnica

Resumo da Nota Técnica
Nesta ordem de serviço foram criados relatórios de Ordem de Serviço utilizando como base os relatórios já existentes de venda por pedido.

A implementação reaproveita o mesmo modelo de análise, filtros, totalizações e estrutura de layout do PDF dos relatórios de pedido, alterando a origem dos dados para consultar informações de Ordem de Serviço e seus respectivos itens.

Detalhes da Nota Técnica

Detalhes da Nota Técnica

Criação dos relatórios de Ordem de Serviço

Foram criados relatórios específicos para Ordem de Serviço, seguindo o mesmo padrão dos relatórios de venda por pedido já existentes no sistema.

A estrutura do relatório foi mantida de forma semelhante, permitindo que o usuário visualize informações consolidadas e detalhadas de OS com o mesmo padrão funcional utilizado nos relatórios de pedidos de venda.

Alteração da origem dos dados do relatório

Nos relatórios de venda por pedido, as informações são obtidas a partir das tabelas relacionadas a pedidos e itens de pedido.

Na nova versão para Ordem de Serviço, a origem dos dados foi alterada para utilizar o cabeçalho da OS e os itens vinculados à OS.

Com isso, o relatório passa a refletir os documentos do tipo Ordem de Serviço, mantendo a lógica de leitura de documento principal e seus respectivos itens.

Reaproveitamento do modelo de relatório existente

A implementação foi realizada com base no mesmo modelo de relatório utilizado para vendas por pedido.

Foram reaproveitados conceitos como:

filtros do relatório;
totalizações;
estrutura de apresentação;
layout de impressão em PDF;
tratamento dos dados retornados para montagem do HTML.

Esse reaproveitamento garante padronização visual e funcional entre os relatórios de venda e os relatórios de OS.

Equivalência entre Pedido de Venda e Ordem de Serviço

A lógica aplicada considera que o relatório de OS utiliza o mesmo modelo de análise do relatório de pedido, porém com outro tipo de documento como fonte.

A equivalência funcional pode ser entendida da seguinte forma:

onde o relatório de venda utiliza um pedido de venda, o relatório de OS utiliza uma ordem de serviço;
onde o relatório de venda utiliza itens ligados ao pedido, o relatório de OS utiliza itens ligados à OS;
onde o relatório de venda considera datas do pedido, o relatório de OS considera datas da ordem de serviço, como abertura, entrega ou demais datas definidas no SQL.

Essa abordagem permite manter o comportamento esperado do relatório, alterando apenas a base de consulta dos dados.

Padronização dos nomes de colunas para compatibilidade

Os nomes das colunas retornadas pelo SQL foram mantidos o mais próximos possível dos nomes utilizados nos relatórios de pedido de venda.

Essa padronização permite que o mesmo arquivo JavaScript responsável por interpretar o resultado do SQL continue funcionando corretamente para os relatórios de OS, reduzindo necessidade de alterações estruturais na renderização.

Resultado esperado para o usuário

Com a implementação, o usuário passa a contar com relatórios de Ordem de Serviço no mesmo padrão dos relatórios de venda por pedido.

A melhoria permite analisar dados de OS com filtros, totais e layout de PDF já conhecidos, mantendo consistência visual e operacional entre os diferentes tipos de documento do sistema.

Questões:

Parâmetros Envolvidos

Parâmetros Envolvidos
Não há parâmetros envolvidos.