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 table tt-ref-ordem,

                                  input numeroDaOrdem,

                                  input numeroDoReporte,

                                  input codigoCentroDeTrabalho,

                                  input codigoContaRefugo,

                                  input codigoCentroCustoRefugo,

                                  input 1,

                                  output table tt-retorno,

                                  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. tt-ref-ordem - Temp-table contendo as informações para rejeição (opcional);
3. numeroDaOrdem - Número da ordem de produção (obrigatório);
4. numeroDoReporte - Número do reporte de produção (opcional);
5. codigoCentroDeTrabalho - Código do centro de trabalho (opcional - somente obrigatório quando reporte do Chão de Fábrica);
6. codigoContaRefugo - Código da conta para refugo (opcional);
7. codigoCentroCustoRefugo - Código do centro de custo para o refugo (opcional);
8. Valor fixo 1;
9. tt-retorno - Temp-table que retornar todos os registros de refugo avulso que foram gerados;
10. 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".
• A conta e o centro de custo são opcionais pois caso não forem enviados, será utilizado o padrão dos parâmetros da produção. Mas se já existir um refugo para o reporte, então é utilizada a informação deste registro.
• O parâmetro 2 só é necessário para apontamento pela produção e se estiver sendo usada rejeição (módulo Controle de Qualidade ligado, tipo CQ igual a 2 ou 3 e, item com controle de qualidade).

Para refugo por número do reporte, é necessário enviar o parâmetro 4. 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.