Radar Docs

Conectar Contas

Disponível emAmazonMercado Livre

Conecte seus sellers de Amazon e Mercado Livre via OAuth — é o que libera os dados de Analytics e do Repricer.

Para que o Radar leia seus pedidos, ofertas e finanças, você precisa conectar cada seller (a sua conta de vendedor no marketplace) por meio de uma autorização OAuth. Conectar é o passo que desbloqueia os dados de Analytics e do Repricer — sem a conexão, esses aplicativos não têm o que processar.

Não confunda os dois tipos de conta: o User é o seu cadastro no Radar (login Clerk); o SellerAccount é a conta de vendedor conectada no marketplace. Cada conexão é feita uma vez e fica salva no seu User.

Conectar uma conta de seller Amazon (SP-API)

A conexão com a Amazon é feita via SP-API OAuth. O fluxo:

  1. Em Contas Amazon, inicie a conexão de um novo seller.
  2. Você é levado ao Amazon Seller Central para autorizar o Radar.
  3. Ao confirmar, a Amazon devolve as credenciais e o Radar cria um SellerAccount, identificado pelo sellingPartnerId.

Amazon

A autorização é via SP-API OAuth (Selling Partner API). Você concede acesso a partir do Seller Central, e o SellerAccount é chaveado pelo sellingPartnerId. É essa conexão que permite ao Analytics sincronizar pedidos, vendas/tráfego e repasses, e ao Repricer ler ofertas e publicar preços.

Conectar uma conta de Mercado Livre

A conexão com o Mercado Livre também é via OAuth: você autoriza o Radar na tela de login do ML e ele cria um SellerAccount próprio para esse marketplace.

Mercado Livre

A autorização é via OAuth do Mercado Livre, concedendo os escopos (scopes) necessários para o Radar ler seus anúncios e atuar sobre eles. O SellerAccount do Mercado Livre é distinto do da Amazon — são conexões independentes, cada uma com seu próprio OAuth.

Dono × colaborador

Cada conexão entre um User e um SellerAccount é uma conexão de seller (UserSeller), e ela pode ter dois papéis:

| Papel | isOwner | O que significa | |---|---|---| | Dono | true | Quem conectou originalmente o seller. Conta para a contagem de uso (limite seller_accounts) e tem controle pleno sobre a conexão. | | Colaborador | false | Um User que recebeu acesso a um seller conectado por outra pessoa, em regime de colaboração. Trabalha sobre o mesmo SellerAccount sem ser o dono dele. |

Esse modelo permite que uma equipe compartilhe o mesmo seller: um dono conecta a conta e convida colaboradores, sem que cada pessoa precise refazer o OAuth.

Vendendo nos dois marketplaces

Um mesmo User que vende na Amazon e no Mercado Livre mantém dois SellerAccounts distintos — um por marketplace, cada um com sua própria autorização OAuth. Eles não se misturam: a conexão da Amazon usa SP-API e o sellingPartnerId; a do Mercado Livre usa o OAuth do ML. Ambos ficam listados no seu User e podem ser usados em paralelo nos aplicativos.

O que conectar desbloqueia

Conectar um seller é o pré-requisito para os dados aparecerem:

  • Analytics — passa a sincronizar pedidos, vendas/tráfego e (com assinatura) financeiro e repasses do seller conectado.
  • Repricer — passa a ler as ofertas/anúncios do seller e a reprecificá-los conforme suas automações.

Enquanto não houver pelo menos um seller conectado, esses aplicativos ficam sem dados para exibir.