Compartilhar via


Módulo de seletor de loja

O Grupo de Interesse de Varejo da Dynamics 365 Commerce mudou do Yammer para o Viva Engage. Se você não tiver acesso à nova comunidade do Viva Engage, preencha este formulário (https://aka.ms/JoinD365commerceVivaEngageCommunity) para ser adicionado e permaneça envolvido nas discussões mais recentes.

Este artigo abrange o módulo de seletor de loja e descreve como adicioná-lo às páginas do site no Microsoft Dynamics 365 Commerce.

Os clientes podem usar o módulo de seletor de loja para retirar um produto em uma loja selecionada após realizarem uma compra online. Na versão 10.0.13 do Commerce, o módulo de seletor de loja também inclui recursos que podem exibir uma página Localizar uma loja que mostra as lojas próximas.

O módulo de seletor de loja permite que os usuários insiram um local (cidade, estado, endereço, etc.) para procurar lojas em um raio de pesquisa. Ao abrir o módulo pela primeira vez, ele usará o local do navegador do cliente para localizar lojas (se esse recurso tiver sido autorizado).

Uso do módulo de seletor de loja

  • Um módulo de seletor de loja pode ser usado na página de detalhes de um produto (PDP) para selecionar uma loja onde será feita a retirada.
  • Um módulo de seletor de loja pode ser usado na página de um carrinho para selecionar uma loja onde será feita a retirada.
  • Um módulo de seletor de loja pode ser usado em uma página autônoma que mostra todas as lojas disponíveis.

Configuração do grupo de atendimento no Commerce headquarters

Para que o seletor de loja exiba os armazenamentos disponíveis, o grupo de atendimento deve ser configurado no Commerce headquarters. Para obter mais informações, consulte Configurar grupos de atendimento.

Além disso, para cada loja no grupo de processamento, a latitude e a longitude da loja de varejo devem ser definidas no headquarters.

Para inserir os valores de latitude e longitude de uma loja de varejo no Commerce headquarters, siga estas etapas:

  1. No Commerce headquarters, acesse Administração da Organização > Organizações > Unidade operacional.

  2. Pesquise pelo número da unidade operacional no painel esquerdo.

  3. Na Guia Rápida Endereços, selecione Mais opções -> Avançado.

    Exemplo de informações da loja no headquarters.

  4. No Painel de Ações, selecione Editar.

  5. Na Guia Rápida Geral, insira valores de Latitude e Longitude.

    Exemplo de configuração de latitude e longitude para uma loja no headquarters.

  6. No Painel de ações, selecione Salvar.

  7. Execute o trabalho de agenda de distribuição Configuração do canal 1070,

Ocultar um armazenamento no módulo de seletor de loja

Algumas lojas de um grupo de atendimento podem não ser locais de retirada válidos. Para garantir que apenas locais de retirada válidos apareçam como opções no módulo de seletor de loja, siga estas etapas no Commerce headquarters.

  1. No Commerce headquarters, acesse Varejo e Comércio > Configuração do Commerce > Grupos de processamento > Todas as lojas.
  2. No Painel de Ações, selecione Editar.
  3. Em Configuração, para cada loja que não seja um local de retirada válido, desmarque a caixa de seleção É Local de Retirada.
  4. No Painel de ações, selecione Salvar.
  5. Execute o trabalho de agenda de distribuição Configuração do canal 1070,

Importante

  • O Bing Mapas para Empresas foi preterido e está agendado para ser desativado. Se você tiver uma licença corporativa do Bing Maps for Enterprise, poderá continuar a usá-la até 30 de junho de 2028. Se você tiver uma licença básica ou gratuita do Bing Maps for Enterprise, poderá continuar a usá-la até 30 de junho de 2025.
  • Até que os módulos do Azure Mapas sejam disponibilizados no Commerce versão 10.0.45, você poderá habilitar manualmente o Azure Mapas seguindo as etapas fornecidas no repositório do GitHub Dynamics365Commerce.Solutions.

Integração do Azure Mapas

O módulo de seletor de loja está integrado com as APIs (interfaces de programação de aplicativo) REST do Azure Mapas para usar os recursos de Pesquisa Difusa do Azure Mapas. Uma chave de API do Azure Mapas é necessária e deve ser adicionada à página de parâmetros compartilhados no Commerce headquarters. A integração com a API de Sugestão Automática é usada para mostrar sugestões de pesquisa quando os usuários inserem locais no campo de pesquisa.

Para o SDK REST do Azure Mapas, é necessário garantir que as seguintes URLs sejam permitidas de acordo com a CSP (política de segurança de conteúdo) do seu site. Essa configuração é executada na criação de site do Commerce, adicionando as URLs permitidas às várias diretivas da CSP do site (por exemplo, img-src). Para obter mais informações, consulte Política de segurança de conteúdo.

  • Para a diretiva child-src, adicione "blob:".
  • Para a diretiva connect-src, adicione https://atlas.microsoft.com/ e https://js.monitor.azure.com/.
  • Para a diretiva font-src, adicione https://atlas.microsoft.com/.
  • Para a diretiva script-src, adicione https://atlas.microsoft.com/.
  • Para a diretiva style-src, adicione https://atlas.microsoft.com/.

Modo Retirar na loja

O módulo de seletor de loja oferece suporte para o modo Retirar na loja, que mostra uma lista de lojas nas quais o produto está disponível para retirada. Ele também mostra o horário de funcionamento e o estoque de produtos de todas as lojas na lista. O módulo de seletor de loja requer o contexto de um produto para renderizar a disponibilidade do produto e para permitir que o usuário adicione o produto ao carrinho, caso o modo de entrega do produto esteja definido como retirada na loja selecionada. Para obter mais informações, consulte configurações de estoque.

O módulo de seletor de loja pode ser adicionado a um módulo de caixa de compra em uma PDP para mostrar as lojas em que um produto está disponível para retirada. Também pode ser adicionado a um módulo de carrinho. Nesse caso, o módulo de seletor de loja mostra as opções de retirada para cada item de linha no carrinho. O módulo de seletor de loja também pode ser adicionado a outras páginas ou módulos por meio de extensões e personalizações.

Para que esse cenário funcione, os produtos devem ser configurados para usar o modo de entrega retirada. Caso contrário, o módulo não será mostrado nas páginas de produtos. Para obter mais informações sobre como configurar o modo de entrega, consulte Configurar os modos de entrega.

A imagem a seguir mostra um exemplo de um módulo de seletor de loja usado em uma PDP.

Exemplo de um módulo de seletor de loja usado em um PDP.

Anotação

No Commerce versão 10.0.16 e posterior, um novo recurso pode ser habilitado que permite que uma organização defina vários modos de separação de opções de entrega para os clientes. Se esse recurso estiver habilitado, o módulo de seletor de loja e outros módulos do Commerce serão aprimorados para permitir que o comprador escolha entre as opções potencialmente múltiplas de entrega de separação, se configurado. Para saber mais sobre esse recurso, consulte esta documentação.

Modo Localizar lojas

O módulo de seletor de loja também oferece suporte para um modo Localizar lojas. Esse modo pode ser usado para criar uma página de localizações de lojas que mostra as lojas disponíveis e suas informações. Nesse modo, o módulo de seletor de loja funciona sem o contexto do produto e pode ser usado como um módulo autônomo em qualquer página do site. Além disso, se as configurações relevantes estiverem ativadas para o módulo, os usuários poderão selecionar a sua loja preferida. Quando uma loja é selecionada como a preferida do usuário, a sua ID será mantida no cookie do navegador. Portanto, o usuário deverá aceitar a mensagem de consentimento de cookies.

A ilustração a seguir mostra um exemplo de um módulo de seletor de loja usado com um módulo do Azure Mapas na página de localizações de loja.

Exemplo de um módulo de seletor de loja e um módulo do Azure Mapas em uma página de localizações de loja.

Renderizar um mapa

O módulo de seletor de loja pode ser usado com o módulo do Azure Mapas para mostrar as localizações das lojas no mapa. Saiba mais em Módulo do Azure Mapas

Propriedades do módulo de seletor de loja

Nome da propriedade Valor descrição
Título Texto O título do módulo.
Modo Localizar lojas ou Retirar na loja O modo Localizar lojas mostra as lojas disponíveis. O modo Retirar na loja permite que os usuários selecionem uma loja para retirar o produto.
Estilo Caixa de diálogo ou Em linha O módulo pode ser renderizado em linha ou em uma caixa de diálogo.
Definir como loja preferida Verdadeiro ou Falso Quando essa propriedade for definida como True, os usuários poderão definir uma loja preferida. Esse recurso requer que os usuários aceitem uma mensagem de consentimento de cookies.
Mostrar todas as lojas Verdadeiro ou Falso Quando essa propriedade for definida como True, os usuários poderão ignorar a propriedade Raio de pesquisa e exibir todas as lojas.
Opções de sugestão automática: resultados máximos Número Essa propriedade define o número máximo de resultados de sugestão automática que podem ser exibidos pela API de Pesquisa Difusa do Azure Mapas.
Pesquisar raio Número Essa propriedade define o raio de pesquisa de lojas, em milhas. Se nenhum valor for especificado, o raio de pesquisa padrão de 50 milhas será usado.
Termos de serviço URL Essa propriedade especifica a URL de termos de serviço necessária para usar o serviço Azure Mapas.

Configurações de site

O módulo seletor de armazenamento respeita as Configurações de Adicionar produto ao carrinho. Depois que um item é adicionado ao carrinho do módulo de seletor de loja, os usuários do site verão os fluxos de trabalho configurados adequados.

Adicionar um módulo de seletor de loja a uma página

O modo Retirar na loja pode ser usado somente em PDPs e páginas de carrinho. Defina o modo como Retirar na loja no painel de propriedades do módulo.

  • Para obter informações sobre como adicionar um módulo de seletor de loja a um módulo de caixa de compra, consulte Módulo de caixa de compra.
  • Para obter informações sobre como adicionar um módulo de seletor de loja a um módulo de carrinho, consulte Módulo de carrinho

Para configurar o módulo de seletor de loja a fim de mostrar as lojas disponíveis na página de localizações, siga estas etapas.

  1. No Commerce headquarters, acesse Modelos e selecione Novo para criar um modelo.
  2. Na caixa de diálogo Novo modelo, em Nome do modelo, insira Modelo de marketing e selecione OK.
  3. Selecione Salvar, Concluir edição para fazer check-in do modelo e depois selecione Publicar para publicá-lo.
  4. Acesse Páginas e selecione Novo para criar uma nova página.
  5. Na caixa de diálogo Criar uma nova página, em Nome da página, insira Localização das lojas e selecione Avançar.
  6. Em Escolher um modelo, selecione o Modelo de marketing que você criou e escolha Avançar.
  7. Em Escolher um layout, selecione um layout de página (por exemplo, Layout flexível) e selecione Avançar.
  8. Em Revisar e concluir, revise a configuração da página. Se você precisar editar as informações da página, selecione Voltar. Se as informações da página estiverem corretas, selecione Criar página.
  9. No slot Principal da nova página, selecione as reticências (...) e, depois, Adicionar módulo.
  10. Na caixa de diálogo Selecionar módulos, selecione o módulo Contêiner e, depois, OK.
  11. No slot Contêiner, selecione as reticências (...) e, depois, Adicionar módulo.
  12. Na caixa de diálogo Selecionar módulos, selecione o módulo Contêiner com 2 colunas e, depois, OK.
  13. No painel de propriedades do módulo, defina o valor de Largura como Preencher Contêiner.
  14. Defina o valor de Configuração da coluna da porta de exibição extra pequena como 100%.
  15. Defina o valor de Configuração da coluna da porta de exibição pequena como 100%.
  16. Defina o valor de Configuração da coluna da porta de exibição média como 33% 67%.
  17. Defina o valor de Configuração da coluna da porta de exibição grande como 33% 67%.
  18. No slot Contêiner com 2 colunas, selecione as reticências (...) e, depois, Adicionar módulo.
  19. Na caixa de diálogo Selecionar módulos, selecione o módulo Seletor de loja e, depois, OK.
  20. No painel de propriedades do módulo, defina o valor de Modo como Localizar lojas.
  21. Defina o valor de Raio de pesquisa em milhas.
  22. Defina as outras propriedades, como Definir como loja preferida, Exibir todas as lojas e Habilitar a sugestão automática, conforme necessário.
  23. No slot Contêiner com 2 colunas, selecione as reticências (...) e, depois, Adicionar módulo.
  24. Na caixa de diálogo Selecionar módulos, selecione o módulo do Azure Mapas e, em seguida, selecione OK.
  25. No painel de propriedades do módulo, defina as propriedades adicionais conforme necessário.
  26. Selecione Salvar, Concluir edição para fazer check-in da página e depois selecione Publicar para publicá-lo.

Recursos adicionais

Visão geral da biblioteca de módulos

Módulo de caixa de compra

Módulo de carrinho

Tour rápido da PDP

Tour rápido do carrinho e do check-out

Configurar os modos de entrega

Gerenciar o Azure Mapas da sua organização

SDK REST do Azure Mapas

Módulo do Azure Mapas