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:
pi-executar | ||||
Requisito | Não há. | |||
Descrição | Geração/eliminação de pendências de aprovação para os documentos do MLA conforme parâmetros | |||
Parâmetros | Tipo | Input/Output | Descrição | |
i-cod-tip-doc | INTEGER | INPUT | 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 | |
i-tipo-trans | INTEGER | INPUT | Transação que está sendo realizada (criação, alteração ou eliminação) Utilizar: 1 – Inclusão 2 – Modificação 3 – Eliminação | |
| c-motivo | CHARACTER | INPUT | Motivo da geração da pendência | |
| de-valor | DECIMAL | INPUT | Valor da pendência | |
| i-moeda | INTEGER | INPUT | Moeda referente ao valor da pendência | |
| c-usuar-trans | CHARACTER | INPUT | Usuário que está realizando a transação (manutenindo o documento origem que deve refletir a pendência no MLA) | |
| c-usuar-doc | CHARACTER | INPUT | Usuário responsável pelo documento para o qual está sendo gerada a pendência | |
| c-lotacao-doc | CHARACTER | INPUT | 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. | |
| c-item | CHARACTER | INPUT | 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. | |
| c-referencia | CHARACTER | INPUT | 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. | |
| c-ep-codigo | CHARACTER | INPUT | Empresa para a qual a pendência será gerada | |
| c-cod-estabel | CHARACTER | INPUT | Estabelecimento para o qual a pendência será gerada | |
| tt-mla-chave | TEMP-TABLE | INPUT | Informações da chave do documento. Enviar cada um dos registros de chave do documento como um registro diferenciado de "extent" na temp-table. | |
| tt-erro | TEMP-TABLE | OUTPUT | Informações sobre os erros ocorridos durante o processo de geração das pendências. | |
Retorno | O retorno desta procedure será "NOK" sempre que ocorrer algum erro durante o processamento, caso contrário o retorno será "OK". | |||
pi-executar-2 | ||||
Requisito | Não há. | |||
Descrição | Geração/eliminação de pendências de aprovação para os documentos do MLA conforme parâmetros (mesma funcionalidade da pi-executar, com a diferença de retornar os erros na RowErrors). | |||
Parâmetros | Tipo | Input/Output | Descrição | |
i-cod-tip-doc | INTEGER | INPUT | 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 | |
i-tipo-trans | INTEGER | INPUT | Transação que está sendo realizada (criação, alteração ou eliminação) Utilizar: 1 – Inclusão 2 – Modificação 3 – Eliminação | |
| c-motivo | CHARACTER | INPUT | Motivo da geração da pendência | |
| de-valor | DECIMAL | INPUT | Valor da pendência | |
| i-moeda | INTEGER | INPUT | Moeda referente ao valor da pendência | |
| c-usuar-trans | CHARACTER | INPUT | Usuário que está realizando a transação (manutenindo o documento origem que deve refletir a pendência no MLA) | |
| c-usuar-doc | CHARACTER | INPUT | Usuário responsável pelo documento para o qual está sendo gerada a pendência | |
| c-lotacao-doc | CHARACTER | INPUT | 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. | |
| c-item | CHARACTER | INPUT | 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. | |
| c-referencia | CHARACTER | INPUT | 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. | |
| c-ep-codigo | CHARACTER | INPUT | Empresa para a qual a pendência será gerada | |
| c-cod-estabel | CHARACTER | INPUT | Estabelecimento para o qual a pendência será gerada | |
| tt-mla-chave | TEMP-TABLE | INPUT | Informações da chave do documento. Enviar cada um dos registros de chave do documento como um registro diferenciado de "extent" na temp-table. | |
| RowErrors | TEMP-TABLE | OUTPUT | Informações sobre os erros ocorridos durante o processo de geração das pendências. | |
Retorno | O retorno desta procedure será "NOK" sempre que ocorrer algum erro durante o processamento, caso contrário o retorno será "OK". | |||
RowErrors | Entrada/Saída | |||
Temp-table com dados dos erros ocorridos durante o processo | Saída | |||
Atributo | Tipo | Descrição | Obrigatório | Evolução |
ErrorSequence | INTEGER | Número da sequência do erro | Sim | Não se aplica |
ErrorNumber | INTEGER | Código do erro | Sim | Não se aplica |
| ErrorDescription | CHARACTER | Descrição do erro | Sim | Não se aplica |
| ErrorParameters | CHARACTER | Parâmentros da mensagem de erro | Sim | Não se aplica |
| ErrorType | CHARACTER | Tipo do erro | Sim | Não se aplica |
| ErrorHelp | CHARACTER | Texto de ajuda da mensagem de erro | Sim | Não se aplica |
| ErrorSubType | CHARACTER | Subtipo do erro | Sim | Não se aplica |
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas