Ativação:

  • No painel administrativo, acesse: Canais > Canais. Selecione o canal a ter a funcionalidade ativa > Estoque > Disponibilidade Regional > Ativo


  • Para que todos os estoques estejam relacionados a funcionalidade, marque a opção "Todos os Estoques da Unidade de Negócio"


  • Caso a opção "Todos os Estoques da Unidade de Negócio" esteja ativa, somente os estoques relacionados a unidade de negócio do canal atenderão a funcionalidade.
  • Saiba Mais sobre Canais e  Unidades de Negócio através da documentação.



Definição de Estoques por Faixas de Cep:

  • No painel administrativo, acesse: Backoffice > Estoques. Selecione o Estoque > Formas de Entrega > Área de Cobertura > Marque a Opção Utiliza Área de Cobertura para o Estoque:

Para Incluir Faixas de Cep:

  • Tipo = Inclusão
  • CEP Início e CEP Fim.

Para Excluir Faixas de Cep:

  • Tipo = Exclusão
  • CEP Início e CEP Fim.


  • É possível adicionar diversas faixas de CEP de Inclusão e de Exclusão em um mesmo Estoque.

  • Caso um estoque não possua nenhuma faixa configurada, ele será considerado apto a atender qualquer CEP.

  • Estoques com faixas de exclusão têm prioridade sobre estoques com ou sem faixas de inclusão.

  • As restrições de faixa de CEP também são aplicadas durante o processo de cotação de frete, mesmo que a funcionalidade de Disponibilidade Regional esteja desativada no canal. Por exemplo, um estoque configurado para atender apenas a faixa de CEP do Rio Grande do Sul nunca será considerado em uma cotação de frete para um CEP fora desse estado. Na prática, isso significa que o estoque só realizará despachos de mercadorias para os CEPs dentro da sua área de cobertura configurada.



Para garantir que o cliente consumidor insira seu CEP e visualize os produtos disponíveis diretamente na página inicial ou navegação pela loja virtual:

  1. Solicite à equipe responsável pela interface da loja (ex.: agência parceira) a criação de uma modal ou campo para inserção do CEP na página inicial.

  2. Configure a funcionalidade para que, ao inserir o CEP:

    • O sistema carregue apenas os produtos disponíveis nos estoques que atendem àquela região.

    • Utilize a rota /definir-cep para registrar o CEP informado e atualizar os produtos exibidos.

 Segue abaixo uma sugestão de como implementar o script para definir o CEP na navegação daquele consumidor.

app.tools.getCoordinates(postalCode, function(resp) {
    var lat = null;
    var long = null;

    if (resp.status == "OK") {
        lat = resp.results[0].geometry.location.lat.toString();
        long = resp.results[0].geometry.location.lng.toString();
    }
    
    $.ajax({
        url: browsingContext.Common.Urls.Shopping.Basket.Index + '/definir-cep',
        type: 'POST',
        data: {
            postalCode: postalCode,
            latitude: lat,
            longitude: long
        }
    }).done(function() {
        location.reload();
    }).always(function() {
        // Fechar modal
    });
});

O código JavaScript apresentado utiliza a API do Google Maps para converter um CEP fornecido pelo cliente em coordenadas geográficas (latitude e longitude). Essas informações são então enviadas, junto com o CEP, para a rota /definir-cep por meio de uma requisição AJAX. Após a conclusão da requisição, a página é recarregada para que os produtos exibidos na loja sejam atualizados com base no estoque que atende ao CEP informado.

Por que as Coordenadas São Importantes?

As coordenadas (latitude e longitude) são fundamentais porque são utilizadas pelo sistema de cotação de frete para determinar qual estoque será priorizado com base na proximidade geográfica. Sem essas informações:

  • O sistema pode ignorar a geolocalização.

  • Existe o risco de engajar um estoque mais distante do consumidor, o que pode aumentar custos e prazos de entrega desnecessariamente.

Fluxo do Código

  1. Obtenção das Coordenadas:

    • A função app.tools.getCoordinates chama o Google Maps para buscar as coordenadas do CEP fornecido.

    • Se o status da resposta for "OK", as coordenadas são extraídas e convertidas para strings.

  2. Envio dos Dados:

    • Uma requisição AJAX é feita para a rota /definir-cep, enviando:

      • O CEP fornecido.

      • A latitude e longitude obtidas.

  3. Atualização da Página:

    • Após o envio bem-sucedido dos dados, a página é recarregada para aplicar as alterações na exibição dos produtos disponíveis.

  4. Fechamento da Modal:

    • A modal de inserção do CEP é fechada após o envio ou em qualquer caso de erro.

Essa abordagem garante que os produtos exibidos estejam alinhados com os estoques disponíveis para atender ao CEP informado, otimizando a experiência do cliente consumidor.