Agora no Bluesoft ERP, é possível informar a quantidade realmente produzida no momento de finalizar uma Ordem de Produção (OP) através da API

Como Era o Processo Antes?

Anteriormente, o payload de finalização da Ordem de Produção via API não possuía um campo específico para receber a quantidade produzida real. Com isso, as integrações que utilizavam o endpoint eram obrigadas a finalizar a OP considerando estritamente a quantidade padrão ou planejada da produção, mesmo quando o rendimento real em fábrica havia sido diferente. Isso poderia ocasionar quebras de estoque e inconsistências na contabilização dos insumos e produtos acabados.

Como Irá Funcionar a Partir de Agora?

A partir desta atualização, o contrato da API de finalização foi atualizado para suportar o recebimento do rendimento real da produção. O processo passa a operar conforme as seguintes regras e etapas:

  1. Disparo da Integração: A integração segue o fluxo normal do PCP criando, separando os insumos e iniciando a produção pelos endpoints correspondentes.
  2. Inclusão do Campo no Contrato: Foi adicionado o novo campo opcional quantidadeProduzida dentro do objeto ordemProducaoItem no endpoint de finalização:POST /api/pcp/ordem-de-producao/{ordemProducaoKey}/finalizar.
  3. Flexibilidade e Precisão do Valor: O sistema aceita que o valor informado no campo quantidadeProduzida seja maior ou menor que a quantidade planejada na OP, processando o dado com uma precisão técnica de até 6 casas decimais.
  4. Compatibilidade com o Cenário Atual: Caso o campo quantidadeProduzida não seja enviado no payload, o ERP manterá o comportamento legado, assumindo automaticamente a quantidade padrão da produção.
  5. Efeitos Concluídos: Ao receber a quantidade informada, o ERP realiza a baixa e o lançamento respeitando o rendimento real recebido, aplicando os valores diretamente nas movimentações de estoque, consumo/reaproveitamento de insumos, relatórios de PCP e contabilização.

Exemplo do Novo Payload Proposto:

JSON

{
  "lote": "L001",
  "ordemProducaoItem": {
    "dataValidade": "11/02/2026",
    "quantidadeProduzida": 30.000000
  }
}

Observações / Validações

  • Bloqueio de Valores Inválidos: Caso a API receba no campo quantidadeProduzida um valor menor ou igual a zero, ou um formato de texto que não seja conversível para valor numérico, a finalização será abortada e o sistema retornará o erro 400 Bad Request com mensagens de validação claras.
  • Limite de Precisão: Valores enviados com mais de 6 casas decimais serão bloqueados pelo sistema, retornando um alerta de formato inválido.
  • Validações Legadas: As regras e validações já existentes para obrigatoriedade de lote, data de validade, saldo de insumos e permissões de acesso (4453-API Ordem de produção (Incluir)) permanecem ativas e inalteradas.

Para conhecer mais sobre como é a utilização dessa ferramenta, clique aqui.

Para saber mais sobre a utilização das APIs do ERP, clique aqui.

Disponível a partir da versão r369.62