Árvore de páginas

Documento de API

Produto:

Datasul

Ocorrência:

Documentação de API

Nome Físicocpp/cpapi004.p

 

Objetivo:

Efetuar reportes da produção, sendo responsável pela entrada do produto acabado no estoque, dar baixa na matéria-prima utilizada para a produção destes itens e ainda efetuar transações específicas ao reporte tais como a geração de refugo e fichas de controle de qualidade.

 

Considerações Gerais:

 

-          Na temp-table tt-rep-pto deverão ser enviadas as informações principais do reporte tais como as quantidades reportadas e refugadas por ponto de controle e depósito e localização de saída dos componentes. Nesta temp-table também deverão ser enviados os apontamentos de mão-de-obra caso se esteja reportando pelo real a mão-de-obra empregada na ordem.

-          A temp-table tt-refugo deverá possuir informações quando se deseja caracterizar produção de peças com defeito, sendo que a quantidade de refugos não incrementará o saldo em estoque do item.

-          Quando for necessário fazer a entrada em estoque de itens caracterizados como Sobra, Co-produtos ou mesmo Retorno de Requisição, deve ser alimentada a temp-table tt-res-neg.

 

Parâmetros de Entrada

 

Temp-table tt-rep-pto : Temp-table que vai possuir toda a caracterização do reporte do ponto de controle.

 

TEMP-TABLE tt-rep-pto

Atributo

Tipo

Formato

Valor Inicial

Nr-ord-prod

Integer

>>>,>>>,>>9

0

Linha

Integer

>>9

0

It-codigo

Char

X(16)

 

Dep-sai-comp

Char

X(3)

 

Loc-sai-comp

Char

X(10)

 

Data-fabric

Date

99/99/9999

 

Qt-reportada

Decimal

>>>>>,>>9.9999

0

Qt-refugada

Decimal

>>>>>,>>9.9999

0

Ct-refugo

Char

X(8)

 

Sc-refugo

Char

X(8)

 

Ct-codigo

Char

X(8)

 

Sc-codigo

Char

X(8)

 

Qt-apr-cond

Decimal

>>>>>,>>9.9999

0

Nro-docto

Char

X(12)

 

Serie-docto

Char

X(5)

 

Cod-depos

Char

X(3)

 

Cod-localizacao

Char

X(10)

 

Lote-serie

Char

X(10)

 

Cod-refer

Char

X(8)

 

Dt-vali-lote

Date

99/99/99999

 

Estado

Integer

>9

1

Op-final

Logical

Yes/No

No

Tp-relogio

Char

9

 

Hora-ini

Integer

9999

 

Min-ini

Integer

99

 

Hora-fim

Integer

9999

 

Min-fim

Integer

99

 

Tempo

Decimal

>>>,>>9.9999

0

Tempo-ini

Decimal

>>>,>>9.9999

0

Tempo-fim

Decimal

>>>,>>9.9999

0

Referencia

Char

x(10)

 

Matr-func

Integer

99999

0

Ponto-contr

Integer

>>9

0

Reserva

Logical

Padrão/Arquivo

Padrão

Tipo-custo

Integer

9

0

 

Temp-table tt-refugo: armazena informações referentes a peças refugadas e aprovadas condicionalmente com a sua devida característica de rejeição.

 

TEMP-TABLE TT-REFUGO

Atributo

Tipo

Formato

Valor Inicial

Nr-ord-prod

Integer

>>>,>>>,>>9

0

Codigo-rejei

Integer

>>9

0

Qt-refugada

Decimal

>>>>>,>>9.9999

0

Observação

Char

x(40)

 

 

Temp-table tt-res-neg : possibilita a geração de movimentações como Co-produtos, Sobra e Retorno de Requisição.

 

TEMP-TABLE tt-res-neg

Atributo

Tipo

Formato

Valor Inicial

Nr-ord-prod

Integer

>>>,>>>,>>9

0

It-codigo

Char

X(16)

 

Cod-depos

Char

X(3)

 

Cod-localiz

Char

X(10)

 

Lote-serie

Char

X(10)

 

Quantidade

Decimal

>>>>>,>>9.9999

0

Cod-refer

Char

X(8)

 

Dt-vali-lote

Date

99/99/99999

 

Positivo

Logical

Sim/Não

Não

 

Temp-table tt-erros : Grava informações sobre qualquer inconsistência ou erro que possa Ter ocorrido durante o processamento.

 

TEMP-TABLE tt-erros

Atributo

Tipo

Formato

Valor Inicial

Nr-ord-prod

Integer

>>>,>>>,>>9

0

Linha

Integer

>>>,>>9

 

Sequencia

Integer

>>>,>>9

 

Msg-erros

Char

X(100)

 

 

Execução

 

Execução: O programa cpapi004.p  irá executar estas validações básicas:

 

1ª Validação: Versão de Integração

 

O programa irá verificar se o programa chamador está íntegro com a API, e isto ocorre através da verificação da versão de integração passada como parâmetro. Caso a versão esteja incompatível, a API abortará a execução retornando o código de erro 3941.

 

Outras Validações:

 

-          Se existe a ordem de produção indicada.

-          Verifica se a ordem de produção não havia sido encerrada previamente.

-          Verifica se o item não está obsoleto.

-          Consiste as contas contábeis.

-          Valida os depósitos.

-          Consiste a Rede Pert da ordem.

-          Verifica se o ponto de controle existe.

 

Parâmetros de Saída

 

No retorno da execução do cpapi004.p, será retornado um dos valores abaixo (via RETURN-VALUE):

 

NOK: houveram erros durante o processamento

OK: execução com sucesso