Agora no Bluesoft ERP, é possível iniciar e finalizar a separação de insumos para produção via API

Temos uma excelente novidade para as operações que utilizam o módulo de PCP (Planejamento e Controle da Produção). Acabamos de liberar novos endpoints na nossa API que permitem a integração completa do fluxo de Separação de Insumos.

Confira abaixo os detalhes dessa implementação:

1. Consulta de Pendências (GET)

Agora é possível consultar as ordens de separação que têm origem em uma “Ordem de Produção”. O sistema permite filtrar por Filial, Período e Status, retornando todos os dados necessários para a conferência.

Endpoint: /api/pcp/ordem-de-separacao

Principais Filtros:

• lojaKey: Identificador da loja.

• dataInicio e dataFim: Período de emissão.

• status: Ex: ABERTA, EM_SEPARACAO, FINALIZADA.

Nota: A consulta retorna exclusivamente ordens do tipo “Ordem de Produção”, garantindo que pedidos de E-commerce ou Força de Vendas não se misturem neste fluxo.

2. Execução da Separação (PUT)

Desenvolvemos um método flexível que suporta tanto a separação parcial (item a item) quanto o envio completo de uma só vez.

Endpoint: /api/pcp/ordem-de-separacao/{ordemSeparacaoKey}

Destaques:

• Separação Parcial: Você pode enviar atualizações constantes conforme o operador bipa os produtos. O sistema atualiza o status para “Em Separação” automaticamente.

• Validação de Dados: A API valida tipos de dados (evitando erros de formatação) e garante que você não altere uma ordem que já esteja Cancelada ou Finalizada.

Exemplo de JSON: 

{
    "itens": [
        {
            "ordemSeparacaoItemKey": 8642527,
            "quantidadeSeparada": 0.98
        }
    ]
}

3. Finalização e Controle de Divergências (POST)

Para concluir o processo, disponibilizamos um endpoint específico de finalização que trata automaticamente as diferenças entre o que foi pedido e o que foi separado.

Endpoint: /api/pcp/ordem-de-separacao/{ordemSeparacaoKey}/finalizar

Gerenciamento de Divergência: O sistema possui uma trava de segurança inteligente. Se a quantidade separada for diferente da solicitada (para mais ou para menos), a API retornará um erro, a menos que o parâmetro processarComDivergencia seja enviado como true (Verdadeiro).

• processarComDivergencia: false: Bloqueia a finalização se houver diferenças, listando os itens com problema.

• processarComDivergencia: true: Permite finalizar a ordem assumindo a quantidade real separada

Exemplo de JSON:

{
    "processarComDivergencia": "true"
}

Integração com o ERP

Todo o processo realizado via API reflete imediatamente no ERP Bluesoft.

• Ao iniciar a separação via API, o status da Ordem de Produção muda para Em Separação.

• Ao finalizar com sucesso, o status da Ordem de Produção é atualizado para Separada e as quantidades são gravadas, permitindo o início da produção do produto acabado.

Requisitos e Segurança

• Permissões: O usuário da API deve possuir as permissões específicas de consulta e inclusão/alteração de Ordem de Separação. Tentativas sem permissão retornarão erro 401 Unauthorized.

  • 4455 – API Ordem de separação (Consultar)
  • 4456 – API Ordem de separação (Alterar)
  • 4457 – API Ordem de separação (Incluir)

• Logs: Todas as operações geram logs de auditoria no sistema para conferência posterior.

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 r364.60