Agora no Bluesoft ERP, é possível importar lotes logísticos usando agrupadores externos via API

O objetivo principal desta melhoria é ajustar o retorno da API de importação de lotes logísticos para que os produtos sejam agrupados pelo seu respectivo número de lote gerado. O processo de geração de lotes logísticos distintos continua utilizando o campo “Agrupamento Externo” configurado no cadastro do produto.

1. Importação de Lotes Logísticos V3

Método HTTPPOST
URL (Novo Endpoint)/api/v3/wms/lotes-logisticos/importar
ProcessamentoAssíncrono (inicia um job em segundo plano)
PayloadIdêntico ao da V2 (contendo importarComDivergencia, motivo e itens)
Retorno ImediatoHTTP 200 OK com o requestId para consulta futura
Permissão Necessária4377 – API Lotes Logísticos Importar Async V3 (Incluir)

Exemplo de Resposta Imediata (POST V3):

{
  "requestId": "a1b2c3d4-e5f6-7890-g1h2-i3j4k5l6m7n8"
}

Este requestId é usado para consultar o status e o resultado final.

2. Consulta do Resultado da Importação V3

Para obter os resultados do processamento assíncrono, utilize o novo endpoint GET

Método HTTPGET
URL (Novo Endpoint)/api/v3/wms/externo/loteslogisticos/{requestId}
Parâmetro de URL ObrigatóriorequestId (string) – ID retornado no POST
Retorno de SucessoHTTP 200 OK (se o processo estiver concluído)
Permissão Necessária4378 – API Lotes Logísticos Importar Async V3 (Consultar)

Estrutura de Retorno do GET V3 (Resultado Agrupado)

A estrutura de retorno da V3 agora garante que os produtos estejam corretamente vinculados aos lotes gerados.

1. lotesGerados: Este objeto/array contém a lista dos lotes.

    ◦ Cada lote é identificado pelo campo numeroLote (número do lote gerado).

    ◦ Dentro de cada lote, há um array itens que lista os produtos alocados naquele lote específico.

2. Tratamento de Falhas: O JSON continua mantendo os arrays para itens que não puderam ser processados totalmente:

    ◦ itensSemSaldoDeEstoque

    ◦ itensComOperacoesEntreLojasSuspensa

Exemplo de Resposta (GET V3) — Produtos vinculados ao Lote:

{
  "processado": true,
  // ... outros campos de monitoramento ...
  "lotesGerados": [
    {
      "numeroLote": 7498, // Lote 7498 (Exemplo: Agrupador Secos)
      "itens": [
        {
          "descricaoProduto": "TOALHA CASA IN.VIS.ABILITY BCO AV 1UN",
          "produtoKey": 89521,
          "logisticaLoteItemKey": 895211111,
          "quantidadeReservada": 24.0,
          "cdKey": 100,
          "lojaKey": 1
        }
      ]
    },
    {
      "numeroLote": 7499, // Lote 7499 (Exemplo: Agrupador Perecíveis)
      "itens": [
        {
          "descricaoProduto": "BEB. LACTEA NESQUIK MORANGO TP 180ML",
          "produtoKey": 152909,
          "logisticaLoteItemKey": 1529099999,
          "quantidadeReservada": 54.0,
          "cdKey": 100,
          "lojaKey": 1
        }
      ]
    }
  ],
  "itensSemSaldoDeEstoque": [],
  "itensComOperacoesEntreLojasSuspensa": []
}

Observação: O endpoint de monitoramento assíncrono existente (GET /api/monitoramento/async/{requestId}) continua disponível para a consulta opcional do status do job (PENDING, RUNNING, FAILED, COMPLETED).

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.01