Ordem de Produção: Apontamento — Documentação Complementar

Pré-requisito	Por que importa
Ordem de Produção Firmada (OPD_STATUS = 1)	Todas as rotinas de apontamento a exigem. Ver Preparação, Passo 9.
Estoque reservado	Sem reserva, o consumo automático não acontece e o apontamento manual de insumo pode ser recusado — ver o Passo 4.
Funcionários (FABPESSOA1)	Quem aponta mão de obra por funcionário. Consulte por FAB_VIEW_PESSOA; os afastamentos estão em FAB_VIEW_AFASTAMENTO.
Tipos de RH (FABTIPORH)	As funções apontáveis no modelo por função.
Máquinas (FABMAQUINA1)	Precisam estar no processo da Ordem de Produção, ou na Fórmula — ver o Passo 6. Consulte por FAB_VIEW_MAQUINA.
Motivos de setup (FABMOTIVOSETUP)	O MSU_TIPO de cada motivo decide se ele é de parada ou de início, e se pode incluir máquina nova.
Lotes (PRODLOTE) e números de série (PRODNS)	Onde os lotes e séries do estoque vivem. O lote do insumo é obrigatório quando a filial e o produto usam controle de lote.
A Fórmula bem configurada	Três campos dela governam este fluxo: FRM_APONTAMENTO de cada insumo, FRM_MODELOAPTRH e a sugestão de número de série. Ver Fórmula de Fabricação.

É o ponto de partida correto antes de apontar insumo: lista os insumos do processo com a quantidade prevista e a quantidade já apontada de cada um. Recebe a Ordem de Produção e o processo, e não grava nada.

{
    "method": "GET",
    "objectType": "PROCEDURE RESULT",
    "objectName": "FAB_RES_APTORDPRO61",
    "params": [
        { "name": "P_OPD_COD", "value": "1001" },
        { "name": "P_PRO_COD", "value": "10" }
    ]
}

No retorno, PREV_UND e PREV_QTD trazem a unidade e a quantidade previstas; OPD_UNI e OPD_QTD, as já apontadas. Insumo ainda não apontado vem com as colunas de apontamento vazias. OPD_ITM identifica o item, e é o valor que a remoção do Passo 9 vai exigir.

Marca o início realizado do processo e o usuário responsável. É a primeira operação da espinha.

{
    "method": "PATCH",
    "objectType": "PROCEDURE",
    "objectName": "FAB_PRC_APTABRIRPROCESSO",
    "params": [
        { "name": "P_OPD_COD",         "value": "1001" },
        { "name": "P_PRO_COD",         "value": "10" },
        { "name": "P_OPD_DATINIREAL",  "value": "2026-08-20 08:00:00" }
    ]
}

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.

P_OPD_DATINIREAL nula assume a data e hora atuais. Os segundos são sempre zerados — a data é truncada ao minuto, para que os apontamentos de pessoas e máquinas casem com a janela do processo.

O que a abertura consome sozinha

Para cada insumo reservado do processo com OPD_APONTAMENTO = 1, a abertura lança automaticamente um apontamento de consumo, pela quantidade reservada. Só o valor 1.

Os cinco valores de OPD_APONTAMENTO

Este é o campo que decide o comportamento de cada insumo no apontamento. Ele nasce em FABORDPRO6 herdado do FRM_APONTAMENTO daquele insumo na Fórmula, no momento da reserva:

Valor	Significado	Quando o consumo acontece
0	Manual	Nunca sozinho. Só por chamada explícita do Passo 4.
1	Automático do Previsto	Na abertura do processo, pela quantidade reservada.
2	Conforme o Produzido	No fechamento do processo, proporcional ao que foi produzido — ver o Passo 8.
3	Conforme Lotes — Iniciais e Complementares	Nenhum consumo automático — ver o aviso abaixo.
4	Conforme Lotes — Sequenciais	Nenhum consumo automático — ver o aviso abaixo.

Duas situações em que o Passo 3 se comporta de outro jeito

Situação	O que acontece
CFG_RESERVAPARCIAL = 0	A abertura não consome nada, qualquer que seja o valor de OPD_APONTAMENTO. Ela lê a quantidade reservada de FABORDPRO6, e sem reserva essa tabela está vazia. Todo o apontamento de insumo passa a ser manual.
Ordem de Produção de OPD_TIPO = 2 Produção em Terceiros	Não é preciso chamar este passo. Se o processo ainda não estiver aberto, FAB_PRC_APTINSUMOS o abre sozinha. É o que faz o fluxo de nota de terceiros funcionar sem chamada de abertura. O mesmo vale para FAB_PRC_APTPRODUTOFABRICADO.

Ordem de abertura

Todos os processos de ordem de execução anterior precisam estar concluídos — iniciados e fechados. A recusa lista os processos pendentes. Processos de mesma ordem de execução correm em paralelo e podem ser abertos independentemente.

Registra consumo, perda ou devolução de um insumo no processo. São doze parâmetros:

Parâmetro	Descrição
P_OPD_COD	Ordem de Produção. Precisa estar Firmada.
P_PRO_COD	Processo, que precisa estar aberto — salvo em Produção em Terceiros, onde a rotina o abre.
P_SPR_COD	Subprocesso. Pode vir nulo: o servidor o preenche sozinho somente quando existe exatamente um subprocesso cadastrado. Com dois ou mais, informe.
P_PD_COD	Produto insumo. Precisa estar ativo no cadastro.
P_PD_UNI	Unidade do apontamento. A quantidade é convertida para unidade de estoque pelo fator de PRODEQUIV; sem equivalência cadastrada o fator usado é 1.
P_PD_LOTE	Lote. Obrigatório quando a filial e o produto usam controle de lote.
P_PD_NUNSER	Número de série do insumo. Aceito e gravado, mas sem captura na tela do ERP.
P_LE_COD	Local de estoque. Pode vir nulo — ver a cascata abaixo.
P_EE_COD	Endereço de estoque. Opcional.
P_OPD_QTD	Quantidade, na unidade informada.
P_OPD_TIPO	Tipo do apontamento [1-Consumo; 2-Perda; 3-Devolução].
P_OBS	Observações livres.

Exemplo — apontar consumo de um insumo

{
    "method": "PATCH",
    "objectType": "PROCEDURE",
    "objectName": "FAB_PRC_APTINSUMOS",
    "params": [
        { "name": "P_OPD_COD",  "value": "1001" },
        { "name": "P_PRO_COD",  "value": "10" },
        { "name": "P_SPR_COD",  "value": "1" },
        { "name": "P_PD_COD",   "value": "204" },
        { "name": "P_PD_UNI",   "value": "KG" },
        { "name": "P_PD_LOTE",  "value": "L2608A" },
        { "name": "P_LE_COD",   "value": "1" },
        { "name": "P_OPD_QTD",  "value": "12.500000" },
        { "name": "P_OPD_TIPO", "value": "1" },
        { "name": "P_OBS",      "value": "Consumo do turno da manhã" }
    ]
}

Como o local de estoque é resolvido quando você não informa

Com P_LE_COD nulo, o servidor procura o local nesta ordem, e usa o primeiro que encontrar:

1. a reserva daquele insumo na Ordem de Produção;
2. a previsão do insumo no processo;
3. o insumo na Fórmula;
4. o insumo alternativo na Fórmula.

Nenhuma das quatro resolvendo, a chamada é recusada pedindo o local de estoque. Informar P_LE_COD explicitamente evita a cascata inteira e é o caminho previsível.

Quando a reserva prévia é exigida

Para Ordem de Produção de Produção Própria Interna ou de finalidade Fracionamento, com CFG_RESERVAPARCIAL = 1 e o insumo configurado como Manual na Fórmula, o processo precisa ter estoque reservado antes do apontamento. Reserve primeiro pelo Passo 10 da Preparação.

Por funcionário — FAB_PRC_APTMAODEOBRA

Registra o início ou a parada de um colaborador no processo. Seis parâmetros: Ordem de Produção, processo, código da pessoa, ocorrência, observação e data e hora da ocorrência.

Ponto	Detalhe
Domínio de P_OPD_OCR	[1-Parar; 2-Iniciar]. Confira a ordem: existem comentários antigos que a invertem, e estão errados.
A função não é parâmetro	O tipo de RH é descoberto pelo servidor a partir do código da pessoa, no cadastro de funcionários.
O item também não	O número do item do apontamento é gerado pelo servidor, como o maior existente mais um.

Por função — FAB_PRC_APTMAODEOBRAFUNCAO

Registra a função e a quantidade de pessoas num intervalo, em vez de nomear cada colaborador. Sete parâmetros; os três últimos são opcionais.

O apontamento pode ser feito em duas etapas: uma chamada só com o início abre o apontamento, e uma chamada posterior para a mesma função só com o término o completa — em vez de criar um registro novo.

Exige quantidade de pessoas maior que zero, e ao menos um entre início e término preenchido. A data de início não pode ser anterior ao início real do processo, e o término precisa ser posterior ao início quando os dois vierem.

Registra a parada ou o início de uma máquina no processo, sempre com um motivo de setup. Seis parâmetros: Ordem de Produção, processo, máquina, motivo, ocorrência e data e hora.

O motivo e a ocorrência precisam ser coerentes

Cada motivo de setup tem um MSU_TIPO, e ele determina qual ocorrência é aceita:

MSU_TIPO	Motivo	Ocorrência exigida
0	Normal	Qualquer uma.
1	Parada Fábrica	P_OPD_OCR = 1, Parar.
2	Início Fábrica	P_OPD_OCR = 2, Iniciar.
3	Parada por Defeito Impeditivo	P_OPD_OCR = 1, Parar.
4	Início de Nova Máquina	P_OPD_OCR = 2, Iniciar.

O domínio de P_OPD_OCR é [1-Parar; 2-Iniciar]. Incoerência entre motivo e ocorrência é recusada nomeando qual das duas o motivo exige.

A máquina precisa estar no processo — com uma exceção

Em regra, a máquina já tem de estar cadastrada no processo da Ordem de Produção. A exceção é o motivo de MSU_TIPO = 4, "Início de Nova Máquina":

Situação	O que acontece
Máquina não está no processo, motivo com MSU_TIPO = 4, e a máquina consta na Fórmula	O servidor insere a máquina no processo automaticamente, com horas e custos zerados, e aceita o apontamento.
Máquina não está no processo, motivo com MSU_TIPO = 4, e a máquina não consta na Fórmula	Recusa nomeando a Fórmula. Acrescente a máquina na Fórmula antes.
Máquina não está no processo, motivo de outro tipo	Recusa nomeando a Ordem de Produção.
Máquina já está no processo, motivo com MSU_TIPO = 4	Recusa: o motivo é inválido nesse caso. Use um motivo de outro tipo.

O processo precisa estar aberto: iniciado e ainda não fechado.

Registra a quantidade produzida ou perdida de produto acabado. Sete parâmetros: Ordem de Produção, produto, unidade, lote, quantidade, tipo [1-Produção; 2-Perda] e endereço de estoque.

Quando o apontamento é aceito

Depende de FRM_APTPRODANTESPROC, da Fórmula. Com o valor 0 — "Somente ao término dos Processos" —, todos os processos precisam estar iniciados e fechados; a recusa lista os pendentes. Com os valores 1 a 4, o apontamento é aceito antes. A matriz dos cinco valores está na página de Fórmula.

Lote: quem informa depende da Fórmula

Configuração da Fórmula	Quem informa o lote
FRM_SUGESTAOLOTE = 0	Você, em P_PD_LOTE — obrigatório se o produto usa controle de lote. Se já houver lote gravado para o produto na Ordem de Produção, ele prevalece sobre o parâmetro.
FRM_SUGESTAOLOTE diferente de 0	O servidor, pelo método configurado. P_PD_LOTE precisa vir vazio: informar lote nesse caso é recusado.

Número de série: não há parâmetro, e a configuração decide tudo

Quando as três condições valem, é gerado um número de série por unidade de estoque da quantidade apontada.

A amostra de qualidade sai junto

Se a Fórmula reserva quantidade para teste de qualidade e a amostra ainda não foi apontada, a chamada é decomposta em dois lançamentos: um para a amostra, no local de estoque de amostras da Fórmula, e outro para o restante. Nesse caso a quantidade informada precisa ser igual ou maior que a quantidade de teste, senão a chamada é recusada.

Marca o término realizado. É a operação mais densa do fluxo: antes de gravar, ela executa dois lançamentos automáticos e cinco conferências.

O que ela faz automaticamente, nesta ordem

1. Consome os insumos de OPD_APONTAMENTO = 2 — "Conforme o Produzido" — proporcionalmente ao que foi produzido. Só entram os itens que ainda não têm apontamento nenhum, e só quando há produto fabricado apontado com quantidade real maior que zero.
2. Devolve o saldo reservado não consumido desses mesmos insumos, com um apontamento de devolução e observação automática.

Falha em um insumo não interrompe o laço: os erros são acumulados e devolvidos numa mensagem consolidada, uma linha por insumo, com o código do insumo e a causa original.

A regra de momento do produto, e a mensagem que engana

As cinco conferências do fechamento

Conferência	O que exige
Apontamento de insumo	Ao menos um apontamento de insumo no processo.
Apontamento de mão de obra	Ao menos um. A mensagem distingue o modelo: a versão por função diz "(por Função)".
Processos anteriores	Todos os de ordem anterior com início e término preenchidos.
Setup de máquina em aberto	Nenhum setup iniciado e não encerrado.
Mão de obra em aberto	Nenhum apontamento de pessoa iniciado e não encerrado. Ordens de Serviço abertas também são conferidas.

O processo precisa ter início preenchido e término ainda vazio, e a Ordem de Produção precisa estar Firmada.

Recebe um único parâmetro: uma lista serializada dos apontamentos a remover.

Parâmetro	Formato
P_INSUMOS	{OPD_COD;PRO_COD;OPD_ITM;OPD_ORD} por apontamento, concatenados sem separador nenhum. As chaves e os ponto-e-vírgulas fazem parte do formato.

Os quatro números são, na ordem: Ordem de Produção, processo, item do apontamento e ordem de digitação — todos vindos de FABORDPRO61. Dois apontamentos ficam assim:

{1001;10;1;1}{1001;10;2;1}

O que a remoção desfaz vai além do apontamento: reverte a movimentação de estoque e de endereçamento, exclui a Nota Fiscal e a ficha geradas, remove os números de série órfãos, e por fim apaga o apontamento. A reserva correspondente também some, quando fica sem saldo reservado e sem nenhum outro apontamento.

Duas rotinas, espelhando as duas de apontamento — e com a mesma assinatura: Ordem de Produção, processo, código do Tipo de RH e item.

Rotina	Remove de
FAB_PRC_REMOVERAPTMAODEOBRA	O apontamento por funcionário.
FAB_PRC_REMOVERAPTMAODEOBRAFUNCAO	O apontamento por função.

As duas exigem processo aberto. Cada chamada apaga um registro, identificado pela chave completa — e no modelo por funcionário isso significa que um par de início e parada exige duas chamadas, uma para cada item.

Três parâmetros: Ordem de Produção, processo e máquina. Exige processo aberto.

Como a remoção de insumo, recebe um único parâmetro com a lista serializada — mas o formato tem três números, não quatro:

Parâmetro	Formato
P_PRODUTOS	{OPD_COD;OPD_PD_COD;OPD_ITM} por apontamento, concatenados sem separador. Ordem de Produção, produto e item — vindos de FABORDPRO12.

{1001;138;1}{1001;138;2}

Esta é a remoção com o limite diferente das outras

Como a de insumo, ela reverte a movimentação de estoque, exclui a Nota Fiscal e a ficha geradas, remove os números de série órfãos e por fim apaga o apontamento. E também confere se o período da ficha de estoque permite alteração.

Desfaz o início do processo: a data e hora de início realizado e o usuário responsável voltam a nulo, e o processo retorna ao estado de não iniciado. A janela prevista é preservada.

Parâmetro	Descrição
P_OPD_COD	Ordem de Produção.
P_PRO_COD	Processo. Opcional: nulo faz o servidor escolher o último processo aberto.

Só é possível desfazer do fim para o começo. Informando um processo que não esteja na maior ordem de execução aberta, a chamada é recusada apontando que existem processos de ordem superior.

O processo não pode ter apontamento nenhum de setup, mão de obra ou insumo — a recusa lista os tipos encontrados. Remova-os primeiro, pelos Passos 9 a 11. E sendo o único processo iniciado da Ordem de Produção, também não pode haver produto fabricado apontado.

Desfaz o fechamento: a data e hora de término realizado e o usuário responsável voltam a nulo. O início é preservado, então o processo fica aberto — não volta a não iniciado.

Exige Ordem de Produção Firmada. Como o cancelamento, respeita a ordem inversa da execução: nenhum processo de ordem posterior pode ter sido iniciado ou fechado, e não pode haver outro processo aberto em ordem diferente.