Histórico da Página
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
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 é:
run lap/mlaapi001.p (INPUT i-cod-tip-doc, INPUT i-tipo-trans, |
Exemplo da utilização:
run lap/mlaapi001.p (INPUT 1, /* 1 - Solicitação de compra */ INPUT 1, /* Inclusão */ |
Para execução persistente, executar da seguinte forma (onde h-mlaapi001 é uma variável do tipo handle):
run lap/mlaapi001.p persistent set h-mlaapi001 (INPUT i-cod-tip-doc, INPUT i-tipo-trans, |
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 | - |
Procedures disponíveis quando a execução for persistente: