Procura global

Um associado da loja deverá ser capaz de procurar por pedidos diretamente ou por pedidos criados para um cliente específico. Além disso, o associado à loja deverá ser capaz de procurar por produtos e remessas para fornecer informações relevantes para o cliente.

Solução

A seção a seguir descreve as APIs, as saídas de usuário, os serviços e outros componentes.

Um associado à loja pode selecionar Pedido, Cliente, Produto ou Remessa como o ponto de entrada e executar as tarefas de procura apropriadas. Por padrão, o Pedido é o ponto de entrada.
  • Pesquisa de pedidos
    O associado da loja pode clicar no ícone Procura global na barra de menus para procurar por um pedido. Se o cliente tiver um recibo, o associado da loja poderá procurar pelo número do pedido ou varrer um código de barras no recibo.
    • Quando o associado da loja varre o código de barras no recebimento, otranslateBarCodeA API é chamada para recuperar o número do pedido Os comandosgetOrderListA API é chamada com o número do pedido para recuperar os detalhes do pedido
      • Se nenhuma tradução for retornada pelotranslateBarCodeAPI, em seguida, ogetOrderListA API é chamada com a entrada original para otranslateBarCodeA API ou o associado da loja pode inserir manualmente o número do pedido.
      • Se várias traduções forem retornadas pelotranslateBarCodeAPI, uma mensagem de erro apropriada é exibida
    • Quando o associado da loja insere manualmente o número do pedido, ogetOrderListA API é chamada para recuperar o pedido
      • Se um único pedido for localizado e se o pedido for confirmado, a tela Resumo do pedido será exibida. Se o pedido for um pedido rascunho, a tela Visualizar carrinho de compras será exibida.
      • Se múltiplos pedidos forem localizados, eles serão listados e o associado da loja poderá selecionar o pedido apropriado para visualizar ou modificar.
      • Se nenhum pedido for retornado pelogetOrderListAPI, uma mensagem de erro apropriada é exibida
    • A procura de pedido também recupera ordens de vendas criadas por meio de múltiplos canais. A lista de pedidos exibe um número fixo de registros e a lista é classificada primeiro pelos pedidos mais recentes. Às vezes, um cliente pode não ter o número ou o recibo do pedido. Nesses casos, o associado da loja poderá clicar no link Procura avançada para procurar pelo pedido usando outros critérios, como nome, sobrenome, ID do e-mail, número de telefone, CEP e método de pagamento do cliente. Por exemplo, se associado da loja escolher um método de pagamento como um dos critérios, a API getPaymentTypeList será chamada para recuperar todos os tipos de pagamento usando o atributo CallingEnterpriseCode para a loja. O tipo de pagamento selecionado pelo associado da loja é transmitido como entrada junto de outros critérios de procura na API getOrderList para recuperar os pedidos correspondentes.
    • A procura exibe um número fixo de pedidos. Se houver mais pedidos para carregar, uma mensagem será exibida indicando o associado da loja para refinar a procura. O associado da loja pode usar a opção de filtro para limitar o resultado da procura.
    • A procura lista os pedidos feitos por clientes registrados e não registrados. A lista de pedido fornece detalhes, como o número do pedido, número de produtos, canal do pedido, nome da loja (no caso de compra na loja), data, quantia do pedido, status, nome do cliente, e assim por diante.
    • A API getCompleteOrderLineList retorna imagens para um máximo de dois produtos junto de uma contagem de produtos restantes no pedido.
  • Procura de cliente
    • Um associado da loja pode clicar no ícone Procura global na barra de menus e selecionar Cliente como o ponto de entrada do menu adjacente. O associado da loja pode digitar o número de telefone completo do cliente para procurar pelo mesmo. A API getCompleteCustomerList é chamada para recuperar os clientes correspondentes. A API faz uma correspondência exata dos números de telefone do cliente e retorna os resultados. Como alternativa, o associado da loja pode clicar no link Procura avançada para limitar a procura de cliente usando nome, e-mail, número de telefone, CEP e os últimos dígitos do cartão de crédito.
      • Se um único cliente for recuperado, a tela de detalhes do cliente será exibida com histórico de pedido do cliente.
      • Se múltiplos clientes forem recuperados, a tela Lista de cliente será exibida. Após o cliente correto ser identificado, o associado da loja poderá clicar em Visualizar pedidos para esse cliente.
      Em seguida, a API getOrderList é chamada para recuperar os pedidos associados a esse cliente. Os pedidos são classificados primeiro pelo mais recente e cada pedido possui detalhes, como o número do pedido, contagem de produtos (linhas de pedido), canal do pedido, status, data de criação do pedido, quantia do pedido, e assim por diante. Os pedidos rascunho também são exibidos junto dos pedidos confirmados.
    • A API getCompleteOrderLineList retorna imagens para um máximo de dois produtos junto de uma contagem de produtos restantes no pedido.
    Filtro

    O associado da loja pode filtrar pedidos usando critérios, como intervalo de data do pedido, status e canal do pedido. Quando o associado da loja clica na opção Refinar Lista de Pedidos , a API getCommonCodeList é chamada para preencher as caixas de seleção do tipo de entrada Os Status do pedido são selecionados a partir de uma lista predefinida no arquivo OrderStatusList.json, presente na pasta <WAR>\ngstore\shared\order\. Como o arquivo é configurável, é possível customizar os status conforme necessário. O associado da Loja pode selecionar Search within store para procurar pedidos criados apenas pela loja atual

    Quando o associado da loja seleciona os critérios de filtro apropriados e aplica o filtro, os critérios de filtro são transmitidos para a API getOrderList para recuperar os pedidos correspondentes aos critérios da entrada. O status do pedido, o intervalo de data, o código da organização vendedora e uma consulta complexa com o atributo EntryType apropriado são transmitidos como entrada para a API getOrderList para recuperar pedidos. Para o canal da loja, o EntryType é Store e, para o canal da central de atendimento, o EntryType é CallCenter.

  • Pesquisa de produtos
    • Um associado da loja pode clicar no ícone Procura global na barra de menus e selecionar Produto como o ponto de entrada do menu adjacente. O associado da loja pode procurar por um produto utilizando o ID do Produto, o Código de barras ou as Palavras-chave.
    • Quando o associado da loja insere as palavras-chave e clica no ícone Procurar, os produtos que corresponderem à procura serão exibidos na tela Localizar produtos. Os comandossearchCatalogIndexA API é chamada com oItemGroupCodeatributo configurado comoPROD, para buscar uma lista de produtos correspondentes às palavras-chave. Quando um produto é selecionado na lista de produtos correspondentes, ogetCompleteItemListA API é chamada para obter detalhes do produto
    • Como alternativa, se o associado da loja varrer um produto ou inserir um ID do produto e clicar no botão Varrer, ogetCompleteItemListA API é chamada para obter os detalhes do produto varrido
    • Quando os detalhes do produto são exibidos, o associado da loja permanece na tela Localizar produtos do assistente.
  • Procura de remessa
    Um associado à loja pode clicar no ícone Procura global na barra de menus e selecionar Remessa como o ponto de entrada no menu adjacente. O associado à loja pode varrer a remessa ou o pedido ou procurar por uma remessa usando o número do pedido ou da remessa. Como alternativa, o associado à loja pode executar uma procura avançada para remessas usando vários critérios, que incluem número do pedido ou número da remessa, tipo de preenchimento, status da remessa, transportadora e assim por diante.
    • Na lista Tipo de Cumprimento, o associado da loja pode selecionar o método de cumprimento apropriado. Por padrão, Todos, Retirada em Loja e Envio da Loja são exibidos.
    • O associado à loja pode selecionar um status apropriado na lista Status da remessa. É possível registrar o status da remessa no arquivo shipment-status.config.js, presente no diretório <WAR>\ngstore\store\config\. Para buscar a lista de status aplicáveis, uma chamada como iscShipmentStatus.getShipmentStatusConfig(All) é feita, que retorna todos os status de remessa aplicáveis para o nome do fluxo All (nome do fluxo padrão para procura de remessa global). O iscShipmentStatusProvider é usado para registrar o status para as remessas com relação a um nome do fluxo. Os nomes de fluxo podem ser Pick, Pack ou All. Ele é customizável e se você deseja incluir seus próprios status, é possível fazer uma chamada para o iscShipmentStatusProvider para registrar novos status para diferentes fluxos. Por exemplo, iscShipmentStatusProvider.addShipmentStatusConfig(All,9000,shipmentList.LABEL_9000); Somente status incluídos no fluxo All são listados aqui na lista de status para procura de remessa.
    • A API getScacList é chamada para preencher as transportadoras na lista Transportadora.
    • Para limitar ainda mais a procura, um associado à loja pode optar por excluir as remessas associadas às ordens de transferência e aos pedidos que estiverem sendo preenchidos por outras lojas. Também é possível procurar por remessas designadas a um associado à loja específico.
    • O associado à loja também pode inserir detalhes do cliente, como nome, sobrenome, número de telefone e endereço de e-mail como os critérios de procura e especificar se o cliente é um destinatário de retirada e loja ou não.

    Quando o associado da loja executar uma procura, a API getShipmentList será chamada para recuperar as remessas que correspondem aos critérios de entrada.

    O associado à loja pode optar por classificar os resultados da procura com base na data de remessa ou de retirada em loja esperada. O CallingOrganizationCode e o Entity = Shipment são transmitidos para o serviço getOrderByList para preencher as opções de classificação

    O associado à loja pode optar por filtrar os resultados da procura de remessa com base nos status de remessa. Os status são buscados na mesma maneira que nos critérios de procura. Com base no status de uma remessa, um associado da loja com permissões de recursos apropriadas poderá executar determinadas tarefas na remessa.

    • Se o status for "Pronto para seleção de estoque", o associado da loja poderá imprimir um chamado de seleção e executar a seleção de estoque.
    • Se o status for "Seleção em estoque em andamento", o associado da loja poderá escolher continuar a seleção de estoque iniciada por outro usuário. O associado da loja será orientado apropriadamente por um prompt, antes de continuar. Na confirmação, a remessa será designada ao associado da loja conectado no momento que poderá continuar com o fluxo do assistente específico.
    • Se o status for "Pronto para empacotamento" o associado da loja poderá escolher empacotar a remessa.
    • Se o status for “Embalagem em Andamento”, o associado da loja poderá escolher continuar com o processo de embalagem já iniciado por outro usuário. O usuário será orientado apropriadamente por um prompt, antes de continuar. Na confirmação, a remessa será designada ao associado da loja conectado no momento que poderá continuar com o fluxo do assistente específico.
    • Se o status for “Pronto para o cliente”, o associado à loja poderá iniciar a tarefa de retirada em loja pelo cliente.

implementação

A seção a seguir descreve as regras que você deve configurar.
  • O associado da loja deve ter a permissão de recurso Procura de Pedido para procurar pedidos..
  • O associado da loja deve ter a permissão de recurso Procura do Cliente para procurar clientes..
  • O associado da loja deve ter a permissão de recurso Captura de Pedido para procurar produtos..
  • O associado da loja deve ter a permissão de recurso Procura de Remessa Global para procurar por remessas
Para obter mais informações, consulte Administração de permissões de grupos de usuários.