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

Características do Requisito

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 direta é:

Exemplo da utilização:

Para execução persistente, executar da seguinte forma (onde h-mlaapi001 é uma variável do tipo handle):

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 29 - Negociação de Fretes 30 - Documento de Fretes 31 - Fatura de Fretes 32 - Originação - Adiantamento Valor 33 - Originação - Fechamento Financeiro	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. Obs.: Essa informação refere-se ao código do item cadastrado no sistema.	Entrada
c-referencia	Caractere	x(20)	Referência a ser considerada para geração da pendência. Para informações sobre a referência de cada documento consultar: DMLA0004 - Quais são as informações consideradas como referência para os documentos do MLA? 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 de "extent" na temp-table.	Entrada
tt-erro	Temp-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 (EXTENT 10)	x(20)	Valor da chave	Sim	-

Exemplo de criação para o documento 1 (Solicitação de Compra - Item): 

/* Localizar o registro da tabela requisicao e it-requisicao */

create tt-mla-chave.
assign tt-mla-chave.valor[1] = string(requisicao.nr-requisicao)
tt-mla-chave.valor[2] = string(it-requisicao.sequencia)
tt-mla-chave.valor[3] = string(it-requisicao.it-codigo).

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-erro	Inteiro

 

		Código do erro	Sim	-
mensagem	Caractere	x(255)	Mensagem de erro	Sim	-