# Modelos de Ordem de Serviço
## Introdução
Os Modelos de Ordem de Serviço são modelos personalizáveis utilizados para padronizar e agilizar a criação de ordens de serviço no sistema. Eles permitem definir layouts, campos e informações padrão que serão aplicados automaticamente ao gerar a impressão das ordens de serviço.
> [!NOTA] Acesso ao formulário
> Caminho: Menu sistema > Suporte > pasta Cadastros > OS modelos
## Benefícios
- Padronização das ordens de serviço
- Agilidade na criação de novas OS
- Personalização de layouts conforme necessidades específicas
- Redução de erros e inconsistências nas informações das OS
## Estrutura do Formulário
O formulário de **OS modelos** está estruturado em uma grid, que reúne as informações de todos os modelos de ordens de serviço personalizados cadastrados no sistema. Esta grid está organizada em linhas e colunas, onde cada linha corresponde a um modelo de OS individual. O formulário possibilita a visualização, edição e criação de novos modelos, facilitando a padronização e a organização das ordens de serviço.
### Campos Obrigatórios

| Campo      | Descrição                     |
| ---------- | ----------------------------- |
| **ID**     | Identificação única do modelo |
| **Modelo** | Nome do modelo de O.S         |
## Exemplo de uso

### Criação de modelo para instalação de internet
1. Acesse o formulário através do caminho: Menu sistema > Suporte > pasta Cadastros > OS modelos;
2. Preencha os campos:
- Modelo
- Texto
3. Utilize um modelo padrão como referência, clicando no botão **Modelos padrão** e selecionando o modelo desejado;
4. No campo **Texto**, insira as variáveis desejadas;
5. Clique em **Salvar**.
## Funcionalidades Principais
- Visualização preliminar do modelo
- Informações personalizadas
- Inserção de imagens e logos
## Variáveis Modelo O.S
Abaixo estão listadas as variáveis disponíveis no sistema para inclusão no modelo personalizado de ordem de serviço, juntamente com a informação que cada uma irá apresentar.

| Variáveis                              | Informação que será incluída                                                                                                                                                         |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| # autenticacao_wpa #                   | Tipo de autenticação mencionado no login do cliente.                                                                                                                                 |
| # assinatura_técnico #                 | Variável que coleta a assinatura do técnico.                                                                                                                                         |
| # caixa_ftth #                         | Informação da Caixa FTTH na qual o cliente está conectado.                                                                                                                           |
| # caixa_ftth_endereco #                | A informação se encontra no caminho: Menu sistema > Provedor > Logins > Selecionar e editar > Aba dados técnicos > F3 no campo Caixa de atendimento > Aba endereço > Campo endereço. |
| # cidade_nome #                        | Nome da Cidade mencionado no cadastro do endereço do cliente.                                                                                                                        |
| # cliente_apartamento #                | Número do apartamento mencionado no cadastro do endereço do cliente.                                                                                                                 |
| # cliente_assinatura #                 | Assinatura do cliente na finalização wizard da Ordem de Serviço.                                                                                                                     |
| # cliente_ativo #                      | Descrição atual do status do cadastro do cliente.                                                                                                                                    |
| # cliente_bairro #                     | Descrição do Bairro mencionado no cadastro do endereço do cliente.                                                                                                                   |
| # cliente_bloco #                      | Descrição do bloco mencionado no cadastro de endereço do cliente.                                                                                                                    |
| # cliente_cep #                        | CEP mencionado no cadastro do cliente.                                                                                                                                               |
| # cliente_cnpj_cpf #                   | CNPJ ou CPF mencionado no cadastro do cliente.                                                                                                                                       |
| # cliente_complemento #                | Complemento de endereço mencionado no cadastro cliente.                                                                                                                              |
| # cliente_condominio #                 | Descrição do Condomínio mencionado no cadastro do cliente.                                                                                                                           |
| # cliente_contrato_id #                | ID do contrato quando tem o login vinculado à OS.                                                                                                                                    |
| # cliente_contrato_plano #             | Informação da descrição do plano de venda do contrato.                                                                                                                               |
| # cliente_email #                      | Email de contato mencionado no cadastro do cliente.                                                                                                                                  |
| # cliente_endereco #                   | Descrição do endereço do cliente.                                                                                                                                                    |
| # cliente_fantasia #                   | Descrição do nome de fantasia do cliente.                                                                                                                                            |
| # cliente_fone #                       | Número do telefone residencial presente no cadastro do cliente na aba de contato.                                                                                                    |
| # cliente_hotsite_email #              | Informação do email presente no cadastro do cliente. Aba contato > campo login.                                                                                                      |
| # cliente_id #                         | ID do cliente da OS.                                                                                                                                                                 |
| # cliente_ie_identidade #              | Informação presente no cadastro do cliente. Aba cliente > campo IE/RG.                                                                                                               |
| # cliente_numero #                     | Informação do número presente na aba de endereço no cadastro do cliente.                                                                                                             |
| # cliente_observacao #                 | Informação das observações inseridas na aba de observações no cadastro do cliente.                                                                                                   |
| # cliente_plano #                      | Plano de venda inserido no contrato do cliente.                                                                                                                                      |
| # cliente_ramal #                      | Informação presente no cadastro do cliente. Aba contato > campo ramal.                                                                                                               |
| # cliente_razao #                      | Descrição da razão social inserida no cadastro do cliente.                                                                                                                           |
| # cliente_referencia #                 | Descrição da referência inserida na aba de endereço no cadastro do cliente.                                                                                                          |
| # cliente_senha_hotsite #              | Senha da central do assinante informada na aba de contato no cadastro do cliente.                                                                                                    |
| # cliente_status_internet #            | Informação do status on-line do login.                                                                                                                                               |
| # cliente_telefone_celular #           | Informação do telefone celular inserido no cadastro do cliente, na aba de contato.                                                                                                   |
| # cliente_telefone_comercial #         | Informação do telefone comercial inserido no cadastro do cliente, na aba de contato.                                                                                                 |
| # cliente_tipo_pessoa #                | Informação inserida no cadastro do cliente. Aba cliente > campo Tipo pessoa.                                                                                                         |
| # cliente_whatsapp #                   | Informação do WhatsApp inserido no cadastro do cliente, na aba de contato.                                                                                                           |
| # comodato_os #                        | Produtos inseridos na aba de comodato da OS com status de emprestado.                                                                                                                |
| # complemento_contrato #               | Informação do complemento do endereço inserido no contrato.                                                                                                                          |
| # concentrador #                       | Informação do concentrador inserido no cadastro do login.                                                                                                                            |
| # condominio_contrato #                | Informação do condomínio inserido na aba de endereço do contrato.                                                                                                                    |
| # condominio_login #                   | Informação do condomínio inserido na aba de endereço do login.                                                                                                                       |
| # conexao #                            | Informação da interface de conexão inserido no login, na aba de concentrador.                                                                                                        |
| # config_onu_pon_id #                  | Informação inserida na aba fibra do login, no campo Pon ID.                                                                                                                          |
| # config_onu_vlan_uplink #             | Informação inserida na aba fibra do login, no campo VLAN Uplink.                                                                                                                     |
| # contato_email #                      | Informação do campo e-mail na aba de contatos do leads vinculado ao cliente da OS.                                                                                                   |
| # contato_fone_residencial #           | Informação do campo fone residencial na aba de contatos do leads vinculado ao cliente da OS.                                                                                         |
| # contato_nome #                       | Informação do campo nome na aba de contato do leads vinculado ao cliente da OS.                                                                                                      |
| # contrato_apartamento #               | Informação do apartamento na aba de endereço do contrato.                                                                                                                            |
| # contrato_bairro #                    | Informação do bairro informado na aba de endereço do contrato.                                                                                                                       |
| # contrato_bloco #                     | Informação do bloco informado na aba de endereço do contrato.                                                                                                                        |
| # contrato_cep #                       | Informação do contrato informado na aba de endereço do contrato.                                                                                                                     |
| # contrato_cidade #                    | Informação da cidade informada na aba de endereço do contrato.                                                                                                                       |
| # contrato_descricao_auxiliar #        | Informação do campo descrição auxiliar do plano inserido no contrato.                                                                                                                |
| # contrato_endereco #                  | Informação do campo endereço inserido no contrato.                                                                                                                                   |
| # contrato_endereco_complemento #      | Informação do campo complemento inserido na aba endereço do contrato.                                                                                                                |
| # contrato_endereco_referencia #       | Informação do campo referência inserido na aba endereço do contrato.                                                                                                                 |
| # contrato_id #                        | ID do contrato vinculado à ordem de serviço.                                                                                                                                         |
| # contrato_nome #                      | Descrição do contrato vinculado à ordem de serviço.                                                                                                                                  |
| # contrato_numero #                    | Informação do campo número inserido na aba de endereço do contrato.                                                                                                                  |
| # contrato_status_acesso #             | Informação do status acesso do contrato vinculado à ordem de serviço.                                                                                                                |
| # dispositivo_acs #                    | Trará os dados do modelo e número serial do dispositivo ACS.                                                                                                                         |
| # download #                           | Informação do campo download, inserido na aba controle de banda padrão do plano de velocidade vinculado ao contrato.                                                                 |
| # endereco_latitude #                  | Latitude do endereço do login.                                                                                                                                                       |
| # endereco_longitude #                 | Longitude do endereço do login.                                                                                                                                                      |
| # equipamento_comodato #               | Informação inserida no cadastro do login. Aba dados técnicos > campo tipo equipamento.                                                                                               |
| # equipe #                             | Equipe informada na finalização da ordem de serviço.                                                                                                                                 |
| # estrutura_cep #                      | CEP informado no cadastro da estrutura inserida na ordem de serviço.                                                                                                                 |
| # estrutura_descricao #                | Descrição da estrutura inserida na ordem de serviço.                                                                                                                                 |
| # estrutura_id #                       | ID da estrutura inserida na ordem de serviço.                                                                                                                                        |
| # filial_bairro #                      | Informação do bairro inserido na aba de endereço da filial que está vinculada à ordem de serviço.                                                                                    |
| # filial_cep #                         | Informação do CEP inserido na aba de endereço da filial que está vinculada à ordem de serviço.                                                                                       |
| # filial_cidade #                      | Informação da cidade inserida na aba de endereço da filial que está vinculada à ordem de serviço.                                                                                    |
| # filial_cnpj #                        | Descrição do CNPJ informado no cadastro da filial vinculada à ordem de serviço.                                                                                                      |
| # filial_endereco #                    | Informação do endereço inserido no cadastro da filial que está vinculada à ordem de serviço.                                                                                         |
| # filial_fantasia #                    | Descrição do nome fantasia da filial vinculada à ordem de serviço.                                                                                                                   |
| # filial_numero #                      | Informação do número inserido na aba de endereço da filial que está vinculada à ordem de serviço.                                                                                    |
| # filial_razao #                       | Descrição da razão social da filial vinculada à ordem de serviço.                                                                                                                    |
| # filial_telefone #                    | Informação do número inserido na filial vinculada à OS.                                                                                                                              |
| # funcionarios_funcionario #           | Informação do colaborador responsável vinculado na OS.                                                                                                                               |
| # grade_comodato_devolvido_contrato #  | Informação da grade com valores id produto, equipamento em comodato, data, id devolução, quantidade, quantidade devolução e status para comodatos devolvidos e baixados.             |
| # grade_comodato_emprestado_contrato # | Informação da grade com valores id produto, equipamentos em comodato, data, quantidade e status de produtos emprestados.                                                             |
| # grade_comodatos #                    | Informação da grade com valores código, produto, quantidade, valor unitário, valor total patrimônio e número de série para comodatos emprestados.                                    |
| # grade_comodatos_2 #                  | Informação da grade com valores de código, produto e quantidade para produtos em comodato.                                                                                           |
| # grade_comodatos_sem_val #            | Informação da grade com valores código, produto, quantidade, patrimônio e número de série para comodatos emprestados.                                                                |
| # grade_desconto_adicional #           | Informação em forma de grade. Todos os descontos adicionais inseridos no contrato.                                                                                                   |
| # grade_internet #                     | Informação dos produtos inseridos no contrato (aba de produtos).                                                                                                                     |
| # grade_logins #                       | Informação da descrição dos logins vinculados à OS.                                                                                                                                  |
| # grade_mensagens #                    | Informação de todas as mensagens e interações de uma ordem de serviço expostos em forma de grade.                                                                                    |
| # grade_produtos #                     | Informação de todos os produtos inseridos na OS expostos em forma de tabela.                                                                                                         |
| # grade_produtos_contrato #            | Informação dos produtos inseridos no contrato expostos em forma de tabela.                                                                                                           |
| # grade_servico_adicional #            | Informação do adicional da mensalidade inserido pela OS.                                                                                                                             |
| # grade_servicos #                     | Informação de todos os serviços inseridos na OS expostos em forma de tabela.                                                                                                         |
| # grade_sva #                          | Informação do plano de SVA vinculado ao contrato.                                                                                                                                    |
| # grade_telefonia #                    | Informação dos Serviços contratados de telefonia.                                                                                                                                    |
| # id_login #                           | Busca do campo login da OS.                                                                                                                                                          |
| # id_ticket #                          | ID do atendimento vinculado à ordem de serviço.                                                                                                                                      |
| # ip #                                 | Informação do IP do cliente.                                                                                                                                                         |
| # justificativa_sla_atrasado #         | Descrição da informação inserida no campo justificativa para SLA atrasado presente na aba outros da OS.                                                                              |
| # lista_contrato_comodato #            | Informação da descrição dos comodatos emprestados, sem grade.                                                                                                                        |
| # login #                              | Informação do login do cliente (descrição).                                                                                                                                          |
| # login_hardware #                     | Informação do hardware inserido dentro das configurações do login na aba dados técnicos.                                                                                             |
| # login_metragem_externa #             | Informação da metragem externa utilizada mencionada dentro do login.                                                                                                                 |
| # login_metragem_interna #             | Informação da metragem interna utilizada mencionada dentro do login.                                                                                                                 |
| # login_obs #                          | Informação inserida na aba de observações do login.                                                                                                                                  |
| # login_onu_mac #                      | Informações de dados do mac da ONU mencionado no login.                                                                                                                              |
| # login_projeto #                      | Informação do projeto login.                                                                                                                                                         |
| # login_sinal_rx #                     | Informação do nível RX é a potência em dBm do sinal recebido.                                                                                                                        |
| # login_sinal_tx #                     | Informação do nível TX é a potência em decibéis por miliwatt (dBm) em que um modem transmite seu sinal.                                                                              |
| # login_splitter #                     | Informação do splitter mencionado no login.                                                                                                                                          |
| # login_ssid_router_wifi #             | Informação do nome de rede Wi-Fi do cliente dentro do login, campo (SSID router Wi-Fi).                                                                                              |
| # login_tipo_equipamento #             | Informação do tipo de equipamento utilizado no login.                                                                                                                                |
| # login_transmissor #                  | Informação que transmite a conexão do login.                                                                                                                                         |
| # mac #                                | Informação do MAC address do modem do cliente.                                                                                                                                       |
| # melhor_horario #                     | Informação do melhor horário para o técnico ir na casa do cliente.                                                                                                                   |
| # mensagem #                           | Informação mencionada na mensagem da OS.                                                                                                                                             |
| # mensagem_data #                      | Informações da data da mensagem mencionada na OS.                                                                                                                                    |
| # mensagem_descricao #                 | Informações da descrição da mensagem mencionada na OS.                                                                                                                               |
| # mensagem_usuarios_nome #             | Informações do nome do usuário que registrou a mensagem.                                                                                                                             |
| # nome_usuario_atendimento #           | Nome do usuário que realizou a abertura do atendimento que está vinculado à ordem de serviço.                                                                                        |
| # observacoes_login #                  | Descrição informada no campo observações na aba observações do login.                                                                                                                |
| # os_condominio #                      | Informação presente no campo condomínio na aba de endereço da OS.                                                                                                                    |
| # os_historico_cliente #               | Histórico das últimas OS do cliente exposto em formato de tabela.                                                                                                                    |
| # pop #                                | Descrição do ponto de presença (POP) inserido no ponto de transmissão.                                                                                                               |
| # porta_ftth #                         | Informações da porta FTTH do cliente na caixa FTTH.                                                                                                                                  |
| # prioridade_os #                      | Informações do nível de prioridade da ordem de serviço.                                                                                                                              |
| # protocolo_os #                       | Informações do número de protocolo da ordem de serviço.                                                                                                                              |
| # radusuarios_tipo_conexao #           | Informações do tipo de conexão Radius que o cliente está usando.                                                                                                                     |
| # senha #                              | Informações da senha Radius do cliente.                                                                                                                                              |
| # senha_router_1 #                     | Informações da senha de acesso ao modem.                                                                                                                                             |
| # senha_router_2 #                     | Informações da senha de acesso ao roteador Wi-Fi.                                                                                                                                    |
| # senha_wifi #                         | Informações da senha de acesso à rede Wi-Fi.                                                                                                                                         |
| # serial_acs #                         | Busca somente o serial number do dispositivo ACS.                                                                                                                                    |
| # sinal #                              | Informação do campo sinal do último atendimento da aba dados técnicos do login.                                                                                                      |
| # solucao #                            | Informação da solução informada na aba outros da ordem de serviço.                                                                                                                   |
| # soma_produto_servico #               | Soma total dos produtos e serviços inseridos na ordem de serviço.                                                                                                                    |
| # soma_total_grades #                  | Informações do valor total das grades na OS, um somatório das grades: comodatos, produtos e serviços, telefonia, internet, SVA, serviços e produtos.                                 |
| # ssid #                               | Informações inseridas na interface transmissor: Login > aba IP/MAC > campo SSID.                                                                                                     |
| # su_oss_assunto_assunto #             | Informação do assunto da ordem de serviço.                                                                                                                                           |
| # su_oss_chamado_apartamento #         | Informação de descrição do apartamento inserido na OS.                                                                                                                               |
| # su_oss_chamado_atendente_abertura #  | Informações do atendente que fez o cadastro da ordem de serviço.                                                                                                                     |
| # su_oss_chamado_bairro #              | Informação de descrição do bairro inserido na OS.                                                                                                                                    |
| # su_oss_chamado_bloco #               | Informação de descrição do bloco inserido na OS.                                                                                                                                     |
| # su_oss_chamado_cidade #              | Informação de descrição da cidade inserida na OS.                                                                                                                                    |
| # su_oss_chamado_complemento #         | Informação de descrição do complemento inserido na OS.                                                                                                                               |
| # su_oss_chamado_condominio #          | Informação de descrição do condomínio inserido na OS.                                                                                                                                |
| # su_oss_chamado_data_abertura #       | Informações da data de abertura da ordem de serviço.                                                                                                                                 |
| # su_oss_chamado_data_agenda #         | Informações da data de agendamento da ordem de serviço.                                                                                                                              |
| # su_oss_chamado_data_fechamento #     | Informações da data de fechamento da ordem de serviço.                                                                                                                               |
| # su_oss_chamado_data_reservada #      | Informações da data reservada da ordem de serviço.                                                                                                                                   |
| # su_oss_chamado_endereco #            | Informações de descrição do endereço selecionado na OS.                                                                                                                              |
| # su_oss_chamado_id #                  | Informações do ID da ordem de serviço.                                                                                                                                               |
| # su_oss_chamado_id_atendente #        | Informações do atendente que fez a última alteração na ordem de serviço.                                                                                                             |
| # su_oss_chamado_mensagem #            | Informações da mensagem de interação na ordem de serviço.                                                                                                                            |
| # su_oss_chamado_referencia #          | Descrição da referência informada na aba de endereço da OS.                                                                                                                          |
| # taxa_instalacao #                    | Taxa de ativação informada no contrato, inserida na aba taxas de ativação.                                                                                                           |
| # tempo_conectado #                    | Informação inserida na aba de conexão do login vinculado à OS.                                                                                                                       |
| # tipo_transmissao #                   | Informações do tipo de entrega de internet para o cliente (5.8, 2.4, fibra, rádio, etc.).                                                                                            |
| # uf_sigla #                           | Informações da sigla do Estado.                                                                                                                                                      |
| # upload #                             | Informações da taxa de upload do contrato.                                                                                                                                           |
| # valor_comodato #                     | Informações do valor somado de todos os comodatos existentes para o contrato.                                                                                                        |
| # valor_plano #                        | Informação do valor do plano inserido no contrato.                                                                                                                                   |
| # valor_total_comodatos_emprestados #  | Informações do valor somado para todos os comodatos emprestados que possui no contrato.                                                                                              |
>[!tip] Considere inserir as variáveis sem espaçamento entre o símbolo # e as palavras, para que funcionem corretamente.
## Fluxo de Trabalho
```mermaid
graph TD
    A[Criar modelo OS] --> B{Definir nome do modelo}
    B --> C[Personalizar layout]
    C --> D[Configurar variáveis]
    D --> E[Vincular o modelo nos assuntos]
    E --> G[Testar modelo]
    G --> H{Modelo ok?}
    H -->|Sim| I[Utilizar modelo]
    H -->|Não| C
```
## Considerações Finais
Os Modelos de Ordem de Serviço são uma ferramenta poderosa para otimizar o processo de criação e gestão de OS. Ao investir tempo na configuração de modelos bem estruturados e personalizados, a empresa pode garantir consistência nas informações, melhorar a produtividade dos técnicos e elevar a qualidade do atendimento ao cliente.
## Etiquetas
#ModelosOS #OrdemDeServico #Suporte #ModeloPersonalizado
## Leia Também
- [[cadastro de ordem de servico|Cadastro de Ordem de Serviço]]