Documento de API

Objetivo: Realizar o cálculo do custo de material, mão de obra e GGF de um ou mais itens, utilizando-se da estrutura desses itens e realizando o cálculo de forma recursiva, processando os valores da cada componente dos itens e acumulando-os de forma a compor o custo final dos itens desejados.

Funcionamento: Realiza-se a chamada através de um comando RUN normal, passando-se as temp-tables carregadas com as informações necessárias ao processamento de um ou mais cálculos. A sintaxe para a chamada é:

run csp/csapi001.p  (input  table tt-custos-param,
                                 input  table tt-custos-item,
                                 output table tt-custos-calculo,
                                 output table tt-custos-mob-dir,
                                 output table tt-custos-ggf,
                                 output table tt-custos-op,
                                 output table tt-erro).

...

Parâmetros: Os parâmetros utilizados pela API são:

...

2 – Médio On-Line (utiliza moeda/estabelecimento);

3 – Custo Padrão Gerencial (utiliza moeda/estabelecimento);

...

1 – Total

2 – Previsto

3 – Padrão

4 - Gerencial

rkw-up – Informa a metodologia de cálculo utilizada para as operações:

...

c-origem – informa se a emissão do relatório partiu da engenharia ou partiu do módulo de desenvolvimento de produtos, caso seja do módulo de engenharia, deverá ser informado “EN”, caso contrário, deve ser informado “DP”

i-processo - Define qual processo de fabricação será utilizado no cálculo dos custos. Podendo ser: 1-Processo Principal, 2-Todos Processos.

nr-linha - Linha de produção utilizada para seleção do processo de fabricação

cod-unid-negoc - Unidade de negócio utilizada para seleção do processo de fabricação.

c-periodo - Indica em qual períodos os custos serão Apurados. Os custos de Gastos gerais de Fabricação serão calculados com base no Período informado neste campo. Caso não seja preenchido, mantém a regra atual de cálculo, onde o custo é apurado baseado no Período Corrente no estoque.

- tt-custos-item: Contém as informações relativas aos itens que serão calculados.

...

cod-unid-negoc – Código da unidade de negócio do item, guardado a partir do padrão. .

cod-lista-compon – Lista de componente utilizada para o cálculo.

cod-roteiro – Roteiro utilizado para o cálculo.

c-origem – Informa se a emissão do relatório partiu da Engenharia ou partiu do módulo de Desenvolvimento de Produtos, caso seja do módulo de engenharia, o programa deve ser informado “EN”, caso contrário, deve ser informado “DP”.

...

- tt-custos-calculo: Retorna o cálculo dos custos de cada item constante da tt-custos-item e também dos componentes desses itens. As informações retornadas por essa temp-table são:

...

qt-up-prep – Quantidade de UP´s relativas ao valor de preparação das operações.

quantidade –

vl-tot-mat – Valor total de material do item.

vl-tot-mob – Valor total de mão de obra direta.

vl-tot-mob-c – Valor total de mão de obra dos componentes do item.

vl-tot-ggf – valor total de GGF do item divido nos seis tipos disponiveis de GGF.

vl-tot-ggf-c – Valor total de GGF, dos componentes do item calculado.

vl-tot-prep – Valor total de preparação.

vl-tot-ext – Valor total de operações externas.

vl-tot-ref – Valor total do refugo, considerando todos os compentes do item calculado.

qt-tot-up-prep – Quantidade total de UP para preparação.

qt-tot-up – Quantidade total de UP.

quant-liquid – Quantidade de liquida do item na estrutura.

fator-perda – Fator perda cadastrado na engenharia.

dt-cotacao – Data de obtenção do preço/custo.

...

tempo – Tempo em horas das operações reportadas.

...

- tt-custos-ggf: Contém os valores totais de GGF agrupados por código de centro de custo.

...

tempo – Tempo em horas das operações reportadas.

periodo - Retorna o período utilizado na montagem dos custos de GGF.

- tt-custos-op: Contém o resultado dos cálculos relativos às operações dos itens informados na tt-custos-item.

...

op-codigo – Código da operação.

tempo – Tempo da operação.

vl-unit-mob – Valor unitário de mão de obra direta.

...

vl-unit-ext – Valor unitário informado da operação externa.

vl-tot-ggf - Valor total de GGF (nos seis tipos disponíveis). Leva em consideração a quantidade na estrutura.

qt-up – Quantidade de up´s.

...

mensagem – Mensagem de erro.

Retorno: A API irá setar o return-value de forma a informar ao programa “chamador” se a execução foi realizada com sucesso ou não. Os valores possíveis para o return-value são: OK (execução correta) e NOK (execução com problemas). Os motivos para a rejeição do cálculo são especificados na temp-table tt-erro.