Árvore de páginas

Documento de API

Produto:

Datasul

Ocorrência:

Documentação de API

Nome Físicocsp/csapi004.p 

 

Esta API tem por finalidade fazer a importação dos custos por centro de custo no módulo de custos industriais(CS0101). Esta API poderá fazer o preenchimento do custo total e do custo previsto do centro de custo de cada espécie de ggf em cada moeda; corrente e nas duas moedas alternativas se houver.

 

Considerações Gerais:

Esta é executada de forma normal através do comando “run”:

  • executar o programa com o seguinte código:

run csp/csapi004.p (input table tt-config,

input  table tt-imp-ext-per-custo,

output table tt-erro).

  • Para processar a importação deve-se informar em cada linha do arquivo texto os valores dos custos e a moeda em que os valores correspondem  no caso de se informar a moeda corrente ( 0 ) o a API irá criar a tabela ext-per-custo na moeda corrente e nas demais moedas alternativas convertendo os valores automaticamente de acordo com a data de cotação informada. No caso de se informar uma moeda alternativa a API irá somente criar/atualizar a ext-per-custo somente na moeda informada.
  • A importação somente ocorrerá para o período em aberto.
  • Se o tipo de fechamento for por estabelecimento será considerado o estabelecimento informado no campo cód-estabel-ini da tabela tt-config.
  • Se for parametrizada para zerar custo(tt-config.zera-custo = yes) e já existir o custo informado para o centro de custo a API irá zerar este valor e gravá-lo com o valor informado no arquivo texto caso contrário a API irá somá-lo com o valor informado no arquivo de importação  
  • Os erros serão retornados através da tabela tt-erro.
  • Cada linha de importação esta associado aos erros ocorridos durante a importação através do numero da linha na temp-table principal e com o numero de seqüência da tabela de erros.

Parâmetro de Entrada

Temp-table  tt-config:

Atributo

Tipo

Formato

Valor Inicial

Cod-versao-integ

Integer

 

 

Dat-cotacao

Date

 

today

Zerar-custo

Logical

 

yes

Cód-estabel-ini

Character

 

 

Cód-estabel-fim

Character

 

 

Acomp

Handle

 

 

Mo-codigo

Integer

 

0

Atributo

Descrição

Cod-versao-integ

Código da versão de integração

Dat-cotacao

Data para cotação das moedas

Zerar-custo

Com valor “yes” indica que o valor existente será zerado, se for “no” o valor existente será somado com o valor in formado no arquivo de importação   

Cód-estabel-ini

Inicio da faixa de estabelecimentos

Cód-estabel-fim

Fim da faixa de estabelecimentos

Acomp

Se o handle for valido a caixa de acompanhamento será acionada

Mo-codigo

Moeda do valor informado

 

Temp-table  tt-imp-ext-per-custo:

Atributo

Tipo

Formato

Valor Inicial

cc-codigo

Character

 

 

Espécie

Integer

 

 

Mo-codigo

Integer

 

 

Custo-total

Decimal

Decimals 4

 

Custo-prev

Decimal

Decimals 4

 

Linha

Integer

 

 

Erro

Logical

 

 

Atributo

Descrição

cc-codigo

Código do centro de custo

Espécie

Tipo de espécie de GGF

Mo-codigo

Código da moeda

Custo-total

Valor do custo total

Custo-prev

Valor do custo previsto

Linha

Numero da linha do arquivo de importação

Erro

Indica se houve ou não erro na importação (controle interno)

 

Parâmetro de Saída

Temp-table tt-erro

Atributo

Tipo

Formato

Valor Inicial

i-sequen

Int

 

 

cd-erro

Int

 

 

Mensagem

Char

X(255)