Retornar as informações usadas na tela de configuração de geração de ordens de compra

Características do Requisito

Retornar as informações usadas na tela de configuração de geração de ordens de compra.

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 por intermédio da chamada de um comando RUN conforme exemplo a seguir.

A sintaxe para executar a API em modo persistente é:

RUN ccp/ccapi361.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.

ttViewAs					Entrada/Saída
Temp-table com os valores dos campos que possuem view-as no progress (que usam as includes padrões para retornar o sua descrição).					Saída
Atributo	Tipo	Formato	Descrição	Obrigatório	Evolução
fieldName	CHARACTER		Nome do campo	Sim
fieldValue	INTEGER		Valor do campo	Sim
fieldText	CHARACTER		Texto do campo	Sim

ttViewAsAux					Entrada/Saída
Obs: mesmos campos da ttViewAs.					Saída
Atributo	Tipo	Formato	Descrição	Obrigatório	Evolução

RowErrorsAux					Entrada/Saída
Temp-table com os erros do processamento					Saída
Atributo	Tipo	Formato	Descrição	Obrigatório	Evolução
ErrorSequence	INTEGER	->,>>>,>>9	ErrorSequence	Sim
ErrorNumber	INTEGER	->,>>>,>>9	ErrorNumber	Sim
ErrorDescription	CHARACTER	x(8)	ErrorDescription	Não
ErrorParameters	CHARACTER	x(8)	ErrorParameters	Não
ErrorType	CHARACTER	x(8)	ErrorType	Não
ErrorHelp	CHARACTER	x(8)	ErrorHelp	Não
ErrorSubType	CHARACTER	x(8)	ErrorSubType	Não

ttSummaryRequestItem					Entrada/Saída
Temp-table com as solicitações que serão atendidas					Entrada
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 Entrega	Não
estado	INTEGER	9	Estado	Não
it-codigo	CHARACTER	x(16)	Item	Não
log-1	LOGICAL	Sim/Não	log-1	Não
nr-requisicao	INTEGER	>>>,>>>,>>9	Requisicao	Não
qt-requisitada	DECIMAL	>>>,>>>,>>9.9999	Qtde Requisit	Não
situacao	INTEGER	>9	Situacao	Não
un	CHARACTER	x(2)	Unidade de Medida	Não
ct-codigo	CHARACTER	x(20)	Conta Contábil	Não
sc-codigo	CHARACTER	x(20)	Centro de Custo	Não
cod-estabel	CHARACTER	x(5)	Estabelecimento	Não
nome-abrev	CHARACTER	x(12)	Requisitante	Não
estado-desc	CHARACTER	x(8)	Descrição Estado	Não
situacao-desc	CHARACTER	x(8)	Descrição situação	Não
narrativa	CHARACTER	x(2000)	Narrativa	Não
sequencia	INTEGER	>>9	Sequência	Não
hra-entrega	CHARACTER	99:99	Hora Entrega	Não

ttSummaryPurchRequisition					Entrada/Saída
Temp-table com as informações das ordens geradas					Saída
Atributo	Tipo	Formato	Descrição	Obrigatório	Evolução
cod-comprado	CHARACTER	X(12)	Comprador	Não
cod-estabel	CHARACTER	x(5)	Estabelecimento	Não
it-codigo	CHARACTER	X(16)	Item	Não
narrativa	CHARACTER	X(2000)	Narrativa	Não
nr-processo	INTEGER	999,999	Processo	Não
numero-ordem	INTEGER	zzzzz9,99	Ordem	Não
situacao	INTEGER	>9	Situação	Não
it-codigo-desc	CHARACTER	x(8)	it-codigo-desc	Não
qt-solic	DECIMAL	>>>,>>>,>>9.9999	Qtde	Não
data-entrega	DATE	99/99/9999	Data Entrega	Não
un	CHARACTER	xx	Unid Medid	Não
parcelado	LOGICAL	yes/no	parcelado	Não
num-pedido	INTEGER	>>>>>,>>9	Pedido	Não
approved	LOGICAL	yes/no	approved	Não
requisitante	CHARACTER	X(12)	Requisitante	Não
situacao-desc	CHARACTER	x(8)	situacao-desc	Não
nr-requisicao	INTEGER	>>>,>>>,>>9	Requisicao	Não

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

REST_GET_getDefaultInformation
Requisito	Nenhum
Sintaxe	RUN REST_GET_getDefaultInformation in handle (OUTPUT <logical>, OUTPUT TABLE <temp-table>).
Descrição	Retornar as informações iniciais da tela, como as opções do campo "Natureza Ordem", "ICMS", e o parâmetro que indica se a geração é por comprador (false) ou grupo de compra (true).
	Parâmetros	Descrição
	generateByPurchaseGroup ttViewAs	Indica se a geração é por comprador (false) ou grupo de compra (true) Temp-table com as opções do campo Natureza Ordem.
Retorno	"OK" caso não tenha ocorrido nenhum erro durante a execução.

REST_GET_checkBuyer
Requisito	Nenhum
Sintaxe	RUN REST_GET_checkBuyer in handle (INPUT<character>, OUTPUT <logical>).
Descrição	Retornar se o comprador é válido ou não
	Parâmetros	Descrição
	QP_pBuyer pValidBuyer	Código do comprador. Flag que indica se é um comprador válido.
Retorno	"OK" caso não tenha ocorrido nenhum erro durante a execução.

REST_POST_processRequest
Requisito	Nenhum
Sintaxe	RUN REST_POST_processRequest in handle (INPUT<temp-table>, INPUT <character>, INPUT <integer>, INPUT <integer>, INPUT <logical>, INPUT <logical>, INPUT <integer>, INPUT <character>, OUTPUT <temp-table>, OUTPUT <temp-table>).
Descrição	Faz a ponte da tela HTML e a fachada de atendimento da solicitação.
	Parâmetros	Descrição
	ttSummaryRequestItem QP_usuario QP_icms QP_generateOrders QP_groupItems QP_divideOrders QP_generateOrdersRelation QP_buyer ttSummaryPurchRequisition RowErrorsAux	Temp-table com os itens que se deseja criar pedidos Usuário logado no sistema ICMS (Industrialização ou consumo) Natureza (Conforme o item, Material, Serviço ou Beneficiamento) Agrupar Itens Dividir ordens entre fornecedores Relacionar ordens ao grupo de compra ou comprador Comprador Temp-table com as ordens criadas Temp-table com os erros do processamento
Retorno	"OK" caso não tenha ocorrido nenhum erro durante a execução.