Integração ERP com a Riachuelo

Conheça a Riachuelo

Integração desenvolvida pela equipe ERP, possibilitando o acompanhamento dos pedidos incluídos na loja virtual.

Para uma melhor experiência em ERP, sugerimos seguir a seguinte ordem de configuração: configurar a integração, importar produtos, importar pedidos.

Recursos disponíveis

Como configurar a integração

1. Para iniciar a configuração, acesse menu → início → integrações.

Observações:

Caso já possua integrações configuradas em sua conta, elas serão exibidas e indicadas da seguinte forma: 

• Ativa: Indica que a integração foi realizada com sucesso e encontra-se pronta para uso.
• Inativa: Indica a inatividade desta loja no ERP, ou seja, a loja não estará disponível para sincronização de pedidos, produtos e demais ações pertinentes.
• Não conectada: Indica que a configuração ainda não foi realizada.

Somente as integrações Ativas serão exibidas para uso nas sincronizações, importações e demais ações no ERP.

1. Clique em adicionar integração, busque por Riachuelo e clique em instalar.
2. Na aba Conexão, no campo nome informe o nome da integração no ERP.
3. Informe o client ID e o client secret criados na Riachuelo Marketplace.
   Para criar o client ID e o client secret acesse o portal do seller.
   
   E em seguida configurações de integração, onde estarão disponíveis o client ID e o client secret e copie as chaves geradas.

1. 
   Acesse configurações:

1. No ERP, cole as chaves nos respectivos campos e clique em Conectar com Riachuelo para validar as credenciais de login.
2. Para atualização de pedidos e produtos, clique, no ERP, em gerar link para receber atualizações dos anúncios. Copie o link gerado.
3. Retorne ao portal do seller da Riachuelo e acesse notificações e em webhook de notificações, clique em adicionar URL e cole a URL de atualização de status dos produtos gerada no ERP.
   
4. Para configurar o frete, clique, no ERP, em gerar link para utilizar a API de fretes. Copie o link gerado.
5. Retorne ao portal do seller e acesse frete → provedor de frete → adicionar provedor de frete e cole a URL de cotação de frete gerada no ERP.
   Para maiores informações da configuração na Riachuelo, acesse a central de ajuda da Riachuelo.
   
6. Após isso, defina os seguintes campos:

Produtos > Fluxo de Produtos

Pedidos > Fluxo de Pedidos

Na aba Produtos > Regras de estoque, defina as regras de estoque da integração:

1. Na aba Pedidos > Dados Fiscais, selecione a informação natureza de operação para venda nesta integração. A natureza selecionada será atribuída de forma padrão na importação dos pedidos no ERP e no momento em que gerar a nota fiscal através do pedido importado.

Observação:

• Caso precise configurar uma nova natureza de operação para utilizar nesta integração, acesse a ajuda natureza de operação e inclua uma natureza conforme seu regime tributário e orientações da sua contabilidade.
• Você pode habilitar ou desabilitar o campo definir natureza de operação diferente para destinatários contribuintes do ICMS. Habilitando esse campo, você poderá selecionar uma natureza de operação específica, a qual será aplicada no momento em que o ERP identificar que o pedido de venda trata-se de um cliente contribuinte.

1. Na aba Pedidos > Preços, defina qual será a regra de preços para a integração, tanto para importação, quanto para envio de produtos ao e-commerce:
   • Preço fixo: conforme o preço do produto, o anúncio pode receber um valor fixo de preço de venda, levando em consideração acréscimos e descontos aplicados individualmente;
   • Conforme regras de preço: trata-se de todas as regras do marketplace no que diz respeito ao percentual de comissão, adicional de frete para produtos com preço mínimo e/ou por faixa de peso cubado dos produtos e fórmula de cálculo para aplicar os valores adicionais. Ao definir essa regra, siga a configuração de precificação de anúncios com base nas regras das plataformas de e-commerce e marketplaces.
   • Conforme lista de preços: utiliza de listas de preços dos produtos, específicas para o e-commerce ou marketplace. Ao definir essa regra, no campo lista de preços utilizada nos produtos, selecione a lista de preços a ser considerada na importação de pedidos do e-commerce. Saiba como configurar em listas de preços.
2. Na aba Situações, é possível relacionar a situação dos pedidos no e-commerce com as respectivas situações no ERP, assim como o fluxo da sequência das situações no ERP.

Adicione as situações presentes no e-commerce, clicando em adicionar situações padrão. Para adicionar novas situações, clique em adicionar mapeamento de situação.

Para alterar a situação de um pedido para uma situação anterior à atual, habilite o campo permite retroceder situação dos pedidos na sincronização de situações, assim, por exemplo, um pedido enviado poderá voltar para a situação preparando Envio.

Observação:

Ao importar um pedido de venda do e-commerce para o ERP, o pedido assume a situação configurada. Caso a situação não esteja configurada, o pedido importado terá a situação em aberto atribuída.

1. Na aba Mapeamentos > Formas de Recebimento, pode-se relacionar as formas de recebimento dos seus pedidos da loja virtual com a forma de recebimento no ERP. Esta configuração fará com que suas contas a receber sejam geradas no ERP com as mesmas informações da plataforma.

Ao habilitar o parâmetro importar forma de recebimento nos pedidos, será possível relacionar as formas de pagamento presentes em sua plataforma com os respectivos destinos no ERP. Para isso, clique em adicionar forma de recebimento.

A seguir, no campo de forma de recebimento, selecione a forma de recebimento do ERP a ser relacionada com a da integração. No campo código na integração, clique sobre o botão  relacionar forma de recebimento e selecione a forma de recebimento de sua plataforma que corresponderá à do ERP.

Se a forma de recebimento correspondente não for exibida, é possível buscar por pedido que possua a mesma forma de recebimento selecionada para realizar o relacionamento ou, caso saiba o código de integração, clique em informar código manualmente e digite o código.

Observação:

Ao adicionar as formas de recebimento selecionadas, o ERP busca as formas já configuradas em sua conta. Para informações de como cadastrar as formas de recebimento, acesse formas de recebimento.
 

1. Para confirmar o relacionamento, clique em relacionar.

No campo forma de recebimento padrão, defina a forma de recebimento que será utilizada sempre que o pedido importado não possua nenhuma forma relacionada.

1. Na aba Mapeamentos > Variações, são relacionadas as variações de um produto no e-commerce com as respectivas variações no ERP. Para verificar o cadastro de variações de um produto, acesse como cadastrar produtos com variações.
   Em abrir edição avançada, o ERP busca no e-commerce as variações disponíveis.

Observação:

A aba variações somente aparecerá com a extensão variações instalada e após salvar as configurações;

1. Na aba Mapeamentos > Formas de frete, pode ser realizado o mapeamento das formas de frete presentes no e-commerce, com as formas de envio cadastradas em sua conta no ERP.

Para isso, no campo forma de envio e forma de frete, selecione as formas que deseja mapear.

Em código na integração, clique no botão relacionar forma de frete. E, na listagem exibida, selecione a forma de envio correspondente em sua plataforma.

Se a forma de frete correspondente não for exibida, é possível buscar por pedido que possua a mesma forma de frete selecionada para realizar o relacionamento ou, caso saiba o código de integração, clique em informar código manualmente e digite o código. Para confirmar o relacionamento, clique em relacionar.

Para adicionar novas formas de frete, clique em adicionar.

Observações:

• Ao adicionar as formas de frete selecionadas, o ERP busca as formas de envio já configuradas em sua conta. Para cadastro de novas formas de envio, consulte formas de envio.

1. Na aba Mapeamentos > Cotação de frete, podem ser definidas as formas de envio preferenciais e alternativas de sua loja, sendo possível cotar o valor do frete para o e-commerce com as formas de envio cadastradas no ERP.

Adicione as formas de envio preferenciais clicando em adicionar forma de envio preferencial.

1. Para cadastrar outras alternativas de envio, clique em adicionar forma de envio alternativa.

Em modo de cotação dos pedidos, defina a forma de cálculo da cotação que será retornada: menor preço, menor prazo ou maior prazo.

Observações:

• As formas de envio alternativas serão utilizadas somente quando não existir cotação para as formas preferenciais.
• Ao utilizar seu contrato com os Correios como forma de envio, sugerimos que mantenha apenas 2 formas de frete cadastradas. Desta forma, os dados serão corretamente retornados no painel da Riachuelo.

1. Não esqueça de salvar as configurações.

Como receber produtos do e-commerce no ERP

1. Acesse menu → cadastros → anúncios para importar os produtos cadastrados em sua loja virtual.
2. Selecione sua integração para recepção dos seus produtos e clique em gerenciar anúncios → importar anúncios.
3. Selecione quais anúncios deseja importar: todos os anúncios da minha conta ou somente anúncios novos (anúncios não cadastrados no ERP) ou um anúncio específico. Selecionando a opção anúncio específico, será necessário preencher o campo identificador do anúncio para localizar o anúncio.Os campos importados são:
   • Atributos;
   • Categoria;
   • Código (SKU);
   • Descrição complementar;
   • Estoque atual;
   • GTIN;
   • Imagens;
   • Altura da embalagem;
   • Comprimento da embalagem;
   • Largura da embalagem;
   • Marca;
   • Nome;
   • Origem;
   • Peso bruto;
   • Peso líquido;
   • Preço;
   • Preço promocional;
   • Variações.
4. Clique em prosseguir e após em relacionar estes anúncios aos seus produtos, selecione a forma de relacionamento destes anúncios com os produtos existentes no ERP (por código SKU, por descrição ou GTIN).
5. Selecione dentre as opções de atualização, se existir um relacionamento prévio entre anúncios: não, para não atualizar informações do produto ou sim, definindo o que será atualizado (todos os dados ou apenas os dados não preenchidos), e se deseja também atualizar preços dos produtos já existentes, atualizar o estoque (necessário informar qual depósito atualizar) ou atualizar imagens.
6. Clique em relacionar para concluir o processo de recebimentos dos produtos.
7. O ERP indicará se existem anúncios ainda não relacionados e você definirá qual ação realizar. Após clique em continuar, retornando à listagem de anúncios.

Observações:

• Se durante a importação dos produtos ocorrer algum imprevisto ou ocorrer algum problema devido ao grande número de produtos a serem importados, é possível interromper a recepção de produtos para continuar a importação num momento posterior.
• Com a ação interromper, é possível continuar a importação num outro momento, continuando do ponto em que parou. É possível retomar esta importação em até 7 dias corridos.

Como receber manualmente pedidos do e-commerce no ERP

1. Para importação dos pedidos acesse menu → vendas → pedidos do e-commerce
2. Ou, acesse menu → vendas → pedidos de venda → receber do e-commerce.
3. Na aba da loja virtual, selecione os pedidos e clique em receber.
   Vale lembrar que é possível filtrar os pedidos por situação e por período.

Observação:

Sempre que um pedido é importado, o cliente automaticamente é cadastrado em cadastros → clientes e fornecedores.

Como enviar produtos do ERP ao e-commerce

Atenção!

Nesta integração não é possível relacionar manualmente os produtos cadastrados no ERP com os produtos já cadastrados na plataforma. Assim, é necessário que o envio dos itens seja realizado a partir do ERP para que o mapeamento seja retornado pela integração.

1. Acesse menu → cadastros → produtos.
2. Selecione um ou mais produtos para envio.
3. Clique em enviar para o e-commerce

Observação:

Selecionando apenas um produto, o envio para o e-commerce pode ser realizado em menu de contexto (...) → enviar para o e-commerce.

1. Selecione sua loja Riachuelo, no campo plataforma.
2. Clique em continuar envio de produtos e você será direcionado para o módulo anúncios → anunciar no e-commerce → relacionamento de categorias. Maiores informações sobre esse módulo, acesse anúncios.
3. Valide o relacionamento de categorias de produtos e clique em continuar.
4. Em revisão do anúncio, clique sobre o anúncio, na tela de editar dados do anúncio vá em ficha técnica e preencha os atributos do anúncios.
5. Salve e valide as informações para envio e clique em enviar anúncios.
   Será apresentada a tela Resumo do envio. Clique em revisar para avaliar as informações do produto ou finalizar para concluir o processo.
   Campos enviados
   • Atributos;
   • Categoria;
   • Código (SKU);
   • Descrição complementar;
   • Estoque atual;
   • GTIN;
   • Imagens;
   • Altura da embalagem;
   • Comprimento da embalagem;
   • Largura da embalagem;
   • Marca;
   • Nome;
   • Origem;
   • Peso bruto;
   • Peso líquido;
   • Preço;
   • Preço promocional;
   • Variações.

Observações:

• Os anúncios devem ter entre 1 e 6 imagens. Imagens iguais serão consideradas como imagem única.
• O botão com problema indica o problema que impediu o envio do anúncio ao marketplace.
• Os anúncios enviados passam por moderação e só serão ativados após notificação da plataforma ao ERP.
• Anúncios não aprovados pela plataforma, ficam na situação não aprovado.
• A situação dos anúncios no ERP pode ser atualizada em menu → anúncios → mais ações → sincronizar situação dos anúncios.

Como enviar estoque dos produtos no ERP ao e-commerce

1. Acesse menu → cadastros → produtos.

Selecione um ou mais produtos para envio.

1. Clique em mais ações → enviar estoque para o e-commerce.

Observações:

• Selecionando apenas um produto, o envio para o e-commerce pode ser realizado em menu de contexto (...) → enviar estoque para o e-commerce.
• Para enviar atualização de estoque de todos os anúncios de uma única vez. Acesse menu → cadastro → anúncios, selecione todos os anúncios da página, clique em enviar estoque para o e-commerce. Uma mensagem de expansão da seleção será exibida. Marque a opção de envio de todos anúncios e confirme. Defina qual saldo de estoque será enviado. Selecione, confira os anúncios e envie.

1. Defina se serão enviados os saldos físico ou disponível dos produtos e clique em selecionar.
   A seguir serão exibidos os dados deste produto tais como: identificador do anúncio, descrição, código (SKU) e estoque.
2. Valide se o produto está com as informações corretas e clique em enviar.

Como enviar o preço dos produtos no ERP ao e-commerce

1. Acesse menu → cadastros → produtos.

Selecione um ou mais produtos para envio.

1. Clique em mais ações → enviar preços para o e-commerce.

Observação:

Selecionando apenas um produto, o envio para o e-commerce pode ser realizado em menu de contexto (...) → enviar preços para o e-commerce.

1. Selecione sua loja Riachuelo , no campo plataforma.
   A seguir serão exibidos os dados deste produto tais como: identificador do anúncio, descrição, código (SKU) e preço.
2. Valide se o produto está com as informações corretas e clique em enviar.

Como enviar o código de rastreio

1. Para envio do código de rastreio por e-mail, localize o pedido e clique em menu de contexto (...) → enviar código de rastreio por e-mail.
2. Ao acessar a expedição será adicionado um marcador que identifica quando o código de rastreio já foi enviado à plataforma.

Como marcar pedidos como entregues no e-commerce

1. Ao marcar os pedidos como entregue no ERP, esses serão sincronizados com o status entregue na plataforma. Para isso, acesse menu → vendas → expedição. Selecione a forma de envio e na aba concluídas, clique em menu de contexto (...) → marcar pedidos como entregue.
2. Na guia marcar como entregue, informe a data de entrega do produto e clique no botão marcar como entregue.
3. Após isso, será adicionado na expedição, um marcador que identificará que a venda já foi marcada como entregue e sincronizada no Marketplace.

Informação adicional

Caso seja necessário realizar a exclusão dos mapeamentos dos produtos com a sua plataforma, acesse menu → início → integrações. Busque pela integração desejada, clique no menu de contexto (...) → excluir todos os anúncios no ERP. Lembramos que essa ação, depois de concluída, não poderá ser desfeita.