Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

API responsável pela geração da pendência de aprovação no MLA

Características do Requisito

Linha de Produto:

Datasul

Segmento:

Manufatura

Módulo:

MLA

Banco(s) de Dados:

MOVIND

Tabelas Utilizadas:

mla-doc-pend-aprov

Release inicialEMS 2.06B


Considerações Gerais

Objetivo

Controle de geração/eliminação de pendências de aprovação para os documentos do MLA conforme detalhamento abaixo.

 

Pré-requisito

Módulo do MLA configurado para geração de pendências para os documentos em questão.

 

Funcionamento

A API irá receber os parâmetros documentados na sequência e fará a geração ou eliminação da(s) pendência(s) de aprovação.

A sintaxe para a chamada da API é:

run lap/mlaapi001.p (INPUT i-cod-tip-doc,

                              INPUT i-tipo-trans,
                              INPUT c-motivo,
                              INPUT de-valor,
                              INPUT i-moeda,
                              INPUT c-usuar-trans,
                              INPUT c-usuar-doc,
                              INPUT c-lotacao-doc,
                              INPUT c-item,
                              INPUT c-referencia,
                              INPUT c-ep-codigo,
                              INPUT c-cod-estabel,
                              INPUT TABLE tt-mla-chave,
                              OUTPUT TABLE tt-erro).

 

Exemplo da utilização:

run lap/mlaapi001.p (INPUT 1, /* 1 - Solicitação de compra */

                              INPUT 1, /* Inclusão */
                              INPUT "Aprovação de compra", /* Motivo */
                              INPUT 150, /* Valor da pendência */
                              INPUT 0, /* Moeda */
                              INPUT "super", /* Usuário da transação */
                              INPUT "requisitante", /* Usuário do documento */
                              INPUT "1000", /* Lotação do documento */
                              INPUT "item1", /* Item*/
                              INPUT "01001", /* Referência */
                              INPUT "001", /* Empresa */
                              INPUT "Est1", /* Estabelecimento */
                              INPUT TABLE tt-mla-chave, /* Registros contendo a chave do documento */
                              OUTPUT TABLE tt-erro). /* Erros ocorridos durante a geração da pendência */

 

Não há forma de execução persistente dessa API.

Informações referentes aos parâmetros:

 

 

 

Parâmetro 

Tipo

Formato

Descrição

Entrada/Saída

i-cod-tip-doc


Inteiro

>>9

Código do tipo do documento para o qual deve ser gerada, alterada ou eliminada a(s) pendência(s)

 

Utilizar:

1 - Solicitação de Compra - Item

2 - Solicitação de Compra - Total

3 - Requisição de Estoque - Item

4 - Requisição de Estoque - Total

5 - Cotação de Materiais

6 - Pedido de Compra - Item

7 - Pedido de Compra - Total

8 - Pedido de Compra Emergencial - Total

9 - Processo de Compra - Item

10 - Processo de Compra - Total

13 - Contrato de Compras

14 - Medição de Contrato de Compra

16 - Evento de Contrato de Compra

18 - Solicitação de Cotação

19 - Pedido de Compra Emergencial - Item

20 - Solicitação de Serviço

21 - Avaliação de Crédito (Pedido de Venda)

24 - Documento do Contas a pagar (Documento normal)

25 - Antecipação do Contas a pagar

26 - Pagamento Extra-Fornecedor

28 - Pagamento Título Normal

Entrada

i-tipo-transInteiro9

Transação que está sendo realizada (criação, alteração ou eliminação)

Utilizar:

1 – Inclusão

2 – Modificação

3 – Eliminação

 Entrada
c-motivoCaracterex(40)Motivo da geração da pendênciaEntrada
de-valorDecimal->>,>>>,>>9.99Valor da pendênciaEntrada
i-moedaInteiro>9Moeda referente ao valor da pendênciaEntrada
c-usuar-transCaracterex(12)Usuário que está realizando a transação (manutenindo o documento origem que deve refletir a pendência no MLA)Entrada
c-usuar-docCaracterex(12)Usuário responsável pelo documento para o qual está sendo gerada a pendênciaEntrada
c-lotacao-docCaracterex(20)

Lotação do documento para o qual está sendo gerada a pendência.

Essa informação é utilizada quando no cadastro do usuário está configurado para que o responsável pela pendência seja “Centro de Custo”, neste caso é considerada essa informação para buscar as hierarquias e faixas de aprovação. Caso não seja informada, é utilizada a lotação do usuário da transação para geração da pendência.

Entrada
c-itemCaracterex(16)Item para o qual está sendo gerada a pendência. Quando não for utilizado ou a aprovação for por total, passar em branco.Entrada
c-referenciaCaractere x(20)

Referência a ser considerada para geração da pendência.

Neste caso, se passada essa informação, e o documento deva utilizar a aprovação por referência, ela será utilizada para busca dos tipos de aprovação/aprovadores. 

Entrada
c-ep-codigoCaracterex(3)Empresa para a qual a pendência será geradaEntrada
c-cod-estabelCaracterex(5)Estabelecimento para o qual a pendência será gerada.Entrada
tt-mla-chaveTemp-table Informações da chave do documento. Enviar cada um dos registros de chave do documento como um registro diferenciado na temp-table.Entrada
tt-erroTemp-table Informações sobre os erros ocorridos durante o processo de geração das pendências.Saída

 

 

tt-mla-chave

Entrada/Saída

Temp-table com as chaves do documento

Entrada

Atributo

Tipo

Formato

Descrição

Obrigatório

Evolução

valor

Caractere

x(20)

Valor da chave

Sim

-

 

 

tt-erro

Entrada/Saída

Temp-table com os erros ocorridos durante o processo

Saída

Atributo

Tipo

Formato

Descrição

Obrigatório

Evolução

i-sequen

Inteiro

 

Sequência do erro

Sim

-

cd-erroInteiro Código do erroSim-
mensagemCaracterex(255)Mensagem de erroSim-

 

 

...

Parâmetro  

...

Tipo 

...

Formato 

...

Descrição 

...

Entrada/Saída 

...

i-cod-tip-doc  

...

Inteiro

...

>>9

Código do tipo do documento para o qual deve ser gerada, alterada ou eliminada a(s) pendência(s) 

  

Utilizar:

1 - Solicitação de Compra - Item

2 - Solicitação de Compra - Total

3 - Requisição de Estoque - Item

4 - Requisição de Estoque - Total

5 - Cotação de Materiais

6 - Pedido de Compra - Item

7 - Pedido de Compra - Total

8 - Pedido de Compra Emergencial - Total

9 - Processo de Compra - Item

10 - Processo de Compra - Total

13 - Contrato de Compras

14 - Medição de Contrato de Compra

16 - Evento de Contrato de Compra

18 - Solicitação de Cotação

19 - Pedido de Compra Emergencial - Item

20 - Solicitação de Serviço

...

...

-

...

25 - Antecipação do Contas a pagar

26 - Pagamento Extra-Fornecedor

28 - Pagamento Título Normal

...

Entrada

...

i-tipo-trans 

...

Inteiro

...

9

...

Transação que está sendo realizada (criação, alteração ou eliminação)

Utilizar:

1 – Inclusão

2 – Modificação

3 – Eliminação

...

 Entrada

...

c-motivo 

...

Caractere 

...

x(40)

...

Motivo da geração da pendência

...

Entrada 

...

de-valor 

...

Decimal

...

->>,>>>,>>9.99 

...

Valor da pendência

...

Entrada 

...

i-moeda 

...

Inteiro

...

>9

...

Moeda referente ao valor da pendência

...

Entrada 

...

c-usuar-trans 

...

Caractere 

...

x(12)

...

Usuário que está realizando a transação (manutenindo o documento origem que deve refletir a pendência no MLA)

...

Entrada 

...

c-usuar-doc 

...

Caractere 

...

x(12)

...

Usuário responsável pelo documento para o qual está sendo gerada a pendência

...

Entrada 

...

c-lotacao-doc 

...

Caractere 

...

x(20)

...

Lotação do documento para o qual está sendo gerada a pendência.

Essa informação é utilizada quando no cadastro do usuário está configurado para que o responsável pela pendência seja “Centro de Custo”, neste caso é considerada essa informação para buscar as hierarquias e faixas de aprovação. Caso não seja informada, é utilizada a lotação do usuário da transação para geração da pendência.

...

Entrada 

...

c-item 

...

Caractere 

...

x(16)

...

Item para o qual está sendo gerada a pendência. Quando não for utilizado ou a aprovação for por total, passar em branco.

...

Entrada 

...

c-referencia 

...

Caractere  

...

x(20)

...

Referência a ser considerada para geração da pendência.

Neste caso, se passada essa informação, e o documento deva utilizar a aprovação por referência, ela será utilizada para busca dos tipos de aprovação/aprovadores. 

...

Entrada 

...

c-ep-codigo 

...

Caractere 

...

x(3)

...

Empresa para a qual a pendência será gerada

...

Entrada 

...

c-cod-estabel 

...

Caractere 

...

x(5)

...

Estabelecimento para o qual a pendência será gerada.

...

Entrada 

...

tt-mla-chave 

...

Temp-table

...

Informações da chave do documento. Enviar cada um dos registros de chave do documento como um registro diferenciado na temp-table.

...

Entrada 

...

tt-erro 

...

Temp-table

...

Informações sobre os erros ocorridos durante o processo de geração das pendências.

...