Linha Datasul

Árvore de páginas

Documento de BO

Produto:

Datasul

Ocorrência:

Documentação de BO

Nome Físicodibo/bodi154.p

 

RecordSet

 

Temp-Table principal utilizada para utilização dos métodos da BO e suas respectivas definições.

Itens do Pedido de Venda

Atributo

Tipo

Formato

Descrição

Obr.

Nome-abrev

char

x(12)

Cliente

Sim

nr-pedcli

char

x(12)

Pedido Cliente

Sim

nr-sequencia

int

>>,>>9

Seqüência

 

it-codigo

char

x(16)

Código do Item

Sim

nr-ordem

int

Zzzzz9.99

Número da Ordem de Compra (Internacional)

 

parcela

int

>9

Parcela da Ordem de Compra (Não é utilizado)

 

dt-entorig

date

99/99/9999

Data de Entrega Original

Sim

dt-entrega

date

99/99/9999

Data de Entrega

Sim

dt-canseq

date

99/99/9999

Data de Cancelamento

 

desc-cancela

char

x(2000)

Motivo de Cancelamento

 

dt-reativ

date

99/99/9999

Data de Reativação

 

dt-suspensao

data

99/99/9999

Data de Suspensão

 

qt-pedida

dec

>>>>,>>9.9999

Quantidade Pedida

Sim

qt-atendida

dec

>>>>,>>9.9999

Quantidade Atendida

 

qt-pendente

dec

>>>>,>>9.9999

Quantidade Pendente

 

qt-devolvida

dec

>>>>,>>9.9999

Quantidade Devolvida

 

dt-devolucao

date

99/99/9999

Data de Devolução

 

desc-devol

char

x(2000)

Motivo de Devolução

 

vl-pretab

dec

>>>,>>>,>>9.999

Preço da Tabela

Sim

vl-preori

dec

>>>,>>>,>>9.999

Preço Original

Sim

vl-preuni

dec

>>>,>>>,>>9.999

Preço Líquido

Sim

per-des-item

dec

->>9.99999

Percentual de Desconto

 

per-minfat

dec

>9.99

Percentual Mínimo de Faturamento Parcial

 

cod-sit-item

int

99

Situação

 

user-impl

char

x(12)

Usuário de Implantação

 

dt-userimp

date

99/99/9999

Data de Implantação

 

user-alte

char

x(12)

Usuário da última alteração

 

dt-useralt

date

99/99/9999

Data da última alteração

 

user-canc

char

x(12)

Usuário do Cancelamento

 

dt-usercan

date

99/99/9999

Data do Cancelamento

 

user-reat

char

x(12)

Usuário de Reativação

 

dt-usserrae

date

99/99/9999

Data de Reativação

 

user-devol

char

x(12)

Usuário de Devolução

 

dt-userdev

date

99/99/9999

Data de Devolução

 

user-susp

char

x(12)

Usuário de Suspensão

 

dt-usersusp

date

99/99/9999

Data de suspensão

 

aliquota-ipi

dec

>>9.99

Alíquota de IPI

 

ind-icm-ret

log

yes/no

Indicador de Retenção do ICMS na Fonte

 

vl-merc-abe

dec

>>>>,>>>,>>9.99

Valor de Mercado

 

vl-liq-it

dec

>>>>,>>>,>>9.99

Valor Total Líquido

 

vl-liq-abe

dec

>>>>,>>>,>>9.99

Saldo Líquido

 

vl-tot-it

dec

>>>>,>>>,>>9.99

Valor Total

 

nr-tabpre

char

x(8)

Tabela de Preços

 

tp-preco

int

99

Tipo de Preço

 

per-des-icms

dec

->>9.999

Percentual de Desconto do ICMS

 

nat-operacao

char

x(6)

Natureza de Operação

Sim

tipo-atend

int

99

Tipo de Atendimento

Sim

observacao

char

x(2000)

Observações

 

ind-componen

int

99

Tipo de Item

Sim

qt-fatenf

dec

>>>>,>>9,9999

 

 

cod-refer

char

x(8)

Código da Referência

 

qt-transfer

dec

>>,>>>,>>9.9999

 

 

desc-txt

char

x(50)

 

 

qt-alocada

dec

>>>>,>>9.9999

Quantidade Alocada

 

cod-sit-pre

int

99

Situação Alocação

 

dt-max-fat

date

99/99/9999

Data de Limite Máximo para Faturamento

 

tp-aloc-lote

int

99

 

 

dt-min-fat

date

99/99/9999

Data de Limite Mínimo para Faturamento

 

esp-ped

int

99

Espécie de Pedido

 

perc-fornec

dec

>>9.99

 

 

qt-lote-min

dec

>>>,>>>,>>9.9999

 

 

cd-freq

int

>>9

 

 

nr-progcli

char

x(12)

 

 

nr-versao

int

>>9

 

 

cod-entrega

char

x(12)

Código do Local de Entrega

Sim

cd-origem

int

99

Origem do Pedido

 

nivel-restituicao

char

!

 

 

pc-restituicao

dec

>>9.99

 

 

vl-pauta

dec

>>>>,>>>,>>9.99

 

 

qt-log-aloca

dec

>>>>,>>9.9999

Quantidade Lógica/Física a Alocar

 

tp-adm-lote

int

99

 

 

ind-fat-qtfam

log

yes/no

Faturamento na Unidade de Medida da Família

 

config-alter

log

yes/no

 

 

nr-config

int

>>>,>>>,>>9

 

 

cons-mrp

log

yes/no

 

 

cons-pmp

log

yes/no

 

 

nr-ord-produ

int

>>>>>9

 

 

nr-programa

int

>>>,>>>,>>9.9999

 

 

qt-trans-mp

dec

>>>>,>>9.9999

 

 

log-ordens-emitidas

log

yes/no

 

 

aloca-canc-saldo

log

yes/no

 

 

aliquota-tax

dec

>>9.99

 

 

cod-isencao

int

>>9

 

 

cod-tax

int

>>9

 

 

cod-vat

int

>>9

Código do Imposto

 

aliquota-iva

int

>>9.99

Alíquota de IVA

 

qt-ordens

dec

>>>>,>>9.9999

 

 

char-1

char

x(100)

 

 

char-2 pos. 01 - 08

char

x(08)

Classificação fiscal

 

char-2 pos. 09 - 10

char

x(02)

Unidade de Medida

 

char-2 pos. 11- 27

char

x(17)

Conta Contábil de Aplicação

 

char-2 pos. 29 - 40

char

x(12)

Custo Contábil

 

dec-1

dec

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

Quantidade Simulada (Embarque)

 

dec-2

dec

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

Alíquota de ISS

 

int-1

int

->>>>>>>>>9

 

 

int-2

int

->>>>>>>>>9

 

 

log-1

log

yes/no

 

 

log-2

log

yes/no

 

 

data-1

date

99/99/9999

 

 

data-2

date

99/99/9999

 

 

vl-desconto

dec

>>,>>9.99999

 

 

cod-cond-esp

int

>>9

 

 

cod-sit-com

int

99

Situação Cotas

 

motivo-alt-sit-cota

char

x(2000)

Motivo Alteração Cotas

 

dat-alter-sit

date

99/99/9999

Data de Alteração Cotas

 

cod-usu-alt-sit

char

x(12)

Usuário Alteração Cotas

 

check-sum

char

x(20)

 

 

log-usa-tabela-desconto

log

yes/no

Usar Tabela de Descontos

 

val-pct-desconto-tab-prec

dec

->9.99999

Percentual de Desconto da Tabela de Preços

 

des-pct-desconto-inform

char

x(50)

Desconto em Percentual Informado

 

val-desconto-inform

dec

>>>,>>>,>>9.99

Desconto em Valor Informado

 

val-pct-desconto-total

dec

->>9.99

Total de Descontos em Valor

 

log-concede-bonif-qtde

log

yes/no

Concede Bonificação pela Quantidade

 

val-pct-bonif

dec

->>9.99

 

 

val-pct-desconto-periodo

dec

->9.999

Percentual de Desconto por Período

 

val-pct-desconto-prazo

dec

->9.999

Percentual de Desconto por Valor

 

val-desconto-total

dec

>>>,>>>,>>9,99

Total de Descontos

 

val-desconto-bonif

dec

>>>,>>>,>>9,99

Total de Bonificações

 

num-sequencia-bonif

int

>>,>>9

Seqüência do Pedido de Origem da Bonificação

 

val-desconto

dec[5]

>>>,>>>,>>9.999

Descontos

 

qt-un-fat

dec

>>>>,>>9.9999

 

 

vl-preori-un-fat

dec

>>>,>>>,>>9.999

 

 

cod-mot-canc-cot

int

>>9

 

 

user-aprov-cot

char

x(12)

Usuário de Aprovação da Cotação

 

dt-aprov-cot

date

99/99/9999

Data de Aprovação da Cotação

 

user-lib-cot

char

x(12)

Usuário de Liberação da Cotação

 

dt-lib-cot

date

99/99/9999

Data de Liberação da Cotação

 

cod-sit-preco

int

99

Situação do Item na Administração de Preços

 

user-preco

char

x(12)

Usuário de Aprovação do Preço

 

dat-aprov-preco

date

99/99/9999

Data de Aprovação do Preço

 

desc-lib-preco

char

x(76)

Descrição da Liberação do Preço

 

ind-drop-shipment

log

yes/no

Utiliza Drop Shipment (Internacional)

 

 

Métodos Básicos

 

Métodos básicos de acesso ao banco de dados.

 

 

Método:

goToKey

 

Descrição: 

Reposiciona o registro da tabela ped-item através de sua chave primária (ch-item-ped).

 

Requisitos: 

Nenhum

 

Parâmetros:

Parâmetro

Tipo

Formato

I

O

IO

Descrição

c-nome-abrev

char

x(12)

X

 

 

nome abreviado do cliente do item do pedido

c-nr-pedcli

char

x(12)

X

 

 

número do pedido do cliente

i-nr-sequencia

int

 

X

 

 

número da seqüência do item do pedido

c-it-codigo

char

x(16)

X

 

 

código do item

c-cod-refer

char

 

X

 

 

código da referência do item

 

 

Método:

destroyBO

 

Descrição:

Deve ser executado antes da finalização da BO (delete procedure <handle da BO>.) quando dela forem utilizados os métodos de inclusão, alteração ou eliminação de itens do pedido de venda.

 

Queries e Constraints

 

Definição das Queries (acesso ao banco de dados) e Contraints (regras de leitura)  utilizadas para buscar grupos de registros da base de dados.

 

 

Método:

openQuerybyCh-item-ped

 

Descrição:

Disponibiliza os itens do pedido, fazendo um filtro por faixa. O filtro é composto de todos os campos chaves da tabela de item do pedido.

 

Constraints Associados:

setConstraintbyCh-item-ped

 

 

Método:

setConstraintbyCh-item-ped

 

Descrição: 

Solicita informações relacionadas a chave do item do pedido.

 

Parâmetros:

Parâmetro

Tipo

Formato

I

O

IO

Descrição

Pcnomeabrevini

Char

x(12)

X

 

 

Nome abreviado do cliente do item do pedido (inicial)

Pcnomeabrevfim

Char

x(12)

X

 

 

Nome abreviado do cliente do item pedido (final )

pCNrPedcliIni

Char

x(12)

X

 

 

Número do item do pedido (inicial)

PCNrPedclifim

Char

x(12)

X

 

 

Número do item do pedido ( final )

pINrSequenciaIni

Int

99999

X

 

 

Seqüencia do item do pedido (inicial)

PINrSequenciafim

Int

99999

X

 

 

Seqüencia do item do pedido (finall)

PCItCodigoIni

Char

X(16)

X

 

 

Item do pedido (inicial)

PCItCodigofim

Char

X(16)

X

 

 

Item do pedido (final )

PCCodReferIni

Char

X(8)

X

 

 

Referência do Item do pedido (inicial)

PCCodReferfim

Char

X(8)

X

 

 

Referência do Item do pedido (final)

 

 

Método:

OpenQueryDefault

 

Descrição:

Disponibiliza os itens do pedido.

 

Constraints Associados:

SetConstraintDefault

 

Descrição: 

Não tem nenhuma solicitação.

 

Parâmetros:

Parâmetro

Tipo

Formato

I

O

IO

Descrição

Nenhum

 

 

 

 

 

 

 

 

Método:

openQueryKey

 

Descrição:

Disponibiliza os itens do pedido relacionados a um pedido.

 

Constraints Associados:

setConstraintKey

 

 

Método:

setConstraintKey

 

Descrição:

Solicita informações relacionadas ao pedido de venda dos itens.

 

Parâmetros:

Parâmetro

Tipo

Formato

I

O

IO

Descrição

c-nome-abrev

Char

x(12)

X

 

 

Nome abreviado do cliente do pedido.

c-nr-pedcli

Char

x(12)

X

 

 

Número do pedido do cliente.

p-nr-sequencia

Int

99999

X

 

 

Seqüência do item do pedido.

p-it-codigo

Char

X(16)

X

 

 

Item do pedido.

p-cod-refer

Char

X(8)

X

 

 

Referência do item do pedido.

 

 

Método:

openQueryMain

 

Descrição:

Disponibiliza os itens do pedido.

 

Constraints Associados:

Nenhum.

 

 

Método:

openQueryOrderItems

 

Descrição:

Disponibiliza os itens do pedido relacionados a um pedido, permitindo um filtro pela sua situação.                                         

 

Constraints Associados:

setConstraintOrderItems

 

 

Método:

setConstraintOrderItems

 

Descrição: 

Solicita informações relacionadas ao pedido de venda dos itens, permitindo um filtro pela sua situação.

 

Parâmetros:

Parâmetro

Tipo

Formato

I

O

IO

Descrição

c-nome-abrev

Char

x(12)

X

 

 

Nome abreviado do cliente do pedido

c-nr-pedcli

Char

x(12)

X

 

 

Número do pedido do cliente

c-lista-situacao

Char

x(30)

X

 

 

Situações dos itens do pedido. Criar uma string com as situações dos itens separadas por vírgula, onde:

1 – Aberto

2 – Atendido Parcial

3 – Atendido Total

5 – Suspenso

6 – Cancelado

ex.: “1,2” para trazer os itens abertos ou atendidos parcialmente.

 

 

Método:

openQueryRowid

 

Descrição:

Busca um item do pedido a partir do rowid do registro passado como parâmetro.

 

Constraints Associados:

setconstraintRowid

 

 

Método:

setconstraintRowid

 

Descrição: 

Recebe o parâmetro da tabela ped-item.

 

Parâmetros:

Parâmetro

Tipo

Formato

I

O

IO

Descrição

rw-ped-item

Rowid

 

X

 

 

Rowid da tabela ped-item



Método:

openQueryToPedVenda

 

Descrição:

Disponibiliza os itens do pedido relacionados a um pedido.

 

Constraints Associados:

Nenhum.

 

Métodos Negócio

 

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

 

 

Método: 

AllocateItem                                       

 

Descrição: 

Método que aloca as quantidades do item do pedido em estoque.

 

Requisitos: 

Nenhum.

 

Parâmetros:

Parâmetro

Tipo

Formato

I

O

IO

Descrição

p-row-ped-item

Rowid

 

X

 

 

Rowid da tabela ped-item, para a qual será feita a alocação.

De-qt-desalocar

Dec

 

X

 

 

Caso tenha alguma quantidade que deve ser desalocada, deve ser informada nesse campo.

RowErros

Table (rowErrros)

 

 

X

 

Temp table com os possíveis erros encontrados no processo.

 

 

Método: 

converteValorQt

 

Descrição: 

Método que aloca as quantidades do item do pedido em estoque.

 

Requisitos: 

Nenhum.

 

Parâmetros:

Parâmetro

Tipo

Formato

I

O

IO

Descrição

p-row-ped-item

Rowid

 

X

 

 

Rowid da tabela ped-item, para a qual será feita a alocação.

De-qt-desalocar

Dec

 

X

 

 

Caso tenha alguma quantidade que deve ser desalocada, deve ser informada nesse campo.

RowErros

Table (rowErrros)

 

 

X

 

Temp table com os possíveis erros encontrados no processo.

 

 

Método: 

createMPLog

 

Descrição: 

Método para indicar se deve ou não ser gerado transação de multiplanta. Exemplo : se a DBO bodi154 estiver sendo chamada para criar um item do pedido de venda, deve gerar log. Mas se estiver sendo chamada para efetivar os log de multiplanta, não deve gerar log novamente.

 

Requisitos: 

Nenhum

 

Parâmetros:

Parâmetro

Tipo

Formato

I

O

IO

Descrição

PgerarLogMP

Log

Yes;no

X

 

 

Indica se deve ou não gerar log de multiplanta.

 


Método: 

inputRowDescPedItem

 

Descrição: 

Método complementar ao de criação/alteração de registros que deve ser executado para passar as eventuais ocorrências de registros de descontos do item do pedido.

 

Requisitos: 

Nenhum

 

Parâmetros:

Parâmetro

Tipo

Formato

I

O

IO

Descrição

tt-desc-ped-item

table (bodi269.i)

 

X

 

 

Tabela com os descontos do item do pedido

 

 

Método: 

inputRowObject

 

Descrição: 

Método que recebe a temp-table da tabela ped-item na BO.

 

Requisitos:

Nenhum.

 

Parâmetros:

Parâmetro

Tipo

 Formato

I

O

IO

Descrição

tt-ped-item

table (dibo154.i)

 

X

 

 

Tabela de Itens do Pedidos de Venda

 

 

Método: 

inputRowParam

 

Descrição: 

Método complementar ao de criação/alteração de registros que deve ser executado para passar os parâmetros de criação/alteração de itens do pedido.

 

Requisitos: 

Nenhum

 

Parâmetros:

Parâmetro

Tipo

Formato

I

O

IO

Descrição

tt-ped-param

table (bodi159.i2)

 

X

 

 

Tabela com os parâmetros do item do pedido

 

Definição Tabela:

Itens do Pedido de Venda

Atributo

Tipo

Formato

Descrição

Obr.

relacao-item-cli

log

yes/no

Utiliza relação item x cliente (item-cli)

Sim

tp-relacao-item-cli

int

9

Tipo da geração da relação item x cliente (item-cli)

Sim

qtde-un-medida-cli

log

yes/no

Informar quantidade dos itens na unidade de medida do cliente

Sim

Multiplicar-qtde

log

yes/no

Multiplicar quantidade de componentes pela quantidade do item composto

Sim

atribuir-preco-comp

log

yes/no

Atribuir total dos preços dos itens componentes ao preço do item composto

Sim

 

 

 

 

 

tp-exp-nat-oper

int

9

Exportar natureza para os itens, quando for alterada no pedido.

Sim

tp-exp-dt-entrega

Int

9

Exportar data de entrega para os itens, quando for alterada no pedido.

Sim

exp-nat-cons-final

log

yes/no

Exporta código da mensagem da nova natureza de operação informada

Sim

exp-nat-cod-mensagem

log

yes/no

 

Sim

Atualizar-entregas

Log

Yes/no

 

Sim

Arredondar-qtde-lote

Log

Yes/no

 

Sim

gerar-proc-exp

Log

Yes/no

 

Sim

Itinerario

Log

Yes/no

 

Sim

 

 

Método: 

setNewDeliveryNumber

 

Descrição: 

Método que retorna o próximo número de entrega (incrementado 10 ao último cadastrado) disponível da tabela ped-ent (Entrega) de um determinado item do pedido.

 

Requisitos: 

Executar método inputRowParam.

 

Parâmetros:

Parâmetro

Tipo

 Formato

I

O

IO

Descrição

p-nr-entrega

int

>>9

 

X

 

Número da Entrega

 

 

Método: 

unallocateItem

 

Descrição: 

Método que desaloca as quantidades do item do pedido em estoque.

 

Requisitos:

Nenhum.

 

Parâmetros:

Parâmetro

Tipo

 Formato

I

O

IO

Descrição

p-row-ped-item

Rowid

 

X

 

 

Rowid da tabela ped-item, para o qual será feita a desalocação da quantidade no estoque.