release notes versão 2.18
TRANSCRIPT
Documentação de Versão Plataforma CORE Versão 2.18
Sumário
Integração com SimFrete
API de Leilões
Novos meios de entrega - Retirada em loja física e Entrega por loja física
Sistema Administrativo
Loja
Carrinho
Checkout
Retirada na loja
Envio pela loja
Painel do Cliente
Layer de integração
DeliveryMethods
Addresses
Novos recursos no tema Mobile
Recursos
CORE – Documentação de versão 2.18 1
Integração com SimFrete Foi implementado um novo meio de entrega, o SimFrete. A configuração se dá no painel
administrativo, em Configs - Meios de Entrega:
Figura 1: Tela de configuração do meio de entrega - SimFrete
A configuração se dá da mesma maneira que os demais meios de entrega com múltiplas
cotações, que deve estar ativa.
Para cada meio de entrega que deve ser disponibilizado no site, deve-se criar um meio de
entrega correspondente, deixando-o inativo. Em seguida, deve-se criar os mapeamentos no
SImFrete, como no exemplo a seguir:
CORE – Documentação de versão 2.18 2
Figura 2: configuração de múltiplas cotações do SimFrete
No Campo do alias deve ser especificado o CNPJ do meio de entrega e o meio de entrega
correspondente, que já deve ter sido previamente cadastrado, deve ser selecionado na
listagem ao lado.
Especificamente, o SimFrete tem configurações de gateway que devem ser preenchidas:
Figura 3: campos específicos de configuração do SimFrete
CORE – Documentação de versão 2.18 3
Campo Descrição / Preenchimento Obrigatório?
SimFrete.RemCNPJ CNPJ do remetente. Deve ser um número de 14 dígitos. Se for um CPF, deverá conter 000 no início.
Sim
SimFrete.RemNome Nome ou razão social do remetente. Deve ter um máximo de 100 caracteres.
Sim
SimFrete.Wsemp Código da empresa na rede da SimKorp. Sim
SimFrete.Wspwd Senha para autenticação do sistema conectando ao servidor.
Sim
SimFrete.Wsurl URL do serviço. Ex.: https://{loja}.simfrete.com/consultafrete5.jsp
Sim
SimFrete.Wsusr Usuário para autenticação do sistema conectando ao servidor.
Sim
Para o funcionamento do serviço, é necessário pedir a liberação dos IPs dos servidores que
irão acessá-lo junto à SimFrete.
CORE – Documentação de versão 2.18 4
API de Leilões Foi implementada a API de leilões, possibilitando toda a gestão dos leilões através da
mesma.
Método Descrição
DeleteProductAuction Método usado para excluir leilões
DeleteProductAuctionBid Método usado para excluir lances de leilões
GetProductAuction Método usado para retornar um leilão
GetProductAuctionBids Lista os lances de um determinado leilão
MakeProductAuctionTransition Método usado para fazer a transição do leilão para determinado status
SaveProductAuction Método usado para criar um novo leilão ou atualizar um leilão existente
SaveProductAuctionBid Método usado para criar um novo lance ou atualizar um lance existente
SearchProductAuctions Método usado para pesquisar leilões
SetProductAuctionWinner Método usado para definir o vencedor do leilão
Fluxo básico de execução dois métodos (Os schemas de requisição e resposta e a forma de
utilização são descritos na própria http://layer.minhaloja.corecommerce.com.br):
1. Utilizar o método SaveProductAuction para criar o leilão.
2. Utilizar o método SaveProductAuctionBid para incluir lances manuais em um leilão.
a. Utilizar o método GetProductAuction para retornar um determinado leilão.
b. Utilizar o método GetProductAuctionBids para retornar os lances de um
determinado leilão.
CORE – Documentação de versão 2.18 5
c. Utilizar o método DeleteProductAuction para excluir um leilão.
d. Utilizar o método DeleteProductAuctionBid para excluir um determinado
lance de um leilão.
e. Utilizar o método SearchProductAuctions para pesquisa leilões dados
diversos critérios especificados na layer.
3. Utilizar o método MakeProductAuctionTransition para alterar o status de um leilão.
4. Após decorrido a data de execução definida, o leilão é finalizado.
5. Com o leilão finalizado, é possível chamar o método SetProductAuctionWinner para
definir um lance vencedor.
CORE – Documentação de versão 2.18 6
Novos meios de entrega - Retirada em loja física e Entrega por loja física
Foram disponibilizados dois novos meios de entrega, “Retirada na loja” e “Envio pela loja”.
Na entrega “Retirada na loja”, é possível configurar uma lista de Pontos de Venda e uma
tabela de CEPs e valores. Desta forma o valor do frete é calculado automaticamente porém
o cliente poderá escolher o Ponto de Venda mais adequado para realizar a retirada dos
produtos.
A entrega “Envio pela loja” também possibilita a configuração de uma tabela de CEPs e
valores e de uma lista de Pontos de Venda, porém, ao contrário do “Retirada na loja”, o
pedido é enviado para o endereço selecionado pelo cliente assim como a seleção da loja
para envio é feita automaticamente priorizando a mais próxima do endereço de entrega.
Tanto no meio de entrega “Retirada na loja” e “Envio pela loja” o cálculo de valor do frete e
prazo é feito através de uma tabela(xls) que deverá ser cadastrada junto ao meio de
entrega.
1. Sistema Administrativo
A configuração para os novos meios de entrega se dá no administrativo do sistema, em
“Configs” > “Meios de Entrega”:
CORE – Documentação de versão 2.18 7
Figura 1: Tela de configuração do meio de entrega - Seleção de tipo
CORE – Documentação de versão 2.18 8
Figura 2: Tela de configuração do meio de entrega - Configuração de tabela de frete
CORE – Documentação de versão 2.18 9
Figura 3: Tela de configuração do meio de entrega - Configuração de Pontos de venda
Também é necessário criar uma Chave de API(API Key) no Google para que seja possível,
usar os serviços de mapas e geolocalização. É possível criar a chave neste link .
Posteriormente preencha o campo respectivo na tela de configurações por grupos.
CORE – Documentação de versão 2.18 10
Figura 4: Tela de configuração de configurações gerais - Configuração de chave de API do Google
2. Loja
2.1. Carrinho
Estes novos meios de entrega serão listados normalmente ao calcular o frete no Carrinho.
2.2. Checkout
2.2.1. Retirada na loja
Ao selecionar o meio de entrega no carrinho ou selecioná-lo na etapa de seleção do
checkout, abrirá uma modal para que seja selecionado o ponto de venda.
CORE – Documentação de versão 2.18 11
Figura 5: Tela de checkout - Seleção de Pontos de Venda
Nesta modal exibida na figura 4, também é possível selecionar outra pessoa para efetuar a
retirada na loja, neste caso, os campos “Nome” e “RG ou CPF” são obrigatórios.
Após a seleção do Ponto de Venda para retirada, a opção selecionada estará exibida abaixo
do endereço na etapa 1 do checkout:
CORE – Documentação de versão 2.18 12
Figura 6: Tela de checkout - Exibição de Ponto de Venda selecionado
E no resumo do pedido:
CORE – Documentação de versão 2.18 13
Figura 7: Tela de checkout - Exibição de Ponto de Venda selecionado
Na tela de confirmação do pedido, os dados do Ponto de Venda selecionado também são
exibidos:
CORE – Documentação de versão 2.18 14
Figura 8: Tela de checkout - Confirmação de pedido
2.2.2. Envio pela loja
Este meio de entrega não altera o fluxo normal de checkout pois o Ponto de Venda
que fará o envio dos produtos é selecionado pelo servidor( back-end ) no momento de
finalização da compra.
2.3. Painel do Cliente
Nas compras efetuadas com o meio de entrega “Retirada na loja”, os dados do Ponto de
Venda escolhido estarão exibidos na tela de detalhe do pedido no Painel do Cliente:
CORE – Documentação de versão 2.18 15
Figura 9: Tela de Detalhe do Pedido- Confirmação de entrega (retirada)
3. Layer de integração
Nos métodos da Layer que retornam o objeto do Pedido, foram adicionados os seguintes
dados:
3.1. DeliveryMethods
DeliveryMethods[].DeliveryMethodType String - Enum referente ao tipo de entrega. Possíveis valores. P- Retirada na loja H- Envio pela loja S- Seller C- Transportadora V- Virtual O - Offline
DeliveryMethods[].PointOfSaleID Int Nullable - ID do Ponto de Venda escolhido
DeliveryMethods[].PointOfSaleIntegrationID Int Nullable - ID de integração do Ponto de Venda escolhido
DeliveryMethods[].PointOfSaleName String - Nome do Ponto de Venda escolhido
Exemplo:
{
"DeliveryMethods" : [ {
"Amount" : 5.0000,
CORE – Documentação de versão 2.18 16
"DeliveryGroupID" : 3, "DeliveryMethodAlias" : "Retirada na loja", "DeliveryMethodID": 35 , "DeliveryMethodType": "P" , "ETA": "3|D" , "ETADays": 3 , "IntegrationID" : null , "OrderDeliveryMethodID" : 203, "OrderID": "8b5a4ff5-08f3-4c8e-958e-b5b443fd930e" , "PointOfSaleID" : 1, "PointOfSaleIntegrationID" : "567", "PointOfSaleName" : "EZ RS", "ScheduleDate": null , "ScheduleDisplayName" : null, "ScheduleEndTime" : null , "ScheduleShiftID" : null , "ScheduleStartTime" : null , "ScheduleTax": null
}
],
...
}
Código: Retorno do objeto Order
3.2. Addresses
Addresses[].ContactDocumentNumber String Nullable - Documento do contato se a retirada for feita por terceiro, caso contrário será null
Addresses[].PointOfSaleID Int Nullable - ID do Ponto de Venda do endereço
Exemplo:
{
"Addresses": [ {
"AddressLine": "Avenida Taquara" ,
CORE – Documentação de versão 2.18 17
"AddressNotes": null , "AddressType": 68 , "City" : "Porto Alegre", "ContactDocumentNumber" : "23432432", "ContactName": "Ricardo Souza" , "Landmark" : null, "Name" : "EZ RS", "Neighbourhood" : "-", "Number" : "335", "OrderAddressID": 406 , "OrderID": "8b5a4ff5-08f3-4c8e-958e-b5b443fd930e" , "PointOfSaleID" : 1, "PostalCode" : "90460210" , "State": "RS"
}
],
... }
Código: Retorno do objeto Order
CORE – Documentação de versão 2.18 18
Novos recursos no tema Mobile 1. Recursos
1.1. Lista de desejos
Disponível nesta nova versão os recursos da lista de desejos, no detalhe do produto, lista de
produtos e resultados de buscas.
Figura [1.1] - Adicionar aos favoritos. Em: Detalhe do produto
CORE – Documentação de versão 2.18 19
Figura [1.2] - Adicionar aos favoritos. Em: Resultado de busca
1.2. Serviços adicionais
No Carrinho é possível selecionar recursos adicionais.
Figura [1.3] - Recursos adicionais. Em: Carrinho
CORE – Documentação de versão 2.18 20
Figura [1.4] - Opções. Em: Carrinho
Figura [1.5] - Item selecionado. Em: Carrinho
Figura [1.6] - Escrever mensagem para embalagem. Em: Carrinho
CORE – Documentação de versão 2.18 21
Figura [1.7] - Mensagem. Em: Carrinho
1.3. Detalhe do produto
O detalhes do produto está renovado, para melhorar a experiência do usuário.
Figura [1.8] - Detalhe do produto
CORE – Documentação de versão 2.18 22
Figura [1.9] - Avaliações. Em: Detalhe do produto
CORE – Documentação de versão 2.18 23
1.4. Login e Cadastro
Novas telas para login e cadastro de novos usuários.
Figura [1.10] - Login
CORE – Documentação de versão 2.18 24
Figura [1.11] - Cadastro
1.5. Informações customizadas no detalhe do produto
Em Detalhe do Produto, onde mostra as descrições é possível configurar uma template
customizadas para novas seções.
Figura [1.12] - Descrição customizada. Em: Detalhe do produto
CORE – Documentação de versão 2.18 25
A configuração é feita em dois arquivos da pasta Shared:
● /Themes/Mobile/”loja”/Configs/settings.template
{% assign ProductDescriptions_ShowCustom = true %}
● /Themes/Mobile/”loja”/Templates/02-widgets/product.descriptions/wd.product.des
criptions.custom.template
< li class="dropdown"> < a title="Detalhes" rel="detalhes" class="title">
< span class="wd-title" > Detalhes</ span> </ a > < div id="accordion-detalhes" class= "content">
< div class= "wrapper"> Lorem ipsum dolor sit amet, consectetur
adipisicing elit...
</ div> </ div>
</ li>
1.6. Painel do Cliente
Com o novo cabeçalho da página do painel do cliente, fica mais fácil de navegar e obter as
informações de seus pedidos.
CORE – Documentação de versão 2.18 26
Figura [1.13] - Painel do Cliente
CORE – Documentação de versão 2.18 27