A Riachuelo, marca brasileira especializada em moda, é uma rede de lojas de departamento que figura entre as maiores varejistas do país. Após firmar uma parceria com a VTEX, a Riachuelo se tornou um conector certificado, também chamado de parceiro. Isso significa que agora é mais fácil para uma loja VTEX vender seus produtos no Riachuelo Marketplace.
Este artigo orienta como configurar a integração com a Riachuelo. O primeiro passo é entrar em contato com o parceiro por meio do cadastro no Riachuelo Marketplace. Para saber como prosseguir após o cadastro, você pode acessar a página da Riachuelo PORTAL DO SELLER - CADASTRO DE SENHA E PRIMEIRO ACESSO.
Feito isso, dê continuidade às etapas da integração, que foram organizadas em três seções:
- Configurações na plataforma VTEX
- Envio de informações para Riachuelo
- Cadastro do Endpoint de Search do afiliado
Você também pode conferir as orientações para a integração fornecidas pela Riachuelo na página MANUAL DE INTEGRAÇÃO VTEX.
Configurações na plataforma VTEX
Para integrar com a Riachuelo, é necessário realizar as seguintes etapas no seu Admin:
- Definir política comercial
- Criar afiliado
- Definir Estratégia de Envio
- Criar novo access key e secret
- Criar novo usuário
Definir política comercial
A política comercial é o que determina o sortimento de produtos, preços e estratégia de envio da sua loja VTEX em um canal de venda. Se você deseja que as mesmas configurações da sua loja sejam utilizadas para seus produtos no Riachuelo Marketplace, não é necessário criar uma política comercial nova, pois uma mesma política comercial pode ser usada para diferentes canais de venda.
Caso seja do seu interesse ter configurações específicas para vender na Riachuelo, você pode configurar uma política comercial para marketplace. Não existe cobrança para a contratação de políticas comerciais adicionais para integrar lojas VTEX com conectores nativos, conectores certificados ou outras lojas VTEX. Saiba mais em Estratégias de marketplace na VTEX.
Os produtos que você deseja enviar para o Riachuelo Marketplace devem estar associados à política comercial definida. Caso contrário, eles não serão integrados.
Criar afiliado
O afiliado é o identificador de uma loja VTEX em um marketplace, sendo necessário que o seller tenha um ID do afiliado diferente para cada marketplace onde venda seus produtos. Ou seja, para a integração com a Riachuelo é preciso configurar um afiliado exclusivo. Para criar um novo ID do afiliado, siga os passos abaixo:
- No Admin, no menu
Configurações da loja > Pedidos
. - Clique em
Configurações
. - No topo da página, selecione
Afiliados
. - Clique em
+ Novo afiliado
. - Preencha os campos da tela, descritos abaixo, e em seguida clique em
Salvar
.
- Nome: designação do novo afiliado, a sugestão do parceiro é utilizar rchlo marketplace.
- ID: código identificador do afiliado, deve ser composto de três consoantes, sejam elas repetidas ou não. Vogais não são aceitas. A sugestão é usar RCL.
- Política Comercial: número da política comercial que definirá o sortimento de catálogo, preço e estratégia de envio dos produtos enviados para a Riachuelo.
- E-mail de Follow Up: endereço eletrônico que receberá notificações sobre a integração.
- Endpoint de Search: URL da aplicação que receberá notificações de produtos, preço, estoque, dentre outros.
Esta informação ficará pendente e será retomada na parte final deste artigo, em Cadastro do Endpoint de Search do afiliado.
- Versão do Endpoint de Search: só existe a opção padrão 1.x.x.
- Deixe desmarcada a flag Usar meu meio de pagamento.
Definir Estratégia de Envio
Para vender seus produtos no Riachuelo Marketplace é preciso determinar uma Estratégia de Envio, ou seja, informar qual será a logística de entrega dos seus produtos. A Estratégia de Envio é composta de três etapas logísticas: Política de Envio, Estoque e Doca.
A Política de Envio estabelece o conjunto de regras das condições de frete, ou seja, informações de custo, transporte e tempo de entrega. Além disso, é também por meio Política de Envio que é feita a associação de qual será o local de armazenamento dos seus produtos (Estoque), e qual será o espaço de escoamento desses produtos (Doca).
Se for do seu interesse utilizar a mesma Estratégia de Envio definida para sua loja VTEX na integração com a Riachuelo, não é necessário criar novas configurações de logística. Se, no entanto, você deseja criar uma Estratégia de Envio específica para o marketplace, é necessário realizar os seguintes passos:
- Cadastrar Política de envio, associada à política comercial usada na integração.
- Cadastrar Doca, associada à política comercial usada na integração.
- Cadastrar Estoque, associado à Doca criada no passo anterior.
Caso você queira conferir se as configurações foram realizadas corretamente, você pode fazer uma simulação de envio. O Simulador de envio é uma ferramenta que possibilita checar as condições de entrega do produto sem de fato abrir um pedido.
Criar novo access key e secret
A chave de integração, chamada de access key, é o que possibilita o fluxo de envio e atualização de informações entre sua loja VTEX e a Riachuelo. Somente o usuário Titular da conta (owner) tem permissão para criar um access key e secret, e a opção só é visível no Admin para este usuário. Para configurar uma nova chave, siga os passos abaixo:
- No avatar de seu perfil, clique em CONFIGURAÇÕES DA CONTA.
- Clique em
Conta
. - Em Segurança, clique em
Gerar access key e secret
. - Preencha com um nome para o novo access key e clique em
Gerar novos secrets
.
O secret gerado, também chamado de appToken, só aparece para o usuário esta única vez, não é possível recuperar a informação pelo sistema posteriormente. Portanto, tenha a certeza de guardá-lo em local seguro.
Criar novo usuário
Um usuário é um perfil configurado para poder realizar determinadas ações na plataforma VTEX. Depois de ter gerado um novo access key e secret, é necessário criar um usuário para conceder as permissões de acesso necessárias. Para isso, siga os passos abaixo:
- No avatar de seu perfil, clique em CONFIGURAÇÕES DA CONTA.
- Clique em
Usuários
. - Clique no botão
+ NOVO
. - Preencha o campo do email com a access key criada.
- Clique em
+ADICIONAR PERFIS
. - Selecione a flag correspondente a
IntegrationProfile - Fulfillment Gateway Oms
. - Clique no botão
ADICIONAR PERFIS
. - Clique em
SALVAR
.
Envio de informações para Riachuelo
Uma vez concluídas as configurações na plataforma VTEX, para dar continuidade à integração é necessário enviar alguns dados para a Riachuelo. Essas informações devem ser encaminhadas para o gerente da sua conta na Riachuelo, por meio do email marketplace@riachuelo.com.br.
- Nome da conta: também chamado de Account Name, é o identificador da sua empresa no sistema da VTEX. Para encontrá-lo, acesse o Admin no módulo CONFIGURAÇÕES DA CONTA > Gerenciamento da conta > Conta > Dados da empresa.
- Política comercial: número da política comercial determinada na etapa Definir política comercial.
- ID do afiliado: identificador configurado na etapa Criar afiliado.
- Access key (appKey): definido na etapa Criar novo access key e secret.
- Secret (appToken): definido na etapa Criar novo access key e secret.
Cadastro do Endpoint de Search do afiliado
Na etapa Criar afiliado, o preenchimento do campo Endpoint de Search havia ficado pendente e agora será realizado.
O cadastro do Endpoint de Search só pode ser feito após a confirmação da Riachuelo de que o catálogo da sua loja VTEX foi integrado.
Uma vez recebida a confirmação do parceiro, realize os passos abaixo:
- No Admin, no menu Configurações de loja > Pedidos.
- Clique em
Configurações
. - No topo da página, selecione
Afiliados
. - Clique sobre o ID do afiliado definido na etapa Criar afiliado.
- Preencha o campo Endpoint de Search com a URL
https://vtex-notification-prd.azurewebsites.net/api/notification
. - Clique em
Salvar
.
Feito isso, a integração com a Riachuelo terá sido concluída. Vale ressaltar que o processo de onboarding com conectores certificados é responsabilidade dos parceiros. A Riachuelo disponibiliza conteúdo de treinamento sobre o Portal do Seller.
Você também pode conferir as orientações para a integração fornecidas pela Riachuelo pela página MANUAL DE INTEGRAÇÃO VTEX. Em caso de dúvidas, entre em contato pela central de ajuda da Riachuelo.