Árvore de páginas

Documento de API

Produto:

Datasul

Ocorrência:

Documentação de API

Nome Físicocpp/cpapi005.p


Objetivo:

Baseado na temp-table carregada com os dados referentes a Gastos Gerais de Fabricação serão consistidos e gerados os movimentos de GGF.


Considerações Gerais:


-          Devem ser passada 2 temp-tables com informações e parâmetros para a criação de transações.

-          Todas as temp-tables são passadas como parâmetro através do comando INPUT-OUTPUT, pois além de passar parâmetros, elas retornam informações para o programa chamador.

-          Se o estabelecimento para o qual está sendo gerada a movimentação de Gastos Gerais de Fabricação possuir o preço médio on-line ou preço padrão o movimento já será valorizado no momento da sua criação.


Parâmetros de Entrada

 

input-output table tt-movto-ggf,

input-output table tt-erro,

input l-deleta-erros .

 

Temp-table tt-movto-ggf : Temp-table que vai possuir toda a movimentação de Gastos Gerais de Fabricação


TEMP-TABLE tt-movto-ggf

Atributo

Tipo

Formato

Valor Inicial

cc-codigo

Char

X(8)


cd-tarefa

Integer

>>>>9

0

cd-tecnico

Char

99999-9


cd-turno

Char

X(10)


Cod-roteiro

Char

X(16)


Conta-cr-ggf

Char[6]

X(17)


Conta-ordem

Char

X(17)


Crp-atual

Logi

Sim/Não

Não

Ct-cr-ggf

Char[6]

X(8)


Ct-ordem

Char

8


Db-cr-ok

Logi

Sim/Não

Não

Dt-retorno

Date

99/99/9999

Hoje

Dt-trans

Date

99/99/9999

Hoje

Gm-codigo

Char

X(9)


Horas-report

Deci-4

>>>,>>9.9999


It-codigo

Char

X(16)


Lote

Char

X(10)


Matr-func

Integer

99999

0

Narrativa

Char

X(2000)


Nr-ord-produ

Integer

>>>,>>>,>>9

0

Nr-reporte

Integer

>>>>>>>>9

1

Nr-req-sum

Integer

>>>,>>>,>>9

0

Nr-up-report

Deci-2

>>>,>>9.99

0

Nro-docto

Char

X(16)


Num-ord-inv

Inte

>>>,>>9

0

Op-codigo

Inte

>>>>>9

0

Op-seq

Inte

>>>9

0

Qt-peças-boas

Deci-4

>>>>,>>>,>>9.99

0

Qt-refugo

Deci-4

>>>>,>>9.9999

0

Refer-contab

Char

X(10)


Referência

Char

X(10)


Sc-cr-ggf

Char[6]

X(8)


Sc-ordem

Char

X(8)


Serie-docto

Char

X(5)


Tempo-limp

Deci-3

>>>9.999

0

Tempo-maquin

Deci-3

>>>9.999

0

Tempo-prepar

Deci-3

>>>9.999

0

Tempo-trans

Deci-3

>>>9.999

0

Tipo-valor

Inte

9

0

Tp-especial

Char

X(8)


Valor-ggf-1-m

Deci-4[3]

>>>>,>>>,>>9.99

0

Valor-ggf-2-m

Deci-4[3]

>>>>,>>>,>>9.99

0

Valor-ggf-3-m

Deci-4[3]

>>>>,>>>,>>9.99

0

Valor-ggf-4-m

Deci-4[3]

>>>>,>>>,>>9.99

0

Valor-ggf-5-m

Deci-4[3]

>>>>,>>>,>>9.99

0

Valor-ggf-6-m

Deci-4[3]

>>>>,>>>,>>9.99

0

Valor-ggf-1-o

Deci-4[3]

>>>>,>>>,>>9.99

0

Valor-ggf-2-o

Deci-4[3]

>>>>,>>>,>>9.99

0

Valor-ggf-3-o

Deci-4[3]

>>>>,>>>,>>9.99

0

Valor-ggf-4-o

Deci-4[3]

>>>>,>>>,>>9.99

0

Valor-ggf-5-o

Deci-4[3]

>>>>,>>>,>>9.99

0

Valor-ggf-6-o

Deci-4[3]

>>>>,>>>,>>9.99

0

Valor-ggf-1-p

Deci-4[3]

>>>>,>>>,>>9.99

0

Valor-ggf-2-p

Deci-4[3]

>>>>,>>>,>>9.99

0

Valor-ggf-3-p

Deci-4[3]

>>>>,>>>,>>9.99

0

Valor-ggf-4-p

Deci-4[3]

>>>>,>>>,>>9.99

0

Valor-ggf-5-p

Deci-4[3]

>>>>,>>>,>>9.99

0

Valor-ggf-6-p

Deci-4[3]

>>>>,>>>,>>9.99

0

Tipo-trans

Inte

>9

1

Hr-trans

Char

X(8)


Hr-contab

Char

X(8)


Dt-contab

Date

99/99/9999

Hoje

Contabilizado

Logi

Sim/Não

Não

Cd-equipto

Char

X(16)


Cod-estabel

Char

X(3)


Tipo-oper

Inte

>9


Qt-reportada

Deci-4

>>>>>,>>9.9999

0

Cod-versão-integração

Inte

999


Rw-movto-ggf

Rowid



Cria-ext-ord

Logi

Sim/Não

Não

Lg-recalc-horas

Logi

Sim/Não

Não

Rw-mov-orig

Rowid




Temp-table tt-erro: nesta temp-table são armazenados os possíveis erros que ocorreram durante a criação das transações.


TEMP-TABLE TT-ERRO

Atributo

Tipo

Formato

Valor Inicial

i-sequen

Integer

“999”


cd-erro

Integer

“>>>>9”


Mensagem

Character

“x(256)”




Execução

 

Execução: O programa cpapi005.p  irá executar estas validações básicas:


1ª Validação: Versão de Integração


O programa irá verificar se o programa chamador está íntegro com a API, e isto ocorre através da verificação da versão de integração passada como parâmetro. Caso a versão esteja incompatível, a API abortará a execução retornando o código de erro 3941.


Outras Validações:


  • Verifica se a ordem de produção a que o movimento de Gastos Gerais de Fabricação será associado existe.
  • Consiste a existência do item.
  • Consiste o grupo de máquinas que originou o gasto.
  • Consiste o centro de custo ao qual vai ser agregado o valor.
  • Quando possui Ordem de Investimento, esta receberá os valores a partir dos movimentos de GGF, criados no apontamento. É utilizada a mesma tabela de manutenção industrial (ord-man-mov).



Parâmetros de Saída

 

No retorno da execução do cpapi005.p, será retornado um dos valores abaixo (via RETURN-VALUE):


NOK: nenhuma movimentação de GGF foi efetivada

OK: execução com sucesso