# 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="/files/QCjMLQHQfth79DWu20r0" 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="/files/hA8JTSz4B6PaFrG8aVZZ" alt=""><figcaption><p>Menu</p></figcaption></figure>

<figure><img src="/files/jJEQx2hcT9nNib10D4Me" 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="/files/w1wm3G4izjRRB0tOYa9B" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/CW8ycNEHfXqbm4HhNxY7" alt=""><figcaption><p>Stock Online</p></figcaption></figure>

<figure><img src="/files/AVXuUPewHX93rtIH5hv3" 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="/files/yrdfXUNKOk90NfuBRak3" 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="/files/JxBPopJ0JphncGif5la3" alt=""><figcaption><p>Filtro categorias</p></figcaption></figure>

<figure><img src="/files/tiQ5qH3vjELFUeNKZdqd" alt=""><figcaption><p>Filtro catálogos</p></figcaption></figure>

<figure><img src="/files/Vd1A49LNRqnucldUS1H3" 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="/files/OKlj5lr4NdvHTXtAhdfw" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/PfdowCiLstrjbenclwfo" 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="/files/QRoUdbeRiXt7KebYwYSY" 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="/files/NNVJhhm5JPgViFk8oOa9" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/67onpF1GP3Sevn8vRie9" 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="/files/7xOIQwbXCowZtHqWqdVL" alt=""><figcaption><p>Escolha do documento</p></figcaption></figure>

<figure><img src="/files/Jxg0EUsrtKvzMmGgAPyx" alt=""><figcaption><p>Copiar Linhas</p></figcaption></figure>

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

<figure><img src="/files/dihmqU7GJR4bJSM6wSJ8" 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="/files/VvkdSoGpmQyOrZA3t46D" 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="/files/TV7vjghBIb3E6RW22egP" 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="/files/IcJNsBhDeMSYSNcf9rJK" alt=""><figcaption><p>Alterar Unidade</p></figcaption></figure>

<figure><img src="/files/t6zjRGY2XOn7qtUdcdTq" alt=""><figcaption><p>Unidades Alternativas</p></figcaption></figure>

## *<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="/files/CjepylyJSY5b2SgWKyii" 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="/files/jPIGojEWBzXnpBHaaLl7" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/szXCPWvTvZZS0pfNHl0c" 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="/files/baujK6USKHOKfiyzft4Q" alt=""><figcaption><p>Pesquisa de Artigos</p></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="/files/nPQ1sH1EyFhcLSnjaiSI" 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="/files/B3Bv6U2DQgVPP2gAyB6n" 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="/files/ok5wclbPqEjyU27mKc1z" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/UtspywfrPNUPZtbFCShP" 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 %}


---

# 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/wave-trade-x/app/estrutura/clientes/documentos.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.