Ordem de Produção: Documentos e Encerramento — Documentação Complementar

Pré-requisito	Por que importa
Empresa cadastrada como fornecedor, com código, comprador e transportador	Três conferências distintas, cada uma com mensagem própria, nas duas rotinas de emissão.
Condição de pagamento e tipos de movimento nas Configurações Gerais	Sem eles a emissão é recusada, mesmo com tudo o mais correto.
Plano de análise no cadastro do produto	É de lá que o plano do lote é copiado — e não da Fórmula. Ver o Passo 7.
Ficha de estoque com o período aberto	Período fechado impede as remoções que desfazem nota, na página de Apontamento.
A Fórmula bem configurada	FRM_APTINSUFIMPROC, FRM_APTPRODANTESPROC e FRM_APTNOTATERCEIROS decidem tudo o que é automático nesta página. Ver Fórmula de Fabricação.

Dois campos da Fórmula governam todo o automatismo desta página. Consulte-os antes de montar a sequência de chamadas — boa parte do que parece faltar já saiu sozinho, e boa parte do que parece duplicado é uma chamada explícita sobre algo já emitido.

FRM_APTINSUFIMPROC — a nota de insumo

Valor	Efeito
0	Não gera nada. A nota de insumo, se for necessária, sai por chamada explícita do Passo 3.
1	Ao fechar cada processo, o servidor gera a Nota Fiscal de saída dos insumos daquele processo — depois de gravar o término realizado, não antes.

FRM_APTPRODANTESPROC — a nota de produto acabado e o fechamento

Este campo aparece em três páginas do módulo, com efeitos diferentes em cada uma. Aqui interessa o efeito fiscal e o de encerramento:

Valor	Significado	O que dispara automaticamente
0	Somente ao término dos Processos	Nada. A nota de produto acabado sai por chamada explícita do Passo 4, e o fechamento pelo Passo 9.
1	Apontar antes do término	Nada de fiscal. O valor só libera o apontamento do produto antes do fim dos processos.
2	Apontar e gerar NF antes do término	O apontamento do produto dispara a Nota Fiscal de entrada — não o fechamento do processo. É o único valor em que o gatilho é o apontamento.
3	Apontar e gerar NF no término do último Processo	Fechar o último processo gera a Nota Fiscal de entrada.
4	Apontar, gerar NF e fechar a O.P.	Fechar o último processo gera a Nota Fiscal de entrada e fecha a Ordem de Produção.

Gera a Nota Fiscal de saída dos insumos apontados em um processo. É o documento de remessa, usado principalmente no fluxo de produção em terceiros.

Parâmetro	Descrição
P_OPD_COD	Ordem de Produção.
P_PRO_COD	Processo cujos insumos apontados entram na nota. Precisa ter insumo apontado.
P_EMISSAO	Data de emissão e de movimento da nota.
P_TM_COD	Tipo de Movimento. Opcional: não informado, usa o de saída de insumos das Configurações Gerais. Informe explicitamente quando a instância tiver mais de um tipo aplicável.

{
    "method": "PATCH",
    "objectType": "PROCEDURE",
    "objectName": "FAB_PRC_GERARNFINSUMO",
    "params": [
        { "name": "P_OPD_COD", "value": "1001" },
        { "name": "P_PRO_COD", "value": "10" },
        { "name": "P_EMISSAO", "value": "2026-08-21" }
    ]
}

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.

Por insumo, a quantidade apontada é conferida contra o saldo do lote no local de estoque. Divergência é recusada identificando o insumo, o lote e o local.

Onde esta nota é exigida

Gera a Nota Fiscal de entrada do produto acabado a partir dos apontamentos ainda não documentados. Três parâmetros: Ordem de Produção, data de emissão e Tipo de Movimento — este último opcional, com o mesmo comportamento do passo anterior.

Um documento por local de estoque

Os apontamentos pendentes são agrupados por local de estoque, e cada local vira um documento separado. Uma Ordem de Produção que apontou produto em dois locais gera duas notas.

Só entram apontamentos do tipo Produção. Apontamento de Perda fica de fora da nota.

Data de emissão

Quando a Ordem de Produção não vem de uma Produção do Dia, a data de emissão não pode ser anterior ao término realizado de nenhum processo. Vindo de Produção do Dia, essa conferência não é aplicada — ver Produção do Dia.

O que a emissão faz além de emitir

• Cadastra o lote em estoque, se ele ainda não existir, calculando fabricação e validade conforme a sugestão de lote da Fórmula. Lote existente com datas em branco é atualizado.
• Escritura os números de série gerados no apontamento, quando o produto controla série gerada pelo sistema.
• Movimenta os endereços de estoque, quando os apontamentos trazem endereço.
• Gera o plano de análise do lote, item a item — ver o Passo 7.
• Vincula cada apontamento ao documento gerado, e é esse vínculo que faz o apontamento deixar de ser "pendente".
• Gera a nota de produto em processo, quando a Fórmula trabalha com produto intermediário.

Vincula documentos de entrada já existentes a uma Ordem de Produção, em lote. Conforme o destino, eles entram como rateio de despesa — compondo o custo indireto — ou como nota de produção em terceiros.

Parâmetro	Descrição
P_OPD_COD	Ordem de Produção que recebe os documentos.
P_PRO_COD	Processo. Informando valor diferente de zero, o processo precisa estar aberto — e só para Ordem de Produção Própria Interna ou Para Terceiros. Nulo ou zero dispensa a exigência.
P_DESTINO	[0-Rateio de Despesas; 1-Nota de Produção em Terceiros].
P_LST_REGISTRO	A lista dos documentos — formato abaixo.

O formato da lista, e a unidade do valor

Documentos separados por ponto-e-vírgula; dentro de cada documento, quatro campos separados por vírgula, nesta ordem:

FL_COD,CF_TIPO,FT_COD,FT_VAL;FL_COD,CF_TIPO,FT_COD,FT_VAL;

Um exemplo com dois documentos de entrada, de valor 1500.00 e 320.50:

1,F,4471,150000;1,F,4472,32050;

Com destino 1, a captação pode apontar a Ordem de Produção inteira

Remove o vínculo de um documento. Cinco parâmetros: Ordem de Produção, filial, tipo do documento, código do documento e destino.

Parâmetro	Descrição
P_CF_TIPO	Sempre "F" neste fluxo — documento de entrada.
P_DESTINO	[0-Rateio de Despesas; 1-Nota de Produção em Terceiros], o mesmo do Passo 5.

Para Ordem de Produção Própria Interna ou Para Terceiros, a remoção exige que nenhum processo da Ordem esteja fora do estado aberto. Produção em Terceiros não entra nessa exigência.

Copia o plano de análise cadastrado no produto para um lote específico, criando os itens de análise e a periodicidade de reanálise. Três parâmetros: filial, produto e lote.

O lote precisa existir em estoque antes. Na sequência normal ele já foi criado pela emissão da nota do Passo 4.

Grava em lote os valores aferidos da análise de qualidade. Um único parâmetro, serializado: registros separados por ponto-e-vírgula, campos separados por vírgula, nove campos por registro:

#	Campo	Observação
1	Filial	—
2	Produto	—
3	Lote	—
4	Item da análise	—
5	Ordem do período	Qual reanálise do cronograma.
6	Valor aferido	Use # no lugar de vírgula literal — ver abaixo.
7	Observação	Mesma regra do #.
8	Data da aferição	Vazia ou não reconhecida como data, o servidor usa a data e hora atuais.
9	Funcionário executor	Omitido ou zero, o servidor busca o responsável do plano. Não achando, grava zero.

Exige também que exista Nota Fiscal para o lote informado — o que na sequência normal já aconteceu no Passo 4.

Fechar é passar OPD_STATUS para 2. É a mesma rotina que firma a Ordem de Produção na página de Preparação; aqui interessa a outra transição.

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

As três conferências do fechamento, na ordem em que disparam

Ordem	Conferência	Detalhe
1	Processos concluídos	Todos com início e término realizados preenchidos. A recusa lista os pendentes.
2	Produto fabricado apontado	Ao menos um apontamento de produto na Ordem de Produção. É a que dispara mais cedo entre as duas de conteúdo — antes da de nota.
3	Nota de saída dos insumos	Nenhum insumo apontado como Consumo ou Perda pode estar sem documento. A recusa lista os produtos pendentes.

O que o fechamento faz depois de aprovar

• Calcula o custo real da Ordem de Produção, depois de registrar o nível dela para o cálculo.
• Libera as reservas não utilizadas, zerando o saldo reservado dos insumos.
• Devolve ao estoque o saldo previsto que havia sido abatido no firmamento.
• Grava a data de conclusão, tomada do término realizado do processo de maior ordem de execução.

Devolve o custo real apurado das Ordens de Produção que já têm apontamento de produto acabado, aberto por insumo, mão de obra, máquina e despesa. Consulta pura, não grava nada.

Parâmetro	Descrição
PFL_COD	Empresa ou filial. 0 traz todas as do usuário.
PPD_COD	Produto fabricado. 0 traz todos.
PDATAINI e PDATAFIM	Faixa de data de produção. Vazias, sem limite.

O retorno traz o custo em duas unidades: na unidade de produção da Ordem e convertido para a unidade padrão de estoque do produto, com o fator de conversão explícito em cada linha. Traz também os códigos dos documentos de entrada do produto fabricado, separados por vírgula, e a data do último deles.

Devolve o tempo de produção das Ordens de Produção de um mês, com a participação percentual de cada uma. É a base do rateio de custo indireto: a participação define quanto do custo indireto do mês cabe a cada Ordem. Três parâmetros: ano, mês e filial.

Ponto	Detalhe
A unidade é o segundo	A coluna de tempo vem em segundos, não em horas.
Ordem que atravessa o mês	Entra pela parte que cai dentro dele: o início considerado é o maior entre o início real e o primeiro instante do mês; o término, o menor entre o término real e o último instante.
Processo ainda aberto	É tratado como se durasse até o fim do mês.
Só entra quem começou	Ordem de Produção apenas programada não aparece.