# Ordem de Serviço

O modelo de Ordem de Serviço (OS) permite a geração de documentos personalizados para formalizar atendimentos, registrar apontamentos de horas e despesas. Este artigo detalha como configurar seu modelo e as variáveis disponíveis.

## 1. Onde configurar o Modelo

Para criar ou editar um modelo de Ordem de Serviço:


1. Acesse o menu **Configurações**.
2. No bloco **Geral**, selecione **Modelos de Documento**.
3. Clique em **+ Novo Registro** ou edite um modelo existente, definindo o tipo como **"Ordem de Serviço"**.

## 2. Utilizando as Variáveis Dinâmicas

As variáveis são códigos inseridos entre colchetes `[ ]` que o sistema identifica e substitui pelos dados reais da OS no momento da exportação.

### Variáveis da Ordem de Serviço

| **Nome** | **Informação** |
|------|------------|
| `[ordem_servico.cod]` | Código da OS |
| `[ordem_servico.data]` | Data da OS |
| `[ordem_servico.recurso]` | Nome do recurso (usuário) |
| `[ordem_servico.narrativa]` | Narrativa da OS |
| `[ordem_servico.tot_horas]` | Total de horas apontadas |
| `[ordem_servico.tot_despesas]` | Total de despesas lançadas |
| `[ordem_servico.extrato_servico]` | Extrato de serviço vinculado |
| `[ordem_servico.extrato_usuario]` | Extrato de usuário |
| `[ordem_servico.nome_cliente]` | Nome do cliente |
| `[ordem_servico.proj_nome]` | Nome do projeto vinculado |

### Informações do Cliente

| **Nome** | **Informação** |
|------|------------|
| `[cliente.nome]` | Nome do cliente / Razão Social |
| `[cliente.tipo_pessoa]` | Tipo do cliente (J/F) |
| `[cliente.nome_fantasia]` | Nome fantasia do cliente |
| `[cliente.cpf_cnpj]` | CPF ou CNPJ do cliente |
| `[cliente.ie_rg]` | RG ou Inscrição Estadual do cliente |
| `[cliente.logradouro]` | Logradouro do endereço |
| `[cliente.numero]` | Número do endereço |
| `[cliente.bairro]` | Bairro do cliente |
| `[cliente.cep]` | CEP do endereço |
| `[cliente.nome_cidade]` / `[cliente.uf_cidade]` | Cidade e UF do cliente |
| `[cliente.email]` / `[cliente.email_financeiro]` | E-mail principal e financeiro |
| `[cliente.telefone1]` / `[cliente.telefone2]` | Telefones de contato |
| `[cliente.logradouro_cob]` | Logradouro de cobrança |
| `[cliente.nome_cidade_cob]` / `[cliente.uf_cidade_cob]` | Cidade e UF de cobrança |

### Informações do Contato e Projeto

| **Nome** | **Informação** |
|------|------------|
| `[contato.nome]` / `[contato.cpf]` | Nome e CPF do contato |
| `[contato.cargo]` / `[contato.email]` | Cargo e E-mail do contato |
| `[projeto.cod]` / `[projeto.nome]` | Código e Nome do projeto |
| `[projeto.prazo_inicial]` / `[projeto.prazo_final]` | Prazos do projeto |
| `[projeto.valor]` / `[projeto.aliq_imposto]` | Valor e Alíquota de imposto |
| `[projeto.fase_projeto]` / `[projeto.situacao]` | Fase e Situação do projeto |

## 3. Exemplo de Modelo Configurado

Veja como organizar as variáveis em um layout de Nota de Débito ou Relatório de OS:

> **ORDEM DE SERVIÇO / NOTA DE DÉBITO**
>
> **Recurso:** `[ordem_servico.recurso]` **Cliente:** `[ordem_servico.nome_cliente]` **Projeto:** `[ordem_servico.proj_nome]` **Data:** `[ordem_servico.data]`
>
> **Tabela de Despesas:** | Data | Tipo | Qtde | Valor Unit | Total | | :--- | :--- | :--- | :--- | :--- | | `[despesas.data;block=tbs:row]` | `[despesas.tipo]` | `[despesas.quantidade]` | `[despesas.valor_unit]` | `[despesas.valor_total]` |
>
> **Total de Despesas:** `[ordem_servico.tot_despesas]`

## 4. Dicas de Formatação

* **Extensão DOCX:** O arquivo deve ser obrigatoriamente `.docx` (Microsoft Word 2007+).
* **Sem Caixas de Texto:** Não utilize caixas de texto ou formas geométricas; o sistema não consegue ler as variáveis dentro delas.
* **Tabelas:** Utilize tabelas para organizar as variáveis de **Apontamentos** e **Despesas** para garantir o alinhamento na exportação.

⚠️ **Importante:** Após salvar o arquivo, faça o upload na rotina **Modelos de Documento**. O modelo estará disponível no botão **Exportar** dentro da tela de Ordem de Serviço.

---

**Documents**

- [Changelog](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/changelog-Zm8YRaLsX2)
- [Comercial e Vendas](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/comercial-e-vendas-mLzQaeyoTV)
- [Configurações Gerais](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/configuracoes-gerais-J7dm490z1m)
- [Gestão de Relacionamento (CRM)](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/gestao-de-relacionamento-crm-74VyXWo680)
- [Integrações](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/integracoes-zJfkJOXdix)
- [Operações e Produtividade](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/operacoes-e-produtividade-k2U2Vd3Fk8)
- [Projetos](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/projetos-jaD6SWGAB9)
- [Relatórios](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/relatorios-uab6Sta2qa)