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