{"section":"tutorials","requestedLocale":"pt","requestedSlug":"integracao-com-riachuelo","locale":"pt","slug":"integracao-com-riachuelo","path":"docs/pt/tutorials/integrações/configurações-de-integrações/integracao-com-riachuelo.md","branch":"main","content":"A [Riachuelo](https://www.riachuelo.com.br), 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](/pt/docs/tutorials/estrategias-de-marketplace-na-vtex#integrado-a-conector-certificado-parceiro), também chamado de parceiro. Isso significa que agora é mais fácil para uma loja VTEX vender seus produtos no Riachuelo Marketplace.\n\nEste 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](https://www.riachuelo.com.br/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](https://riachuelomarketplace.zendesk.com/hc/pt-br/articles/1500010648222-Portal-do-Seller-Cadastro-de-senha-e-primeiro-acesso).\n\nFeito isso, dê continuidade às etapas da integração, que foram organizadas em três seções:\n\n- [Configurações na plataforma VTEX](#configuracoes-na-plataforma-vtex)\n- [Envio de informações para Riachuelo](#envio-de-informacoes-para-riachuelo)\n- [Cadastro do Endpoint de Search do afiliado](#cadastro-do-endpoint-de-search-do-afiliado)\n\n> ℹ️ Você também pode conferir as orientações para a integração fornecidas pela Riachuelo na página [MANUAL DE INTEGRAÇÃO VTEX](https://riachuelomarketplace.zendesk.com/hc/pt-br/articles/1500008432221-Integra%C3%A7%C3%A3o-VTEX-Orienta%C3%A7%C3%B5es-gerais).\n\n## Configurações na plataforma VTEX\n\nPara integrar com a Riachuelo, é necessário realizar as seguintes etapas no seu Admin:\n\n- [Definir política comercial](#definir-politica-comercial)\n- [Criar afiliado](#criar-afiliado)\n- [Definir Estratégia de Envio](#definir-estrategia-de-envio)\n- [Criar novo access _key_ e _secret_](#criar-novo-access-key-e-secret)\n- [Criar novo usuário](#criar-novo-usuario)\n\n### Definir política comercial\n\nA [política comercial](/pt/docs/tutorials/como-funciona-uma-politica-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](/pt/docs/tutorials/criar-uma-politica-comercial) nova, pois uma mesma política comercial pode ser usada para diferentes canais de venda.\n\nCaso seja do seu interesse ter configurações específicas para vender na Riachuelo, você pode [configurar uma política comercial para marketplace](/pt/docs/tutorials/configurando-a-politica-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](/pt/docs/tutorials/estrategias-de-marketplace-na-vtex).\n\n> ⚠️ Os produtos que você deseja enviar para o Riachuelo Marketplace devem estar [associados à política comercial](/pt/docs/tutorials/associacao-de-sku-a-politica-comercial) definida. Caso contrário, eles não serão integrados.\n\n### Criar afiliado\n\nO [afiliado](/pt/docs/tutorials/o-que-e-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](/pt/docs/tutorials/como-configurar-afiliado) exclusivo. Para criar um novo ID do afiliado, siga os passos abaixo:\n\n1. No Admin, no menu `Configurações da loja > Pedidos`.\n2. Clique em `Configurações`.\n3. No topo da página, selecione `Afiliados`.\n4. Clique em `+ Novo afiliado`.\n5. Preencha os campos da tela, descritos abaixo, e em seguida clique em `Salvar`.\n\n- **Nome:** designação do novo afiliado, a sugestão do parceiro é utilizar _rchlo marketplace_.\n- **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.\n- **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.\n- **E-mail de Follow Up:** endereço eletrônico que receberá notificações sobre a integração.\n- **Endpoint de Search:** URL da aplicação que receberá notificações de produtos, preço, estoque, dentre outros.\n\n> ❗ Esta informação ficará pendente e será retomada na parte final deste artigo, em Cadastro do Endpoint de Search do afiliado.\n\n- **Versão do Endpoint de Search:** só existe a opção padrão _1.x.x_.\n- Deixe desmarcada a flag _Usar meu meio de pagamento_.\n\n### Definir Estratégia de Envio\n\nPara vender seus produtos no Riachuelo Marketplace é preciso determinar uma [Estratégia de Envio](/pt/docs/tutorials/estrategia-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](/pt/docs/tutorials/politica-de-envio), [Estoque ](/pt/docs/tutorials/estoque)e [Doca](/pt/tracks/logistica-101--13TFDwDttPl9ki9OXQhyjx/4Rr5XpzAzUPv2Eo9Mh7cEj?&utm_source=autocomplete).\n\nA 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).\n\nSe 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:\n\n1. [Cadastrar Política de envio](/pt/docs/tutorials/politica-de-envio#cadastrar-uma-politica-de-envio), associada à política comercial usada na integração.\n2. [Cadastrar Doca](/pt/docs/tutorials/gerenciar-doca), associada à política comercial usada na integração.\n3. [Cadastrar Estoque](/pt/docs/tutorials/gerenciar-estoque), associado à Doca criada no passo anterior.\n\nCaso você queira conferir se as configurações foram realizadas corretamente, você pode fazer uma [simulação de envio](/pt/docs/tutorials/simulador-de-envio). O Simulador de envio é uma ferramenta que possibilita checar as condições de entrega do produto sem de fato abrir um pedido.\n\n### Criar novo access key e secret\n\nA 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)_](/pt/tracks/contas-e-permissoes--5PxyAgZrtiYlaYZBTlhJ2A/56Bd0KpwbvAji1aFs94xdA?&utm_source=autocomplete) tem permissão para [criar um _access key_ e _secret_](https://developers.vtex.com/vtex-rest-api/docs/getting-started-authentication), e a opção só é visível no Admin para este usuário. Para configurar uma nova chave, siga os passos abaixo:\n\n1. No avatar de seu perfil, clique em _CONFIGURAÇÕES DA CONTA_.\n2. Clique em `Conta`.\n3. Em _Segurança_, clique em `Gerar access key e secret`.\n4. Preencha com um nome para o novo _access key_ e clique em `Gerar novos secrets`.\n\n> ❗ 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.\n\n### Criar novo usuário\n\nUm 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:\n\n1. No avatar de seu perfil, clique em _CONFIGURAÇÕES DA CONTA_.\n2. Clique em `Usuários`.\n3. Clique no botão `+ NOVO`.\n4. Preencha o campo do email com a _access key_ criada.\n5. Clique em `+ADICIONAR PERFIS`.\n6. Selecione a flag correspondente a [`IntegrationProfile - Fulfillment Gateway Oms`](/pt/docs/tutorials/perfis-de-acesso#integrationprofile-fulfillment-gateway-oms).\n7. Clique no botão `ADICIONAR PERFIS`.\n8. Clique em `SALVAR`.\n\n## Envio de informações para Riachuelo\n\nUma 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](mailto:marketplace@riachuelo.com.br)_.\n\n- **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_.\n- **Política comercial:** número da política comercial determinada na etapa [Definir política comercial](#definir-politica-comercial).\n- **ID do afiliado:** identificador configurado na etapa [Criar afiliado](#criar-afiliado).\n- **_Access key (appKey)_:** definido na etapa [Criar novo access key e secret](#criar-novo-access-key-e-secret).\n- **_Secret (appToken)_:** definido na etapa [Criar novo access key e secret](#criar-novo-access-key-e-secret).\n\n## Cadastro do Endpoint de Search do afiliado\n\nNa etapa [Criar afiliado](#criar-afiliado), o preenchimento do campo Endpoint de Search havia ficado pendente e agora será realizado.\n\n> ❗ 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.\n\nUma vez recebida a confirmação do parceiro, realize os passos abaixo:\n\n1. No Admin, no menu _Configurações de loja > Pedidos_.\n2. Clique em `Configurações`.\n3. No topo da página, selecione `Afiliados`.\n4. Clique sobre o ID do afiliado definido na etapa [Criar afiliado](#criar-afiliado).\n5. Preencha o campo _Endpoint de Search_ com a URL `https://vtex-notification-prd.azurewebsites.net/api/notification`.\n6. Clique em `Salvar`.\n\nFeito 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](https://riachuelomarketplace.zendesk.com/hc/pt-br/articles/1500010648222-Portal-do-Seller-Cadastro-de-senha-e-primeiro-acesso).\n\n> ℹ️ Você também pode conferir as orientações para a integração fornecidas pela Riachuelo pela página [MANUAL DE INTEGRAÇÃO VTEX](https://riachuelomarketplace.zendesk.com/hc/pt-br/articles/1500008432221-Integra%C3%A7%C3%A3o-VTEX-Orienta%C3%A7%C3%B5es-gerais). Em caso de dúvidas, entre em contato pela [central de ajuda da Riachuelo](https://riachuelomarketplace.zendesk.com/hc/pt-br)."}