Primeiros passos
1. Para obter seu token de acesso, você precisa se registrar como Seller ou hub:
- Se você é um hub e quer integrar conosco, preencha este formulário e aguarde nosso contato.
- Se você já é um seller do Riachuelo Marketplace, acesse o nosso portal https://marketplace.riachuelo.com.br, e consulte suas chaves de integrações e informe ao seu time de TI ou HUB.
- Se você quer se tornar um seller do Riachuelo Marketplace, acesse a nossa landing page através do link www.riachuelo.com.br/marketplace ou entre em contato com o nosso time comercial através do email marketplace@riachuelo.com.br.
Você receberá suas credenciais de login do portal após o registro.
Acesse Ferramentas > Catálogo de API's, try it e faça login no gerar seu token de acesso e acessar os endpoints do portal.
2. Navegue pela documentação aberta do portal para entender como funciona:
- Nossa autenticação com as nossas apis;
- Nosso webhook de notificações;
- O fluxo de catálogo;
- O fluxo de pedidos;
3. Inicie o processo de homologação;
Para garantir que o seu desenvolvimento passou nos requisitos de integração com o Riachuelo Marketplace, será necessário gerar pelo menos 1 pedido de venda.
Passo 1- Integração de Produtos e skus
A sua integração precisa ser capaz de consultar, criar, atualizar e deletar produtos e skus:
verbo descrição
GET para consultar a lista de atributos
POST para criar um atributo no Marketplace
GET para consultar a lista de produtos
POST para criar produto no Marketplace
GET para consultar um produto especifico
PUT para atualizar um produto especifico
GET para consultar a lista de skus
POST para criar sku no Marketplace
GET para consultar um sku especifico
PUT para atualizar um sku especifico
GET para consultar a lista de skus de um produto
PATCH para ativar um sku
PATCH para inativar um sku
GET para consultar uma imagem específica
POST para criar uma lista de imagens (substitui)
GET para consultar uma lista de imagens
GET para consultar a lista de variações
POST para criar uma lista de variações
Passo 2 - Integração de Preços
A sua integração precisa ser capaz de consultar e atualizar preços:
verbo descrição
GET para consultar preço de um preço específico
PUT para atualizar o preço de um sku específico
Passo 3 - Integração de Estoque
A sua integração precisa ser capaz de consultar e atualizar estoque:
verbo descrição
GET para consultar o estoque de um sku específico
PUT para atualizar o estoque de um sku específico
Passo 4 - Configuração do provedor para cotação de frete
Primeiro informe a sua url do seu provedor de fretes.
Para isso acesse o Portal do Seller e configure em Frete > Provedor de frete
Passo 5 - Configuração do webhook de notificações de pedido
Primeiro informe a sua url para receber notificações de pedidos.
Para isso acesse o Portal do Seller e configure a sua URL em Configurações > Notificações
Passo 6 - Atualização do tracking de Pedido de venda
A sua integração precisa ser capaz de receber as notificações do webhook de pedidos gerados através dos nossos canais de venda, além de atualizar as informações de rastreio.
4. Solicite a validação técnica;
