API

Nome Físico: pdp/pdapi002.p

Nome do include com os parâmetros: pdp/pdapi002.i

Versão de integração: 1
Objetivo: tratar os diferentes tipos de alocação dos itens dos pedidos no estoque.

Parâmetros de Entrada

Temp-table – tt-api-param

Atributo Tipo Formato Descrição

Alocacao-pedidos Inte 1-Mantem 2-Aloca 3-Desaloca
L-acomp Logi
H-acomp Handle

Temp-table – tt-aloc-ped-venda:

Atributo Tipo Formato Descrição

I-sequen Inte
Nome-abrev Char X(12) Nome abreviado do cliente
Nr-pedcli Char X(12) Número do pedido do cliente

Index

Índice Tipo
Ch-pedido Primary unique
Nome-abrev
Nr-pedcli

Temp-table – tt-aloc-ped-ent:

Atributo Tipo Formato Descrição

Nome-abrev Char X(12) Nome abreviado do cliente
Nr-pedcli Char X(12) Número do pedido do cliente
Nr-sequencia Inte >>,>>9 Número de seqüência do item no pedido
It-codigo Char X(16) Código do item
Cod-refer Char X(8) Código de referência do item
Nr-entrega Inte >>>>9 Número de seqüência da entrega do item do pedido
Qt-a-alocar Deci

Index
Índice Tipo
Ch-item-ped Primary unique
Nome-abrev
Nr-pedcli
Nr-sequencia
It-codigo
Cod-refer
Nr-entrega

Parâmetros de Saída
Temp-table - tt-erro –

Atributo Tipo Formato Descrição

I-sequen Inte
Cd-erro Inte
Mensagem Char X(255)

Execução

O programa pdp/pdapi002.p irá proceder através das procedures:

Procedures

 Pi-alocacao – procedure principal da API, que através dos parâmetros passados define se o
processo é de alocação ou desalocação e suas diferentes maneiras de alocar ou desalocar o
itens de um pedido.

Parâmetros:
Parâmetro Tipo Formato I O IO Descrição
Tt-api-param Temp-table X
Tt-aloc-ped-venda Temp-table X
Tt-aloc-ped-ent Temp-table X
I-cod-versao-integracao Inte X
Tt-erro Temp-table X

Variáveis:
Variável Tipo Formato Descrição
L-local-acomp Logi
De-qt-a-alocar Deci

- Para cada ‘Entrega do Item do Pedido’ (ped-ent) do ‘Pedido de Venda’ (ped-venda), onde as
‘Entregas do Item Pedido’ (ped-ent.cod-sit-ent) e a ‘Situação Alocação’ (ped-ent.cod-sit-pre)
sejam maior ou igual a 2 irão ser feitas as verificações para o tipo de alocação.

- Deverão ser passados como parâmetros para as procedures de alocação/desalocação

parâmetros o rowid da Entrega do Item do Pedido (ped-ent) e/ou a Quantidade à alocar (de-
qt-a-alocar) e/ou o caracter que corresponde à Alocação ou Desalocação.

- Será retornado OK se não forem encontrados erros na procedure.

 Pi-aloca-conf – esta procedure chama as procedures de alocação ou desalocação para os

produtos configurados.

Parâmetros:
Parâmetro Tipo Formato I O IO Descrição
R-ped-ent Rowid X
C-aloca Char X

Variáveis:
Variável Tipo Formato Descrição
De-qt-a-alocar Deci

Buffers:
Buffer Descrição
B-ped-item Para a tabela ped-item
- Será retornado OK se não forem encontrados erros na procedure.

 Pi-aloca-logica – esta procedure aloca os itens dos pedidos de venda logicamente no

estoque. A alocação lógica consiste em verificar a quantidade do item disponível em estoque
e sua disponibilidade, deduzindo a quantidade já alocada por outros pedidos de venda. O
valor obtido é a quantidade disponível para alocação.

Parâmetros:
Parâmetro Tipo Formato I O IO Descrição
R-ped-ent Rowid X
De-qt-a-alocar Deci X

Variáveis:
Variável Tipo Formato Descrição
De-saldo Deci
L-permite-saldo-neg Log

- Esta API verifica o saldo no estoque e para isso chama a pi-verifica-saldo. A mesma retorna o
saldo que fora calculado da seguinte maneira: de-saldo = de-saldo +
(b-saldo.qtidade-atu -
(b-saldo.qt-alocada +
b-saldo.qt-aloc-ped +
b-saldo.qt-aloc-prod)).
Onde:
Atributo Tipo Formato Descrição
Qtidade-atu Deci ->>>,>>>,>>9.9999 Quantidade Atual
Qt-alocada Deci >>>>,>>9.9999 Quantidade Alocada do item pela preparação do faturamento
Qt-aloc-ped Deci >>>>,>>9.9999 Quantidade alocada do item no pedido
Qt-aloc-prod Deci >>>>,>>9.9999 Quantidade alocada do item na produção

- Se o parâmetro retornar saldo insuficiente no estoque três erros do EMS poderão se

enviados à tt-erro:

Erro Mensagem Help

18348 O item &1 não possui saldo
disponível para alocação
18294 Quantidade da seqüência &2 do A alocação lógica da seqüência &2 do pedido &1 não será efetuada, pois o
pedido &1 não será alocada saldo disponível para o item &3 no estoque é inferior à quantidade a alocar, e
não é permitida alocação parcial segundo o tipo de atendimento do item do
pedido e/ou dos parâmetros do módulo de pedidos
18327 Item foi alocado parcialmente O item &1 (Cliente &2 Pedido Cliente &3) sofreu alocação parcial, pois a
quantidade disponível era inferior à quantidade a alocar

- Será retornado OK se não forem encontrados erros na procedure.

 Pi-desaloca-logica - esta procedure desaloca os itens dos pedidos de venda logicamente no

estoque.

Parâmetros:
Parâmetro Tipo Formato I O IO Descrição
R-ped-ent Rowid X
De-qt-a-desalocar Deci X

- Será retornado OK se não forem encontrados erros na procedure.

 Pi-aloca-fisica-aut – esta procedure possibilita a reserva real do estoque do produto acabado

a um determinado pedido de venda. Este tipo de alocação requer que todos os dados, que
identificam o item no saldo em estoque, sejam considerados: o item, a referência, lote. E por
ser automática indica que a ordem de produção informada no pedido de venda será
 reportada automaticamente, e a alocação da ordem de produção, para o item em questão,
será efetuada por meio do método FIFO.

Parâmetros:
Parâmetro Tipo Formato I O IO Descrição
R-ped-ent Rowid X
De-qt-a-alocar Deci X

Variáveis:
Variável Tipo Formato Descrição
De-qt-aloc-man Deci
De-saldo Deci
C-estab-ped Char
C-estab-prin Char

- Será retornado OK se não forem encontrados erros na procedure.

 Pi-aloca-fisica-man – esta procedure também possibilita a reserva real do estoque do

produto acabado a um determinado pedido de venda. Este tipo de alocação requer que
todos os dados, que identificam o item no saldo em estoque, sejam considerados: o item, a
referência, lote. Porém por ser de forma manual indica que o processo de alocação on-line
de pedidos de venda é efetuado manualmente pelo usuário desde que este possua
permissão para alocar os pedidos de venda.

Parâmetros:
Parâmetro Tipo Formato I O IO Descrição
R-ped-ent Rowid X
De-qt-a-alocar Deci X
r-saldo-estoq Rowid X

Variáveis:
Variável Tipo Formato Descrição
De-saldo Deci
De-valor-a-maior Deci
De-quant-aux Deci

- A partir da release do EMS204 será validado o percentual a ser faturado a mais na

seqüência do pedido. Esta validação é feita no campo perc-fat-ped da tabela emitente.

- Será retornado OK se não forem encontrados erros na procedure.

 Pi-desaloca-fisica-aut - esta procedure desaloca os itens dos pedidos de venda fisicamente

no estoque e todo o processo de desalocação on-line de pedidos de venda é efetuado sem
que haja interação com o usuário do Datasul-EM

Parâmetros:
Parâmetro Tipo Formato I O IO Descrição
R-ped-ent Rowid X
De-qt-a-alocar Deci X

Variáveis:
Variável Tipo Formato Descrição
De-saldo Deci

- Será retornado OK se não forem encontrados erros na procedure.

 Pi-desaloca-fisica-man - esta procedure desaloca os itens dos pedidos de venda fisicamente
no estoque e o processo de desalocação on-line de pedidos de venda é efetuado
manualmente pelo usuário.

Parâmetros:
Parâmetro Tipo Formato I O IO Descrição
R-ped-ent Rowid X
De-qt-a-alocar Deci X
R-saldo-estoq Rowid X

Variáveis:
Variável Tipo Formato Descrição
De-saldo Deci

- Será retornado OK se não forem encontrados erros na procedure.

 Pi-validacao – esta procedure irá receber como parâmetro de entrada o rowid do item do
pedido e validará o mesmo chamando as procedures pi-param, a pi-valida-pedido e a pi-
valida-item. Se o retorno das três for ‘OK’, a procedure também retornará um OK no seu
final.

Parâmetros:
Parâmetro Tipo Formato I O IO Descrição
R-ped-item Rowid X

Variáveis:
Variável Tipo Formato Descrição
De-qt-a-alocar Deci

Buffers:
Buffer Descrição
B-ped-item Para a tabela ped-item

 Pi-verifica-saldo – esta procedure irá verificar o saldo em estoque para alocação de itens dos
pedidos.

Parâmetros:
Parâmetro Tipo Formato I O IO Descrição
C-it-codigo Char X
C-cod-refer Char X
C-cod-estabel Char X
Dt-entrega Date X
De-saldo Deci X

Variáveis:
Variável Tipo Formato Descrição
C-grupo-aloc Char

Buffers:
Buffer Descrição
B-estab Para a tabela estabelec
B-item Para a tabela item
B-saldo Para a tabela saldo-estoq
B-res-item Para a tabela res-item
B-deposito Para a tabela deposito

 Pi-retorna-erro – esta procedure irá retornar os erros quando o programa chamador não
executa a pi-alocacao.
 Parâmetros:
Parâmetro Tipo Formato I O IO Descrição
Tt-erro Temp-table X