Documento de API

Objetivo

Permitir criar apontamentos apenas de refugo com uma produção pré-existente. É possível realizar refugo avulso para um reporte de produção ou para uma ordem.

Funcionamento

A API somente pode ser chamada de forma padrão. Nesta forma, realiza-se a chamada através de um comando RUN normal, passando-se os parâmetros com as informações necessárias ao processamento de um ou mais refugo avulso. A sintaxe para a chamada é:

run cpp/cpapi026.p  (input table tt-ref,

                                  input numeroDaOrdem,

                                  input numeroDoReporte,

                                  input codigoCentroDeTrabalho,

                                  output table tt-erro).

Os parâmetros utilizados pela API são:

1. tt-ref - Temp-table contendo as informações de refugo avulso (obrigatório);
2. numeroDaOrdem - Número da ordem de produção (obrigatório);
3. numeroDoReporte - Número do reporte de produção (opcional);
4. codigoCentroDeTrabalho - Código do centro de trabalho (opcional - somente obrigatório quando reporte do Chão de Fábrica);
5. tt-erro - Temp-table que retorna os erros da API.

Regras Gerais:

• Não são feitos refugos em ordens terminadas ou encerradas;
• Reportes estornados não recebem refugo avulso;
• Reporte deve possuir peças boas;
• Somente são aceitos refugos para itens com tipo de refugo "Perda Total".

Para refugo por número do reporte, o usuário precisa enviar o parâmetro 3. Regras específicas:

• Quando Chão de Fábrica, somente é aceito refugo avulso para a última operação.
• Se Chão de Fábrica, a operação e o Split não podem estar encerrados.

No caso de refugo para uma ordem, não enviar o número do reporte. Assim são buscados todos os apontamentos feitos para a ordem. Regras específicas:

• Quando Chão de Fábrica, somente são lidos registros de reporte para a última operação e que pertencerem ao Centro de Trabalho recebido como parâmetro.
• Se Chão de Fábrica, somente são buscados os splits que não foram encerrados.

Temp-tables

No caso do módulo produção, não existe o uso de motivo de refugo e quantidade retrabalhada, então não há necessidade de preenchimento destes campos. Enviar apenas nr-ord-prod e qtd-operac-refgda.