Documento de API
Produto: | Datasul |
Ocorrência: | Documentação de API |
Nome Físico | mip/miapi075.p |
Objetivo
A API faz através das temp-tables passadas como parâmetro, a confirmação do planejamento de materiais.
Funcionamento
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.
Tabelas Temporárias
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 |
Métodos
Quando a API for executada em modo persistente, os seguintes métodos estarão disponíveis para execução:
Método Negócio
confirmMaterialPlanning
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. |