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