Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Documento de API

Produto:

Datasul

Ocorrência:

Documentação de API

Nome Físicocsp/csapi001.p

 


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,

...

 output table tt-custos-op,

 output table tt-erro).

 

 



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

...

Nota
titleNota:

Os campos fm-codigo e ge-codigo, apesar de não utilizados pela API, podem ser úteis na geração de relatórios, caso se deseje agrupar as informações por família ou por grupo de estoque.

O campo <cod-unid-negoc> existe apenas a partir da release 2.06B do EMS2. Sendo que ele será utilizado apenas quando utilizada a função de Unidade de Negócio no EMS5. Caso não seja informado o valor neste campo e a função estiver ativa, então será considerada a Unidade de Negócio padrão do ItemxEstabelecimentoxDepósito ou no caso de falta da primeira no ItemxEstabelecimento.

...


 

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.

...

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.