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
#trackbackRdf ($trackbackUtils.getContentIdentifier($page) $page.title $trackbackUtils.getPingUrl($page))