Histórico da Página
Documento de API
Produto: | Datasul |
Ocorrência: | Documentação de API |
Nome Físico | csp/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 | ||
---|---|---|
| ||
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.