For the complete documentation index, see llms.txt. This page is also available as Markdown.

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).

Lista

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.

Menu
Opção Preço com IVA ativa

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.

Stock Online
Stock Online - Resumo 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).

Filtro categorias
Filtro catálogos
Catálogos

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.

Escolha do documento
Copiar Linhas

Consultar Observações

Observações

Linhas Suspensas

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

Linhas Suspensas

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.

Histórico de Artigos Vendidos

Alterar Unidade

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

Alterar Unidade
Unidades Alternativas

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:

  1. Se o controlo de devoluções está ativo (ControlReturns diferente de "Não fazer nada").

  2. Se está configurado um período de histórico (DiasHistóricoDevoluções > 0).

  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 (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.

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.

X_Table_VAT_ExemptionMotivos de isenção de IVA

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.

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:

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)

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

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.

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).

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).

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).

Galeria

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

Pesquisa de Artigos

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).

Artigo Único

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).

Resumo

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