Ocorrência:

Documentação de API

run laphtml/mlahtml009p.p persistent set h-handle.

listagemDocumentos

Requisito

Listagem de pendências do MLA (em várias situações) do documento de Processo de compra – Por Item

Sintaxe

{laphtml/mladados.i}

RUN listagemDocumentos in h-handle (input  iCodTipDoc,

                                                               input  tipoDoc,

                                                               input dtIni,

                                                               input dtFim,

                                                               output table ttDados).                                                                       

Descrição

Através dos parâmetros passados para a procedure, ela retorna os registros para listagem dos documentos (Processo de compra – por item)

Parâmetros

Tipo

Descrição

iCodTipDoc

INTEGER

Código do tipo de documento (neste caso para processo de compra – por item , informar 9)

tipoDoc

CHARACTER

Tipo de documento a ser apresentado. As opções que podem ser utilizadas são:

prin: Documentos pendentes de aprovação

saida: Documentos aprovados, rejeitados e reaprovados (histórico de aprovação)

alt: Documentos pendentes como usuário alternativo

mes: Documentos como usuário mestre

ambos: Documentos pendente de aprovação como usuário principal e como alternativo

aprov: Documentos aprovados e reaprovados

reprov: Documentos reprovados

dtIni

DATE

Data de início para consideração dos documentos já aprovados, rejeitados, reaprovados (histórico)

dtFim

DATE

Data de término para consideração dos documentos já aprovados, rejeitados, reaprovados (histórico)

As datas somente são utilizadas para o histórico e caso não sejam informadas serão considerados 30 dias.                                     

Retorno

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

Nesta temp-table contém dados da temp-table  tt-cotacao-processo-lista, que é detalhada na tabela mais abaixo.

Exemplo de registro que poderiam existir na tt-cotacao-processo-lista:

ttDados.cTable = “tt-cotacao-processo-lista”

ttDados.iRow = 1

ttDados.cField = “cod-emitente”

ttDados.cValue = “3456”

ttDados.cTable = “tt-cotacao-processo-lista”

ttDados.iRow = 1

ttDados.cField = “numero-ordem”

ttDados.cValue = “99999”

ttDados.cTable = “tt-cotacao-processo-lista”

ttDados.iRow = 1

ttDados.cField = “it-codigo”

ttDados.cValue = “Item XXXX”

ttDados

Entrada/Saída

Temp-table com dados da listagem em formato único.

Saída

Atributo

Tipo

Descrição

Obrigatório

Evolução

cTable

CHARACTER

Nome da temp-table

Sim

Não se aplica

iRow

INTEGER

Sequencial de registro

Sim

Não se aplica

cField

CHARACTER

Nome do campo da temp-table

Sim

Não se aplica

cValue

CHARACTER

Valor do campo

Sim

Não se aplica

tt-cotacao-processo-lista

Entrada/

Saída

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

Saída

Atributo

Tipo

Formato

Descrição

Obrigatório

cod-emitente

INTEGER

>>>>>>>>9

Código do fornecedor

Sim

numero-ordem

INTEGER

zzzzz9,99

Ordem de compra

Sim

nr-processo

INTEGER

999,999

Processo

Sim

it-codigo

CHARACTER

X(16)

Código do item

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

listagemDocumentosEmpresaEstab

Requisito

Listagem de pendências do MLA (em várias situações) do documento de processo de compra – por item por empresa e estabelecimento

Sintaxe

{laphtml/mladados.i}

RUN listagemDocumentosEmpresaEstab in h-handle (input cEpCodigo,

input cCodEstabel,

input  iCodTipDoc,

input  tipoDoc,

input dtIni,

input dtFim,

output table ttDados).                                                                       

Descrição

Através dos parâmetros passados para a procedure, ela retorna os registros para listagem dos documentos (Processo de compra – Item)

Parâmetros

Tipo

Descrição

iCodTipDoc

INTEGER

Código do tipo de documento (neste caso para processo de compra por item, informar 9)

tipoDoc

CHARACTER

Tipo de documento a ser apresentado. As opções que podem ser utilizadas são:

prin: Documentos pendentes de aprovação

saida: Documentos aprovados, rejeitados e reaprovados (histórico de aprovação)

alt: Documentos pendentes como usuário alternativo

mes: Documentos como usuário mestre

ambos: Documentos pendente de aprovação como usuário principal e como alternativo

aprov: Documentos aprovados e reaprovados

reprov: Documentos reprovados

dtIni

DATE

Data de início para consideração dos documentos já aprovados, rejeitados, reaprovados (histórico)

dtFim

DATE

Data de término para consideração dos documentos já aprovados, rejeitados, reaprovados (histórico)

As datas somente são utilizadas para o histórico e caso não sejam informadas serão considerados 30 dias.                                      

Retorno

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

Nesta temp-table contém dados da temp-table  tt-cotacao-processo-lista, que é detalhada na tabela mais abaixo.

Exemplo de registro que poderiam existir na tt-cotacao-processo-lista:

ttDados.cTable = “tt-cotacao-processo-lista”

ttDados.iRow = 1

ttDados.cField = “cod-emitente”

ttDados.cValue = “3456”

ttDados.cTable = “tt-cotacao-processo-lista”

ttDados.iRow = 1

ttDados.cField = “numero-ordem”

ttDados.cValue = “99999”

ttDados.cTable = “tt-cotacao-processo-lista”

ttDados.iRow = 1

ttDados.cField = “it-codigo”

ttDados.cValue = “Item XXXX”

detalheDocumento

Requisito

Detalhe de pendências do MLA do documento de Processo de compra (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 (Processo de compra – 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-cotacao e tt-mapa-comparativo, que são detalhadas na tabela mais a baixo.

Exemplo de registro que poderiam existir na tt-cotacao:

ttDados.cTable = “tt-cotacao”

ttDados.iRow = 1

ttDados.cField = “cod-estabel”

ttDados.cValue = “EST1”

ttDados.cTable = “tt-cotacao”

ttDados.iRow = 1

ttDados.cField = “numero-ordem”

ttDados.cValue = “99999”

ttDados.cTable = “tt-cotacao”

ttDados.iRow = 1

ttDados.cField = “it-codigo”

ttDados.cValue = “Item XXXX”

tt-cotacao

Entrada/

Saída

Temp-table com dados da cotação de compra para serem apresentados no detalhamento do documento

Saída

Atributo

Tipo

Formato

Descrição

Obrigatório

cod-estabel

CHARACTER

X(5)

Estabelecimento

Sim

numero-ordem

INTEGER

zzzzz9,99

Ordem de compra

Sim

desc-cod-estabel

CHARACTER

X(40)

Nome estabelecimento

Sim

seq-cotac

INTEGER

>>9

Sequência Cotação

Sim

it-codigo

CHARACTER

X(16)

Código do item

Sim

desc-it-codigo

CHARACTER

X(60)

Descrição do item

Sim

narrativa

CHARACTER

x(2000)

Narrativa

Sim

narrativa-ord-solic

CHARACTER

X(2000)

Narrativa da ordem/solicitação

Não

requisitante

CHARACTER

X(12)

Requisitante

Sim

nome-solic

CHARACTER

X(40)

Nome requisitante

Sim

fone-solic

CHARACTER

X(15)

Telefone requisitante

Não

cod-comprado

CHARACTER

X(12)

Comprador

Sim

nome-comprador

CHARACTER

X(40)

Nome comprador

Sim

fone-comprador

CHARACTER

X(15)

Telefone comprador

Não

un

CHARACTER

X(2)

Unidade medida

Sim

un-desc

CHARACTER

X(15)

Descrição Unidade medida

Sim

mo-codigo

INTEGER

>9

Moeda

Sim

desc-mo-codigo

CHARACTER

X(12)

Descrição moeda

Sim

tt-mapa-comparativo

Entrada/

Saída

Temp-table com dados das cotações para ordem em questão e dados da última compra para serem apresentados no detalhamento do documento

Saída

Atributo

Tipo

Formato

Descrição

Obrigatório

numero-ordem

INTEGER

zzzzz9,99

Ordem de compra

Sim

data-cotacao

DATE

99/99/9999

Data cotação

Sim

cod-emitente

INTEGER

>>>>>>>>9

Código fornecedor

Sim

nome-abrev

CHARACTER

X(12)

Nome abreviado do fornecedor

Sim

nome-emit

CHARACTER

X(80)

Nome fornecedor

Sim

cidade-estado

CHARACTER

X(40)

Cidade/estado

Sim

nome-contato

CHARACTER

X(40)

Nome contato

Sim

fone-contato

CHARACTER

X(15)

Telefone contato

Sim

ramal-contato

CHARACTER

X(5)

Ramal contato

Sim

qt-solic

DECIMAL

>>>,>>>,>>9.9999

Quantidade solicitada

Sim

pre-unit-for

DECIMAL

>>>>>,>>>,>>9.99999

Preço Unitário Fornecedor

Sim

preco-total

DECIMAL

>>>>>,>>>,>>9.99999

Preço total sem IPI

Sim

aliquota-ipi

DECIMAL

>>9.99

Alíquota API

Sim

valor-ipi

DECIMAL

>>>>>,>>>,>>9.99999

Valor IPI

Sim

preco-total-ipi

DECIMAL

>>>>>,>>>,>>9.99999

Preço total com IPI

Sim

perc-descto

DECIMAL

>9.99999

Percentual desconto

Sim

valor-descto

DECIMAL

>>>,>>>,>>9.9999

Valor do desconto

Não

nr-dias-taxa

INTEGER

>>9

Dias Taxa Financeira

Sim

valor-taxa

DECIMAL

>>9.9999

Taxa Financeira

Sim

preco-total-calc

DECIMAL

>>>>>,>>>,>>9.99999

Preço total

Sim

preco-medio

DECIMAL

>>>>>,>>>,>>9.99999

Preço médio

Sim

prazo-entreg

INTEGER

>,>>9

Prazo Entrega

Sim

cod-cond-pag

INTEGER

>>>9

Condição de pagamento

Sim

desc-cod-cond-pag

CHARACTER

X(30)

Descrição da condição de pagamento

Sim

narrativa

CHARACTER

X(2000)

Narrativa da cotação

Sim

c-aprovada

CHARACTER

X(2000)

Narrativa da cotação aprovada

Sim

un

CHARACTER

X(2)

Unidade medida

Sim

desc-un

CHARACTER

X(15)

Descrição Unidade medida

Sim

aprovada

LOGICAL

YES/NO

Indica se a cotação está aprovada

Sim

ult-compra

LOGICAL

YES/NO

Indica que são informações da última compra

Sim