Agora no Bluesoft ERP, é possível receber o número da Ordem de Separação (ordemSeparacaoKey) imediatamente no retorno da requisição ao solicitar a separação de uma Ordem de Produção (OP) via API, além de consultar a Ordem de Separação informando diretamente a chave da OP.

O objetivo desta melhoria é otimizar as integrações do módulo PCP, eliminando a necessidade de consultas auxiliares por período, loja ou status para localizar a separação recém-gerada. Isso garante maior desempenho, reduz requisições desnecessárias e evita problemas de concorrência em ambientes de alto volume.

O Que Mudou?

Como Era o Processo Antes?

Antes, ao executar a solicitação de separação de uma Ordem de Produção pelo endpoint da API (POST /api/pcp/ordem-de-producao/{ordemProducaoKey}/separar), o sistema gerava a Ordem de Separação com sucesso, porém o retorno confirmava apenas o êxito da operação sem disponibilizar a chave da separação gerada. Para dar continuidade às etapas seguintes (como informar as quantidades separadas), as integrações eram obrigadas a realizar buscas na listagem de Ordens de Separação filtrando por loja e período para tentar identificar o registro correspondente, gerando complexidade e gargalos operacionais.

Agora, ao disparar a solicitação de separação da OP, a API retorna imediatamente a chave ordemSeparacaoKey vinculada. Adicionalmente, o endpoint de consulta foi atualizado para permitir a filtragem direta pela chave da Ordem de Produção.

Como Irá Funcionar a Partir de Agora?

1. Geração e Retorno da Separação:
   • Ao enviar a requisição de separação para o endpoint POST /api/pcp/ordem-de-producao/{ordemProducaoKey}/separar, a resposta da API trará a chave gerada diretamente no JSON de retorno:
     JSON{ "ordemSeparacaoKey": 987654 }
   • A Ordem de Produção altera seu status para EM_SEPARACAO.
2. Consulta Direta por Ordem de Produção:
   • No endpoint de consulta (GET /api/pcp/ordem-de-separacao), foi disponibilizado o parâmetro opcional ordemProducaoKey.
   • A integração pode realizar a busca direta passando a chave da OP (ex: GET /api/pcp/ordem-de-separacao?ordemProducaoKey=123), obtendo exclusivamente o registro de separação vinculado, sem a necessidade de varreduras por período ou loja.
3. Continuidades do Fluxo:
   • Com a ordemSeparacaoKey em mãos, a integração pode prosseguir diretamente para a atualização das quantidades separadas (PUT /api/pcp/ordem-de-separacao/{ordemSeparacaoKey}) e finalizar a separação (POST /api/pcp/ordem-de-separacao/{ordemSeparacaoKey}/finalizar) sem etapas intermediárias de busca.

Observações Importantes!

• Permissões de Acesso: Para solicitar a separação da OP via API é necessária a permissão 4453 – API Ordem de produção (Incluir). Para realizar a consulta de Ordens de Separação, é necessária a permissão 4455 – API Ordem de separação (Consultar).
• Compatibilidade Retroativa: O contrato existente da API foi preservado e ampliado de forma para permanecer compatível com versões passadas, adicionando o novo campo no retorno sem remover propriedades anteriores.
• Atualização de Quantidades: O endpoint de solicitação de separação não recebe dados de quantidade; a atualização das quantidades separadas continua sendo executada pelo endpoint PUT da Ordem de Separação.

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.