**Processo:**
PROC005.1 Reformulação Tela Principal O.S. - Detalhes
**Versão do Documento:**1.0
**Responsável(eis):** Luís Leite
**Data:** 03/11/2025
##### **1. Introdução****Este processo visa exemplificar a reformulação da tela principal da Ordem de Serviço**
**Processo**
**Envolvidos**
**Dados de Entrada**
**Dados de Saída**
PROC005 Reformulação Tela Principal O.S.
-
Nova ordem de serviço ou edição dos dados da ordem de serviço
Ordem de Serviço salva ou alterada
PROC005.1 Reformulação Tela Principal O.S. - Detalhes
-
Nova ordem de serviço ou edição dos dados da ordem de serviço
Ordem de Serviço salva ou alterada
PROC006 Reformulação Tela de Listagens da O.S.
-
Filtros de período e etapas das O.Ss
Listagem filtrada de ordens de serviço
PROC007 OS Modo Visualização
-
-
-
#### **Processos Relacionados**
- - - - - -
[PROC005 Reformulação Tela Principal O.S.](https://docs.softensistemas.com.br/books/reformulacao-os/page/proc005-reformulacao-tela-principal-os)
[PROC006 Reformulação Tela de Listagens da O.S.](https://docs.softensistemas.com.br/books/reformulacao-os/page/proc006-reformulacao-tela-de-listagens-da-os)
[PROC007 OS Modo Visualização](https://docs.softensistemas.com.br/books/reformulacao-os/page/proc007-os-modo-visualizacao)
#### **Especificação Funcional**
- - - - - -
#### **PROC005.1 Reformulação Tela Principal O.S. - Detalhes**
##### ***Protótipo de Tela:***
[](https://docs.softensistemas.com.br/uploads/images/gallery/2025-11/image-1762796689898.png)
*Imagem I - Tela focada na Aba Detalhes*
##### ***Regras de Interface Principais:******3. Botão Voltar:*** Ao clicar sobre o botão deve retornar a tela de listagem de Ordens de Serviço.***4. Botão Próximo:*** Caso esteja na primeira aba "Cliente e Equipamento" a ação do botão deve direcionar para o preenchimento da próxima aba "Detalhes da OS". Estando na Aba "Detalhes da OS" o botão "Próximo" não deve ter efeito.***5. Botão Salvar:*** A ação do botão deve fazer todas as validações de campos obrigatórios, caso algum campo não seja validado deve ser retornado em tela a mensagem de aviso. Deve ser retornado para cada campo não validado:
O campo X é de preenchimento obrigatório!
**5.1** Caso passe por toda a validação para salvar, deve ser retornado para a tela de listagem de O.S. e retornar o aviso positivo em tela
Ordem de Serviço salva com sucesso.
##### ***Regras de Negócio Principais:******1. Botão Salvar:*** A ação do botão deve fazer todas as validações de campos obrigatórios, caso seja uma nova Ordem de Serviço realiza o novo cadastro no banco de dados; caso se trate de uma edição, realiza a alteração do registro selecionado.
#### **Accordion Detalhes da OS:**[](https://docs.softensistemas.com.br/uploads/images/gallery/2025-10/image-1761229608856.png)*Imagem II - Detalhes da OS*
##### ***Descrição dos Campos:***
**Campo**
**Tipo**
**Tamanho**
**Obrig. ?**
**Máscara**
**Observações**
Cód. Interno
Texto
60
Não
-
-
Vendedor
Caixa de Seleção
-
Não
-
-
Técnico Responsável
Caixa de Seleção
-
-
-
-
Prioridade
Caixa de Seleção
-
-
-
Valores Possíveis:AltaNormalBaixaValor Padrão = Normal
Etapa
Caixa de Seleção
-
-
-
-
Garantia
Caixa de Seleção
Não
-
Data da Garantia
Data
Sim
-
Data da Retirada
Data
Sim
-
Quem Retirou?
Texto
200
Não
-
placeholder: "Insira quem retirou"
Observações Internas
Texto
500
Não
-
placeholder: "Adicione observações relevantes"
Observações
Texto
500
Não
-
placeholder: "O que for escrito nesses campos será impresso no PDF da OS"
##### ***Regras de Interface:*****1. Código Interno:**
Código opcional para controle de código interno do cliente. Deve permitir alfanumérico. Por padrão vem em branco.**2. Vendedor:***Select* para seleção do vendedor que será vinculado na O.S.
Caso exista vendedor padrão vinculado no usuário, este deve ser o padrão a aparecer na listagem como padrão.
**3.** **Técnico Responsável:**
Deve listar os Técnicos cadastrados vinculados na conta da empresa. Devem ser listados apenas técnicos ativos, de acordo com a documentação [PROC001 Tela de Cadastro de Profissional](https://docs.softensistemas.com.br/books/reformulacao-os/page/proc001-tela-de-cadastro-de-profissional)
**4. Prioridade:**
Por padrão deve vir como "Normal". Contém as opções Alta, Normal e Baixa.
**5. Etapa:
**Por padrão deve iniciar com a etapa ordenada como a primeira Etapa na empresa. Mais informações [aqui](https://docs.softensistemas.com.br/books/reformulacao-os/page/2-listagem-de-etapas).**6. Garantia:**
Campo para calculo em dias da data de limite de garantia.
Existe um campo configuração em "Configurações Adicionais>Ordem de Serviço>Dias de Garantia ao Finalizar a OS".
Caso esteja preenchido, considerar como padrão esse valor.
Deve conter o *placeholder* "Selecione a data"
**7. Data da Garantia:
**A data de garantia deve ser calculada com base no valor de dias do campo "Garantia". Caso não seja preenchido os dias de garantia, o valor deve ser a data atual.
*Placeholder* "Selecione a data"
**8. Data de Retirada:** A data de retirada deve puxar o dia atual em seu preenchimento. Manter o comportamento atual, caso nao seja preenchida a data completa, limpar os valores.
Deve conter o *Placeholder* "Selecione a data".
**9. Quem Retirou:** Manter o comportamento atual, caso nao seja preenchida a data completa, limpar os valores. Deve conter o *Placeholder* "Insira quem retirou"**10. Observações Internas:** Deve haver um *label* no rodapé do campo contabilizando a quantidade de caracteres restantes.
Deve conter o *Placeholder "*Adicione observações relevantes*"*
**11. Observações:** Deve haver um *label* no rodapé do campo contabilizando a quantidade de caracteres restantes.
Deve conter o *Placeholder "*O que for impresso nesse campo será impresso no PDF da OS*"*
##### ***Regras de Negócio:*****1. Vendedor:**
Caso exista vendedor padrão vinculado no usuário, este deve vir como padrão preenchido.
#### **Accordion Informações de Pagamento:**
##### **Protótipo de Tela:**
[](https://docs.softensistemas.com.br/uploads/images/gallery/2025-11/image-1762796714788.png)
*Imagem III - Pagamentos da OS*
##### ***Descrição dos Campos:***
**Campo**
**Tipo**
**Tamanho**
**Obrig. ?**
**Máscara**
**Observações**
Receber
RadioButton
-
-
-
Deve conter o card para seleção:
ServiçoProdutosTotal
Forma de Pagamento
Caixa de Seleção
Valor
Decimal
Data de Vencimento
Data
Descrição
Texto
Período
SelectBox
Deve conter as opções:
Diário,Semanal,Mensal, Anual
Listagem
Forma de Pagamento
Column Header
Valor
Column Header
Data de Vencimento
Column Header
Pagamento
Column Header
Ações
Column Header
##### ***Regras de Interface:*****1. Receber:**
Deve permitir apenas a seleção de um dos cards: Serviço, Produto ou Totais.**2. Forma de Pagamento.**
Deve listar as formas de pagamento criadas e vinculadas na empresa.
O botão deve abrir a Dialog existente de cadastro de nova forma de pagamento.**3. Data de Vencimento.** Renderizar com a data atual. Não permitir manter sem valor, voltar rejeição em tela "não foi possível reconhecer '\_\_/\_\_/\_\_\_\_' como uma data."**4. Repetir por:**Por padrão deve vir como 1.**5. Período:**A caixa de seleção deve conter os seguintes valores padrões:
- - - Dia
- Semana
- Dezena
- Quinzena
- Mês
- Bimestre
- Trimestre
- Semestre
- Ano
**6. Listagem: **
**6.1 Forma de pgto
**Por padrão deve ficar na ordem de inserção, mas deve permitir a reordenação ASC ou DESC.
**6.2 Valor:
**Por padrão deve ficar na ordem de inserção, mas deve permitir a reordenação ASC ou DESC.**6.3 Data de vencimento:** Por padrão deve ficar na ordem de inserção, mas deve permitir a reordenação ASC ou DESC.
**6.4 Pagamento:
**Por padrão deve vir como "Não Pago"
**6.5 Ações:**
- - - - **Editar[](https://docs.softensistemas.com.br/uploads/images/gallery/2025-10/image-1760730534944.png): **Deve liberar os campos "forma pgto, valor e data vencimento" para edição.
- **Excluir [](https://docs.softensistemas.com.br/uploads/images/gallery/2025-10/image-1760730563577.png):** Deve abri a dialog de confirmação de exclusão "Tem certeza que deseja excluir esta parcela?". Caso o usuário confirme, deve ser limpo apenas da listagem do pagamento.
##### ***Regras de Negocio:******1. Repetir por:***O valor inteiro adicionado aqui será usado para repetir o lançamento com base no **Período** selecionado.******
**2.Editar[](https://docs.softensistemas.com.br/uploads/images/gallery/2025-10/image-1760730534944.png): **Os valores editados são primeiramente salvos em memoria, só serão confirmadas as alterações caso o usuário salve a Ordem de Serviço, do contrario nada deve ser alterado em banco**3.Excluir [](https://docs.softensistemas.com.br/uploads/images/gallery/2025-10/image-1760730563577.png):** Os lançamentos só são removidos em memoria, só serão confirmadas as alterações caso o usuário salve a Ordem de Serviço, do contrario nada deve ser alterado em banco.
##### ***Questões Técnicas Gerais:***
**1. Geral:** As tabelas relacionadas a Ordem de Serviço na base de dados são:
- - **ordermservico**
- **ordemservicoitem**
**2. Adicionar os seguintes campos:**
```SQL
ALTER TABLE ordemservicoADD COLUMN prioridade BIT(1), vendedorId BIGINT, garantia INT
```
**GerencieAqui**:
Títulos dos *Accordions*: #626262
*Label* dos campos: #044572
Botões principais: #044572
Tooltip: #242424
Botão editar da listagem: #1974FC
Botão exclusão da listagem: #DB102B
Título da *dialog*: #242424
Placeholders: #50505080 (50%)
Label das abas: #626262
Label aba selecionada: #009997
Inputs e textos nos grids: #000000
**AplicativoEmpresarial**:
Títulos dos *Accordions*: #626262
*Label* dos campos: #621FA4
Botões principais: #621FA4
Tooltip: #242424
Botão editar da listagem: #1974FC
Botão exclusão da listagem: #DB102B
Título da *dialog*: #242424
Placeholders: #50505080 (50%)
Label das abas: #626262
Label aba selecionada: #009997
Inputs e textos nos grids: #000000