Agora no Bluesoft ERP, é possível consultar, por meio de APIs, as informações necessárias para preparar a distribuição forçada por operador logístico. A integração disponibiliza consultas de operadores, lojas de destino, operações, locais de estoque e prévia de distribuição, permitindo obter sugestões de abastecimento conforme os parâmetros e filtros informados. O objetivo desta melhoria é facilitar a integração com sistemas externos, disponibilizando as informações da distribuição logística de maneira automatizada, com controle de acesso e aproveitamento das regras de cálculo do ERP.

Como Era o Processo Antes?

Anteriormente, as informações para preparação da distribuição forçada eram disponibilizadas apenas pelo ERP por meio da funcionalidade WMS > Operador Logístico > Distribuição Forçada de Operador Logístico, permitindo selecionar o contexto da operação, aplicar filtros e consultar as sugestões de distribuição.

Como Irá Funcionar a Partir de Agora?

Com a melhoria, essas informações também poderão ser consultadas por sistemas externos, por meio de APIs específicas, ampliando as possibilidades de integração logística.

A partir desta versão, estarão disponíveis cinco consultas para integração com a distribuição forçada por operador logístico.

Permissões de Acesso

Para utilizar as APIs de Consulta de Distribuição Forçada por Operador Logístico, o usuário deverá possuir as permissões correspondentes às operações que deseja consultar.

As permissões estão disponíveis para configuração nos grupos de usuários do Bluesoft ERP.

  • 4764 – Consultar operadores logísticos
  • 4765 – Consultar lojas de destino
  • 4766 – Consultar operações disponíveis
  • 4767 – Consultar locais de estoque
  • 4768 – Consultar prévia de distribuição

Exemplos de uso

Os valores abaixo são ilustrativos e devem ser substituídos pelos dados e pela autenticação do ambiente. Os exemplos demonstram as cinco consultas disponíveis na API de Distribuição Forçada por Operador Logístico.

1. Consultar os operadores logísticos disponíveis

Permite consultar os operadores logísticos disponíveis para o usuário autenticado, considerando os vínculos com as lojas autorizadas.

Requisição:

GET {{baseUrl}}/api/wms/externo/distribuicoes-forcadas-operador-logistico/operadores?currentPage=0&pageSize=30

Exemplo ilustrativo de resposta com dois operadores:

{
  "currentPage": 0,
  "pageSize": 30,
  "data": [
    {
      "operador": 913,
      "descricao": "Operador CD Fortaleza"
    },
    {
      "operador": 914,
      "descricao": "Operador Loja Norte"
    }
  ]
}

Permissão necessária: 4764 — Consultar operadores logísticos.

2. Consultar as lojas de destino autorizadas

Permite consultar as lojas de destino vinculadas ao operador logístico informado, respeitando os acessos do usuário autenticado.

Requisição:

GET {{baseUrl}}/api/wms/externo/distribuicoes-forcadas-operador-logistico/lojas?operador=913

Exemplo ilustrativo de resposta com duas lojas:

{
  "data": [
    {
      "loja": 4,
      "descricao": "Loja Centro"
    },
    {
      "loja": 9,
      "descricao": "Loja Norte"
    }
  ]
}

Permissão necessária: 4765 — Consultar lojas de destino.

3. Consultar as operações disponíveis

Permite identificar a operação de distribuição disponível para o operador logístico informado.

Requisição:

GET {{baseUrl}}/api/wms/externo/distribuicoes-forcadas-operador-logistico/operacoes?operador=913

Exemplo ilustrativo de resposta:

{
  "data": [
    {
      "operacao": "ENVIAR_PARA_LOJA",
      "descricao": "Enviar para loja"
    }
  ]
}

Permissão necessária: 4766 — Consultar operações disponíveis.

4. Consultar os locais de estoque

Permite consultar os locais de estoque ativos pertencentes ao operador logístico informado.

Requisição:

GET {{baseUrl}}/api/wms/externo/distribuicoes-forcadas-operador-logistico/locais-estoque?operador=913

Exemplo ilustrativo de resposta:

{
  "data": [
    {
      "localEstoque": 19,
      "descricao": "Estoque Padrão"
    },
    {
      "localEstoque": 27,
      "descricao": "Pulmão CD"
    }
  ]
}

Permissão necessária: 4767 — Consultar locais de estoque.

5. Consultar a prévia de distribuição

Permite consultar uma prévia da distribuição forçada considerando o operador logístico, a loja de destino, o local de estoque, a operação e os filtros informados.

Requisição:

GET {{baseUrl}}/api/wms/externo/distribuicoes-forcadas-operador-logistico/previa?operador=913&loja=4&localEstoque=19&operacao=ENVIAR_PARA_LOJA&diasReposicao=1

Exemplo ilustrativo de resposta com um produto:

{
  "data": [
    {
      "produto": 376821,
      "descricao": "Arroz Tipo 1 5kg",
      "estoqueDisponivel": 120,
      "vendaMedia": 18,
      "sugestao": 24
    }
  ]
}

Permissão necessária: 4768 — Consultar prévia de distribuição.

Observações importantes

  • As consultas utilizam o método GET e exigem autenticação válida.
  • Cada consulta possui uma permissão específica de acesso, de 4764 a 4768.
  • As lojas retornadas respeitam os vínculos do operador logístico e as autorizações do usuário.
  • A prévia utiliza as regras de cálculo e as configurações aplicáveis no ERP.
  • As consultas não realizam reserva de estoque, geração de lotes, separação ou faturamento.
  • A API de prévia seleciona os produtos conforme os filtros permitidos, sem aceitar uma lista explícita de produtos enviada pelo integrador.

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