Documento de API
Produto: | Datasul |
Ocorrência: | Documentação de API |
Nome Físico | cpp/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