Distribuição Forçada de Operador Logístico

Visão Geral

Em um modelo onde a loja Matriz fornece os produtos as suas Filiais, e seu estoque é armazenado em um operador logístico, para que as mercadorias cheguem as lojas o usuário deve fazer os seguinte procedimentos:

1) Operador Logístico – Retorno de Mercadoria Armazenada em Depósito

2) Loja Contratante – Entrada de Retorno de Armazenagem

3) Loja Contratante – Transferência Saída

---

---

O objetivo da ferramenta Distribuição Forçada de Operador Logístico para Lojas Filiais da Loja Contratante, é tornar o abastecimento das lojas filiais de lojas contratantes de operadores logístico um processo simples e automatizado.

Ao efetuar uma Distribuição Logística, onde o objetivo é enviar a mercadoria para uma loja filial, será possível efetuar esse procedimento automaticamente.

Quando não houver loja contratante, é possível enviar distribuição para qualquer loja da rede. Desde que a loja tenha emitido a nota de remessa para armazenagem.

Assim enviando do Operador Logístico para a loja contratante.

Filtro:

• Finalidade da Distribuição

Selecione a finalidade Enviar para uma Loja ou Movimentar Locais Estoque

• Remetente (Operador Logístico)

Selecione o Operador Logístico

• Local de estoque de origem

Selecione um local de estoque com estoque disponível

• Incluir produtos sugeridos para distribuição?

Selecione a opção sim para gerar uma sugestão por demanda baseada na venda, opção não deve incluir um produto manualmente para poder informar a quantidade a ser distribuída

• Destinatário

Selecione um destinatário para enviar a distribuição

• Linha de compra do CD

Selecione a opção “Somente produtos em linha”, é gerado a distribuição baseada nos produtos incluso na linha de compra CD, ou “Todos”, onde é gerado a distribuição de todos os produtos independente do produto está em linha.

• Entradas de mercadorias do dia

Informe uma data para listar os produtos baseada a partir de uma determinada entrada.

• Desprezar itens já gerados hoje

Selecione a opção Sim, se houver um lote já gerado o item os itens desse lote será desprezado na distribuição, caso informe não o item é considerado.

• Desprezar vendas em oferta

Selecione a opção sim, para desprezar as quantidades vendida em oferta, caso escolha a opção não é considerado a quantidade de venda com preço em oferta e norma.

• Listar produtos sem venda/com venda

Selecione as opção “Com Venda”, “Sem Venda”, “Ambos”. Filtrando pela por  “Desprezar produtos sem venda”, é possível  desconsiderar na sugestão da distribuição os produtos que não possui média de venda media no destinatário ou gerar uma sugestão apenas com produtos sem histórico de venda média.

• Dias ideais de Cobertura

Quantos dias o estoque demora para ficar abaixo do estoque de segurança.

• Dias de reposição

A sugestão de distribuição será baseada na regra Maior Venda Média ou por Media. Duvidas Clique aqui.

Ex: se um produto possui venda média diária de 5 caixas e você deseja abastecer a loja por 3 dias, serão sugeridas 15 caixas.

• Curva ABC

Selecione a classificação do Produto, A1 A2 A3, B1 B2 B3, C1 C2 C3

• Distribuição por

Se o parâmetro Estoque mínimo estiver ativo, essa opção não é exibida, caso opção for exposição mínima é possível selecionar Palete, Camada, Caixa e unidade

• Departamento

Selecione o primeiro nível da estrutura da classificação mercadológica, comum a muitos produtos. (Ex.: Bazar, Mercearia…)

• Seção

Selecione o segundo nível da estrutura da classificação mercadológica. Por exemplo, para o departamento Bazar, poderíamos ter as seções Material Escolar e Eletrônicos;

• Grupo

Selecione o terceiro nível da estrutura da classificação mercadológica, ou seja a sub divisão da seção. Exemplificando, para a seção Material Escolar poderíamos selecionar os grupos Caderno e Caneta.

• Subgrupo

Selecione o quarto e último nível da estrutura da mercadológica da classificação mercadológica. Como exemplos, poderíamos selecionar para os grupos já citados acima os seguintes subgrupos: para Caderno, Espiral e Brochura.

---

– Configurações

Para que os próximos passos funcionem, algumas configurações devem ser feitas:

•  Devemos informar qual loja é contratante do Operador Logístico.

Devemos acessar Administração > Lojas > Consulta e Pré-Cadastro de Lojas

---

• Após buscar Operador Logístico devemos clicar em editar 

  

---

• Na aba Operador Logístico, e preencher o campo Loja Contratante:

---

Para utilizar, devemos seguir os seguintes passos:

1) Devemos acessar o módulo Logística > Operador Logístico > Distribuição Forçada de Operador Logístico

---

2) Como nossa necessidade no final do processo, será abastecer a loja filial, iremos escolher a mesma no início do processo informando a mesma no campo Enviar para a filial:

Esse campo exibirá todas as lojas filiais, da loja definida como Loja Contratante do operador logístico.

Quando preenchermos o campo acima citado, todo o processo após essa escolha, será baseado na necessidade da loja filial escolhida.

---

3) No nosso exemplo a loja filial a ser abastecida será a LJ-9 – BLUESOFT:

---

4) Após preencher os dados para sugestão de abastecimento, devemos clicar em PROSSEGUIR.

---

5) Após a escolha dos produtos para distribuição, e suas quantidades devemos clicar em GERAR LOTES:

---

6) Após a confirmar a geração dos lotes, será redirecionado para a Separação de lotes para distribuição com o lote já sendo buscado.

---

7) Após o lote gerado, devemos selecionar o usuário que fará a separação dos produtos. Devemos escolher o separador e clicar em SALVAR:

---

8) Após preenchidas as Quantidades Separadas do lotes, demos acessar o módulo de Faturamento de Lotes.

Logistica > Faturamento de Lotes

---

9) Após buscar os lotes, devemos clicar em PROSSEGUIR:

Este será o ponto diferencial nesta operação, onde ao clicar em Prosseguir para Faturamento, o usuário visualizará a nota fiscal de Transferência Saída da Loja Contratante para sua Filial:

---

10) Ao clicar em FATURAR NOTA FISCAL, serão faturadas as seguintes notas fiscais:

• 1) Operador Logístico – Retorno de Mercadoria Armazenada em Depósito para Loja Contratante
• 2) Loja Contratante – Entrada de Retorno de Armazenagem
• 3) Loja Contratante – Transferência Saída – Para Loja Filial escolhida no início do processo.

---

11) Após o final da operação serão exibidas todas as nota fiscais faturadas, ficando pendente somente o Envio a Sefaz:

---

 

 Consulta de Distribuição Forçada Operador Logístico por API

Através da API de Consulta de Distribuição Forçada por Operador Logístico, é possível integrar sistemas externos ao Bluesoft ERP para consultar operadores logísticos, lojas de destino, operações disponíveis, locais de estoque e sugestões de distribuição de mercadorias.

A integração utiliza as regras de cálculo e os parâmetros configurados no ERP, respeitando os vínculos logísticos e as permissões de acesso do usuário autenticado.

Com essa funcionalidade, os sistemas integrados poderão obter as informações necessárias à preparação da distribuição forçada, sem realizar reservas de estoque ou geração de lotes.

Exemplos de uso

Os valores abaixo são ilustrativos e devem ser substituídos pelos dados e pela autenticação do ambiente.

Os exemplos de respostas JSON são simplificados e demonstrativos. A estrutura definitiva de integração deve seguir o contrato disponibilizado na documentação das APIs do ERP.

1. Consultar os operadores logísticos disponíveis

A consulta de operadores permite identificar os operadores logísticos disponíveis para o usuário autenticado.

O resultado considera os vínculos entre os operadores logísticos e as lojas de destino autorizadas.

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

Parâmetros disponíveis:

• currentPage: Número da página que será consultada. A contagem começa em zero.
• pageSize: Quantidade de registros apresentados por página.

A paginação utiliza 30 registros por página como padrão, com limite máximo de 1.000 registros por requisição.

Exemplo de 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"
    }
  ]
}

Observação: Caso não existam operadores logísticos disponíveis conforme as autorizações do usuário, a consulta poderá retornar uma lista vazia.

A consulta não concede acesso automático a todas as lojas vinculadas aos operadores apresentados.

2. Consultar as lojas de destino

A consulta de lojas permite identificar os destinos vinculados ao operador logístico informado.

O retorno considera os vínculos existentes entre o operador e as lojas, respeitando as autorizações do usuário autenticado.

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

Parâmetro obrigatório:

• operador: Código do operador logístico que será consultado.

Exemplo de 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"
    }
  ]
}

Importante: A existência de um vínculo cadastral entre a loja e o operador logístico não substitui a autorização do usuário.

Uma filial poderá ser apresentada quando atender aos vínculos logísticos e estiver diretamente autorizada ao usuário, mesmo que o vínculo do operador seja estabelecido por meio de sua matriz.

3. Consultar as operações disponíveis

A consulta de operações permite identificar a finalidade de distribuição disponível para o operador logístico informado.

Nesta entrega, a operação contemplada é o envio de mercadorias para lojas.

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

Parâmetro obrigatório:

• operador: Código do operador logístico que será consultado.

Exemplo de 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"
    }
  ]
}

Observação: Essa consulta permite identificar a operação disponível para o operador logístico, mas não executa a distribuição das mercadorias.

4. Consultar os locais de estoque

A consulta de locais de estoque permite identificar os locais ativos pertencentes ao operador logístico informado.

Esses locais poderão ser utilizados na consulta da prévia de distribuição para definir a origem das mercadorias.

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

Parâmetro obrigatório:

• operador: Código do operador logístico que será consultado.

Exemplo de 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"
    }
  ]
}

Observação: Serão considerados os locais de estoque ativos pertencentes ao operador logístico informado.

A consulta não realiza movimentações ou alterações no estoque.

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

A consulta da prévia permite calcular sugestões de distribuição de mercadorias considerando o operador logístico, a loja destinatária, o local de estoque, a operação e os filtros informados.

O resultado utiliza as regras de cálculo do Bluesoft ERP para selecionar os produtos elegíveis e apresentar informações de estoque, vendas e sugestões de distribuição.

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

Parâmetros principais:

• operador: Código do operador logístico.
• loja: Código da loja destinatária.
• localEstoque: Código do local de estoque de origem.
• operacao: Finalidade da distribuição. Nesta entrega, deverá ser utilizada a operação ENVIAR_PARA_LOJA.
• diasReposicao: Quantidade de dias utilizada no cálculo de reposição. Para calcular a sugestão, deve ser informado um valor positivo.

Filtros adicionais disponíveis:

• Dias de cobertura: Permite considerar o período de cobertura no cálculo.
• Curvas: Permite restringir os produtos de acordo com as curvas informadas.
• Departamento: Permite filtrar produtos por departamento.
• Seção: Permite filtrar produtos por seção.
• Grupo: Permite filtrar produtos por grupo.
• Subgrupo: Permite filtrar produtos por subgrupo.
• Período de entrada: Permite considerar a data de entrada dos produtos.
• Produtos com venda ou sem venda: Permite aplicar o filtro de vendas.
• Desprezar venda em oferta: Permite considerar a regra de exclusão das vendas em oferta.
• Desprezar gerados hoje: Permite desconsiderar os produtos abrangidos pela regra de lotes gerados no dia.
• Forma de distribuição: Permite informar a forma de distribuição, respeitando as configurações aplicáveis ao cálculo.

Importante: Para aplicar o filtro de período de entrada, deverão ser informadas as duas datas. Quando somente uma data for informada, não será aplicada a restrição por período de entrada.

Exemplo de 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
    }
  ]
}

Nesse exemplo, a consulta apresenta informações ilustrativas do produto selecionado, incluindo estoque disponível, média de vendas e quantidade sugerida para distribuição.

A sugestão real considera as configurações logísticas do destinatário e as regras de cálculo aplicáveis no ERP.

Regras importantes:

• A loja destinatária deverá estar autorizada para o usuário autenticado.
• O local de estoque deverá estar ativo e pertencer ao operador logístico informado.
• Os produtos serão selecionados conforme os filtros e as regras de cálculo do ERP.
• Não será permitido informar uma lista explícita de produtos por meio do parâmetro produtos.
• As configurações do destinatário serão consideradas pelo cálculo.
• A consulta não realiza reserva de estoque nem geração de lotes.

Permissões e segurança

As cinco consultas possuem permissões independentes, permitindo controlar quais operações estarão disponíveis para cada usuário. Para utilizar todas as consultas, o usuário deverá possuir as permissões 4764, 4765, 4766, 4767 e 4768. Caso o usuário não possua a permissão necessária para determinada consulta, o acesso será negado, com retorno HTTP 401 previsto para esse controle. Além das permissões, a integração respeita os vínculos entre operadores logísticos e lojas autorizadas.

Importante: A autorização para consultar um operador logístico não concede automaticamente acesso a todas as lojas relacionadas a ele. As informações retornadas deverão respeitar as autorizações do usuário autenticado.

Observações importantes

• Todas as consultas utilizam o método GET.
• Não é necessário enviar um corpo de dados nas requisições.
• Cada consulta poderá ser executada independentemente das demais, desde que sejam informados os parâmetros necessários.
• A funcionalidade contempla a consulta e a preparação da distribuição forçada para envio de mercadorias às lojas.
• A integração não contempla movimentações entre locais de estoque.
• As consultas não realizam reserva de estoque, geração de lotes, separação ou faturamento.
• A prévia de distribuição utiliza as regras de cálculo e as configurações aplicáveis no ERP.
• As quantidades apresentadas na prévia representam uma sugestão calculada no momento da consulta e não garantem disponibilidade futura do estoque.
• A integração não altera as permissões necessárias para os processos posteriores de distribuição.

Informações sobre os exemplos apresentados

Os exemplos desta documentação utilizam dados fictícios exclusivamente para demonstração.

O endereço {{baseUrl}} deverá ser substituído pelo endereço correspondente ao ambiente do Bluesoft ERP utilizado na integração.

As respostas JSON apresentadas são exemplos simplificados, não capturas reais da API. Para integrações efetivas, deverão ser utilizados os nomes de campos, os formatos e os parâmetros definidos no contrato técnico publicado da API.

Disponível a partir da versão r375.01.