Realizar as operações de inclusão, edição, exclusão e busca referentes as requisições. 

Características do Requisito

Linha de Produto:

Datasul

Segmento:

Manufatura

Módulo:

MCC

Versão Expedida:12.1.9

Considerações Gerais

Objetivo

 

Realizar as operações de inclusão, edição, exclusão e busca referentes as requisições e seus itens.

Funcionamento

 

Na forma padrão, realiza-se a chamada por intermédio de um comando RUN normal, passando-se as temp-tables carregadas com as informações necessárias.

A execução na forma persistente é realizada através da chamada de um comando RUN conforme exemplo a seguir.

A sintaxe para executar a API em modo persistente é:

 

RUN ccp/ccapi354.p PERSISTENT SET h-handle.

 

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

Datasets

 

dsRequestList

Entrada/Saída

Informações das requisições ou dos itens das requisições.

Saída

Temp-table

Descrição

ttRequestList

Requisições ou itens das requisições

dsItRequest

Entrada/Saída

Detalhes dos itens de uma requisição. Agrupa as temp-tables ttRequestItem e ttBusUnitRequest

Saída

Temp-table

Relacionamento com a ttRequestItem

Descrição

ttBusUnitRequest

nr-requisicao, nr-requisicao, sequencia, sequencia, it-codigo, it-codigo

Unidades de negócio

ttListParameters

 

Tabelas Temporárias

 

ttRequestList

Entrada/Saída

Requisições ou itens das requisições

Saída

Atributo

Tipo

Formato

Descrição

Obrigatório

Evolução

nr-requisicao

INTEGER

>>>,>>>,>>9

Requisição

Sim

 

tp-requis    

INTEGER

>9

Tipo da requisição

Sim

 

tp-requis-desc

CHARACTER

 

Descrição do tipo da requisição

Não

 

cod-estabel  

CHARACTER

x(5)

Estabelecimento

Sim

 

dt-requisicao

DATE

99/99/9999

Data da requisição

Sim

 

estado       

INTEGER

9

Estado da requisição

Sim

 

estado-desc  

CHARACTER

 

Descrição do estado

Não

 

situacao     

INTEGER

9

Situação da requisição

Sim

 

situacao-desc

CHARACTER

 

Descrição da situação

Não

 

requisicao-narrativa    

CHARACTER

x(2000)

Narrativa da requisição

Não

 

it-requisicao-narrativaCHARACTERX(2000)Narrativa o item da requisiçãoNão 

narrativa-item

CHARACTER

x(2000)

Narrativa do item da requisição

Não

 

it-codigo    

CHARACTER

x(16)

Código do item

Sim

 

sequencia    

INTEGER

>>9

Sequência do item

Sim

 

urgente      

LOGICAL

Sim/Não

Urgente

Não

 

desc-item    

CHARACTER

x(60)

Descrição do item

Não

 

nome-abrev   

CHARACTER

x(12)

Requisitante

Sim

 

qt-requisitada

DECIMAL

>>>,>>>,>>9.9999

Quantidade requisitada

Sim

 

un           

CHARACTER

x(2)

Unidade de medida

Sim

 

dt-entrega   

DATE

99/99/9999

Data de entrega

Sim

 

hra-entrega  

CHARACTER

99:99

Hora de entrega

Não

 

requestRowid 

ROWID

 

Rowid da requisição ou item da requisição

Não

 

epc-value    

CHARACTER

x(200)

Campo para customização

Não

 

prioridade-aprovINTEGER>>9Prioridade de AprovaçãoNão 
prioridade-aprov-descCHARACTER Descrição da Prioridade de AprovaçãoNão 

currentTTRequestList

Entrada/Saída

Chave das requisições já retornadas para a tela.

Saída

Atributo

Tipo

Formato

Descrição

Obrigatório

Evolução

nr-requisicao

INTEGER

>>>,>>>,>>9

Requisição

Sim

 

ttRequest

Entrada/Saída

Informações das requisições.

Saída

Atributo

Tipo

Formato

Descrição

Obrigatório

Evolução

cod-estabel   

CHARACTER

x(5)

Estabelecimento

Sim

 

dt-atend      

DATE

99/99/9999

Data de atendimento

Não

 

dt-devol      

DATE

99/99/9999

Data de devolução

Não

 

dt-requisicao 

DATE

99/99/9999

Data da requisição

Sim

 

estado        

INTEGER

9

Estado

Sim

 

impressa      

INTEGER

9

Impressa

Sim

 

loc-entrega   

CHARACTER

x(30)

Local de entrega

Não

 

narrativa     

CHARACTER

x(2000)

Narrativa

Não

 

nome-abrev    

CHARACTER

x(12)

Requisitante

Sim

 

nome-aprov    

CHARACTER

x(12)

Aprovador

Não

 

nr-requisicao 

INTEGER

>>>,>>>,>>9

Requisição

Sim

 

situacao      

INTEGER

9

Situação

Sim

 

tp-requis     

INTEGER

>9

Tipo da requisição

Sim

 

nome          

CHARACTER

x(40)

Nome do estabelecimento

Não

 

nome-abrev-desc

CHARACTER

 

Nome do requisitante

Não

 

impressa-desc 

CHARACTER

 

Descrição estado de impressão

Não

 

situacao-desc 

CHARACTER

 

Descrição da situação da requisição

Não

 

tp-requis-desc

CHARACTER

 

Descrição do tipo de requisição

Não

 

estado-desc   

CHARACTER

 

Descrição do estado da requisição

Não

 

RowErrors

Entrada/Saída

Erros ocorridos durante a execução do programa.

Saída

Atributo

Tipo

Formato

Descrição

Obrigatório

Evolução

ErrorSequence  

INTEGER 

 

Sequência

Sim

 

ErrorNumber    

INTEGER 

 

Número

Sim

 

ErrorDescription

CHARACTER

 

Descrição

Não

 

ErrorParameters

CHARACTER

 

Parãmetros

Não

 

ErrorType      

CHARACTER

 

Tipo de erro

Não

 

ErrorHelp      

CHARACTER

 

Texto de ajuda

Não

 

ErrorSubType   

CHARACTER

 

Sub-tipo do erro

Não

 

 

 

ttItRequisicaoResumida

Entrada/Saída

Principais informações dos itens das requisições.

Saída

Atributo

Tipo

Formato

Descrição

Obrigatório

Evolução

nr-requisicao

INTEGER

>>>,>>>,>>9

Requisição

Sim

 

sequencia

INTEGER

>>9

Sequência

Sim

 

it-codigo

CHARACTER

x(16)

Código do item

Sim

 

it-desc

CHARACTER

x(18)

Descrição do item

Não

 

cod-refer

CHARACTER

x(8)

Referência

Não

 

un

CHARACTER

x(2)

Unidade de medida

Não

 

qt-requisitada

DECIMAL

>>>,>>>,>>9.9999

Quantidade requisitada

Sim

 

dt-entrega

DATE

99/99/9999

Data de entrega

Sim

 

hra-entrega

CHARACTER

99:99

Hora de entrega

Não

 

situacao

INTEGER

>9

Situação

Sim

 

situacao-desc

CHARACTER

 

Descrição da situação

Não

 

urgente

LOGICAL

Sim/Não

Urgente

Não

 

estado

INTEGER

9

Estado da requisição

Sim

 

estado-desc

CHARACTER

 

Descrição do estado

Não

 

narrativa

CHARACTER

x(2000)

Narrativa

Não

 

tp-requis

INTEGER

>9

Tipo de requisição

Sim

 

r-rowid

ROWID

 

Rowid do item

Não

 

epc-value

CHARACTER

x(200)

Campo para customização

Não

 

ttItRequisicaoResumida

Entrada/Saída

Principais informações dos itens das requisições.

Saída

Atributo

Tipo

Formato

Descrição

Obrigatório

Evolução

nr-requisicao

INTEGER

>>>,>>>,>>9

Requisição

Sim

 

sequencia

INTEGER

>>9

Sequência

Sim

 

it-codigo

CHARACTER

x(16)

Código do item

Sim

 

it-desc

CHARACTER

x(18)

Descrição do item

Não

 

cod-refer

CHARACTER

x(8)

Referência

Não

 

un

CHARACTER

x(2)

Unidade de medida

Não

 

qt-requisitada

DECIMAL

>>>,>>>,>>9.9999

Quantidade requisitada

Sim

 

dt-entrega

DATE

99/99/9999

Data de entrega

Sim

 

hra-entrega

CHARACTER

99:99

Hora de entrega

Não

 

situacao

INTEGER

>9

Situação

Sim

 

situacao-desc

CHARACTER

 

Descrição da situação

Não

 

urgente

LOGICAL

Sim/Não

Urgente

Não

 

estado

INTEGER

9

Estado da requisição

Sim

 

estado-desc

CHARACTER

 

Descrição do estado

Não

 

narrativa

CHARACTER

x(2000)

Narrativa

Não

 

tp-requis

INTEGER

>9

Tipo de requisição

Sim

 

r-rowid

ROWID

 

Rowid do item

Não

 

epc-value

CHARACTER

x(200)

Campo para customização

Não

 

ttRequestItem

Entrada/Saída

Informações dos itens das requisições.

Saída

Atributo

Tipo

Formato

Descrição

Obrigatório

Evolução

cod-depos

CHARACTER

x(3)

Depósito

Não

 

cod-estabel

CHARACTER

x(5)

Estabelecimento

Sim

 

cod-localiz

CHARACTER

x(20)

Localização

Não

 

cod-refer

CHARACTER

x(8)

Referência

Sim

 

cod-unid-negoc

CHARACTER

X(3)

Unidade de Negócio

Não

 

dt-atend

DATE

99/99/9999

Data de Atendimento

Não

 

dt-entrega

DATE

99/99/9999

Data de Entrega

Sim

 

ep-codigo

CHARACTER

x(3)

Empresa

Sim

 

estado

INTEGER

9

Estado

Sim

 

it-codigo

CHARACTER

x(16)

Item

Sim

 

nome-abrev

CHARACTER

x(12)

Requisitante

Sim

 

nome-abrev-desc

CHARACTER

x(50)

Nome do requisitante

Não

 

nome-aprov

CHARACTER

x(12)

Aprovador

Não

 

nr-requisicao

INTEGER

>>>,>>>,>>9

Requisicao

Sim

 

num-ord-inv

INTEGER

>>>,>>9

Ordem de Investimento

Não

 

numero-ordem

INTEGER

zzzzz9,99

Ordem de Compra

Não

 

preco-unit

DECIMAL

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

Preço Unitário

Sim

 

prioridade-aprov

INTEGER

>>9

Prioridade de Aprovação

Sim

 

qt-a-atender

DECIMAL

>>>,>>>,>>9.9999

Quantidade Saldo

Não

 

qt-a-devolver

DECIMAL

>>>,>>>,>>9.9999

Quantidade a Devolver

Não

 

qt-atendida

DECIMAL

>>>,>>>,>>9.9999

Quantidade Atendida

Não

 

qt-devolvida

DECIMAL

>>>,>>>,>>9.9999

Quantidade Devolvida

Não

 

qt-requisitada

DECIMAL

>>>,>>>,>>9.9999

Quantidade Requisitada

Sim

 

sequencia

INTEGER

>>9

Sequência

Sim

 

situacao

INTEGER

>9

Situacao

Sim

 

un

CHARACTER

x(2)

Unidade de Medida

Sim

 

ct-codigo

CHARACTER

x(20)

Conta

Não

 

lote

CHARACTER

x(40)

Lote/Série

Não

 

narrativa

CHARACTER

x(2000)

Narrativa

Não

 

sc-codigo

CHARACTER

x(20)

Sub-Conta

Não

 

sc-codigo-desc

CHARACTER

 

Descrição da sub-conta

Não

 

ct-codigo-desc

CHARACTER

 

Descrição da conta

Não

 

log-1

LOGICAL

Sim/Não

Urgente

Não

 

log-2

LOGICAL

Sim/Não

Homologa fornecedor

Não

 

nome

CHARACTER

X(40)

Nome Estabelecimento

Não

 

des-unid-negoc

CHARACTER

x(40)

Descrição da Unidade de Negócio

Não

 

desc-item

CHARACTER

x(60)

Descrição do item

Não

 

val-item

DECIMAL

>>>>>>,>>>,>>9.99

Valor do item

Não

 

cod-depos-desc

CHARACTER

x(40)

Nome depósito

Não

 

cod-refer-desc

CHARACTER

x(32)

Descrição referência

Não

 

log-1-desc

CHARACTER

 

Descrição

Não

 

estado-desc

CHARACTER

x(3)

Descrição do estado

Não

 

situacao-desc

CHARACTER

 

Descrição da situação

Não

 

prioridade-aprov-desc

CHARACTER

 

Descrição da prioridade aprovação

Não

 

ep-codigo-desc

CHARACTER

x(60)

Razao Social

Não

 

cod-localiz-desc

CHARACTER

x(30)

Descrição da Localização

Não

 

un-desc

CHARACTER

x(15)

Descrição da Unidade de medida

Não

 

afeta-qualidade

LOGICAL

Sim/Não

Afeta qualidade

Não

 

char-1

CHARACTER

x(100)

Campo livre

Não

 

char-2

CHARACTER

x(100)

Campo livre

Não

 

cod-utilizacao

CHARACTER

X(12)

Código da Utilização

Não

 

cod-utilizacao-desc

CHARACTER

X(40)

Descrição código utilização

Não

 

hra-entrega

CHARACTER

99:99

Hora de Entrega

Não

 

preco-unit-desc

CHARACTER

 

Descrição

Não

 

tp-requis

INTEGER

>9

Tipo de Requisição

Sim

 

tp-requis-desc

CHARACTER

 

Descrição do tipo de requisição

Não

 

epc-value

CHARACTER

x(200)

Campo para customização

Não

 

ttBusUnitRequest

Entrada/Saída

Unidades de negócio do item da requisição

Saída

Atributo

Tipo

Formato

Descrição

Obrigatório

Evolução

cod_unid_negoc

CHARACTER

X(3)

Unidade de Negócio

Sim

 

nr-requisicao

INTEGER

>>>,>>>,>>9

Requisição

Sim

 

perc-unid-neg

DECIMAL

>>9.9999

% Unidade Negócio

Não

 

sequencia

INTEGER

>>9

Sequência do item

Sim

 

des-unid-negoc

CHARACTER

x(40)

Unidade de Negócio

Não

 

it-codigo

CHARACTER

x(16)

Item

Sim

 

ttRequestDefault

Entrada/Saída

Informações de uma requisição.

Obs: Mesma definição da temp-table ttRequest.

Saída

Atributo

Tipo

Formato

Descrição

Obrigatório

Evolução

 

 

 

 

 

 

ttEnableFields

Entrada/Saída

Campos habilitados e desabilitados da requisição

Saída

Atributo

Tipo

Formato

Descrição

Obrigatório

Evolução

tabela

CHARACTER

 

Tabela

Sim

 

campo

CHARACTER

 

Campo

Sim

 

habilitado

LOGICAL

 

Habilitado

Sim

 

ttGenericBusinessUnit

Entrada/Saída

Contém informações das unidades de negócio.

Saída

Atributo

Tipo

Formato

Descrição

Obrigatório

Evolução

perc-unid-neg

DECIMAL

>>9.9999

% Unidade de Negócio

Sim

 

cod_unid_negoc

CHARACTER

X(3)

Unidade de Negócio

Sim

 

des-unid-negoc

CHARACTER

x(40)

Unidade Negócio

Não

 

ttIntegrationAccountCCenterVO

Entrada/Saída

Contém informações a serem utilizada nas contas e centros de custo.

Saída

Atributo

Tipo

Formato

Descrição

Obrigatório

Evolução

company

CHARACTER

 

Empresa

Sim

 

centerCostPlan

CHARACTER

 

Plano do centro de custo

Não

 

accountPlan

CHARACTER

 

Plano da conta

Não

 

dateMovto

DATE

 

Data do movimento

Sim

 

site

CHARACTER

 

Estabelecimento

Não

 

module

CHARACTER

 

Módulo

Sim

 

ttRequestItemOriginal

Entrada/Saída

Contém informações dos itens de uma requisição.

Saída

Atributo

Tipo

Formato

Descrição

Obrigatório

Evolução

cod-depos

CHARACTER

x(3)

Depósito

Sim

 

cod-estabel

CHARACTER

x(5)

Estabelecimento

Sim

 

cod-localiz

CHARACTER

x(20)

Localização

Não

 

cod-refer

CHARACTER

x(8)

Referência

Sim

 

cod-unid-negoc

CHARACTER

X(3)

Unidade Negócio

Não

 

dt-atend

DATE

99/99/9999

Data Atendimento

Não

 

dt-entrega

DATE

99/99/9999

Data Entrega

Sim

 

ep-codigo

CHARACTER

x(3)

Empresa

Sim

 

estado

INTEGER

9

Estado

Sim

 

it-codigo

CHARACTER

x(16)

Item

Sim

 

nome-abrev

CHARACTER

x(12)

Requisitante

Sim

 

nome-aprov

CHARACTER

x(12)

Aprovador

Não

 

nr-requisicao

INTEGER

>>>,>>>,>>9

Requisicao

Sim

 

num-ord-inv

INTEGER

>>>,>>9

Ordem Invest

Não

 

numero-ordem

INTEGER

zzzzz9,99

Ordem Compra

Não

 

preco-unit

DECIMAL

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

Preço Unit

Sim

 

prioridade-aprov

INTEGER

>>9

Prioridade Aprovação

Não

 

qt-a-atender

DECIMAL

>>>,>>>,>>9.9999

Qtde Saldo

Não

 

qt-a-devolver

DECIMAL

>>>,>>>,>>9.9999

Qtde Devolver

Não

 

qt-atendida

DECIMAL

>>>,>>>,>>9.9999

Qtde Atend

Não

 

qt-devolvida

DECIMAL

>>>,>>>,>>9.9999

Qtde Dev

Não

 

qt-requisitada

DECIMAL

>>>,>>>,>>9.9999

Qtde Requisit

Sim

 

seq-planej

INTEGER

>>9

Seq Planej

Não

 

sequencia

INTEGER

>>9

Seq

Sim

 

situacao

INTEGER

>9

Situacao

Sim

 

un

CHARACTER

x(2)

Unid Medid

Sim

 

ct-codigo

CHARACTER

x(20)

Conta

Não

 

lote

CHARACTER

x(40)

Lote/Série

Não

 

narrativa

CHARACTER

x(2000)

Narrativa

Não

 

sc-codigo

CHARACTER

x(20)

Sub-Conta

Não

 

log-1

LOGICAL

Sim/Não

?

Não

 

log-2

LOGICAL

Sim/Não

?

Não

 

nome

CHARACTER

X(40)

Nome

Não

 

des-unid-negoc

CHARACTER

x(40)

Unidade Negócio

Não

 

descricao

CHARACTER

 

 

Não

 

desc-item

CHARACTER

x(60)

Descrição

Não

 

val-item

DECIMAL

>>>>>>,>>>,>>9.99

Valor

Não

 

cod-depos-desc

CHARACTER

x(40)

Descrição

Não

 

ct-codigo-desc

CHARACTER

 

 

Não

 

cod-refer-desc

CHARACTER

x(32)

Descrição

Não

 

log-1-desc

CHARACTER

 

 

Não

 

estado-desc

CHARACTER

x(3)

 

Não

 

situacao-desc

CHARACTER

 

 

Não

 

prioridade-aprov-desc

CHARACTER

 

 

Não

 

ep-codigo-desc

CHARACTER

x(60)

Razao Social

Não

 

cod-localiz-desc

CHARACTER

x(30)

Descrição

Não

 

un-desc

CHARACTER

x(15)

Descrição

Não

 

impactsQuality

LOGICAL

Sim/Não

 

Não

 

utilizationCode

CHARACTER

X(12)

Código da Utilização

Não

 

utilizationCodeDesc

CHARACTER

X(40)

Descrição

Não

 

hra-entrega

CHARACTER

99:99

Hora Entrega

Não

 

preco-unit-desc

CHARACTER

 

 

Não

 

ttRequestItemDefault

Entrada/Saída

Contém informações dos itens de uma requisição.

Obs: Mesmos campos da temp-table ttRequestItemOriginal mais os definidos abaixo

Saída

Atributo

Tipo

Formato

Descrição

Obrigatório

Evolução

desc-refer

CHARACTER

x(32)

Descrição da referência

Não

 

desc-un

CHARACTER

x(15)

Descrição da unidade de medida

Não

 

desc-ep

CHARACTER

x(70)

Nome empresa

Não

 

epc-value

CHARACTER

x(200)

Campo para customização

Não

 

ttBusinessUnit

Entrada/Saída

Contém informações das unidades de negócio.

Obs: Mesmos campos da ttGenericBusinessUnit.

Saída

Atributo

Tipo

Formato

Descrição

Obrigatório

Evolução

 

 

 

 

 

 

ttGenericBusinessUnitOriginal

Entrada/Saída

Contém informações das unidades de negócio.

Obs: Mesmos campos da ttGenericBusinessUnit.

Saída

Atributo

Tipo

Formato

Descrição

Obrigatório

Evolução

 

 

 

 

 

 

ttIntegrationAccountCCenterVO2

Entrada/Saída

Contém informações a serem utilizada nas contas e centros de custo.

Obs: Mesmos campos da tt ttIntegrationAccountCCenterVO

Saída

Atributo

Tipo

Formato

Descrição

Obrigatório

Evolução

 

 

 

 

 

 

ttListParameters

Entrada/Saída

Contém informações sobre parâmetros da api, como filtros e ordenações.

Saída

Atributo

Tipo

Formato

Descrição

Obrigatório

Evolução

sortBy

CHARACTER

 

Campo para ordenação: nr-requisicao, cod-estabel, tp-requis,

dt-requisicaoit-codigo, dt-entrega

Sim

 

orderAsc

LOGICAL

Sim/Não

Ascendente

Não

 

sight

INTEGER

 

Visão da tela: 0- Visão por requisição

1- Visão por item da requisição

Sim

 

basicFilter

CHARACTER

 

Filtro simples. (Será utilizada para filtrar requisições pelo número, código do item e descrição do item)

O filtro simples será aplicado considerando os outros filtros.

Não

 

rLastEstabelecRowid

ROWID

 

Rowid do estabelecimento do últmo registro retornado

Não

 

rLastRequestRowid

ROWID

 

Rowid da requisição do últmo registro retornado

Não

 

rLastRequestItRowid

ROWID

 

Rowid do item da requisição do últmo registro retornado

Não

 

statusOpen

LOGICAL

Sim/Não

Requisição aberta

Não

 

statusIncomplete

LOGICAL

Sim/Não

Requisição incompleta

Não

 

statusClosed

LOGICAL

Sim/Não

Requisição fechada

Não

 

statusWithOrder

LOGICAL

Sim/Não

Requisição com ordem

Não

 

approved

LOGICAL

Sim/Não

Requisição aprovada

Não

 

notApproved

LOGICAL

Sim/Não

Requisição não aprovada

Não

 

inventoryRequest

LOGICAL

Sim/Não

Requisição de estoque

Não

 

purchaseRequest

LOGICAL

Sim/Não

Requisição de compra

Não

 

quotationRequest

LOGICAL

Sim/Não

Requisição cotação

Não

 

dateIni

DATE

99/99/9999

Data inicial da requisição

Não

 

dateEnd

DATE

99/99/9999

Data final da requisição

Não

 

requestNumberIni

INTEGER

>>>,>>>,>>9

Requisição inicial

Não

 

requestNumberEnd

INTEGER

>>>,>>>,>>9

Requisição final

Não

 

siteIni

CHARACTER

x(5)

Estabelecimento inicial

Não

 

siteEnd

CHARACTER

x(5)

Estabelecimento final

Não

 

requesterIni

CHARACTER

x(12)

Requisitante inicial

Não

 

requesterEnd

CHARACTER

x(12)

Requisitante final

Não

 

descriptionItem

CHARACTER

 

Narrativa do item da requisição

Não

 

descriptionRequestCHARACTER Narrativa da requisiçãoNão 

itemCodeIni

CHARACTER

x(16)

Item inicial

Não

 

itemCodeEnd

CHARACTER

x(16)

Item final

Não

 

itemDescriptionIni

CHARACTER

x(60)

Descrição inicial do item

Não

 

itemDescriptionEnd

CHARACTER

x(60)

Descrição final do item

Não

 

itemCompCodeIni

CHARACTER

x(20)

Código Complementar inicial

Não

 

itemCompCodeEnd

CHARACTER

x(20)

Código Complementar final

Não

 

itemCompInfoIni

CHARACTER

x(16)

Inf. Complementar inicial

Não

 

itemCompInfoEnd

CHARACTER

x(16)

Inf. Complementar final

Não

 

lowPriorityLOGICAL Flag que indica se devem ser consideradas na busca as requisições com prioridade baixaNão 
mediumPriorityLOGICAL Flag que indica se devem ser consideradas na busca as requisições com prioridade médiaNão 
highPriorityLOGICAL Flag que indica se devem ser consideradas na busca as requisições com prioridade altaNão 
veryHighPriorityLOGICAL Flag que indica se devem ser consideradas na busca as requisições com prioridade muito altaNão 
buyerIniCHARACTERX(12)Comprador InicialNão 
buyerEndCHARACTERX(12)Comprador FinalNão 
alternativeRequestLOGICAL Requisições alternativasNão 
requesttoprocessLOGICAL Flag que indica que a execução é pela tela requesttoprocessNão 
urgentYesLOGICAL Não urgentesNão 
urgentNoLOGICAL UrgenteNão 
onlyBuyerGroupLOGICAL Flag que indica se devem ser consideradas apenas as requisições do grupo do compradorNão 
purchaseGroupIniCHARACTERX(12)Grupo de Compra InicialNão 
purchaseGroupEndCHARACTERX(12)Grupo de Compra FinalNão 

ttSummaryRequestItem

Entrada/Saída

Contém as principais informações dos itens de uma requisição

Saída

Atributo

Tipo

Formato

Descrição

Obrigatório

Evolução

desc-item    

CHARACTER

x(60)

Descrição do item

Não

 

dt-entrega   

DATE

99/99/9999

Data de entrega

Sim

 

estado       

INTEGER

9

Estado da requisição

Sim

 

it-codigo    

CHARACTER

x(16)

Item

Sim

 

log-1        

LOGICAL

Sim/Não

Urgente

Não

 

nr-requisicao

INTEGER

>>>,>>>,>>9

Requisicao

Sim

 

qt-requisitada

DECIMAL

>>>,>>>,>>9.9999

Quantidade Requisitada

Sim

 

situacao     

INTEGER

>9

Situação

Sim

 

un           

CHARACTER

x(2)

Unidade de medida

Sim

 

ct-codigo    

CHARACTER

x(20)

Conta

Não

 

sc-codigo    

CHARACTER

x(20)

Sub-Conta

Não

 

cod-estabel  

CHARACTER

x(5)

Estabelecimento

Sim

 

nome-abrev   

CHARACTER

x(12)

Requisitante

Sim

 

estado-desc  

CHARACTER

 

Descrição do estado

Não

 

situacao-desc

CHARACTER

 

Descrição da situação

Não

 

narrativa    

CHARACTER

x(2000)

Narrativa do item

Não

 

sequencia    

INTEGER

>>9

Sequência do item

Sim

 

hra-entrega  

CHARACTER

99:99

Hora de entrega

Não

 

ttSummaryRequestItemCopy

Entrada/Saída

Contém as principais informações dos itens de uma requisição.

Obs: Mesmos campos da temp-table ttSummaryRequestItem mais os definidos abaixo.

Saída

Atributo

Tipo

Formato

Descrição

Obrigatório

Evolução

un-desc

CHARACTER

x(15)

Descrição da unidade de medida

Não

 

ttIntegrationAccountCCenterVO2

Entrada/Saída

Contém informações a serem utilizada nas contas e centros de custo.

Obs: Mesmos campos da tt ttIntegrationAccountCCenterVO

Saída

Atributo

Tipo

Formato

Descrição

Obrigatório

Evolução

 

 

 

 

 

 

ttFieldsReportConfigDefaultEntrada/Saída
Contém as informações dos campos disponíveis no relatórioSaída
AtributoTipoFormatoDescriçãoObrigatórioEvolução
fieldNameCHARACTER Nome do campoSim 
fieldLabelCHARACTER Label do campoSim 
fieldShowLOGICAL Flag que indica se o campo estará visível ou nãoSim 

 

 

 

Metodo Negócio

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

REST_GET_ requestDetails

Requisito

Nenhum

Sintaxe

RUN REST_GET_requestDetails in handle (INPUT <integer>,

                                                                        OUTPUT TABLE <temp-table>,

                                                                       OUTPUT <logical>,

                                                                       OUTPUT TABLE <temp-table>).

Descrição

Retornar informações de uma requisição.

Parâmetros

Descrição

QP_pNrRequisicao

ttRequest

lHabilita

RowErrors

Número da requisição

Informações da requisição

Indica se as opções de inclusão/edição de itens ou requisição deve ser habilitada.

Erros ocorridos no processo

Retorno

Retorna uma temp-table contendo informações de uma requisição, se é possível altera-la ou incluir itens e uma temp-table com os erros ocorridos no processo.

REST_GET_ requestItems

Requisito

Nenhum

Sintaxe

RUN REST_GET_ requestItems   in handle (INPUT <integer>,

                                                                         INPUT <rowid>,

                                                                        INPUT <logical>,

                                                                        OUTPUT <logical>,

                                                                        OUTPUT <integer>,

                                                                        OUTPUT TABLE <temp-table>,

                                                                        OUTPUT TABLE <temp-table>).

Descrição

Retorna os itens de uma requisição.

Parâmetros

Descrição

QP_pNrRequisicao

QP_pRowidItRequisicao

QP_ pShouldPaginate

lHabilita

length

ttItRequisicaoResumida

RowErrors

Número da requisição

Rowid do último item da lista (paginação) (Se for a primeira busca passar "?" para o campo)

Indica se deve utilizar paginação

Indica se as opções de inclusão/edição de itens deve ser habilitada.

Quantidade total de registros

Itens de uma requisição.

Erros ocorridos no processo

Retorno

Retorna uma temp-table contendo informações dos itens de uma requisição, se é possível altera-los ou incluir, quantidade total de registros e uma temp-table com os erros ocorridos no processo.

REST_GET_ requestItemDetails

Requisito

Nenhum

Sintaxe

RUN REST_GET_ requestItemDetails in handle (INPUT <integer>,

                                                                                INPUT <integer>,

                                                                               INPUT <character>,

                                                                               OUTPUT <logical>,

                                                                                OUTPUT <dataset>,

                                                                               OUTPUT TABLE <temp-table>).

Descrição

Retorna os detalhes de um item da requisição.

Parâmetros

Descrição

QP_pNrRequisicao

QP_pSequencia

QP_pItCodigo

lHabilita

dsItRequest

RowErrors

Número da requisição

Sequência do item

Código do item

Indica se as opções de inclusão/edição de itens deve ser habilitada.

Contém os detalhes do item da requisição e respectivas unidades de negócios

Erros ocorridos no processo

Retorno

Retorna um dataset contendo informações dos detalhes de um item da requisição, suas unidades de negócio, se é possível altera-lo e uma temp-table com os erros ocorridos no processo.

REST_GET_ getDefaults

Requisito

Nenhum

Sintaxe

RUN REST_GET_ getDefaults in handle (OUTPUT TABLE <temp-table>,

                                                                   OUTPUT TABLE <temp-table>).

Descrição

Retornar os valores padrões para o preenchimento dos campos de uma requisição e os campos que devem estar habilitados/ e desabilitados na inclusão.

Parâmetros

Descrição

ttRequestDefault

ttEnableFields

Valores padrões da requisição

Campos habilitados e desabilitados da requisição

Retorno

Retorna duas temp-tables, uma contendo os valores padrões para inserção de uma nova requisição e outra contendo os campos a serem habilitados em tela.

REST_GET_ getRequestToUpdate

Requisito

Nenhum

Sintaxe

RUN REST_GET_ getRequestToUpdate in handle (INPUT <integer>,

                                                                                    OUTPUT TABLE <temp-table>,

                                                                                    OUTPUT TABLE <temp-table>).

Descrição

Retornar os detalhes de uma requisição e os campos que devem ser habilitados/desabilitados na alteração.

Parâmetros

Descrição

QP_pNrRequisicao

ttRequestDefault

ttEnableFields

Número da requisição a ser retornada

Informações da requisição

Campos habilitados e desabilitados da requisição

Retorno

Retorna duas temp-tables, uma contendo as informações da requisição e outra contendo os campos a serem habilitados em tela.

REST_POST

Requisito

Nenhum

Sintaxe

RUN REST_POST in handle (INPUT <temp-table>,

                                                OUTPUT TABLE <temp-table>).

Descrição

Incluir uma nova requisição.

Parâmetros

Descrição

ttRequest

RowErrors

Temp-table com os dados da nova requisição

Erros ocorridos durante o processo

Retorno

Retorna os erros ocorridos no processo.

REST_PUT

Requisito

Nenhum

Sintaxe

RUN REST_PUT in handle (INPUT <temp-table>,

                                              OUTPUT TABLE <temp-table>).

Descrição

Alterar uma requisição.

Parâmetros

Descrição

ttRequest

RowErrors

Temp-table com os dados da requisição a ser alterada

Erros ocorridos durante o processo

Retorno

Retorna os erros ocorridos no processo.

REST_ DELETE

Requisito

Nenhum

Sintaxe

RUN REST_ DELETE in handle (INPUT <integer >,

                                                      OUTPUT TABLE <temp-table>).

Descrição

Remove uma requisição existente.

Parâmetros

Descrição

QP_pNrRequisicao

RowErrors

Número da requisição a ser removida

Erros ocorridos durante o processo

Retorno

Retorna os erros ocorridos no processo.

REST_GET_validateBtUpdateRequest

Requisito

Nenhum

Sintaxe

RUN REST_GET_validateBtUpdateRequest in handle (INPUT <integer>,

                                                                                         OUTPUT <logical>).

Descrição

Verificar se a requisição pode ser modificada.

Parâmetros

Descrição

QP_ pNrRequisicao

lHabilita

Número da requisição a ser verificada

Indica se a requisição pode ou não ser modificada

Retorno

Retorna uma variável lógica identificado se a requisição pode ser modificada.

REST_GET_ getDefaultsItem

Requisito

Nenhum

Sintaxe

RUN REST_GET_ getDefaultsItem in handle (INPUT <integer >,

                                                                           OUTPUT <logical>,

                                                                           OUTPUT <logical>,

OUTPUT <logical>,

                                                                           OUTPUT TABLE <temp-table>,

                                                                           OUTPUT TABLE <temp-table>,

                                                                           OUTPUT TABLE <temp-table>,

                                                                           OUTPUT TABLE <temp-table>,

                                                                           OUTPUT TABLE <temp-table>,

                                                                           OUTPUT TABLE <temp-table>,

                                                                           OUTPUT TABLE <temp-table>).

Descrição

Retornar os valores padrões para o preenchimento dos campos de um novo item da requisicao, dados da requisição, unidades de negócio, e os campos que devem estar habilitados e desabilitados na inclusão.

Parâmetros

Descrição

QP_ pNrRequisicao

lExibeUnidNegoc

lHabilitaUnidNegoc

lOcultaPreco

ttRequest

ttIntegrationAccountCCenterVO2

ttRequestItemDefault

ttEnableFields

ttGenericBusinessUnit

ttBusinessUnit

RowErrors

Número da requisição do item a ser inserido

Indica se deve exibir as unidades de negócio

Indica se deve habilitar as unidades de negócio para edição

Indica se deve ocultar o valor da requisição

Informações da requisição a qual o item pertence

Filtros a serem utilizados para sugestão do centro de custo

Informações default do item da requisição

Campos a serem habilitados/desabilitados para o item da requisição

Unidades de negócio do item da requisição

Unidades de negócio selecionáveis para o item

Erros ocorridos no processo

Retorno

Retorna as informações padrões para inclusão de um item da requisição, suas unidades de negócio e informações da requisição a qual pertence.

REST_POST_onLeaveItemRequisicao

Requisito

Nenhum

Sintaxe

RUN REST_POST_ onLeaveItemRequisicao in handle (INPUT <character >,

                                                                                          INPUT <character>,

                                                                                          INPUT TABLE <temp-table>,

                                                                                           INPUT TABLE <temp-table>,

                                                                                          OUTPUT TABLE <temp-table>,

                                                                                         OUTPUT TABLE <temp-table>,

                                                                                          OUTPUT TABLE <temp-table>,

                                                                                          OUTPUT TABLE <temp-table>).

Descrição

Retornar os dados atualizados para as temp-tables de acordo com os leaves dos campos.

Parâmetros

Descrição

QP_Action

QP_ pField

ttRequestItemOriginal

ttGenericBusinessUnitOriginal

ttRequestItemDefault

ttEnableFields

ttGenericBusinessUnit

RowErrors

Tipo de transação (create, update)

Nome do campo em que ocorreu o leave

Informações atuais do registro de item da requisição

Informações atuais das unidades de negócio do registro de item da requisição

Informações atualizadas do item da requisição

Campos a serem habilitados/desabilitados

Unidades de negócio atualizadas do item da requisição

Erros ocorridos no processo

Retorno

Retorna as informações atualizadas do item da requisição, suas unidades de negócio, campos que devem estar habilitadas e desabilitados em tela de acordo com o campo em que o “Leave” ocorreu. Além disso, retorna os erros ocorridos durante o processo.

REST_GET_ getRequestItemForEdit

Requisito

Nenhum

Sintaxe

RUN REST_GET_ getRequestItemForEdit in handle (INPUT <integer >,

                                                                                       INPUT <integer>,

                                                                                       INPUT <character>,

                                                                                       OUTPUT <logical>,

                                                                                       OUTPUT <logical>,

OUTPUT <logical>,

                                                                                      OUTPUT TABLE <temp-table>,

                                                                                      OUTPUT TABLE <temp-table>,

                                                                                      OUTPUT TABLE <temp-table>,

                                                                                      OUTPUT TABLE <temp-table>,

                                                                                      OUTPUT TABLE <temp-table>,

                                                                                      OUTPUT TABLE <temp-table>,

                                                                                      OUTPUT TABLE <temp-table>).

Descrição

Retornar os dados de um item da requisição para realizar a edição.

Parâmetros

Descrição

QP_pNrRequisicao

QP_pSequencia

QP_pItCodigo

lHabilitaUnidNegoc

lExibeUnidNegoc

lOcultaPreco

ttRequest

ttIntegrationAccountCCenterVO2

ttRequestItemDefault

ttEnableFields

ttGenericBusinessUnit

ttBusinessUnit

RowErrors

Número da requisição

Sequência do item a ser modificado

Código do item a ser modificado

Informa se deve habilitar as unidades de negócio para edição

Informa se deve exibir as unidades de negócio

Informa se deve exibir o valor da requisição

Informações da requisição a qual o item pertence

Filtros a serem utilizados para sugestão do centro de custo

Informações do item da requisição

Campos a serem habilitados e desabilitados

Unidades de negócio do item da requisição

Unidades de negócio selecionáveis para o item

Erros ocorridos no processo

Retorno

Retorna as informações de um item para edição, suas unidade de negócio e os erros ocorridos no processo.

REST_POST_createUpdateRequestItem

Requisito

Nenhum

Sintaxe

RUN REST_POST_ createUpdateRequestItem in handle (INPUT <character >,

                                                                                           INPUT <logical>,

                                                                                           INPUT TABLE <temp-table>,

                                                                                          INPUT TABLE <temp-table>,

                                                                                          OUTPUT TABLE <temp-table>).

Descrição

Realizar a criação/edição de um item da requisição.

Parâmetros

Descrição

QP_pAction

QP_pLastItem

ttRequestItemOriginal

ttGenericBusinessUnit

RowErrors

Tipo de transação (create, update)

Indica se é o último item a ser registrado

Informações do item da requisição

Unidades de negócio do item da requisição

Erros ocorridos no processo

Retorno

Retorna os erros ocorridos no processo de edição/inclusão do item da requisição.

REST_POST_updateApprovalInfo

Requisito

Nenhum

Sintaxe

RUN REST_POST_ updateApprovalInfo in handle (INPUT <temp-table>, 

                                                                                  OUTPUT TABLE <temp-table>).

Descrição

Atualizar as informações de aprovação.

Parâmetros

Descrição

ttRequestItemDefault

RowErrors

Informações do item da requisição

Erros ocorridos no processo

Retorno

Retorna os erros ocorridos no processo.

REST_DELETE_removeRequestItem

Requisito

Nenhum

Sintaxe

RUN REST_DELETE_ removeRequestItem in handle (INPUT <integer>,

                                                                                 INPUT <integer>, 

                                                                                INPUT <character>,

                                                                                 OUTPUT TABLE <temp-table>).

Descrição

Remover um item da requisição

Parâmetros

Descrição

Qp_pNrRequisicao

QP_pSequencia

QP_pItCodigo

RowErrors

Número da requisição do item a ser removido

Sequência do item a ser removido

Código do item a ser removido

Erros ocorridos no processo

Retorno

Retorna os erros ocorridos no processo de remoção do item da requisição.

REST_POST_getListRequests

Requisito

Nenhum

Sintaxe

RUN REST_POST_getListRequests in handle (INPUT TABLE <temp-table>,

                                                                            INPUT TABLE <temp-table>, 

                                                                            OUTPUT <logical>,

                                                                             OUTPUT <integer>,

                                                                            OUTPUT TABLE <temp-table>,

                                                                            OUTPUT <character>,

                                                                             OUTPUT <rowid>,

                                                                            OUTPUT <rowid>).

Descrição

Retornar as requisições ou itens das requisições

Parâmetros

Descrição

ttListParameters

currentTTRequestList

lEnableUpdate

iCount

ttRequestList

cCodEstabelec

rLastRequestRowid  

rLastRequestItRowid

Parâmetros utilizados pela api para retornar os registros (filtros, ordenação, visão de tela entre outros).

Temp-table contendo os registros já retornados anteriormente (utilizado para evitar duplicatas)

Indica se as opções de copiar/adicionar/editar devem ficar habilitadas em tela

Quantidade de registros (requisições)

Informações das requisições

Código do estabelecimento do último registro retornado

Rowid da tabela de requisições do último registro retornado

Rowid da tabela de itens das requisições do último registro retornado

Retorno

Retorna os erros ocorridos no processo de remoção do item da requisição.

validateUserPermission

Requisito

Nenhum

Sintaxe

RUN validateUserPermission in handle (OUTPUT <logical>).

Descrição

Verificar se o usuário possui permissão para editar as requisições de outros usuários.

Parâmetros

Descrição

lHabilita

Indica se o usuário possui permissão para editar requisições de outros usuários.

Retorno

Retorna uma variável identificando se o usuário possui permissão para editar requisições de outros usuários.

 

 

REST_GET_ getSummaryRequestItem

Requisito

Nenhum

Sintaxe

RUN REST_GET_ getSummaryRequestItem in handle (INPUT <integer>,

                                                                                          INPUT <integer>,

                                                                                          OUTPUT <integer>,

                                                                                         OUTPUT TABLE <temp-table>,

                                                                                          OUTPUT TABLE <temp-table>).

Descrição

Retornar os itens de uma requisição para realizar a cópia de itens.

Parâmetros

Descrição

QP_pNrRequisicaoOrig

QP_NrRequisicaoDest

pTipRequis

ttSummaryRequestItem

RowErrors

Número da requisição origem

Número da requisição destino

Tipo da requisição destino

Itens da requisição origem

Erros ocorridos no processo

Retorno

Retorna uma temp-table com as informações dos itens da requisição origem e os erros ocorridos no processo.

REST_POST_copyItemRequest

Requisito

Nenhum

Sintaxe

RUN REST_POST_copyItemRequestin handle (INPUT <integer>,

                                                                               INPUT TABLE <temp-table>,

                                                                             OUTPUT TABLE <temp-table>).

Descrição

Realizar a cópia dos itens de uma requisição para outra

Parâmetros

Descrição

PP_pNrRequisicao

ttSummaryRequestItem

RowErrors

Número da requisição destino

Itens da requisição a serem copiados

Erros ocorridos no processo

Retorno

Retorna os erros ocorridos durante o processo.

REST_POST_updateStatus

Requisito

Nenhum

Sintaxe

RUN REST_POST_updateStatus in handle (INPUT <temp-table>).

Descrição

Atualizar o status da requisição

Parâmetros

Descrição

ttRequestList

Informações do item da requisição

Retorno

"OK" caso não ocorra erro

REST_GET_getFieldsReportConfigDefault

Requisito

Nenhum

Sintaxe

RUN REST_GET_getFieldsReportConfigDefault in handle (OUTPUT <temp-table>).

Descrição

Retorna uma temp-table com os campos disponíveis no relatório do atendimento das requisições (html.cc0325)

Parâmetros

Descrição

ttFieldsReportConfigDefault

Campos disponíveis para uso no relatório

Retorno

"OK" caso não ocorra erro

#trackbackRdf ($trackbackUtils.getContentIdentifier($page) $page.title $trackbackUtils.getPingUrl($page))