Ordem de Produção: Criação e Preparação — Documentação Complementar

Pré-requisito	Por que importa
Fórmula de Fabricação Ativa	É a origem de toda Ordem de Produção. Fórmula em Edição ou Inativa recusa a criação com "A Fórmula N não está Ativa." Ver Fórmula de Fabricação.
Empresa ou filial (FILIAL)	Parâmetro de todas as rotinas de criação. No caminho do planejamento, é dela que sai o setor padrão.
Setor / centro de custo (SETOR)	Onde o custo da produção é apropriado.
Local de estoque (LOCEST)	De onde os insumos saem e para onde o produto fabricado entra.
Turnos de trabalho (FABTURNOEMPRESA)	Definem a jornada usada no cálculo das janelas previstas dos processos.
Custo de máquina (FABMAQUINACUSTO)	Sem custo cadastrado para a máquina na faixa de horário da programação, o recálculo do custo previsto é interrompido com mensagem.
Saldo em estoque dos insumos	A reserva automática confere o saldo e recusa o processo inteiro quando falta.
Registro em Órgão Regulatório dos produtos	Produto com registro vencido faz a criação recusar, listando os produtos.
FABCONFIG	CFG_RESERVAPARCIAL liga e desliga a reserva inteira; CFG_PERMANUTENCAO1 é a data de corte que bloqueia alteração retroativa nos processos.

Escolha um. Os três terminam numa Ordem de Produção completa, mas partem de pontos diferentes e dão graus diferentes de controle:

Rotina	Você informa	Quando usar
FAB_PRC_GERAROPFORMULA	A Fórmula, ou o produto, ou a matéria prima principal	O caminho principal. É o único com controle explícito sobre qual Fórmula será usada, e o único que aceita programar, firmar e reservar na mesma chamada. As outras duas o chamam por baixo.
FAB_PRC_GERAROPPEDIDO	Listas de pedidos e de itens de Pedido de Venda	Quando a produção é puxada por venda. Agrupa os itens elegíveis e cria uma Ordem de Produção por grupo, já vinculada aos itens que a originaram.
FAB_PRC_GERAROPMRP	Produto, quantidade e data	Quando a produção vem do planejamento de necessidades. A Fórmula é descoberta pelo produto, sob critérios rígidos, e os processos já saem programados.

Cria a Ordem de Produção completa: cabeçalho, produtos a fabricar, processos, insumos previstos, mão de obra prevista, máquinas, setups e especificações, com todos os custos previstos calculados.

São doze parâmetros; os sete últimos são opcionais:

Parâmetro	Descrição
P_CODIGO	Código cujo significado depende de P_QTDREF — ver o bloco seguinte.
P_FL_COD	Empresa ou filial da Ordem de Produção.
P_ST_COD	Setor ou centro de custo.
P_LE_COD	Local de estoque.
P_QTD	Quantidade a produzir, interpretada conforme P_QTDREF.
P_INTERNO	Indica chamada vinda de outra rotina [0-Não; 1-Sim]. Opcional, padrão 0. Tem efeito sobre como o código da Ordem de Produção é publicado — ver o Passo 6.
P_DATA	Data e hora de geração. Opcional, padrão nulo.
P_QTDREF	Define o que P_CODIGO representa. Opcional, padrão 0.
P_ORD_COD	Código da Ordem de Serviço a vincular. Opcional, padrão 0.
P_PROGRAMACAO	Data e hora de início da programação dos processos. Opcional, padrão nulo. Informada, programa.
P_OPD_STATUS	Já criar Firmada [0-Não; 1-Sim]. Opcional, padrão 0.
P_OPD_ESTOQUE	Reservar os insumos na criação. Opcional, padrão 0. Três valores — ver abaixo.

Os quatro valores de P_QTDREF

Este parâmetro muda o significado do primeiro. Errar aqui não produz mensagem: produz uma Ordem de Produção de outra coisa.

Valor	O que P_CODIGO passa a ser	Efeito
0	Código da Fórmula de Fabricação	Padrão. A quantidade é a da unidade de fabricação da Fórmula.
1	Código da Matéria Prima Principal	A Fórmula é a que declara aquele produto como matéria prima principal. Fórmula sem matéria prima definida recusa.
2	Código do Produto Fabricado	A Fórmula é descoberta pelo produto. Produto sem Fórmula recusa com "Não foi encontrado Fórmula para o Produto N."
9	Código de uma Ordem de Produção existente	Regenera aquela Ordem de Produção em vez de criar uma nova. É o que FAB_PRC_ALTERARQTDFABRICAR usa por baixo.

Os três valores de P_OPD_ESTOQUE

Valor	Efeito
0	Não reserva. É o padrão.
1	Reserva todos os insumos previstos.
2	Reserva sem a matéria prima principal, deixando-a para reserva manual com escolha de lote e local.

Chamada única ou decomposta

Com P_PROGRAMACAO, P_OPD_STATUS e P_OPD_ESTOQUE informados, a rotina executa as três etapas seguintes nesta ordem: programa os processos, firma a Ordem de Produção, reserva o estoque. É exatamente a sequência dos Passos 7, 9 e 10, feita de uma vez.

Forma	Quando escolher
Chamada única os três parâmetros preenchidos	Quando a agenda e a reserva podem ser automáticas. Menos requisições, e a ordem correta é garantida pelo servidor.
Decomposta criar, depois programar, firmar e reservar	Quando você precisa conferir entre as etapas — ajustar a agenda antes de firmar, ou escolher lote e local na reserva. Também isola em qual etapa uma recusa aconteceu.

Exemplo — criar, programar, firmar e reservar numa chamada

{
    "method": "PATCH",
    "objectType": "PROCEDURE",
    "objectName": "FAB_PRC_GERAROPFORMULA",
    "params": [
        { "name": "P_CODIGO",       "value": "42" },
        { "name": "P_FL_COD",       "value": "1" },
        { "name": "P_ST_COD",       "value": "1" },
        { "name": "P_LE_COD",       "value": "1" },
        { "name": "P_QTD",          "value": "100.000000" },
        { "name": "P_PROGRAMACAO",  "value": "2026-08-20 08:00:00" },
        { "name": "P_OPD_STATUS",   "value": "1" },
        { "name": "P_OPD_ESTOQUE",  "value": "1" }
    ]
}

Valores ilustrativos. Os códigos acima são exemplos. Use os cadastros da sua instância. A assinatura completa e autoritativa está no dicionário oficial.

Recebe listas de pedidos e de itens, agrupa os itens elegíveis e cria uma Ordem de Produção por grupo, com a quantidade somada. Cada Ordem criada já nasce vinculada aos itens que a originaram.

Parâmetro	Descrição
P_LST_PEDIDO	Lista de pedidos no formato {FL_COD.PE_COD}, concatenados. As chaves fazem parte do formato.
P_LST_ITEM	Lista de itens no formato {FL_COD.PE_COD.PE_ITM}, concatenados.
P_ST_COD	Setor ou centro de custo de destino das Ordens de Produção.

Como o agrupamento funciona

Os itens elegíveis são agrupados por filial, setor de origem do pedido, local de estoque e produto. Cada grupo vira uma Ordem de Produção, com a soma das quantidades em unidade de estoque. Dois pedidos do mesmo produto na mesma filial produzem uma Ordem de Produção, não duas.

Quais itens entram

Um item precisa cumprir todos estes critérios:

• pedido do tipo venda, com status ativo;
• saldo a faturar maior que zero;
• quantidade cancelada igual a zero;
• quantidade atendida igual a zero;
• ainda não vinculado a nenhuma Ordem de Produção.

A Fórmula de cada Ordem de Produção é descoberta a partir do produto do pedido. Produto sem Fórmula que atenda aos critérios de geração faz aquele grupo falhar com a mensagem do caminho por Fórmula.

Ver também Pedido de Venda, para como os itens chegam a esse estado.

Cria uma Ordem de Produção para um produto sob demanda e já programa os processos dela. Aqui não se informa a Fórmula: o servidor a descobre pelo produto.

Parâmetro	Descrição
P_FL_COD	Empresa ou filial. O setor de destino vem do padrão cadastrado nela, em FILIAL.FL_ST_CODPADRAO, e não é parâmetro.
P_PD_COD	Produto a fabricar. A Fórmula é descoberta a partir dele.
P_QTDE	Quantidade a produzir, na unidade de fabricação da Fórmula.
P_DATA	Data e hora de produção e de início da programação dos processos.

Os quatro critérios da Fórmula, todos ao mesmo tempo

• FRM_PD_PERSOBDEMANDA igual a 100 para aquele produto;
• a Fórmula ter exatamente um produto a fabricar;
• FRM_STATUS = 1, Ativa;
• FRM_TIPO = 1, Própria Interna.

Nenhuma das três rotinas de criação devolve o código da Ordem de Produção como resultado da chamada. Esta seção é o caminho para descobri-lo, e vale a pena ler inteira antes de montar a integração.

O caminho recomendado: P_INTERNO = 1

Só para FAB_PRC_GERAROPFORMULA. Ela publica o número da Ordem de Produção no controle de processamento do usuário da sessão, em CTRLPROCESSAMENTO.CTP_INFOEXE — e o formato depende de P_INTERNO:

P_INTERNO	O que vai para CTP_INFOEXE
0 (padrão)	Uma frase: Foi gerado a Ordem de Produção de código "N". O número vem dentro do texto, e você precisa extraí-lo.
1	Só o número. É o formato utilizável por programa.

A chave de CTRLPROCESSAMENTO é o par usuário e código de processamento, então selecionar a linha certa também exige saber o usuário do seu token.

A alternativa: consultar a maior Ordem de Produção

Consulte FAB_VIEW_ORDEMPRODUCAO logo após a chamada, filtrando pela Fórmula e pela filial que você acabou de usar, e tome o maior OPD_COD.

Nos outros dois caminhos

Rotina	Onde encontrar o que foi criado
FAB_PRC_GERAROPPEDIDO	Consulte FABORDPROPED pelos itens de pedido que você informou — o vínculo é criado junto com a Ordem de Produção e é o retorno mais confiável dos três caminhos.
FAB_PRC_GERAROPMRP	Consulte FAB_VIEW_ORDEMPRODUCAO pelo produto, filial e data, com a mesma ressalva de concorrência.

FAB_VIEW_ORDEMPRODUCAO é o ponto de entrada do módulo

É por ela que se lê a Ordem de Produção com os códigos já traduzidos — filial, tipo, finalidade, status, Fórmula, local de estoque e centro de custo. Toda consulta desta página e das seguintes começa aqui. Guarde o OPD_COD: ele é o primeiro parâmetro de praticamente todas as rotinas do módulo.

Campo	Domínio
OPD_STATUS	[0-Simulação; 1-Firmada; 2-Fechada; 9-Cancelada]
OPD_TIPO	[1-Própria Interna; 2-Própria em Terceiros; 3-Para Terceiros]
OPD_FINALIDADE	[0-OP de Produção; 1-OP de Fracionamento/Embalagem]
OPD_MODELOAPTRH	[0-Por Funcionário; 1-Por Função] — herdado da Fórmula, decide qual rotina de mão de obra a Ordem aceita.

Programar é atribuir data e hora previstas de início e término a cada processo, respeitando os turnos de trabalho. Sem isso a Ordem de Produção não pode ser firmada.

Parâmetro	Descrição
P_OPD_COD	Código da Ordem de Produção.
P_PRO_COD	Processo inicial a partir do qual a programação é recalculada.
P_INICIO	Data e hora de início para esse processo inicial.

A rotina percorre os processos da Ordem de Produção em ordem hierárquica e grava a janela prevista de cada um. Ao mudar de ordem hierárquica, o início é reiniciado a partir do término do grupo anterior — processos de mesma ordem correm em paralelo, a partir do mesmo início. É assim que a concomitância declarada na Fórmula se realiza na agenda.

Com turno cadastrado para a filial, o término é calculado consumindo as horas previstas dentro das faixas de trabalho de cada dia. Sem turno, o término é simplesmente o início somado às horas previstas.

Cada gravação recalcula em cadeia o custo previsto de máquina do processo. Se a máquina não tiver custo cadastrado para a faixa de horário da programação, o recálculo é interrompido com mensagem — e a causa está no cadastro de custo de máquina, não na chamada.

Consultar a agenda

View	O que entrega
FAB_VIEW_AGENDAPROCESSO	A agenda dos processos das Ordens de Produção.
FAB_VIEW_AGENDAMAQUINA	A agenda das máquinas, para enxergar conflito de ocupação.
FAB_VIEW_MAQUINA	O cadastro das máquinas da fábrica.
FAB_VIEW_MANUTENCAOMAQUINA	As manutenções previstas, para não agendar processo sobre máquina parada.

Mover um processo na agenda — FAB_PRC_REAGENDARPROCESSO

É a rotina indicada para mover um processo já programado. Recebe a nova janela completa e propaga o efeito aos processos seguintes.

{
    "method": "PATCH",
    "objectType": "PROCEDURE",
    "objectName": "FAB_PRC_REAGENDARPROCESSO",
    "params": [
        { "name": "P_OPD_COD", "value": "1001" },
        { "name": "P_PRO_COD", "value": "10" },
        { "name": "P_INICIO",  "value": "2026-08-21 08:00:00" },
        { "name": "P_FIM",     "value": "2026-08-21 16:00:00" }
    ]
}

Ela é a única rotina desta página que devolve um result set: o processo reagendado e todos os processos cuja janela mudou por efeito da cascata, com OPD_COD, PRO_COD, OPD_DATINIPREV e OPD_DATFIMPREV já gravados. Assim você vê o efeito completo, não só o processo que pediu.

Reagende antes de abrir o processo. Depois de aberto, a gravação é recusada informando que o processo já foi iniciado — o caminho é cancelar a abertura primeiro, pelas rotinas da página de Apontamento. A data também precisa ser posterior ao corte de CFG_PERMANUTENCAO1, e a ordem de agendamento precisa seguir a ordem de execução dos processos.

Registrar uma parada prevista — FAB_PRC_INCLUIROCIOPROCESSO

Grava o tempo entre o início e o fim informados como tempo ocioso do processo, e recalcula o término previsto somando as horas de trabalho às horas de ócio.

O alcance é só o processo informado: os seguintes não são reprogramados. Para propagar a mudança pela cadeia, chame FAB_PRC_REAGENDARPROCESSO depois.

Trocar a máquina de um processo — FAB_PRC_ALTERAEVENTOMAQUINA

Refaz os setups previstos e as horas previstas com a máquina nova, recalcula os custos previstos e sempre reprograma o processo ao final, mesmo quando a máquina informada é a mesma.

Parâmetro	Descrição
P_OPD_DATINIPREV	É o primeiro parâmetro, não o código da Ordem de Produção. Data e hora usadas na reprogramação final.
P_OPD_COD	Código da Ordem de Produção.
P_PRO_COD	Código do processo.
P_MAQ_COD_ANT	Máquina atualmente alocada.
P_MAQ_COD_NEW	Máquina nova. Precisa constar na Fórmula para aquele processo, senão a chamada é recusada.

A mesma rotina governa as quatro transições de status. Aqui interessa a passagem para 1, Firmada — o fechamento em 2 está na página de Documentos e Encerramento.

{
    "method": "PATCH",
    "objectType": "PROCEDURE",
    "objectName": "FAB_PRC_ALTERARSTATUSOP",
    "params": [
        { "name": "P_OPD_COD",    "value": "1001" },
        { "name": "P_OPD_STATUS", "value": "1" }
    ]
}

Alvo	Status	O que exige
0	Simulação	Nenhum apontamento de insumo, mão de obra ou setup.
1	Firmada	Todos os processos com início e término previstos preenchidos.
2	Fechada	Ver a página de Documentos e Encerramento.
9	Cancelada	Nenhum apontamento de insumo, mão de obra ou setup.

Firmar não é só mudar um campo. Ao firmar, o servidor abate o saldo previsto do estoque dos insumos da Ordem de Produção — desde que ela ainda não tenha apontamento de insumo — e marca a quantidade prevista reservada dos produtos a fabricar. Cancelar ou voltar para Simulação desfaz isso, libera as reservas de todos os processos e limpa as datas previstas.

Reservar é separar o estoque dos insumos previstos para esta Ordem de Produção. Exige a Ordem de Produção Firmada. Há duas rotinas, com propósitos diferentes.

A automática — FAB_PRC_RESERVARESTOQUE — é o caminho principal

Reserva todos os insumos previstos de um processo, ou de todos os processos, deixando o servidor escolher de onde. É a que confere saldo.

Parâmetro	Descrição
P_OPD_COD	Código da Ordem de Produção. Precisa estar Firmada.
P_PRO_COD	Processo a reservar. Opcional: nulo ou zero reserva todos os processos, da primeira ordem de execução para a última.
P_IGNORAR_MP	[0-Reservar todos os insumos; 1-Pular a matéria prima principal]. Opcional, padrão 0.

Para cada insumo previsto, o servidor compara a quantidade prevista com o maior saldo disponível. Faltando saldo em qualquer insumo, o processo inteiro é recusado, com a lista dos insumos sem saldo.

A manual — FAB_PRC_RESERVARESTOQUE2 — quando o lote importa

Reserva um insumo, na quantidade, no lote e no local que você escolher. São oito parâmetros, todos obrigatórios: Ordem de Produção, processo, subprocesso, filial, local de estoque, produto, lote e quantidade.

O modo de apontamento do insumo reservado é herdado da Fórmula, do campo FRM_APONTAMENTO daquele insumo; sem correspondência, assume 0, Manual. É esse valor que decide o que a abertura do processo consome — ver Apontamento.

Liberar devolve a quantidade reservada ao saldo previsto do estoque e descarta os insumos reservados. Duas rotinas, espelhando as duas de reserva.

Rotina	Alcance
FAB_PRC_LIBERARESTOQUE	O processo inteiro, ou todos os processos quando P_PRO_COD vier nulo ou zero — percorridos da última ordem de execução para a primeira.
FAB_PRC_LIBERARESTOQUE2	Um insumo, identificado por processo, subprocesso, produto e lote.

As duas exigem, no nível do processo: nenhum apontamento de insumo, e o processo ainda não iniciado. Basta um apontamento em qualquer insumo do processo para bloquear a liberação de todos eles.

Como a liberação também percorre vários processos numa chamada, vale a mesma ressalva da reserva: a recusa de um processo interrompe a rotina e deixa o estado parcial.

Serve para três coisas: trocar o insumo por outro, mudar a quantidade prevista ou mudar o local de estoque de onde ele sairá. São sete parâmetros, todos obrigatórios.

Parâmetro	Descrição
P_OPD_COD, P_PRO_COD, P_SPR_COD	Ordem de Produção, processo e subprocesso.
P_PD_COD_OLD	Insumo atual, que será substituído.
P_PD_COD_NEW	Insumo novo. Para mudar só a quantidade ou o local, informe o mesmo valor de P_PD_COD_OLD.
P_QTDPREV	Nova quantidade prevista, na unidade de estoque do produto.
P_LE_COD	Local de estoque de onde o insumo sairá.

A unidade do insumo novo não é parâmetro: assume a unidade de estoque cadastrada no produto, e a quantidade é convertida pelo fator de equivalência de PRODEQUIV. Sem equivalência cadastrada, o fator usado é 1 — o que produz quantidade errada em silêncio. Cadastre a equivalência antes.

O insumo novo é gravado como alterado manualmente, e não como vindo da Fórmula. Os custos previstos do processo e do produto a fabricar são recalculados na sequência.

Parâmetro	Descrição
P_OPD_COD	Código da Ordem de Produção.
P_QTD	Nova quantidade total a produzir. Não é acréscimo: substitui a quantidade prevista.

Só é aceita com a Ordem de Produção em Simulação ou Firmada, e sem nenhum apontamento — nem de insumo, nem de mão de obra, nem de setup — e sem processo iniciado. Para mudar a quantidade de uma Ordem que já tem apontamento, remova os apontamentos primeiro, pelas rotinas da página de Apontamento.

O status anterior é preservado na regeração: uma Ordem Firmada continua Firmada depois da alteração.

O vínculo entre Ordem de Produção e item de Pedido de Venda alimenta o acompanhamento de status de venda. Quando a Ordem nasce pelo Passo 4 ele já vem pronto; estas rotinas servem para ajustá-lo depois.

Vincular — FAB_PRC_VINCULAROPPEDIDO

Recebe as mesmas duas listas do Passo 4, mais o código da Ordem de Produção, e vincula em lote os itens que atendem aos critérios. Valem aqui os mesmos cinco critérios de elegibilidade, a mesma regra de lista vazia significa todos, e o mesmo silêncio: item que não cumpra os critérios é ignorado sem aviso. Confira o resultado em FABORDPROPED.

Desvincular — FAB_PRC_DESVINCULAROPPEDIDO

Remove um vínculo por vez. Os cinco parâmetros — Ordem de Produção, filial, pedido, item e produto — formam a chave da exclusão. Exige Ordem de Produção não Fechada e item ainda não atendido.

FAB_PRC_RECALCULARCPREVOP

Recalcula o custo previsto inteiro da Ordem de Produção, em cinco etapas encadeadas: insumo, máquina, mão de obra, processo e produto a fabricar. Recebe só o P_OPD_COD.

Use-a depois de mudar preço de custo, custo de máquina ou custo por tipo de RH nos cadastros — a Ordem de Produção guarda os custos calculados no momento em que foi criada, e não os atualiza sozinha.

FAB_FNC_OPANTERIOR

Função de consulta, chamada por GET. Devolve o código da Ordem de Produção considerada anterior à informada — a de etapa mais avançada cujo término realizado seja anterior ao corte da Ordem de referência. Serve para encadear produções da mesma Fórmula.

Parâmetro	Descrição
P_OP_COD	Ordem de Produção de referência. Obrigatório.
P_FRM_COD	Restringe a busca a Ordens da mesma Fórmula. Opcional, padrão 0, que significa qualquer Fórmula.
P_OPD_STATUS	Restringe a busca por status. Opcional, padrão -1, que significa qualquer status.

Retorno vazio significa que nenhuma Ordem de Produção atendeu aos filtros.

Recebe apenas o P_OPD_COD. Exige que a Ordem de Produção não esteja Fechada, não tenha Ordens filhas e não tenha nenhum apontamento nem processo iniciado ou fechado.

Aprovadas as validações, a rotina libera a reserva de estoque de cada processo, cancela a previsão de reserva se a Ordem estiver Firmada, remove os lotes que ela criou e que nunca foram usados, e então exclui os registros.

Duas tabelas ficam de fora, e podem impedir a remoção

A rotina apaga dezenove conjuntos de registros da Ordem de Produção, mas não apaga estas duas:

Tabela	O que guarda	Quando aparece
FABORDPRO9	Notas de produtos e insumos da Produção em Terceiros	Ordem de Produção de OPD_TIPO = 2 com nota de terceiros vinculada.
FABORDPRODOCS	Rateios de despesas por Ordem de Produção	Documento de despesa captado e rateado para a Ordem.