# Documentos Livres

Neste ecrã é possível **criar um documento livre**, com base nas configurações previamente definidas no BackOffice.

### Cabeçalho e Entidade

No topo do ecrã, encontra-se:

* Um **ícone de menu** no canto superior esquerdo;
* Uma **select box** que permite escolher o **tipo de documento** a criar. Os documentos disponíveis nesta lista são os que foram previamente configurados no BackOffice.

Após selecionar o tipo de documento, será necessário preencher os campos de **código** e **nome da entidade**. Para isso, o utilizador deve pressionar o **ícone de lupa** localizado à direita desses campos, que redireciona para o [**ecrã de entidades**](/mobile-logistic-manual/aplicacao-android/app/funcionalidades/entidades.md), onde poderá procurar e selecionar a entidade desejada.

{% hint style="info" %}
Caso o documento escolhido tenha sido configurado no BackOffice com uma entidade associada, os campos de código e nome da entidade já aparecerão automaticamente preenchidos.
{% endhint %}

Por baixo dos dados da entidade, encontra-se um *input* que permite efetuar a **leitura manual de códigos de barras**, útil em situações em que o scanner do PDA não esteja a funcionar corretamente.

Ao pressionar o botão com o **ícone de código de barras**, o utilizador ativa o campo de texto onde poderá **introduzir o código de barras manualmente**. Após introduzir o código, deve pressionar o botão **✓**.

A **checkbox "Qtd."** define o comportamento da leitura:

* Quando **marcada**, após a leitura (manual ou por scanner), o utilizador será redirecionado para um[ ecrã onde deve indicar a quantidade](/mobile-logistic-manual/aplicacao-android/app/funcionalidades/quantidades.md) que pretende ler.
* Quando **desmarcada**, a leitura do código contabiliza automaticamente **1 unidade**, sem necessidade de confirmar quantidades adicionais.

### Menu lateral

Ao carregar no **ícone de menu** localizado no cabeçalho do ecrã, é aberta uma **sidebar** com várias opções que permitem consultar ou configurar detalhes adicionais do documento:

* **Observações**\
  Redireciona para o [**ecrã de observações**](/mobile-logistic-manual/aplicacao-android/app/funcionalidades/observacoes.md), onde é possível adicionar ou editar observações associadas ao documento.
* **Dados da entidade**\
  Mostra uma ***popup*** com os dados detalhados da **entidade selecionada**, como nome, morada, NIF, entre outros.
* **Total de unidades**\
  Apresenta um **popup** com o **total de unidades contadas** no documento até ao momento.
* **Armazém**\
  Exibe o **armazém de origem** atualmente definido para o documento e permite alterá-lo.

{% hint style="info" %}
No caso de documentos do tipo **transferência**, será também mostrado o **armazém de destino**, igualmente editável.
{% endhint %}

### Linhas do documento

A inserção de linhas num documento livre pode ser feita de duas formas:

* **Leitura do código de barras** de um artigo, utilizando o leitor do PDA para adicionar automaticamente o artigo ao documento;
* Pressionando o **ícone de lupa** localizado ao lado da **checkbox "Qtd."**, que redireciona para o [**ecrã de artigos**](/mobile-logistic-manual/aplicacao-android/app/funcionalidades/search-articles.md). Neste ecrã, o utilizador poderá procurar e selecionar manualmente o artigo que pretende adicionar ao documento.

Se o artigo lido for o “artigo pai” de um artigo com grelhas, será apresentado um pop-up para que o utilizador escolha a cor e o tamanho que pretende selecionar.\
Só após escolher a cor e o tamanho é que o artigo será adicionado ao documento.

<figure><img src="/files/Yl7mtBpisxmGzFlBy8sy" alt="" width="360"><figcaption></figcaption></figure>

### Ações por Swipe numa Linha do Documento

Ao efetuar um *swipe* da **direita para a esquerda** sobre uma linha do documento, são apresentados diversos botões que permitem ao utilizador aceder a funcionalidades adicionais relacionadas com o artigo em questão:

* **Ícone de código de barras**\
  Redireciona para o [ecrã de **atribuição de códigos de barras**](/mobile-logistic-manual/aplicacao-android/app/funcionalidades/atribuir-codigo-de-barras.md), onde é possível associar um código de barras ao artigo selecionado.
* **Ícone de impressora**\
  Redireciona para o [ecrã de **impressão de etiquetas**](/mobile-logistic-manual/aplicacao-android/app/funcionalidades/impressao.md), onde é possível gerar e imprimir etiquetas com informações detalhadas sobre o artigo.
* **Ficha do Artigo**\
  Redireciona para o [ecrã de **ficha do artigo**](/mobile-logistic-manual/aplicacao-android/app/funcionalidades/ficha-do-artigo.md), onde são apresentadas informações detalhadas sobre o artigo, como nome completo, referência, código de barras, entre outros dados relevantes.
* **Apagar**\
  Retira o artigo da lista de linhas lidas.

### Guardar documento

Na parte inferior do ecrã, encontra-se uma **barra** que disponibiliza as seguintes informações e funcionalidades:

* **Ícone de X** — Permite **voltar ao ecrã anterior** sem guardar o documento;
* **Referência da última leitura** — Apresenta a **referência do último artigo lido**;
* **Número total de linhas** — Indica **quantas linhas** (artigos) o documento contém até ao momento;
* **Ícone de ✓** — Permite **guardar o documento**.

Ao pressionar o botão de **guardar (✓)**, é apresentada uma **confirmação** a perguntar se o utilizador pretende gravar o documento.

**Após confirmação e gravação bem-sucedida**, surge uma *popup* com informação sobre o **tipo e número do documento criado**.

***

<div><figure><img src="/files/fg7cLTXL0HlDB5GAK0xQ" alt=""><figcaption><p>Documentos Livres 1</p></figcaption></figure> <figure><img src="/files/qWo8UgTMoApgtQ4hF1Zm" alt=""><figcaption><p>Documentos Livres 2</p></figcaption></figure></div>


---

# Agent Instructions: 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:

```
GET https://docs.wave.pt/mobile-logistic-manual/aplicacao-android/app/funcionalidades/documentos-livres.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.