Árvore de páginas

Documento de BO

Produto:

Datasul

Ocorrência:

Documentação de BO

Nome Físicodibo/bodi233q02.p

 

RecordSet

 

Tabela principal utilizada para comunicação dos métodos da BO com o mundo externo e suas respectivas definições.

Descontos

Atributo

Tipo

Formato

Descrição

Obr.

cod-cond-pag        

inte    

>>9           

Código Condição Pagamento

 

cod-emitente        

inte    

>>>>>>>>9     

Código Cliente

 

it-codigo           

char    

x(16)

Código Item

 

cod-refer           

char    

x(8)

Código Referência

 

cod-rep             

inte    

>>>>9         

Código Representante

 

fm-codigo           

char    

x(8)

Código Família

 

fm-cod-com          

char     

x(8)

Código Família Comercial

 

cdn-cliente-matriz  

inte    

>>>>>>>>9     

Código do cliente matriz

 

nome-ab-reg         

char    

x(12)

Região

 

situacao            

inte    

>9            

Situação do desconto

 

qt-minima           

deci-4  

>>>,>>>,>>9.999

Quantidade mínima

 

vl-desconto         

deci-2  

>>,>>9.99     

Valor do desconto

 

perc-desconto       

deci-2  

>>9.99        

Percentual de desconto

 

ind-frete           

inte    

>9            

Tipo de frete

 

cod-canal-venda     

inte    

>>9           

Código do canal de venda

 

char-1              

char    

x(100)

 

 

char-2              

char    

x(100)

 

 

dec-1               

deci-8  

->>>>>>>>>>>9.9

 

 

dec-2               

deci-8  

->>>>>>>>>>>9.9

 

 

int-1               

inte    

->>>>>>>>>9   

 

 

int-2               

inte    

->>>>>>>>>9   

 

 

log-1               

logi    

Sim/Não       

 

 

log-2               

logi    

Sim/Não       

 

 

data-1              

date    

99/99/9999    

 

 

data-2              

date    

99/99/9999    

 

 

cod-desconto        

inte    

>,>>>,>>>,>>9 

Campo interno para controlar qual desconto foi aplicado no pedido/nota fiscal/cotação

Sim

check-sum           

char    

x(20)

 

 

dat-ult-atualiz     

date    

99/99/9999    

Data da última atualização do desconto

 

cod-usuario-atualiz 

char    

x(12)

Código do usuário da última atualização

 

hra-ult-atualiz     

char    

x(8)

Hora da última atualização

 

dat-ini-val         

date    

99/99/9999    

Data de inicio de validade

Sim

val-faturamento     

deci-2  

>>>,>>>,>>>,>>9

Volume de faturamento que deve ser verificado para

concessão ou não de descontos - verificado nas estatísticas de faturamento (tabela fat-estat) pela quantidade de meses parametrizada no módulo

 

dat-fim-validade    

date    

99/99/9999    

Data de fim de validade

Sim

cdn-desconto-pgto   

inte    

>>,>>>,>>9    

Código do desconto por prazo de pagamento

 

cdn-desconto-periodo

inte    

>>,>>>,>>9    

Código do desconto por período

 

log-concede-bonif-qtd

logi    

Sim/Não       

Indica se será concedida bonificação em quantidade, ou seja, se a quantidade vendida deste item implicará em bonificação de um outro item numa quantidade proporcional a essa

 

val-desconto        

deci-5[5]

>>>,>>>,>>9.999

Desconto Período Descontos da tabela de descontos, em percentual ou valor, conforme parâmetros do módulo.

Descontos parametrizados (de 1 a 5) da tabela de descontos

Sim

cod-moeda           

inte    

>9            

Código da moeda

 

cod-produto-coml    

char    

x(16)

Código do produto comercial

 

 

RecordSet

 

Temp Tables auxiliares

 

Temp Table com todos os registros de descontos encontrados, que correspondem a desc-ped-item. Pode conter várias registros.

 

tt-desc-ped-item

Atributo

Tipo

Formato

Descrição

cod-desconto       

Integer

>,>>>,>>>,>>9

Código Desconto

val-desconto

Decimal

>>>,>>>,>>9.99999

Valor Desconto

val-pct-desc-periodo

Decimal

->9.999

Valor Percentual Desconto Período

val-pct-desc-prazo

Decimal

.>9.999

Valor Percentual Desconto Prazo

log-concede-bonif-qtd

Logical

Sim/Não

Concede Bonificação

 

Temp table com os resultados dos descontos tratados conforme politica (melhor,cascata,somatoria).   Contém apenas um registro, com o resultado final.

 

tt-resultado-desconto

Atributo

Tipo

Formato

Descrição

val-desconto

Decimal

>>>,>>>,>>9.99999

Valor Desconto

val-pct-desc-periodo

Decimal

->9.999

Valor Percentual Desconto Período

val-pct-desc-prazo

Decimal

.>9.999

Valor Percentual Desconto Prazo

log-concede-bonif-qtd

Logical

Sim/Não

Concede Bonificação

val-pct-bonif

Decimal

->9.999

Valor Percentual Bonificação

 

Temp table com os descontos encontrados no for each da bodi233.p . Será usada para chamar outras procedures, principalmente na bodi233b.

 

tt-descontos-encontrados

Atributo

Tipo

Formato

Descrição

cod-desconto

Integer

>,>>>,>>>,>>9

Código Desconto

val-desconto

Decimal

>>>,>>>,>>9.99999

Valor Desconto

val-pct-desc-periodo

Decimal

.>9.999

Valor Percentual Desconto Periodo

val-pct-desc-prazo

Decimal

.>9.999

Valor Percentual Desconto Prazo

log-concede-bonif-qtd

Logical

Sim/Não

Concede Bonificação

cod-moeda

Integer

>9

Código Moeda

 

Temp-table que será usada na procedure pesquisarDescontoTabelaDesconto no bodi233.p e em todos os lugares onde é chamado o PD0508r.p. Essa temp-table passa os parâmetros vindos do pedido e da nota fiscal.

 

Atributo

Tipo

Formato

Descrição

p-cod-emitente

inte    

>>>>>>>>9     

Código Cliente

p-nome-ab-cli

char

X(12)

Nome Abreviado Cliente

p-it-codigo

char    

x(16)

Código Item

p-fm-cod-com

char    

x(8)

Código Família Comercial

p-cod-canal-venda

inte    

>>9           

Código do canal de venda

p-cod-produto

char    

x(16)

Código do Produto

p-cdn-cliente-matriz

inte    

>>>>>>>>9     

Código do cliente matriz

p-fm-codigo

char    

x(8)

Código Família

p-cod-cond-pag-cli

integer

>>9

Código Condição Pagamento Cliente

p-cod-cond-pag-ped

integer

>>9

Código Condição Pagamento Cliente

p-cod-rep

inte    

>>>>9         

Código Representante

p-nome-ab-reg

char     

x(12)

Região

p-cod-refer

char    

x(8)

Código Referência

p-ind-frete

inte    

>9            

Tipo de frete

p-qt-minima

deci-4  

>>>,>>>,>>9.999

Quantidade mínima

p-val-faturamento

deci-2  

>>>,>>>,>>>,>>9

Volume de faturamento

p-cod-moeda

inte    

>9            

Código da moeda

p-dt-validade

date    

99/99/9999    

Data de Validade

 

Métodos Negócio

 

 Métodos adicionais de atualização e acesso a base de dados.

 

 

Método: 

CalcularDescontoFinal

 

Descrição: 

Método que recebe uma temp table (tt-descontos-processados) . Essa temp table pode vir da bodi233.p, onde existe um for each de descontos ou pode vir de outro programa onde os valores dessa tabela sofreram alterações pelo usuário. Os resultados serão gravados em duas tabelas : a tt-resultado-desconto que contém a somatoria , ou cascata ou melhor dos descontos ( terá sempre um só registro , com os valores já calculados ) ; a tt-desc-ped-item contém o nr do desconto encontrado e seus valores ( pode conter vários registros ) .

 

Requisitos:

Nenhum

 

Parâmetros:

Parâmetro

Tipo

Formato

I

O

IO

Descrição

tt-descontos-encontrados

Temp table

 

X

 

 

Temp table com descontos que serão processados.

tt-param-desconto

Temp Table

 

X

 

 

Temp table com parâmetros ( usado para melhor desconto ).

tt-desc-ped-item

Temp Table

 

 

X

 

Temp table com o melhor/cascata/somatória de cada desconto (Um registro).

tt-resultado-desconto

Temp Table

 

 

X

 

Temp table com os descontos processados (corresponde a desc-ped-item).

 

 

Método: 

encontrarDescontoPeriodo

 

Descrição: 

Método usado para encontrar o desconto período.

 

Requisitos: 

Nenhum

 

Parâmetros:

Parâmetro

Tipo

Formato

I

O

IO

Descrição

p-dat-validade

date

 

X

 

 

Data entrega ou Data de Implantação, conforme param do modulo.

p-cdn-desconto-periodo

integer

 

X

 

 

Código do desconto do Período.

p-percentual

decimal

 

 

X

 

Contém o percentual de desconto encontrado nessa procedure.

 

 

Método: 

encontrarDescontoPrazo

 

Descrição: 

Método usado para encontrar o percentual de desconto do prazo.

 

Requisitos:

Nenhum

 

Parâmetros:

Parâmetro

Tipo

Formato

I

O

IO

Descrição

p-cod-cond-

pag-cli

integer

 

X

 

 

Condição de pagamento do emitente.

p-cod-cdn-pag-ped

integer

 

X

 

 

Condição de pagamento pedido.

p-cdn-desconto-periodo

integer

 

X

 

 

Código desconto prazo.

p-dat-validade

date

 

X

 

 

Data de entrega ou de implantação, conforme parâmetros do modulo.

p-percentual

decimal

 

 

X

 

Percentual desconto prazo encontrado.