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 inicial	EMS 2.06B

Considerações Gerais

Objetivo

Geração de pendências 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 : Aprovação de compras ou MLA configurado para gerar geração de pendências para os documentos em questão.

Funcionamento

A API irá receber como parâmetros o Tipo de Documento, Tipo de transação e o Rowid do documento o qual será gerada a pendência 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 cdprun lap/cdapi171mlaapi001.p (input p (INPUT i-cod-tip-doc,

INPUT i-tipo,

input i-transacao,

                                 r-documento-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 cdprun lap/cdapi171mlaapi001.p p (input INPUT 1, /* 1 - Solicitação de compra */ input

INPUT 1, /* 1 - Inclusão */

input rowid(it-requisicao) /* Rowid do registro que deverá ser gerada a pendência */ ).

A execução na forma persistente é realizada através da chamada de um comando RUN conforme exemplo a seguir.

A sintaxe para executar a API em modo persistente é:

RUN cdp\cdapi171.p PERSISTENT SET h-handle.

A variável denominada h-handle irá receber o “handle” do programa, permitindo o acesso aos “métodos” internos da API.

Informações referentes aos parâmetros:

def input parameter p-cod-tip-doc as integer no-undo.
def input parameter p-tipo-trans as integer no-undo.
def input parameter p-motivo as char no-undo.
def input parameter p-valor as decimal no-undo.
def input parameter p-moeda as integer no-undo.
def input parameter p-usuar-trans as char no-undo.
def input parameter p-usuar-doc as char no-undo.
def input parameter p-lotacao-doc as char no-undo.
def input parameter p-item as char no-undo.
def input parameter p-referencia as char no-undo.
def input parameter p-ep-codigo LIKE empresa.ep-codigo no-undo.
def input parameter p-cod-estabel LIKE estabelec.cod-estabel no-undo.
def input parameter table for tt-mla-chave.
def output parameter table for tt-erro.

i-tipo					Entrada/Saída
Tipo do Documento					Entrada
Atributo	Tipo	Formato	Descrição	Obrigatório	Evolução
i-tipo	Inteiro		Tipo do Documento	Sim

Utilizar:

1 - Solicitiação de compra

2 - Requisição de estoque

3 - Cotação

4 - Pedido de compra

5 - Solicitação de cotação

6 - Pedido emergencial

7 - Processo de compra

8 - Contrato de compra

9 - Solicitação de serviço

10 - Contrato de compra

11 - Evento de contrato

12 - Medição de contrato

i-transacao					Entrada/Saída
Tipo da Transação					Entrada
Atributo	Tipo	Formato	Descrição	Obrigatório	Evolução
i-transacao	Inteiro		Tipo da Transação	Sim

Utilizar:

1 - Inclusão

2 - Modificação

3 - Exclusão

r-documento					Entrada/Saída
Rowid do documento					Entrada
Atributo	Tipo	Formato	Descrição	Obrigatório	Evolução
r-documento	rowid		Rowid do documento	Sim

Informações complementares:

- Documento "1 - Solicitação de compra" passar o rowid do item da solcitação (it-requisicao)

- Documento "2 - Requisição de estoque" passar o rowid do item da solcitação(it-requisicao)

- Documento "3 - Cotação" passar o rowid da cotação (cotacao-item)

- Documento "4 - Pedido de compra" passar o rowid da ordem de compra (ordem-compra)

- Documento "5 - Solicitação de cotação" passar o rowid do item da solicitação(it-requisicao)

- Documento "6 - Pedido emergencial" passar o rowid da ordem de compra (ordem-compra)

- Documento "7 - Processo de compra" passar o rowid da cotação (cotacao-item)

- Documento "8 - Contrato de compra" passar o rowid do item do contrato (item-contrat)

- Documento "9 - Solicitação de serviço" passar o rowid da solicitação de serviço (solic-serv)

- Documento "10 - Contrato de compra" passar o rowid do contrato (contrato-for)

- Documento "11 - Evento de contrato" passar o rowid do evento (evento-ped)

- Documento "12 - Medição de contrato" passar o rowid da medição (medicao-contrat)

Metodo Negócio

Quando a API for executada em modo persistente, os seguintes métodos estarão disponíveis para execuçã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-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.	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	-

Retorna um return-value “OK” se o processo foi executado corretamente.

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	-
pi-executar
Requisito	Nenhum
Sintaxe	RUN pi-executar in handle (INPUT i-tipo, INPUT i-transacao, INPUT r-documento).
Descrição	Geração da tabela de documentos pendentes de aprovação.
	Parâmetros	Descrição
	i-tipo i-transacao r-documento	1-Solicitação 2-Requisição 3-Cotação 4-Pedido 5-Solicitação Cotação 6-Pedido Emergencial 7-Processo Compras 8-Contrato Fornec 9-Manutenção Industrial 10-Documento Contrato 11-Evento de Contrato 12-Medição de Contrato 1-Inclusão 2-Modificação 3-Exclusão Rowid do documento
Retorno

Árvore de páginas

Versões comparadas

Versão antiga 2

Nova versão 3

Chave

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

Características do Requisito

Considerações Gerais

Informações referentes aos parâmetros:

Metodo Negócio

Informações referentes aos parâmetros:

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 2

Nova versão 3

Chave

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

Características do Requisito

Considerações Gerais

Informações referentes aos parâmetros:

Metodo Negócio

Informações referentes aos parâmetros: