MIAPI075 - Confirmação do Planejamento de Materiais.

Documento de API

Objetivo

A API faz através das temp-tables passadas como parâmetro, a confirmação do planejamento de materiais.

A API faz a confirmação do planejamento para compra ou produção dos materiais necessários as ordens de manutenção existentes no sistema.

Então para todos os registros da tabela de Planejamento do Período serão geradas ordens de compra ou ordens de produção.

A sintaxe para executar a API em modo persistente é:

run mip\miapi075.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.

Nos atributos das tabelas temporárias de entrada e saída:

Tabela Temporária	Descrição	Entrada/Saída
ttSelecao	Tabela temporária com a seleção do filtro	Entrada

Atributo	Tipo	Formato	Descrição	Obrigatório	Evolução
familyInit	Char	Padrão	Família do Item Inicial do filtro	Sim	001
familyFinal	Char	Padrão	Família do Item Final do Filtro	Sim	001
stockGroupInit	Integer	Padrão	Grupo de Estoque Inicial do Filtro	Sim	001
stockGroupFinal	Integer	Padrão	Grupo de Estoque Final do Filtro	Sim	001
itemInit	Char	Padrão	Item inicial do Filtro	Sim	001
itemFinal	Char	Padrão	Item final do Filtro	Sim	001
plannerInit	Char	Padrão	Planejador Inicial do Filtro	Sim	001
plannerFinal	Char	Padrão	Planejador Final do Filtro	Sim	001
productionLineInit	Integer	Padrão	Linha de Produção Inicial do Filtro	Sim	001
productionLineFinal	Integer	Padrão	Linha de Produção Final do Filtro	Sim	001
establishmentInit	Char	Padrão	Estabelecimento Inicial do Filtro	Sim	001
establishmentFinal	Char	Padrão	Estabelecimento Final do Filtro	Sim	001
bussinessUnitInit	Char	Padrão	Unidade de Negócio Inicial do Filtro	Sim	001
bussinessUnitFinal	Char	Padrão	Unidade de Negócio Final do Filtro	Sim	001
priceType	Integer	Padrão	Tipo de preço	Sim	001
currency	Integer	Padrão	Moeda corrente	Sim	001
dateInitial	Date	99/99/9999	Data Inicial do Filtro	Sim	001
dateFinal	Date	99/99/9999	Data Final do Filtro	Sim	001

Tabela Temporária	Descrição	Entrada/Saída
ttParametros	Tabela temporária com os parâmetros informados ao gerar o planejamento dos materiais	Entrada

Atributo	Tipo	Formato	Descrição	Obrigatório	Evolução
showReprogrammedOrders	logical	padrão	Valor que informa se as ordens reprogramadas serão apresentadas	Sim	001
considersPredictedConsumption	logical	padrão	Considerar Consumo Previsto	Sim	001
checkNeedOrders	logical	padrão	Considerar Necessidade das Ordens de Produção, para o planejamento dos Materiais	Sim	001
dependentDemand	logical	padrão	Considerar Itens com Demanda Dependente	Sim	001
independentDemand	logical	padrão	Considerar Itens com Demanda Independente	Sim	001
initialConsumptionDate	date	99/99/9999	Data de Consumo Inicial	Sim	001
cutDate	date	99/99/9999	Data de Corte	Sim	001

Tabela Temporária	Descrição	Entrada/Saída
ttReprogramadas	Contém os registros das Ordens reprogramadas na confirmação do planejamento de materiais	Saída

Atributo	Tipo	Formato	Descrição	Obrigatório	Evolução
numberOrder	integer	padrão	Número da Ordem Reprogramada	Não	001
itemCode	char	padrão	Código do Item reprogramado	Não	001
itemDescription	char	padrão	Descrição do Item	Não	001
typeCode	integer	padrão	Tipo : 1 – Ordem de Compra 2 – Ordem de Produção	Não	001
currentDate	date	99/99/9999	Data Corrente	Não	001
reprogramationDate	date	99/99/9999	Data da Reprogramação da Ordem	Não	001
qtdBalance	decimal	padrão	Quantidade reprogramada	Não	001

Tabela Temporária	Descrição	Entrada/Saída
RowErrors	Contém os erros ocorridos na API (Mesma temp-table utilizada para gerar erros pelas BOs)	Saída

Atributo	Tipo	Formato	Descrição	Obrigatório	Evolução
ErrorSequence	integer	padrão	Seqüência dos erros	Sim	001
ErrorNumber	integer	padrão	Número do erro	Sim	001
ErrorDescription	char	padrão	Descrição do erro	Sim	001
ErrorParameters	char	padrão	Parâmetros passados para criar mensagem	Não	001
ErrorType	char	padrão	Tipo do erro: WARNING: Aviso ERROR: Erro	Sim	001
ErrorHelp	char	padrão	Texto de ajuda do erro	Sim	001
ErrorSubType	char	padrão	Sub Tipo da mensagem de erro	Não	001

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

Método Negócio

Requisito	Handles estarem inicializados.
Sintaxe	RUN confirmMaterialPlanning IN h-handle (INPUT TABLE ttSelecao, INPUT TABLE ttParametros, OUTPUT TABLE ttReprogramadas, OUTPUT TABLE RowErrors).
Descrição	Confirmar o Planejamento de Materiais
	Parâmetros	Descrição
	ttSelecao ttParametros ttReprogramad as RowErrors	Tabela Temporária com as informações do filtro realizado Tabela Temporária com as informações dos parâmetros ao realizar o planejamento Tabela Temporária com as informações da ordens reprogramadas. Tabela temporária com os erros que poderão retornar da API.
Retorno	A API/BO irá setar o return-value de forma a informar ao programa “chamador” se a execução foi realizada com sucesso ou não. Os valores possíveis para o return-value são: OK (execução correta) e NOK (execução com problemas). Os motivos para a rejeição do movimento de reporte são especificados na temp-table RowErrors.