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.