Agora no Bluesoft ERP, é possível realizar a comunicação automatizada e assíncrona entre o ERP e o sistema do integrador Sorter. Esta nova integração abrange o disparo automático de lotes logísticos no evento operacional de Stage In, a recepção de alocações de paletes e o processamento de cancelamentos de volumes diretamente no fluxo padrão do integrador.

Objetivo

O objetivo desta novidade é garantir a sincronização em tempo real do fluxo logístico entre o ERP e o equipamento Sorter Velox, mitigando processos manuais, assegurando a rastreabilidade completa do ciclo de vida de cada lote e promovendo a resiliência na operação através do controle rígido de reenvios e idempotência.

.

Como Irá Funcionar a Partir de Agora?

A integração opera por meio de uma arquitetura assíncrona e parametrização individualizada por CD. O fluxo está estruturado em três grandes pilares:

1. Tela de Parametrização e Configuração do Sorter

O gerenciamento das conexões é realizado em uma nova interface interna do módulo. Ao acessar, o usuário deve preencher as definições obrigatórias para ativar a comunicação:

2. Disparo Automático de Lotes no Stage In

O ERP monitora as movimentações e realiza o envio automático do payload ao Sorter assim que as quatro condições abaixo forem atendidas cumulativamente:

  • O lote logístico for elegível ao Sorter;
  • Estiver devidamente vinculado a uma Carga WMS;
  • For alocado/confirmado em um endereço logístico classificado como STAGE IN;
  • A configuração da integração estiver ativa para o CD correspondente.

Nota sobre o Payload de Envio:

O número do lote logístico é mapeado diretamente no campo Pedido, e a Ordem de Serviço vinculada é enviada no campo OrdemSeparacao.

O campo TipoProduto é classificado de forma inteligente pelo ERP, enviando 1 para produtos alimentícios e 2 para não alimentos.

3. Novas APIs Públicas de Retorno (Sorter ERP)

Para fechar o ciclo operacional, foram disponibilizadas duas novas rotas de recepção de dados com suporte a validação de token (Bearer Auth):

  • API de Alocação de Palete (/api/logistica/estoque/wms/sorter/{contexto}/aloca-palete): Recebe o retorno do Sorter confirmando a cubagem, peso e os itens alocados no unitizador. O sistema valida a duplicidade do payload JSON exato antes de processar, impedindo a ocorrência de reprocessamentos errôneos.
  • API de Cancelamento de Volumes (/api/logistica/estoque/wms/sorter/{contexto}/cancelamento): Recebe os cortes de produtos ou rejeições ocorridas no Sorter. A API processa o corte e classifica automaticamente o StatusAvaria com base no motivo informado pelo integrador:
    • Status 1: Quando a justificativa contiver os termos “consumo” ou “interno”.
    • Status 2: Quando a justificativa contiver os termos “qualidade”, “defeito”, “avaria” ou “danificado”.
    • Status 3: Padrão para qualquer outro motivo informado (Descarte).

Observações / Validações

  • Monitoramento e Ciclo de Vida: Cada tentativa de envio de lote gera logs detalhados e atualiza o ciclo de vida do registro através dos status: PENDENTE, EM_PROCESSAMENTO, ENVIADO ou ERRO.
  • Disparo Manual: Caso ocorram falhas de rede transitórias, o sistema conta com o endpoint público POST /wms/sorter/enviar-pedido, que permite ao operador forçar o envio manual de itens de uma Ordem de Serviço informando o wmsOrdemServicoKey no corpo da requisição, desde que a OS possua produtos aptos ao Sorter.
  • Novas Permissões de Acesso: O controle de visualização e edição está atrelado às seguintes novas permissões sistêmicas no módulo WMS:
    • 4556 – Sorter Configuração (Consultar)
    • 4557 – Sorter Configuração (Incluir)
    • 4558 – Sorter Configuração (Editar)
    • 4559 – Sorter Configuração (Excluir)
    • 4567– Sorter API Cancelamento (Incluir)
    • 4566– 4085- Consultar as notas fiscais de lotes logísticos via API

Para saber mais sobre a funcionalidade, acesse o link da documentação das APIs