> For the complete documentation index, see [llms.txt](https://virtux-up-gestao.gitbook.io/virtux-up-gestao/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://virtux-up-gestao.gitbook.io/virtux-up-gestao/modulos/servicos/ordem-de-servico.md).

# Ordem de Serviço

## **Visão Geral do Módulo**

O usuário é redirecionado para a página de listagem de ordens de serviço, onde é possível realizar sua gestão. Nessa tela, é possível cadastrar uma nova ordem de serviço, editar as já cadastradas, excluir e desativar registros.

<figure><img src="/files/2pYVJHkk5B7WTPwJH0hu" alt=""><figcaption><p>Tela de listagem de Ordem de serviço.</p></figcaption></figure>

***

## **Novo Registro - Ordem de Serviço**

O formulário de cadastro de ordem de serviço é dividido em três abas:

{% tabs %}
{% tab title="Cliente" %}
Utilizada para inserir os dados do cliente a fim de gerar a ordem de serviço. O formulário é estruturado da seguinte forma:​

<figure><img src="/files/rnFthjRs3O5jbN17MTUk" alt=""><figcaption><p>Serviços > Ordem de Serviço > Cliente (pessoa física)</p></figcaption></figure>

<figure><img src="/files/qj3oWS2rVkJtguswtLi9" alt=""><figcaption><p>Serviços > Ordem de Serviço > Cliente (pessoa jurídica)</p></figcaption></figure>

Ela possui duas divisões: **Dados do Cliente** e **Fase**.

Dados do Cliente

* **Cliente**: Ao selecionar o cliente, caso o mesmo já tenha um cadastro, a aplicação carrega automaticamente os seguintes dados:​
  * Contato
  * E-mail
  * Celular
  * Telefone
  * CNPJ (se pessoa jurídica) ou CPF (se pessoa física)
  * IE (se pessoa jurídica) ou RG (se pessoa física)
  * Endereço de fatura
    {% endtab %}

{% tab title="Itens" %}
Esta seção serve para criar a ordem de serviço, adicionando cada item, bem como os valores de frete e tributações.​

<figure><img src="/files/Y0dUckyOj3m7sqvKtMzU" alt=""><figcaption><p>Serviços > Ordem de Serviço > Itens</p></figcaption></figure>

A aba **Itens** possui os seguintes campos:

* Descrição do item (campo do tipo seleção, obrigatório)
* Quantidade (campo obrigatório)
* Valor unitário (campo obrigatório)

{% hint style="info" %}
**NOTA:** Ao final da seleção dos itens, o **Total Final** é calculado automaticamente pelo sistema.
{% endhint %}
{% endtab %}

{% tab title="Conclusão" %}
É destinada à finalização da ordem de serviço. Nela, são informados dados e condições de pagamento, bem como outras informações sobre o serviço que será prestado.

<figure><img src="/files/ATeeb97p7TaUE4VSTPOc" alt=""><figcaption><p>Serviços > Ordem de Serviço > Conclusão</p></figcaption></figure>

**Campos da aba Conclusão:**

* Situação
  * Faturar
* Dados de Conclusão
  * Nota
  * Projeto
  * Conta Financeira
  * Forma de Pagamento
  * Centro de Resultado
  * Vendedor
  * Categoria
  * Data Lançamento
  * CEP Cidade Prestação Serviço
  * Local da Prestação do Serviço
  * Pagamento
  * Valor Total
* Outras Informações
  * Dados Adicionais
  * Observações internas
    {% endtab %}
    {% endtabs %}

***

### **Editar Registro - Ordem de Serviço** <a href="#editar-registro-orcamento" id="editar-registro-orcamento"></a>

Caso o usuário queira editar uma Ordem de Serviço já criada, basta selecionar um registro na listagem e alterar as informações.

***

## **Ordem de Serviço - Filtros**

É possível filtrar os dados de ordens de serviço pelos seguintes parâmetros:

<details>

<summary><strong>Empresa</strong></summary>

<figure><img src="/files/ebBIYGfmOhNpXZPpAmsP" alt=""><figcaption><p>Serviços > Ordem de Serviço > Filtros > Empresa</p></figcaption></figure>

* Empresa (caso o acesso possua o recurso [multiempresa](/virtux-up-gestao/configuracoes-da-conta/detalhes-da-conta/empresas/multiempresa.md), é possível selecionar ou deselecionar as demais empresas cadastradas para que sejam exibidas (ou não) na listagem).

</details>

<details>

<summary><strong>Principal</strong></summary>

<figure><img src="/files/BUm4XkySLiLL4KCubxru" alt=""><figcaption><p>Serviços > Ordem de Serviço > Filtros > Principal</p></figcaption></figure>

* Status
* Espécie de documento
* Situações
* Ações
* Número do documento (intervalo inicial) - Até (intervalo final)
* Código do produto (intervalo inicial) - Até (intervalo final)

</details>

<details>

<summary><strong>Datas</strong></summary>

<figure><img src="/files/NbMsrjRY1Q2hDTPG3pJ4" alt=""><figcaption><p>Serviços > Ordem de Serviço > Filtros > Datas</p></figcaption></figure>

* Data de lançamento De (data inicial) - Até (data final)
* Data de saída De (data inicial) - Até (data final)
* Data de emissão De (data inicial) - Até (data final)

</details>

<details>

<summary><strong>Outros</strong></summary>

<figure><img src="/files/504vikOmvFyBM23kdMKj" alt=""><figcaption><p>Serviços > Ordem de Serviço > Filtros > Outros</p></figcaption></figure>

* Fases
* Vendedor
* Usuário
* Formas de pagamento
* Centros de resultado
* Categoria
* Projeto
* Nota

</details>

***

## **Ordem de Serviço - Listagem - Outras opções**

<figure><img src="/files/0XJsMyoulbupIrDrm4Eq" alt=""><figcaption><p>Opções adicionais da listagem.</p></figcaption></figure>

No canto superior direito, o usuário terá acesso as funções "Unificar Lançamentos e "Atualizar":

<details>

<summary><strong>Unificar Lançamentos</strong></summary>

Permite ao usuário agrupar lançamentos de serviços em um único registro.

<figure><img src="/files/slYnLMZFtJhM23M4sLgY" alt=""><figcaption><p>Serviços > Ordem de Serviço > Unificar Lançamentos</p></figcaption></figure>

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://virtux-up-gestao.gitbook.io/virtux-up-gestao/modulos/servicos/ordem-de-servico.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.