> For the complete documentation index, see [llms.txt](https://docs.wave.pt/mobile-logistic-manual/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wave.pt/mobile-logistic-manual/aplicacao-android/app/funcionalidades/documentos-livres.md).
# 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.
* **Configurar Localizações:** apenas visível se o parâmetro `appUsaLocalizacoes` estiver ativo.
* **Impressão:** permite imprimir uma etiqueta de cabeçalho.
* **Potência RFID:** apenas visível se o leitor RFID estiver ativo.
{% 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.
### 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.
#### Documentos com PAT
Quando o parâmetro `PATRequired` está ativo, ao selecionar o tipo de documento é pedido o **número de PAT** (Pedido de Assistência Técnica).
* Se já existirem documentos desse tipo associados ao PAT, é apresentada a lista **"Selecionar Documento"**, onde o utilizador pode:
* Escolher um documento existente e pressionar **"Continuar"**: as linhas desse documento são carregadas e o documento será **editado** ao guardar;
* Escolher **"Novo documento"** para criar um novo registo para o mesmo cliente.
* Se não existirem documentos, a **entidade é preenchida automaticamente** com o cliente do PAT.
{% hint style="info" %}
Ao guardar um documento que foi editado, a mensagem final indica que o documento foi **editado** em vez de criado.
{% endhint %}
#### FEFO
Nos documentos configurados no BackOffice com validação FEFO, ao escolher um lote é verificado se existem lotes com stock que **expiram mais cedo**.
### 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**.
***
