Agora no Bluesoft ERP, é possível iniciar e finalizar ordem de produção via API
Visando facilitar a integração com sistemas externos de automação industrial e oferecer maior agilidade, disponibilizamos novos endpoints na API de PCP (Planejamento e Controle da Produção). Agora é possível gerenciar o ciclo de vida da produção — iniciar, estornar e finalizar Ordens de Produção (OP) — diretamente via integração.
O que mudou?
Foram criados novos recursos para permitir que softwares de terceiros ou coletores de dados comuniquem o andamento da produção diretamente ao ERP.
1. Iniciar Produção Permite alterar o status da Ordem de Produção para “Em Produção”, registrando o início do processo produtivo.
• Endpoint: POST /api/pcp/ordem-de-producao/{ordemProducaoKey}/iniciar-producao
2. Desfazer Início de Produção Caso a produção tenha sido iniciada indevidamente, é possível reverter o status de “Em Produção” para “Separada”.
• Endpoint: POST /api/pcp/ordem-de-producao/{ordemProducaoKey}/desfazer-inicio-producao
3. Finalizar Ordem de Produção Registra o término do processo produtivo, gerando o lote e a validade do produto final. O sistema realiza as mesmas validações da tela do ERP para garantir a integridade dos dados.
• Endpoint: POST /api/pcp/ordem-de-producao/{ordemProducaoKey}/finalizar
Exemplo de JSON:
{
"lote": "LOTE_TESTE_2026",
"ordemProducaoItem": {
"dataValidade": "16/02/2026"
}Regras de Negócio Importantes
Ao utilizar a API para finalizar uma produção, o sistema aplica regras específicas para o cálculo da Data de Validade, dependendo da configuração do produto:
• Com Ficha Técnica: É obrigatório informar a data de validade no JSON. A data informada deve ser igual ou superior à data atual (não são permitidas datas retroativas).
• Sem Ficha Técnica (Produto Avulso): O envio da data de validade é opcional. Se enviado como null, a API calculará a validade automaticamente (Data Atual + Dias de Validade do Cadastro do Produto). Não é permitido informar uma data manual neste cenário.
Outras validações:
• Lote Único: O sistema impedirá a finalização caso o código do lote informado já exista em outra produção finalizada.
• Status Correto: A OP deve estar estritamente no status “Em Produção” para ser finalizada.
Permissões Necessárias
Para utilizar os novos recursos, o token de acesso deve possuir as seguintes permissões vinculadas:
• 4453 – API Ordem de produção (Incluir)
• 4454 – API Ordem de produção (Alterar)
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.