Documentos
A página dos Documentos vai estar dividida em 3 Views do catálogo:
Os descontos e o bônus visíveis são parâmetros ao documento que tem que ser tratados no Portal.
Lista
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 (6) e ainda filtrar o produto por:
Designação
Código de Barras
Designação + Referência
Existem 2 menus nesta view, um geral (1) e um ao artigo selecionado (5). O menu geral (1) inclui as funcionalidades de Copiar Linhas, Consultar Observações à entidade e Linhas Suspensas. O menu do artigo (5) 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 Alterar a sua Unidade (7).
Pode visualizar as linhas dos Artigos Vendidos anteriormente (2) e passar para a view Galeria (3), assim como ver o Resumo do Documento (4).

No menu em (5) existe a opção de Mostrar Preço com IVA e se essa opção for selecionada, irá ter a informação do preço com IVA em todos os artigos.


Ainda no menu em (5) existe a opção de Stock Online (1) e Preço e Desc. Online (2). Estas 2 funcionalidades também se encontram no Resumo do Documento.



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 (2).
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 (1). Ao utilizar esta funcionalidade, o preço e os descontos são atualizados com o que a query preenchida no parâmetro devolver.

De maneira a ter mais níveis de filtragem dos artigos, como podemos verificar em (1) na imagem seguinte os campos ao terminal category1_label e category2_label terão que estar preenchidos. Se apenas o campo category1_label 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 ItemsCategory1 (X_Items_Category1 na middleware) e ItemsCategory2 (X_Items_Category2). Na ficha de artigo: category1 e category2. Também é possível filtrar os artigos por Catálogos (2).



Sub Famílias
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 sub_family_level1, sub_family_level2, sub_family_level3). As sub famílias têm também que estar preenchidas na tabela SubFamily (X_Items_Sub_Families na middleware).
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 (1), selecionar a primeira sub família antes de selecionar a segunda sub família (2), etc. A combo box de cada sub família apenas está visível se existirem sub famílias do nível especifico na tabela SubFamily.


Permitir apenas descontos a 100%
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” (1) 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?” (2) como verdadeiro.

De seguida, deve-se configurar o campo “N. Desc” (3) com o valor 1, de modo a que, na aplicação, apenas o desconto 1 (4) fique ativo. Nesse mesmo campo, apenas serão permitidos descontos de 0% ou 100%.


Copiar Linhas
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.


Consultar Observações

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

Artigos Vendidos
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 (1), caso exista, e Agrupar os artigos por Referência (2), ficando apenas com a linha mais recente de cada produto.

Alterar Unidade
Se o artigo possuir mais do que uma Unidade Alternativa, pode escolher a unidade desejada carregando em (1).


Taxa de devolução
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.
Como Funciona
Ao selecionar um artigo num documento, o sistema verifica:
Se o controlo de devoluções está ativo (ControlReturns diferente de "Não fazer nada").
Se está configurado um período de histórico (DiasHistóricoDevoluções > 0).
Calcula a taxa de devolução do artigo para aquele cliente no período definido.
Se a taxa calculada for igual ou superior à taxa configurada (ControlReturnsPercentage), aplica a ação configurada.
A taxa é calculada com base nos movimentos do artigo (tabela Pn) no período, comparando quantidades vendidas e quantidades devolvidas para o cliente em causa.
Parâmetros de Configuração
Ao Documento
ControlReturns — Define o comportamento ao detetar taxa excedida:
0 — Não fazer nada (funcionalidade desativada para este tipo de documento).
1 — Avisar: mostra popup informativo mas permite a inserção.
2 — Bloquear: impede a inserção do artigo.
ControlReturnsPercentage — Percentagem a partir da qual a regra é aplicada.
Ao Terminal
DiasHistóricoDevoluções — Número de dias para trás considerados no cálculo (ex: 365 = último ano).
Portal
É no portal que controlamos os Parametros.
Parâmetro ao Documento. (1) -> ControlReturnsPercentage. (2) ->ControlReturnsPercentage.

Parâmetro ao Terminal. (3) ->DiasHistóricoDevoluções.

SDR — Sistema de Depósito e Devolução de Embalagens
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.
Linhas de Taxa Automáticas
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.
Modelo de dados
Tabelas de Configuração
X_Items_Taxes — Ligação artigo ↔ taxa
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.
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.
X_Table_VAT_Exemption — Motivos de isenção de IVA
Tabela com os códigos de isenção/não-sujeição de IVA
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.
X_Items — Artigo-taxa
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:
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)
Regra de isenção de IVA: 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
X_Documents_Lines_ERP — Campos de linhas de taxa
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.
Parâmetros de configuração do documento
Existem dois parâmetros que podem ser configurados no portal group_tax_lines (1) e allow_delete_tax_lines (2).
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).

Galeria
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 Pesquisa de Artigos (5) com imagem e filtrar esses artigos.
Existe 1 menu ao artigo selecionado (7) 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 Alterar a sua Unidade (8).
Pode alterar a forma como vê a disposição dos artigos (6), visualizar as linhas dos Artigos Vendidos (2) anteriormente, voltar à view Lista (1) e passar para a view Artigo Único (3), assim como ver o Resumo do Documento (4). Tem ainda a oportunidade de ver artigos por Catálogo (9).

Na galeria também poderá ter acesso à informação de stock (1) e à possibilidade de adicionar e remover artigos de forma rápida (2). Foi adicionado também um menu que permite definir o modo de visualização da galeria, assim como o tamanho do texto (3).
Os preços visíveis dos artigos (4) 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 (3).


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.
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.
Pesquisa de Artigos
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

Agrupamento de linhas.
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" (1) nos documentos.

Artigo Único
Na view do catálogo em Artigo Único teremos a possibilidade de Alterar a Unidade (4) do artigo visualizado, visualizar as linhas dos Artigos Vendidos (2) anteriormente, voltar à view Galeria (1) e ver o Resumo do Documento (3).

Resumo do Documento
No resumo do documento poderá eliminar linhas selecionadas (1), converter as linhas do documento em Linhas Suspensas através do menu (2) e Finalizar o Documento (3).

Ao finalizar o documento, se pretender enviar o mesmo por e-mail, necessita de garantir que tem pelo menos um e-mail adicionado (1) e a checkbox de envio de e-mail ativa (2).


Topos os campos booleanos, numéricos, de texto e de combo presentes na finalização do documento são parâmetros ao documento.
Last updated