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,
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”.
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.
...
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.
Nota | ||
---|---|---|
| ||
O fechamento gerencial é um modelo que permite realizar o processo de fechamento do estoque em períodos alternativos ao período fiscal. |