Tabelas de Operações Comerciais (Compras/Vendas)

Introdução

É necessário para a personalização de um projeto comercial, além de conhecer as regras de negócios, a estrutura do banco de dados.

Deter conhecimento sobre as tabelas associadas e as ligações entre os campos é importante para extrair bons resultados Definir a tabela principal e os principais campos de relacionamento é o primeiro passo para a construção de um DER que verifica o volume de vendas, por exemplo.

O DER abaixo representa as relações entre as tabelas utilizadas para analisar as vendas por produto, com a principal tabela sendo a TGFCAB, juntamente com a TGFITE, que contém as informações pertinentes aos produtos, quantidades e os valores atribuídos.

As duas instâncias, apresentam todas chaves estrangeiras (FK) necessárias para realização das ligações pertinentes aos processos.

O processo de compras e venda são similares e grande parte das instâncias são utilizadas nos dois processos. A diferenciação fica por alguns pontos como:

• parametrizações nos campos da tabela TGFTOP;
• uso das instância de preços TGFTAB e TGFEXC para vendas;
• uso das instância de preços TGFCUS e TGFCUSITE para compras;

O DER apresenta o seguinte conjunto de tabelas:

• TGFCAB
• TGFTOP
• TGFITE
• TGFPRO
• TGFGRU
• TGFVEN
• TGFPAR
• TGFTAB
• TGFEXC
• TGFCUS
• TGFCUSITE
• TGFTPV
• TGFLOC
• TGFEST
• TGFVAR

Diagrama em alta resolução disponível neste link.

As tabelas abaixo apresentam informações detalhadas do DER, são apresentadas colunas pertinentes ao processo de vendas ou compras, descrição dos campos, tipo de dado, se as colunas apresentam nulos e valores padrões.

TGFCAB

A TGFCAB é a instância que corresponde ao cabeçalho da nota, e recebe grande parte das chaves estrangeiras (FK) de outras tabelas relacionadas a ela. Ligada a ela, através da chave primária NUNOTA, temos a TGFITE. Essa ligação permite ao usuário elaborar uma visão, tanto do prisma comercial, financeiro ou gerencial.

A TGFCAB possui campos de datas importantes, como por exemplo:

• DTNEG - quando utilizado em operações de vendas, indica data de negociação da operação de saída. Já em operações de compras, é preenchido com a data de emissão da nota de compra emitida pelo fornecedor.

• DTENTSAI - usualmente utilizado em operações de compras, indicando o registro do dia em que a nota de compra é lançado no ERP Sankhya.

• DTMOV - é usado com o mesmo intuito do campo DTENTSAI, porém, mais utilizado em operações contábeis (registros contábeis) e atualização de estoque, registrando a entrada de estoque no dia indicado, dentro do ERP Sankhya.

📘

Dica Importante

Para criação de filtros em relatórios destinados a operação de vendas, indica-se o campo DTNEG.

TGFTOP

Instância onde ocorre a parametrizações dos processos de entradas ou saídas, registros financeiros e movimentos de estoque. A ligação entre a TGFTOP e a TGFCAB apresenta pontos importantes, que devem ser analisados:

• relacionamento entre o campo DHTIPOPER da tabela TGFCAB e o campo DHALTER da tabela TGFTOP.

• ligação entra a chave estrangeira CODTIPOPER da tabela TGFCAB e a chave primária do campo CODTIPOPER da tabela TGTOP.

📘

Informação Importante

O campo DHALTER armazena parametrizações, dando a TGFTOP a condição de uma tabela de armazenamento histórico.

O detalhe importante que existe na TGFTOP é que ela é conhecida como uma tabela histórica, guardando cada parametrização através do campo DHALTER da TGFTOP, logo cada vendas irá registrar as parametrizações criadas com o decorrer do tempo.

Por exemplo: Se parametrizarmos a TGFTOP de venda para não gerar financeiro e criarmos uma venda no Portal de Vendas, essa nota não irá gerar o financeiro, e no campo DHTIPOPER da TGFCAB estará o registro da data e hora em que essa parametrização foi realizada.

Se voltarmos na TGFTOP e alterarmos para que ela gere financeiro como receita, o campo DHALTER registrará a data e hora dessa nova parametrização e todas as próximas vendas realizadas começarão a gerar financeiro do tipo receita. Porém a venda realizada na parametrização anterior permanecerá imutável, pois a parametrização anterior permaneceu igual e a venda realizada naquele momento dizia que não geraria financeiro.

Isso é o efeito histórico que essa tabela possui, sendo possível o registro de todas as parametrizações realizadas no decorrer do tempo.

FROM
TGFCAB CAB
inner join TGFTOP TPO on CAB.CODTIPOPER = TPO.CODTIPOPER and CAB.DHTIPOPER = TPO.DHALTER 🟢🟢🟢

TGFITE

Nessa instância tem-se informações das quantidades negociadas, através do campo QTDNEG e do preço de venda do produto, através do campo VLRUNIT. O resultado dessa operação resulta no VLRTOT.

📘

Informações Importantes

• Utiliza-se o campo VLRTOT para determinar o valor total dos itens negociados, ao invés de realizar a multiplicação dos campos QTDNEG e VLRUNIT.

• Para se obter o valor total líquido da venda do produto, utiliza-se o desconto atribuído ao item, realizando a subtração dos campos (VLRTOT – VLRDESC).

FROM
TGFCAB CAB
inner join TGFTOP TPO on CAB.CODTIPOPER = TPO.CODTIPOPER and CAB.DHTIPOPER = TPO.DHALTER
inner join TGFITE ITE on CAB.NUNOTA = ITE.NUNOTA 🟢🟢🟢

TGFPRO

Instância responsável por centralizar informações a respeito dos produtos inseridos no ERP Sankhya. Para trazer informações do cadastro de produtos, relaciona-se a chave estrangeira CODPROD da tabela TGFITE com a chave primária CODPROD da tabela TGFPRO. Ao realizar essa ação se obtém informações como a descrição do produto e sua marca.

FROM
TGFCAB CAB
inner join TGFTOP TPO on CAB.CODTIPOPER = TPO.CODTIPOPER and CAB.DHTIPOPER = TPO.DHALTER
inner join TGFITE ITE on CAB.NUNOTA = ITE.NUNOTA
inner join TGFPRO PRO on ITE.CODPROD = PRO.CODPROD 🟢🟢🟢

TGFGRU

Através do relacionamento da instância TGFPRO, é possível relacionar o grupo de produto, trazendo informações como a descrição do grupo em que ele está inserido. O processo se dá através da chave estrangeira CODGRUPOPROD da tabela TGFPRO com a chave primária CODGRUPOPROD da tabela TGFGRU.

FROM
TGFCAB CAB
inner join TGFTOP TPO on CAB.CODTIPOPER = TPO.CODTIPOPER and CAB.DHTIPOPER = TPO.DHALTER
inner join TGFITE ITE on CAB.NUNOTA = ITE.NUNOTA
inner join TGFPRO PRO on ITE.CODPROD = PRO.CODPROD
inner join TGFGRU GRU on PRO.CODGRUPOPROD = GRU.CODGRUPOPROD 🟢🟢🟢

TGFVEN

Nas vendas realizadas, obtém-se o registro do vendedor através do campo CODVEND da TGFCAB. Para se ter o nome do vendedor (campo APELIDO), é necessário realizarmos a ligação da chave estrangeira CODVEND da TGFCAB com a chave primária CODVEND da TGFVEN.

FROM
TGFCAB CAB
inner join TGFTOP TPO on CAB.CODTIPOPER = TPO.CODTIPOPER and CAB.DHTIPOPER = TPO.DHALTER
inner join TGFITE ITE on CAB.NUNOTA = ITE.NUNOTA
inner join TGFPRO PRO on ITE.CODPROD = PRO.CODPROD
inner join TGFGRU GRU on PRO.CODGRUPOPROD = GRU.CODGRUPOPROD
inner join TGFVEN VEN on CAB.CODVEND = VEN.CODVEND 🟢🟢🟢

TGFPAR

A instância de parceiros se relaciona com a tabela TGFCAB através da chave estrangeira CODPARC, ligando-as através da chave primária CODPARC da tabela TGFPAR.

FROM
TGFCAB CAB
inner join TGFTOP TPO on CAB.CODTIPOPER = TPO.CODTIPOPER and CAB.DHTIPOPER = TPO.DHALTER
inner join TGFITE ITE on CAB.NUNOTA = ITE.NUNOTA
inner join TGFPRO PRO on ITE.CODPROD = PRO.CODPROD
inner join TGFGRU GRU on PRO.CODGRUPOPROD = GRU.CODGRUPOPROD
inner join TGFVEN VEN on CAB.CODVEND = VEN.CODVEND
inner join TGFPAR PAR on CAB.CODPARC = PAR.CODPARC 🟢🟢🟢

TGFTAB

TGFEXC

TGFCUS

Na parametrização do processo de compras é comum criarmos fórmulas em que os valores de custos fiscais e gerenciais são formados automaticamente.

Isso ocorre através da inserção do histórico das entradas (de acordo com a empresa, local ou controle e regras de negócio do parceiro) a tabela TGFCUS.

A instância TGFCUS apresenta os valores de custos registrados, estes formados pelas fórmulas de custo e preço.

FROM
TGFCAB CAB
inner join TGFITE ITE on CAB.NUNOTA = ITE.NUNOTA
inner join TGFCUSITE CUS on ITE.NUNOTA = CUS.NUNOTA AND ITE.SEQUENCIA = CUS.SEQUENCIA 🟢🟢🟢

TGCUSITE

A instância TGFCUSITE, corresponde ao custo por item, apresenta os mesmos registros presentes na TGFCUS, porém aqui são apresentados somente os itens de uma compra lançada, possibilitando a busca de notas através da chave primária composta NUNOTA e SEQUENCIA.

TGFTPV

Na instância de tipos de negociações estão cadastradas as formas de pagamentos utilizadas nas operações em que existam financeiro. Ela apresenta a mesma característica de armazenamento histórico, registrando historicamente cada alteração realizada, inserindo uma nova linha de acordo com a data de alteração utilizando o campo.

📘

Dica Importante

Ao iniciar uma nota de venda ou compra, se for necessário realizar alguma alteração no tipo de negociação, exclui-se a nota e cria-se uma nova. Isso garante que as alterações ocorram, pois na TGFCAB também é registrado a data de alteração do tipo de negociação, através do campo DHTIPVENDA.

TGFLOC

Na instância TGFLOC, são cadastrados os espaços físicos ou gerenciais em que produtos são armazenados.
Dividem-se em dois grupos:

• Físicos: armazéns, depósitos ou a própria empresa;
• Gerencial: avaria, separação ou site;

O local de armazenamento, pode ser lançado em operações de compra e vendas. Em compras, é realizado no processo de entrada de estoque no local selecionado, enquanto em vendas, quando há baixa de estoque.

Uma terceira opção é quando há transferência de estoque, que realiza as duas operações (compras/vendas) ao mesmo tempo e em locais distintos.

TGFEST

A instância TFGEST (estoque) registra as quantidades que cada produto possui armazenado, podendo esse estoque ser detalhado por suas chaves primárias.

A parametrização podendo ocorrer por empresa, local, controle, parceiro e tipo (próprio do parceiro ou de terceiros).

TGFVAR

Instância que realiza a ligação entre orçamentos e pedidos, pedidos e notas, notas e devoluções. Ela utiliza os campos NUNOTAORIG (número único de origem) e o NUNOTA (número único destino), além dos campos SEQUENCIAORIG e SEQUENCIA.

Ela é utilizada para registrar também os possíveis vários faturamentos parciais que possam ocorrer entre pedidos e notas, como também de notas e devoluções.

Por exemplo, no ato da geração de um pedido de venda, a empresa pode não ter todos os itens no ato da venda e negociar com o cliente o faturamento parcial apenas dos produtos em estoque.

Logo um único pedido pode ser faturado em várias notas de venda, com isso, a TGFVAR terá vários números únicos de destino (vendas) para apenas um número único de origem (o pedido de venda).

Dicas para criação de relatórios

No processo de criação relatórios para parceiros Sankhya, deve-se ter em mente que grande parte não será possível o reaproveitamento, pois existe nuances específicas para cada negócio. Indica-se realizar um levantamento com os usuários que irão utilizar os relatórios, e documentar os detalhes a fim de validar o escopo.

📘

Dica Importante

Em processos comerciais(compra ou venda) é necessário relacionar as condições dos filtros de vendedor, grupo de produtos e parceiros, tendo como requisito funcional a não obrigatoriedade desses filtros.

Na realização de queries para consulta, dentro cláusula WHERE, deve-se colocar a seguinte sequência:

• campo a ser filtrado seguido do operador de igualdade;
• parâmetro seguido do operador booleano OR seguido da condição IS NULL;

Tudo deve ser realizado dentro de parênteses visto que há envolvimento do operador lógico OR.

WHERE
	CAB.DTNEG BETWEEN :PERIODOINI and :PERIODOFIN
	AND (CAB.CODVEND = :CODVEND or :CODVEND IS NULL)🟢🟢🟢
	AND (CAB.CODPARC = :CODPARC or :CODPARC IS NULL)🟢🟢🟢
	AND (PRO.CODGRUPOPROD = :CODGRUPOPROD or :CODGRUPOPROD IS NULL)🟢🟢🟢

📘

Informação Importante

Com o detalhamento dos relacionamentos das tabelas na consulta acima, é possível desenvolver relatórios com as especificidades solicitadas pelos usuários finais do ERP Sankhya.

Como tirar dúvidas?

Para tirar dúvidas e compartilhar informações, use a sala Banco de dados da comunidade Sankhya Developer.