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 é:
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 */ |
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 | - |
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 | - |
...
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.
...