Documento de API
Produto: | Datasul |
Ocorrência: | Documentação de API |
Nome Físico | csp/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) |
|