> For the complete documentation index, see [llms.txt](https://docs.wave.pt/wave-trade-x/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/wave-trade-x/app/estrutura/clientes/documentos.md).

# Documentos

A página dos Documentos vai estar dividida em 3 Views do catálogo:

* [<mark style="color:blue;">**Lista**</mark>](#lista)
* [<mark style="color:blue;">**Galeria**</mark>](#galeria)
* [<mark style="color:blue;">**Artigo Único**</mark>](#artigo-unico)

{% hint style="info" %}
Os descontos e o bônus visíveis são parâmetros ao documento que tem que ser tratados no Portal.
{% endhint %}

## *<mark style="color:blue;">Lista</mark>*

Na view do catálogo em Lista teremos a possibilidade de pesquisar artigos por família, marcas, apenas artigos que já tenham sido vendidos à entidade <mark style="color:red;">(6)</mark> e ainda filtrar o produto por:

* Designação
* Código de Barras
* Designação + Referência

Existem 2 menus nesta view, um geral <mark style="color:red;">(1)</mark> e um ao artigo selecionado <mark style="color:red;">(5)</mark>. O menu geral <mark style="color:red;">(1)</mark> inclui as funcionalidades de [<mark style="color:blue;">**Copiar Linhas**</mark>](#copiar-linhas), [<mark style="color:blue;">**Consultar Observações**</mark>](#consultar-observacoes) à entidade e [<mark style="color:blue;">**Linhas Suspensas**</mark>](#linhas-suspensas). O menu do artigo <mark style="color:red;">(5)</mark> inclui as informações Preço Líquido, Preços a este Cliente e Fator de Conversão. Em relação ao artigo, pode também [<mark style="color:blue;">**Alterar a sua Unidade**</mark>](#alterar-unidade) <mark style="color:red;">(7)</mark>.

Pode visualizar as linhas dos [<mark style="color:blue;">**Artigos Vendidos**</mark> ](#artigos-vendidos)anteriormente <mark style="color:red;">(2)</mark> e passar para a view [<mark style="color:blue;">**Galeria**</mark> ](#galeria)<mark style="color:red;">(3)</mark>, assim como ver o [<mark style="color:blue;">**Resumo do Documento**</mark>](#resumo-do-documento) <mark style="color:red;">(4).</mark>

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2FfFCPvOW52J25PtlG7Fmn%2FDocs_Catalog.jpg?alt=media&amp;token=229f6a09-8cc5-4c8e-b558-7bf5086b943f" alt=""><figcaption><p>Lista</p></figcaption></figure>

No menu em <mark style="color:red;">(5)</mark> existe a opção de *<mark style="color:blue;">**Mostrar Preço com IVA**</mark>* e se essa opção for selecionada, irá ter a informação do preço com IVA em todos os artigos.

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2F7D8NzpqkwPH1BcgJnlLM%2FShow_VAT_Price.png?alt=media&amp;token=e74f9594-c163-45b2-bde0-ff5fca2c3590" alt=""><figcaption><p>Menu</p></figcaption></figure>

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2F89yIaDWEgCCZMLcgPpsm%2FShow_VAT_Price_2.png?alt=media&amp;token=e93931a3-0bd8-4727-89bd-825b925f8833" alt=""><figcaption><p>Opção Preço com IVA ativa</p></figcaption></figure>

Ainda no menu em <mark style="color:red;">(5)</mark> existe a opção de *<mark style="color:blue;">**Stock Online**</mark>***&#x20;**<mark style="color:red;">**(1)**</mark> e *<mark style="color:blue;">**Preço e Desc. Online**</mark>***&#x20;**<mark style="color:red;">**(2)**</mark>. Estas 2 funcionalidades também se encontram no ***Resumo do Documento.***&#x20;

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2Fg6I6SBzA93iXZ3wupQoU%2FPrice_Discs_Online.png?alt=media&amp;token=809a30db-d5a6-485e-8baf-6d250054517d" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2Fm2MHEAIGRSCFAEIYK6Yk%2FStock_Online.png?alt=media&amp;token=42654366-b4cb-4887-bcbc-b042f6280c80" alt=""><figcaption><p>Stock Online</p></figcaption></figure>

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2FLrr9NSEhmFsIw3lJZnWx%2FStock_Online_2.png?alt=media&amp;token=7c55836b-484f-4dce-96b5-094c74a3a7a6" alt=""><figcaption><p>Stock Online - Resumo Documento</p></figcaption></figure>

De maneira a conseguir usar a funcionalidade ***Stock Online*** é necessário preencher o parâmetro ***"Query para validação do stock online. A query deve retornar apenas 1 linha com os seguintes campos: 'referencia', 'stock', 'reservada' e 'encomendada'."*** ao terminal <mark style="color:red;">**(2)**</mark>.&#x20;

Para conseguir usar a funcionalidade ***Preço e Desc. Online*** é necessário preencher o parâmetro ***"Query para validação de preços do artigo. A query deve retornar apenas 1 linha com os seguintes campos: 'referencia', 'preco', 'desconto1', 'desconto2', 'desconto3' e 'desconto4'"*** ao terminal <mark style="color:red;">**(1)**</mark>. Ao utilizar esta funcionalidade, o preço e os descontos são atualizados com o que a query preenchida no parâmetro devolver.

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2FLPYpsSNe8FLwttCI0mIH%2FPrint.png?alt=media&amp;token=ffaf5c13-fbbe-4612-98a5-dcb2b61129f6" alt=""><figcaption></figcaption></figure>

De maneira a ter mais níveis de filtragem dos artigos, como podemos verificar em <mark style="color:red;">**(1)**</mark> na imagem seguinte os campos ao **terminal**  *<mark style="color:blue;">category1\_label</mark>* e *<mark style="color:blue;">category2\_label</mark>* terão que estar preenchidos. Se apenas o campo *<mark style="color:blue;">category1\_label</mark>* estiver preenchido, apenas estará uma combo box visível no terminal, como podemos ver na imagem. Os valores associados a cada combo box vem das tabelas <mark style="color:blue;">**ItemsCategory1**</mark> (*X\_Items\_Category1 na middleware)* e <mark style="color:blue;">**ItemsCategory2**</mark> (*X\_Items\_Category2). Na ficha de artigo: <mark style="color:blue;">category1</mark>* e *<mark style="color:blue;">category2</mark>*.  Também é possível filtrar os artigos por Catálogos <mark style="color:red;">**(2)**</mark>.

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2FO1If9Vo5P64Xpc5wpqku%2FDocs_Filtros_Combo.png?alt=media&amp;token=7a1d03c4-498b-40b5-a143-4edd3328f9ee" alt=""><figcaption><p>Filtro categorias</p></figcaption></figure>

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2Fyjs4pXgO6uu5WorVNg2M%2FDoc_List_Catalog.png?alt=media&amp;token=bc0911d2-5c7e-429d-99b1-8c25d170bba5" alt=""><figcaption><p>Filtro catálogos</p></figcaption></figure>

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2Fc3Uieq6XlljwYym0aMxE%2FDoc_List_Catalog_2.png?alt=media&amp;token=737de15a-7e3b-4881-a7e5-43a308d02caf" alt=""><figcaption><p>Catálogos</p></figcaption></figure>

#### *<mark style="color:blue;">Sub Famílias</mark>*

Também é possível filtrar os artigos por sub famílias. Para isso, os artigos têm que ter os códigos das sub famílias preenchidas na tabela de artigos (na *middleware,* colunas  *<mark style="color:blue;">sub\_family\_level1, sub\_family\_level2, sub\_family\_level3</mark>*). As sub famílias têm também que estar preenchidas na tabela *<mark style="color:blue;">SubFamily</mark>* (*<mark style="color:blue;">X\_Items\_Sub\_Families</mark>* na *middleware*).&#x20;

Para filtrar os artigos, tem de selecionar o primeiro nível antes de conseguir selecionar o nível seguinte, ou seja, selecionar a família antes de conseguir selecionar a primeira sub família <mark style="color:red;">(1)</mark>, selecionar a primeira sub família antes de selecionar a segunda sub família <mark style="color:red;">(2)</mark>, etc. A combo box de cada sub família apenas está visível se existirem sub famílias do nível especifico na tabela *<mark style="color:blue;">SubFamily</mark>*.

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2FDO1YMLHw7MWDfWGzjIdS%2FSub_Familias.png?alt=media&amp;token=944c2efb-172c-4497-87e9-abf27314759d" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2Fa7tazfXQXHYiW7bFi7KB%2FSub_Familias_2.png?alt=media&amp;token=32a12165-78c5-47c0-8e0a-fe5255662317" alt=""><figcaption></figcaption></figure>

#### *<mark style="color:blue;">Permitir apenas descontos a 100%</mark>*

Existe também a possibilidade de permitir apenas descontos a 100%.\
Para isso, no portal, na secção Documentos, deve-se definir o parâmetro “Permite alterar desconto” <mark style="color:red;">**(1)**</mark> como verdadeiro, no separador das Permissões.\
De seguida, no separador dos Parâmetros, deve-se definir o parâmetro “Permitir apenas descontos de 100% na aplicação?” <mark style="color:red;">**(2)**</mark> como verdadeiro.

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2FjvXm68unNrKO87K3mw72%2FDesc100_1.png?alt=media&amp;token=765fff35-fb5d-4ee9-b69c-efe4e4b509c9" alt=""><figcaption></figcaption></figure>

De seguida, deve-se configurar o campo “N. Desc” <mark style="color:red;">**(3)**</mark> com o valor 1, de modo a que, na aplicação, apenas o desconto 1 <mark style="color:red;">**(4)**</mark> fique ativo. Nesse mesmo campo, apenas serão permitidos descontos de 0% ou 100%.

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2FibCJo7AbehLlY2qL6nRy%2FDesc100_2.png?alt=media&amp;token=5a02bf17-9922-49e1-a4fc-93f12e6cc5c1" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2FWI7ELFQyURP6l3E7eYSY%2FDesc100_3.png?alt=media&amp;token=f068ea19-c960-4c62-8cde-207bcce0d566" alt=""><figcaption></figcaption></figure>

#### *<mark style="color:blue;">Copiar Linhas</mark>*

Para copiar linhas necessita primeiro de escolher o documento do qual quer copiar as linhas e posteriormente selecionar as linhas que pretende adicionar ao documento atual.

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2FXrdUSONorzyJIM7DZVhb%2FCopy_Lines.jpg?alt=media&amp;token=bb922b11-28ad-4839-a9cb-7745a5e6ac69" alt=""><figcaption><p>Escolha do documento</p></figcaption></figure>

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2FESHup0BgaLpIiErlxQE6%2FCopy_Lines_2.jpg?alt=media&amp;token=d9766ec3-eab8-4ba3-9c41-999155d7f9fb" alt=""><figcaption><p>Copiar Linhas</p></figcaption></figure>

#### *<mark style="color:blue;">Consultar Observações</mark>*

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2FdeXZhrLUXX1yi9I1aZ1M%2FDocs_Obs.jpg?alt=media&amp;token=7160c564-1893-4da5-980a-3fb45bb79b68" alt=""><figcaption><p>Observações</p></figcaption></figure>

#### *<mark style="color:blue;">Linhas Suspensas</mark>*

As linhas suspensas que selecionar e inserir no documento serão eliminadas após a finalização do documento atual.

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2FtEYq8v54og14vCNcwmZH%2FSuspended_Lines.jpg?alt=media&amp;token=bc681932-9fc2-4950-97ea-cac87eca52f5" alt=""><figcaption><p>Linhas Suspensas</p></figcaption></figure>

#### *<mark style="color:blue;">Artigos Vendidos</mark>*

As linhas que adicionar dos produtos vendidos serao inseridas no documento atual. Tem a possibilidade de ver os artigos das linhas com a Unidade Principal ou a Unidade Alternativa <mark style="color:red;">(1)</mark>, caso exista, e Agrupar os artigos por Referência <mark style="color:red;">(2)</mark>, ficando apenas com a linha mais recente de cada produto.

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2FCQXKeXHgxIRZv4RUE5Ub%2FSales_History.jpg?alt=media&amp;token=be20a0a2-22d9-4989-b53c-257813fde921" alt=""><figcaption><p>Histórico de Artigos Vendidos</p></figcaption></figure>

#### *<mark style="color:blue;">Alterar Unidade</mark>*

Se o artigo possuir mais do que uma Unidade Alternativa, pode escolher a unidade desejada carregando em <mark style="color:red;">(1)</mark>.

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2FN9cDI0JGAkU5vL13ehbX%2FChange_Unity.jpg?alt=media&amp;token=89bce4b9-5d60-4d57-9bcd-828b3df755d0" alt=""><figcaption><p>Alterar Unidade</p></figcaption></figure>

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2FYM6JgmgcFhfhHkkp9KQk%2FAlt_Unities.jpg?alt=media&amp;token=428ada4d-17c5-467d-a6ce-c7776ed2378d" alt=""><figcaption><p>Unidades Alternativas</p></figcaption></figure>

## *<mark style="color:blue;">Taxa de devolução</mark>*

A funcionalidade de Taxa de Devolução permite controlar a inserção de artigos em documentos com base no histórico de devoluções do cliente. O sistema calcula a percentagem de devoluções de um artigo para um cliente específico num determinado período e, conforme a configuração, pode avisar ou bloquear a inserção.

#### *<mark style="color:blue;">Como Funciona</mark>*

Ao selecionar um artigo num documento, o sistema verifica:

1. Se o controlo de devoluções está ativo (*<mark style="color:blue;">ControlReturns</mark>* diferente de "Não fazer nada").
2. Se está configurado um período de histórico (*<mark style="color:blue;">DiasHistóricoDevoluções > 0</mark>*).
3. Calcula a taxa de devolução do artigo para aquele cliente no período definido.
4. Se a taxa calculada for igual ou superior à taxa configurada (*<mark style="color:blue;">ControlReturnsPercentage</mark>*), aplica a ação configurada.

A taxa é calculada com base nos movimentos do artigo (tabela *<mark style="color:blue;">Pn</mark>*) no período, comparando quantidades vendidas e quantidades devolvidas para o cliente em causa.

### *<mark style="color:blue;">Parâmetros de Configuração</mark>*

#### *<mark style="color:blue;">Ao Documento</mark>*

*<mark style="color:blue;">ControlReturns</mark>* — Define o comportamento ao detetar taxa excedida:

* *<mark style="color:blue;">0</mark>* — Não fazer nada (funcionalidade desativada para este tipo de documento).
* *<mark style="color:blue;">1</mark>* — Avisar: mostra popup informativo mas permite a inserção.
* *<mark style="color:blue;">2</mark>* — Bloquear: impede a inserção do artigo.
* *<mark style="color:blue;">ControlReturnsPercentage</mark>* — Percentagem a partir da qual a regra é aplicada.

### *<mark style="color:blue;">Ao Terminal</mark>*

* *<mark style="color:blue;">DiasHistóricoDevoluções</mark>* — Número de dias para trás considerados no cálculo (ex: 365 = último ano).

### *<mark style="color:blue;">Portal</mark>*

É no portal que controlamos os Parametros.

* Parâmetro ao Documento. <mark style="color:red;">(1)</mark> -> *<mark style="color:blue;">ControlReturnsPercentage.</mark>* <mark style="color:red;">(2)</mark> ->*<mark style="color:blue;">ControlReturnsPercentage.</mark>*

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2F4KOZBp0fkF6FVnno4cgi%2FPortalDoc.png?alt=media&amp;token=f096a7d5-89c2-45ef-af9d-1c635357486a" alt=""><figcaption></figcaption></figure>

* Parâmetro ao Terminal. <mark style="color:red;">(3)</mark> ->*<mark style="color:blue;">DiasHistóricoDevoluções.</mark>*

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2FxS8dNNaf6exzxGHXuAVo%2FPortalTer.png?alt=media&amp;token=33010507-04dd-457d-967e-a4fa1ad4005f" alt=""><figcaption></figcaption></figure>

## *<mark style="color:blue;">SDR — Sistema de Depósito e Devolução de Embalagens</mark>*

O SDR (também conhecido como sistema "Volta") é o sistema de depósito e devolução de embalagens de bebidas não reutilizáveis. O consumidor paga um depósito de €0,10 por embalagem na compra e recupera esse valor ao devolver a embalagem num ponto de recolha.

O valor do depósito SDR **não está sujeito a IVA** (motivo M99 — Decreto-Lei n.º 152-D/2017, de 11 de dezembro). Aplica-se a embalagens primárias não reutilizáveis de bebidas em plástico e metais (PET e latas) com capacidade até 3 litros.

Na aplicação, o SDR é implementado através de um mecanismo genérico de **linhas de taxa automáticas**, que pode ser utilizado para qualquer tipo de taxa.

### <mark style="color:$primary;">Linhas de Taxa Automáticas</mark>

O mecanismo de linhas de taxa permite associar taxas automáticas a artigos. Quando um artigo com taxas configuradas é inserido num documento, a aplicação gera automaticamente linhas de taxa adicionais com o valor, quantidade e IVA adequados, com valor e fator de conversão configuráveis por artigo.

### <mark style="color:$primary;">Modelo de dados</mark>

#### <mark style="color:$primary;">Tabelas de Configuração</mark>

<mark style="color:orange;">**`X_Items_Taxes`**</mark>**&#x20;—&#x20;**<mark style="color:$primary;">**Ligação artigo ↔ taxa**</mark>

Tabela que associa um artigo-base a um artigo-taxa. É a tabela central do mecanismo: define quais artigos geram linhas de taxa automáticas e com que parâmetros.

| Campo               | Descrição                                                                                                                                                                       |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `reference`         | Referência do artigo-base (`X_Items.item_code`). É o artigo que o vendedor seleciona.                                                                                           |
| `tax_reference`     | Referência do artigo-taxa ( `X_Items.item_code`). É o artigo que representa a taxa (ex: `SDR001`).                                                                              |
| `value`             | Valor unitário da taxa (ex: `0.10` para €0,10 por embalagem).                                                                                                                   |
| `conversion_factor` | Fator de conversão entre unidades do artigo-base e unidades de taxa. `1` = 1 unidade de taxa por unidade vendida. `6` = 6 unidades de taxa por unidade vendida (ex: pack de 6). |

Um mesmo artigo-taxa pode estar ligado a múltiplos artigos-base.

<mark style="color:orange;">**`X_Table_VAT_Exemption`**</mark>**&#x20;—&#x20;**<mark style="color:$primary;">**Motivos de isenção de IVA**</mark>

Tabela com os códigos de isenção/não-sujeição de IVA

| Campo      | Descrição                                                                                  |
| ---------- | ------------------------------------------------------------------------------------------ |
| `code`     | Código do motivo (ex: `M99`).                                                              |
| `mention`  | Texto legal da menção (ex: "Não sujeito - Decreto-Lei n.º 152-D/2017, de 11 de dezembro"). |
| `standard` | Indica se é um motivo standard da AT.                                                      |

Esta tabela serve apenas para obter o texto da menção legal.

<mark style="color:orange;">**`X_Items`**</mark>**&#x20;—&#x20;**<mark style="color:$primary;">**Artigo-taxa**</mark>

O artigo-taxa é um artigo normal registado em `X_Items`. O que o distingue é estar referenciado como `tax_reference` em `X_Items_Taxes`. Exemplo para SDDR:

| Campo                  | Valor                                                |
| ---------------------- | ---------------------------------------------------- |
| `item_code`            | `SDR001` ( aponta para `X_Items_Taxes.reference`)    |
| `description`          | EX: Sistema de Depósito e Reembolso (Volta)          |
| `price_line_1`         | EX: `0.10`                                           |
| `reason_vat_exemption` | EX: `M99` (aponta para `X_Table_VAT_Exemption.code`) |

<mark style="color:$primary;">**Regra de isenção de IVA**</mark>**:** Se `st.reason_vat_exemption` estiver preenchido (não vazio/ não null), o artigo é tratado como isento — a linha do documento fica com IVA = 0 e o código é copiado para `doclin.reason_vat_exemption`. Esta regra aplica-se a qualquer artigo, não apenas a artigos-taxa. Artigos-taxa que devam levar IVA normal deixam este campo vazio.

**Campos no documento**

<mark style="color:orange;">**`X_Documents_Lines_ERP`**</mark>**&#x20;—&#x20;**<mark style="color:$primary;">**Campos de linhas de taxa**</mark>

| Campo                     | Descrição                                                                                                          |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| `tax_line`                | `true` se a linha é uma linha de taxa gerada automaticamente.                                                      |
| `tax_line_parent_dlstamp` | `Dlstamp` da linha-pai que originou esta taxa. Vazio quando `GroupTaxLines = true` (linha agrupada sem pai único). |
| `tax_line_unit_price`     | Preço unitário da taxa (valor de `X_Items_Taxes.value`).                                                           |
| `tax_line_total`          | Total da linha de taxa (`X_Items_Taxes.value × X_Items_Taxes.conversion_factor × qty_pai`).                        |
| `reason_vat_exemption`    | Código de isenção copiado do artigo-taxa (ex: `M99`), se aplicável.                                                |

<mark style="color:$primary;">**Parâmetros de configuração do documento**</mark>

Existem dois parâmetros que podem ser configurados no portal `group_tax_lines` <mark style="color:$danger;">(1)</mark> e `allow_delete_tax_lines`  <mark style="color:$danger;">(2)</mark>.

| Campo                    | Descrição                                                                                                                                                           |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `group_tax_lines`        | Se `true`, agrupa todas as linhas de taxa do mesmo `tax_reference` numa única linha totalizadora. Se `false`, cada linha-pai tem a sua própria linha de taxa filha. |
| `allow_delete_tax_lines` | Se `false`, o utilizador não pode apagar linhas de taxa manualmente (aparece alerta de bloqueio).                                                                   |

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2FX4kBR5v127pzOnTlyERc%2FPortaldocpsdr.png?alt=media&amp;token=036d9f54-c750-499b-b4e8-cf7c56f98038" alt=""><figcaption></figcaption></figure>

## *<mark style="color:blue;">Artigos Compostos</mark>*

Um artigo composto é um artigo-pai que, ao ser inserido num documento, adiciona um conjunto de artigos-filho (a sua composição).

Quando um artigo com composição configurada é inserido num documento, a aplicação gera automaticamente as linhas dos componentes, com quantidades proporcionais à quantidade do artigo pai.

### <mark style="color:$primary;">Como Funciona</mark>

Ao inserir um artigo num documento, o sistema verifica:

1. Se o documento permite compostos (`CompoundAllows` ativo).
2. Se existe composição configurada para referência do artigo para referência do artigo (<mark style="color:orange;">**`X_Items_composite`**</mark>). Se não existir, o artigo é inserido como uma linha normal.
3. Insere as linhas conforme o modo de seleção definido (`CompositeControlValues`).
4. Atribui o valor conforme o modo definido (`CompositeControlValues`). Consoante o modo, o valor do docuemnto pode vir todo do artigo-pai, todos do componentes, ou de ambos. As linhas que não entram no total ficam com o valor a 0.

Cada linha de componente fica ligada à linha do artigo-pai que lhe deu origem , o que permite recalcular quantidades, agrupar linhas repetidas e eliminar composição em conjunto com o pai.

### <mark style="color:$primary;">Modelo de dados</mark>

#### <mark style="color:$primary;">Tabela de Configuração</mark>

<mark style="color:orange;">**`X_Items_Composite`**</mark> — <mark style="color:$primary;">**Ligação artigo-pai ↔ componente**</mark>

Tabela que associa um artigo-base aos seus componentes. É a tabela central do mecanismo: define quais artigos são compostos e porque artigos são formados.

| Campo                   | Descrição                                                                                                                                                                                                                                  |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `reference_composite`   | Referência do artigo-**pai**, o artigo composto (`X_Items.Item_code`). É o artigo selecionado.                                                                                                                                             |
| `reference_composition` | Referência do artigo-**filho**, o componente (`X_Items.Item_code`). É o artigo que é gerado automaticamente na linha.                                                                                                                      |
| `quantity`              | Quantidade do componente por cada unidade do artigo-pai. É multiplicada pela quantidade vendida do pai para obter a quantidade da linha do componente. Ex: com `quantity` = `6`, vender 10 unidades do pai gera 60 unidades do componente. |
| `observations`          | Texto copiado para as observações da linha do componente(`doclin.ObsLine`).                                                                                                                                                                |

Um artigo-pai tem tantos componentes quantos os registos que existirem com a sua referência em `reference_composite`.&#x20;

{% hint style="info" %}
Um artigo só é tratado como composto se existir pelo menos um registo em *<mark style="color:blue;">X\_Items\_Composite</mark>* para a sua referência. Caso contrário, é inserido no documento como um artigo normal.
{% endhint %}

#### <mark style="color:$primary;">Campos no Documento</mark>

<mark style="color:orange;">**`X_Documents_Lines_Erp`**</mark> — <mark style="color:$primary;">**Campos de linha de composição**</mark>

| Campo                |                                                             |
| -------------------- | ----------------------------------------------------------- |
| `composite`          | Indica de a linha é um componente filho                     |
| `dl_composite_stamp` | Dlstamp da linha-pai que originou esta linha de componente. |

O artigo-pai mantém-se como uma linha normal (`composite = false`), sendo indentificado como pai através do Dlstamp referenciado pelas linhas do seus componentes.

#### <mark style="color:$primary;">Webservice</mark> <a href="#webservice" id="webservice"></a>

A composição é disponibilizada à aplicação pelo webservice:

| Campo                |                           |
| -------------------- | ------------------------- |
| Rota                 | `item-composite` (POST)   |
| Tabela               | `X_Items_Composite`       |
| Sincronização na App | `SyncTableItemsComposite` |

### <mark style="color:$primary;">Parâmetros de Configuração</mark> <a href="#parametros-de-configuracao" id="parametros-de-configuracao"></a>

*<mark style="color:blue;">CompoundAllows</mark>* (`compounds_allows`) — Ativa os artigos compostos no tipo de documento. Se estiver inativo, o documento ignora por completo as composições e os artigos-pai são inseridos como linhas simples.

*<mark style="color:$primary;">CompositeControl</mark>* (`Composite_control`) — Define que linhas ficam no documento:&#x20;

* <mark style="color:$primary;">0</mark> — Apenas o artigo: é inserida somente a linha do artigo-pai.
* <mark style="color:$primary;">1</mark> — Artigo e composição: é inserida as linhas do artigo-pai e as linhas de todos os componentes.
* <mark style="color:$primary;">2</mark> — Apenas a composição: são inseridas as linhas dos componentes.&#x20;

*<mark style="color:$primary;">CompositeControlValues</mark>* (`composite_control_values`) — Define que linhas transportam valor, ou seja, quais entram para o total do documento:

* <mark style="color:$primary;">0</mark> — **Apenas o artigo**: o valor vem exclusivamente do artigo pai. Os componentes entram a preço 0.
* <mark style="color:$primary;">1</mark> — **Artigo e composição**: o artigo-pai e os componentes tem valores. O total é a soma de todas as linhas.
* <mark style="color:$primary;">2</mark> — **Apenas a composição**: o valor vem exclusivamente dos componentes. O artigo pai fica com o valor 0.

#### <mark style="color:$primary;">Portal</mark> <a href="#portal" id="portal"></a>

É no portal que controlamos os parâmetros.

Parâmetro ao Documento -> *<mark style="color:blue;">CompoundAllows</mark>* (<mark style="color:$danger;">1</mark>)  -> *<mark style="color:$primary;">CompositeControl</mark>* (<mark style="color:$danger;">2</mark>) -> *<mark style="color:$primary;">CompositeControlValues</mark>* (<mark style="color:$danger;">3</mark>).

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2F4fO3mGAQTVQhmHAZNQvA%2Fcompostosportal.png?alt=media&amp;token=66a54f00-e62a-48b0-aead-b5d7be8e6e3a" alt=""><figcaption></figcaption></figure>

## <mark style="color:$primary;">Artigos em Encomendas Pendentes</mark>

Uma encomeda pendente é uma encomenda é uma encomenda do cliente que ainda não foi totalmente satisfeita, ou seja , em que a quantidade encomendada é superior à quantidade já entregue. A funcionalidade avisa o vendedor, durante a seleção do item, de que os artigos  que está a vender já tem quantidades por satisfazer noutras encomendas.

### <mark style="color:$primary;">Como funciona</mark>

A consulta é feita online, no momento em que a página de documento é aberta:

1. Verifica nas preferências do tablet se este desenvolvimento está ativo (<mark style="color:$primary;">WarnArticleInPendingOrders</mark>).
2. Verifica o estado da ligação do servidor.
3. Pede ao Webservice as linhas de encomenda pendente do cliente.
4. Guarda as linhas em memoria.

A partir daqui, toda a informação é apresentado ao vendedor — o ícone de estado, o aviso por artigo e a listagem — é servida a partir dessas linhas em memória, sem novos pedidos ao servidor.

{% hint style="info" %}
As linhas pendentes são obtidas **uma única vez**, na abertura da página de documento. Documentos emitidos durante a sessão não atualizam a listagem — esta só é recarregada quando a página de documento é aberta de novo.
{% endhint %}

#### <mark style="color:$primary;">Aviso por artigo</mark>

Ao selecionar um artigo nos documentos, a aplicação verifica se a sua referência está nas linhas pendentes. Se estiver, é apresentado um ícone (<mark style="color:$danger;">1</mark>) de aviso, que ao ser premido mostra a quantidade total pendente.&#x20;

> O artigo {referência} tem {quantidade} quantidades pendentes em encomendas (<mark style="color:$danger;">2</mark>).

A quantidade apresentada é a **soma** das quantidades pendentes desse artigo em todas as encomendas em aberto do cliente. &#x20;

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2F9ZekyJfvASKhYaLhbQLy%2Fpendentesaviso.png?alt=media&amp;token=b33cef91-37e4-4a43-a9bc-75b8ea60a150" alt=""><figcaption></figcaption></figure>

#### <mark style="color:$primary;">Listagem Completa</mark>&#x20;

O cabeçalho da página de documento tem um botão (<mark style="color:$danger;">1</mark>) que abre a listagem de todos os produtos em encomendas pendentes do cliente.&#x20;

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2FVsQLDv7fIiJC1hhXC27i%2Fabrirpendentes.png?alt=media&amp;token=81f2c984-b096-4382-aea9-e18a52d96845" alt=""><figcaption></figcaption></figure>

A listagem apresenta, por linha:

| Coluna       | Descrição                                  |
| ------------ | ------------------------------------------ |
| Data         | Data de criação do documento da encomenda. |
| Designação   | Nome do artigo.                            |
| Nº Documento | Número da encomenda de origem.             |
| Quantidade   | Quantidade encomendada.                    |
| Satisfeita   | Quantidade já entregue.                    |
| Pendente     | Quantidade por entregar.                   |

A listagem permite filtrar por intervalo de datas e por texto (referência ou designação), e ordenar por data, designação ou referência. **Todos os filtros são aplicados em memória**, pelo que funcionam mesmo sem ligação ao servidor.

O intervalo de datas arranca na data da linha pendente mais antiga, de modo a abranger por defeito todas as encomendas.

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2F8Loy2olW1wDM1FtUyIkB%2Fimage.png?alt=media&amp;token=d9466d1f-1e76-4990-a49f-83f877907608" alt=""><figcaption></figcaption></figure>

### <mark style="color:$primary;">Estados do ícone</mark>

O ícone no cabeçalho do documento reflete o resultado da consulta:

| Estado                        | Significado                                                                                | Ícone                                                                                                                                                                                                                                        |
| ----------------------------- | ------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Tem linhas                    | O cliente tem encomendas pendentes.                                                        | ![](https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2FpZUnBy0zMDwniOoUXxiK%2Fic_pending_orders.svg?alt=media\&token=c7cd8038-727a-47d4-a619-cd4ad89a7993)              |
| Não tem linhas                | O clientes não tem encomendas pendentes.                                                   | ![](https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2Fi9lv39UDlWvG34BUhE7m%2Fic_ino_pending_orders.svg?alt=media\&token=04fb2979-5c93-4ff9-b13d-13690e1eb1ee)          |
| Não tem conecção ao servidor. | Não foi possível contactar o servidor, pelo que não é possível saber se existem pendentes. | ![](https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2FR8g2oef7ssZ1euBxJjj8%2Fic_pending_orders_noconnection.svg?alt=media\&token=90535ec6-4053-4ad2-b9c9-186bbdee4e0a) |

Enquanto a consulta decorre, é apresentado um indicador de atividade junto ao ícone.

## *<mark style="color:blue;">Galeria</mark>*

Na view do catálogo em Galeria teremos a possibilidade de pesquisar artigos por família, no menu do lado esquerdo, assim como fazer uma [<mark style="color:blue;">**Pesquisa de Artigos**</mark>](#pesquisa-de-artigos)  <mark style="color:red;">(5)</mark> com imagem e filtrar esses artigos.&#x20;

Existe 1 menu ao artigo selecionado <mark style="color:red;">(7)</mark> nesta view, que inclui as informações Preço Líquido, Preço com IVA, Preços a este Cliente e Fator de Conversão. Em relação ao artigo, pode também [<mark style="color:blue;">**Alterar a sua Unidade**</mark>](#alterar-unidade) <mark style="color:red;">(8)</mark>.

Pode alterar a forma como vê a disposição dos artigos <mark style="color:red;">(6)</mark>,  visualizar as linhas dos [<mark style="color:blue;">**Artigos Vendidos**</mark> ](#artigos-vendidos)<mark style="color:red;">(2)</mark> anteriormente, voltar à view [<mark style="color:blue;">**Lista**</mark>](#lista) <mark style="color:red;">(1)</mark> e passar para a view [<mark style="color:blue;">**Artigo Único**</mark>](#artigo-unico) <mark style="color:red;">(3)</mark>, assim como ver o [<mark style="color:blue;">**Resumo do Documento**</mark>](#resumo-do-documento) <mark style="color:red;">(4)</mark>. Tem ainda a oportunidade de ver artigos por [<mark style="color:blue;">**Catálogo**</mark>](#catalogo) <mark style="color:red;">(9)</mark>.

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2FMEPgdk8fniVXi1tg7ggv%2FGallery_View.jpg?alt=media&amp;token=7382332e-7e80-4101-96b3-f42bf1231092" alt=""><figcaption><p>Galeria</p></figcaption></figure>

Na galeria também poderá ter acesso à informação de stock <mark style="color:red;">**(1)**</mark> e à possibilidade de adicionar e remover artigos de forma rápida <mark style="color:red;">(2)</mark>. Foi adicionado também um menu que permite definir o modo de visualização da galeria, assim como o tamanho do texto <mark style="color:red;">(3)</mark>.&#x20;

Os preços visíveis dos artigos <mark style="color:red;">(4)</mark> podem ser os preços líquidos, caso o parâmetro ao documento ***"Mostrar preços líquidos na galeria?"*** esteja **ativo** a a galeria esteja em modo ***Slide*** <mark style="color:red;">(3)</mark>.

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2Fp6VVquOwh3D69kCbweTj%2FGalery_Catalog_2.jpg.png?alt=media&amp;token=e4c5c0e3-7baa-4c8f-ac46-cb4d8ffbee17" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2F6TpKSZmyjRgYwHE7aEDt%2FGalery_Catalog_3.jpg.png?alt=media&amp;token=772c679e-8998-4fdd-af49-ae9ecad68ef8" alt=""><figcaption></figcaption></figure>

No lado esquerdo temos um painel de navegação em que temos as famílias, as labels e os catálogos. Ao selecionar qualquer um desses separadores, é expandida uma lista de subcategorias.

* Ao selecionar "Todos", em famílias apresenta todos os artigos disponíveis na galeria, sem aplicar qualquer filtro.
* Se selecionar a subcategoria, como "Alimentar", filtra os produtos apresentados, mostrando apenas os que pertencem a essa família específica.
* Podemos também cruzar várias famílias e labels.
* Para o caso especifico das labels, aqui selecionamos o separador "Nenhum", para apresentar todos os artigos disponíveis.&#x20;

Sobre os catálogos, estes tem de ser criados no portal, em Catálogos -> Catálogos de produtos. Dentro dessa página, podemos editar ou criar novos catálogos. &#x20;

#### *<mark style="color:blue;">Pesquisa de Artigos</mark>*

Na pesquisa de artigos pode selecionar apenas artigos com imagem e ainda filtrar os artigos por:

* Designação
* Código de Barras
* Designação + Referência

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2FszmKpDFNjtJv2R8WvPOO%2FDocs_Search.jpg?alt=media&amp;token=7e373947-3708-4e42-8057-fd970df79074" alt=""><figcaption><p>Pesquisa de Artigos</p></figcaption></figure>

## <mark style="color:$primary;">Campos Personalizados no Catálogo</mark>

Os **campos personalizados do artigo** são campos livres, que permitem transportar informação especifica de cada cliente.

A aplicação disponibiliza cinco campos personalizados por artigo. Destes, **apenas dois tem permissão para ser apresentados no catálogo**: os campos 4 e 5.

O objetivo é que o vendedor veja a informação relevante junto de cada artigo do catálogo, sem ter de abrir a ficha.

### <mark style="color:$primary;">Como Funciona</mark>

A sua apresentação no catálogo é controlada pelos parâmetros *<mark style="color:$primary;">show\_custom\_text\_4\_in\_catalogs</mark>* e <mark style="color:$primary;">show\_custom\_text\_5\_in\_catalogs</mark>. Sem estes parâmetros ativos, os campos não são apresentados no catálogo, ainda que estejam preenchidos no artigo.

### <mark style="color:$primary;">Apresentação</mark>

Os campos 4 (<mark style="color:$danger;">1</mark>) e 5 (<mark style="color:$danger;">2</mark>) são apresentados por baixo de cada artigo no catálogo, lado a lado, o campo 4 à esquerda e o campo 5 à direita.

O texto é truncado a uma linha, ficando totalmente visivel como *tooltip*.

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2F0ya0o2amHSQ3FZudNc9A%2Fcamposcatalogo.png?alt=media&amp;token=7b643a91-23d9-4b43-aee4-1b277a3dfb65" alt=""><figcaption></figcaption></figure>

### <mark style="color:$primary;">Portal</mark>

É no portal que controlamos os Parâmetros.

Parâmetro ao Terminal  -> *<mark style="color:$primary;">show\_custom\_text\_4\_in\_catalogs</mark>* (<mark style="color:$danger;">1</mark>) -> <mark style="color:$primary;">show\_custom\_text\_5\_in\_catalogs</mark> (<mark style="color:$danger;">2</mark>)*<mark style="color:blue;">.</mark>*

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2FVSL4q8pfxG78ca2yk4hN%2Fportaltextocatalogo.png?alt=media&amp;token=af23dfba-2927-43b9-8c7b-f14e7e348a7a" alt=""><figcaption></figcaption></figure>

#### *<mark style="color:blue;">Agrupamento de linhas.</mark>*

A funcionalidade de agrupamento de linhas permite agrupar na mesma linha produtos adicionados pela galeria ou pelos artigos em lista que tenham os mesmos descontos, mesma referência e o mesmo preço. Para ativar esta funcionalidade é necessário ativar o parâmetro em lista "Agrupa as linhas quando adiciona ou edita produtos no catálogo" <mark style="color:red;">(1)</mark> nos documentos.&#x20;

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2FcEOb3TAuODwbeVMBSLDq%2F2.png?alt=media&amp;token=a0b51676-e673-4e05-a3af-f7cff5d84144" alt=""><figcaption></figcaption></figure>

## *<mark style="color:blue;">Artigo Único</mark>*

Na view do catálogo em Artigo Único teremos a possibilidade de [<mark style="color:blue;">**Alterar a Unidade**</mark>](#alterar-unidade) <mark style="color:red;">(4)</mark> do artigo visualizado, visualizar as linhas dos [<mark style="color:blue;">**Artigos Vendidos**</mark>](#artigos-vendidos) <mark style="color:red;">(2)</mark> anteriormente, voltar à view [<mark style="color:blue;">**Galeria**</mark> ](#galeria)<mark style="color:red;">(1)</mark> e ver o [<mark style="color:blue;">**Resumo do Documento**</mark>](#resumo-do-documento) <mark style="color:red;">(3)</mark>.

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2FNq7zmgSMuzLlGYDwipON%2FSingle_View.jpg?alt=media&amp;token=b44aa22d-8f7a-453a-8e83-18f7046ed7c9" alt=""><figcaption><p>Artigo Único</p></figcaption></figure>

## *<mark style="color:blue;">Resumo do Documento</mark>*

No resumo do documento poderá eliminar linhas selecionadas <mark style="color:red;">(1)</mark>, converter as linhas do documento em [<mark style="color:blue;">**Linhas Suspensas**</mark>](#linhas-suspensas) através do menu <mark style="color:red;">(2)</mark> e Finalizar o Documento <mark style="color:red;">(3)</mark>.

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2FtxAlRE9IDsumqrLm5m4E%2FDoc_Resume.jpg?alt=media&amp;token=2644c3e4-0297-4dd0-96d9-1bdc49887982" alt=""><figcaption><p>Resumo</p></figcaption></figure>

{% hint style="info" %}
Ao finalizar o documento, se pretender enviar o mesmo por e-mail, necessita de garantir que tem pelo menos um e-mail adicionado <mark style="color:red;">(1)</mark> e a checkbox de envio de e-mail ativa <mark style="color:red;">(2)</mark>.
{% endhint %}

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2FQRBx8rQmX0Dc5ZN8NSMe%2FFinish_Doc.jpg?alt=media&amp;token=27bed134-dca6-4058-9965-ed444dfc9415" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2FM4E2rGUmp3EWbk7pF3sq%2FFinish_Doc_2.jpg?alt=media&amp;token=aef1c6a0-d5a7-46e8-bf23-b3a36c57be9d" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Topos os campos booleanos, numéricos, de texto e de combo presentes na finalização do documento são parâmetros ao documento.
{% endhint %}
