Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Considerações Gerais

 

Objetivo

 

O objetivo desta API é fornecer dados sobre pendências do módulo do MLA para o documento pedido de compra emergencial (por item), estejam elas pendentes de aprovações, aprovadas ou reprovadas.

 

Funcionamento

 

A API fornece basicamente dois tipos de informações: listagem de documentos (neste caso pedidos de compra emergencial - por item) e/ou detalhe um documento (neste caso pedidos de compra emergencial - por item).

...

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

 

...

Metodo Negócio

 

Quando a API estiver executada em modo persistente, os seguintes métodos estarão disponíveis para execução:

...

tt-pedido-item-lista

Entrada/

Saída

Temp-table com dados pedidos de compra para serem apresentados na listagem

Saída

Atributo

Tipo

Formato

Descrição

Obrigatório

cod-estabel

CHARACTER

X(5)

Estabelecimento

Sim

num-pedido

INTEGER

>>>>>,>>9

Número pedido

Sim

numero-ordem

INTEGER

zzzzz9,99

Ordem de compra

Sim

it-codigo

CHARACTER

X(16)

Código do item

Sim

nr-contrato

INTEGER

>>>>>>>>9

Número contrato

Não

nome-abrev

CHARACTER

X(12)

Nome abreviado do fornecedor

Sim

nome-emit

CHARACTER

X(80)

Nome fornecedor

Sim

data-pedido

DATE

99/99/9999

Data pedido

Sim

desc-natureza

CHARACTER

X(30)

Natureza

Sim

desc-cond-pagto

CHARACTER

X(30)

Descrição da condição de pagamento

Sim

responsavel

CHARACTER

X(12)

Responsável

Sim

cod-estab-gestor

CHARACTER

X(5)

Código do estabelecimento gestor

Sim

valor

DECIMAL

->>,>>>,>>9.99

Valor

Sim

situacao-doc

INTEGER

>9

Situação da pendência

Sim

situacao-doc-desc

CHARACTER

X(15)

Descrição da situação

Sim

nr-trans

INTEGER

>>>,>>>,>>9

Número da transação (MLA)

Sim

alternativo

LOGICAL

YES/NO

Indica que é uma pendência como alternativo

Sim

cod-usuar

CHARACTER

X(12)

Aprovador

Sim

mla-doc-pend-aprov-valor-doc

DECIMAL

->>,>>>,>>9.99

Valor do documento

Sim

chave-doc

CHARACTER

X(40)

Chave do documento

Sim

chave-doc-formatada

CHARACTER

X(70)

Chave do documento formatada

Sim

      

 

Obs.: Se necessário alterar ou incluir informação na listagem, existe um ponto de EPC com evento com o nome de “ListagemDocs” que pode ser utilizado. Ele possui o parâmetro “Handle_ttDados”, que possui o handle da temp-table ttDados.

...

detalheDocumento

Requisito

Detalhe de pendências do MLA do documento de Pedidos de compra emergencial (por item)

Sintaxe

{laphtml/mladados.i}

 

RUN detalheDocumento in h-handle (input  p-nr-transacao,

                                                            input  p-situacao,

                                                            output table ttDados).                                                                       

Descrição

Através dos parâmetros passados para a procedure, ela retorna as informações para detalhamento da pendência do documento (Pedidos de compra emergencial - por item)

Parâmetros

Descrição

p-nr-transacao

Número da transação da pendência (no MLA)

Retorno

p-situacao: Situação da pendência (INTEGER) – Conforme situação no MLA (doc-pend-aprov)

 

A procedure retorna também uma temp-table, do tipo ttDados, que está definida na include laphtml/mladados.i.

Nesta temp-table contém dados das temp-tables  tt-pedido, tt-cond-especif, tt-ordem-compra, tt-prazo-compra, tt-cotacao-item, tt-alt-ped, tt-ultima-comrpa e tt-it-requisicao, que são detalhadas na tabela mais a baixo.

 

Exemplo de registro que poderiam existir na tt-pedido:

 

 

ttDados.cTable = “tt-pedido”

ttDados.iRow = 1

ttDados.cField = “cod-estabel”

ttDados.cValue = “EST1”

 

ttDados.cTable = “tt-pedido”

ttDados.iRow = 1

ttDados.cField = “num-pedido”

ttDados.cValue = “99999”

 

ttDados.cTable = “tt-pedido”

ttDados.iRow = 1

ttDados.cField = “desc-natureza”

ttDados.cValue = “Compra”

...

tt-it-requisicao

Entrada/

Saída

Temp-table com dados dos itens de solicitação referente a ordem de compra, para serem apresentados no detalhamento do documento

Saída

Atributo

Tipo

Formato

Descrição

Obrigatório

numero-ordem

INTEGER

zzzzz9,99

Número da ordem

Sim

nr-requisicao

INTEGER

>>>,>>>,>>9

Requisição

Sim

sequencia

INTEGER

>>9

Sequência

Sim

it-codigo

CHARACTER

X(16)

Item

Sim

desc-it-codigo

CHARACTER

X(60)

Descrição do item

Sim

cod-depos

CHARACTER

X(3)

Depósito

Sim

cod-estabel

CHARACTER

X(5)

Estabelecimento

Sim

cod-localiz

CHARACTER

X(20)

Localização

Sim

cod-refer

CHARACTER

X(8)

Referência

Sim

dt-atend

DATE

99/99/9999

Data atendimento

Sim

dt-entrega

DATE

99/99/9999

Data entrega

Sim

qt-requisitada

DECIMAL

>>>,>>>,>>9.9999

Quantidade requisitada

Sim

ct-codigo

CHARACTER

X(20)

Conta

Não

desc-ct-codigo

CHARACTER

X(40)

Descrição da conta

Não

sc-codigo

CHARACTER

X(20)

Sub-conta

Não

desc-sc-codigo

CHARACTER

X(40)

Descrição sub-conta

Não

situacao

INTEGER

>9

Situação

Sim

desc-situacao

CHARACTER

X(10)

Descrição da situação

Sim

narrativa

CHARACTER

X(2000)

Narrativa

Não

 

 

Obs.: Se necessário alterar ou incluir informação no detalhamento, existe um ponto de EPC com evento com o nome de “DetalheDoc” que pode ser utilizado. Ele possui o parâmetro “Handle_ttDados”, que possui o handle da temp-table ttDados.

...