Shopee

Roteiro de acesso à API da Shopee — 9 etapas

0 de 42 tarefas concluídas · 0%

🧭 Como usar esta página: role pra baixo e siga as etapas na ordem — cada uma só destrava quando a anterior estiver 100% marcada. Clique no checkbox de cada tarefa conforme ela for resolvida de verdade, não só porque "já sabe como fazer".
A decisão que define tudo

Por que o nosso perfil tem que ser "Third-party Partner Platform"

A Shopee Open Platform oferece dois tipos de conta de desenvolvedor, e a escolha errada é motivo oficial de rejeição ("Eligibility criteria not met: solicitou no modelo incorreto"):

1 · Shopee Seller

Pra empresa que vende na Shopee e quer automatizar a própria loja. A documentação em inglês é explícita: "You can only provide software services to your own Shopee shop" — só serve pra loja do próprio dono da conta. Exige inclusive ter 1 venda completa nos últimos 30 dias. Não é o nosso caso: a gente não vende na Shopee, presta serviço a quem vende.

2 · Third-party Partner Platform (ISV) — o nosso modelo

Pra "Integradoras, HUBs de Integração, ERPs e outras plataformas dessa categoria: contas de empresas com licenças registradas que prestam serviços a vendedores no Shopee" (texto literal da página oficial BR). É o único modelo em que um parceiro pode pedir autorização a vários vendedores diferentes — exatamente o que o Carteira Place é.

!
A regra que muda toda a nossa estratégia: pra aprovar nesse modelo, a Shopee exige que o produto já esteja ativo, com integrações de e-commerce existentes e ativas "identificáveis em uma parte de 'Integrações' na conta teste fornecida" (texto literal). Traduzindo: precisamos ter o Carteira Place no ar, integrado de verdade a outro marketplace, antes de pedir acesso à Shopee. É por isso que o Mercado Livre virou a Etapa 2 deste roteiro.
Roteiro

9 etapas — e por que organizamos assim

A ordem não é arbitrária: cada etapa produz algo que a próxima precisa pra existir — como numa construção, não dá pra levantar parede sem fundação, nem pintar sem parede pronta.

  1. Etapa 1 — Documentos da empresa: vem primeiro porque quase tudo depende dela — inclusive o e-mail oficial que trava a Etapa 4.
  2. Etapa 2 — Produto vivo com integração ao Mercado Livre: roda em paralelo às outras, mas é a peça mais demorada — por isso precisa começar cedo.
  3. Etapa 3 — Conta de teste dentro do nosso produto: só faz sentido depois que o produto (Etapa 2) já existe de verdade.
  4. Etapa 4 — Login na Shopee Open Platform: depende da decisão de e-mail tomada na Etapa 1, que não muda depois.
  5. Etapa 5 — Formulário e submissão: junta tudo que veio antes — é o ponto sem volta, porque errar aqui reabre a fila de análise do zero.
  6. Etapa 6 — Análise da Shopee: esperar a resposta e, se vier rejeição, corrigir só o que foi apontado.
  7. Etapa 7 — Criar o App: só existe depois de aprovado — é aqui que nascem as credenciais reais (partner_id/partner_key).
  8. Etapa 8 — Testes em sandbox: validar o fluxo inteiro num ambiente seguro antes de valer pra produção.
  9. Etapa 9 — Go-Live: produção liberada de verdade — o marketing já pode planejar lançamento com data.
Pendente — pode trabalhar agora Travada — espera a etapa anterior fechar Concluída — 100% das tarefas marcadas
Etapa 1

Fundação empresarial: CNPJ e documentos

Pendente
Por quêO formulário da Shopee pede Razão Social, número do CNPJ e imagem do Comprovante de Inscrição e Situação Estadual, além de endereço completo. Dois dos seis motivos oficiais de rejeição vêm exatamente daqui.
Como funcionaA conta da Open Platform é da empresa, não de uma pessoa — e o e-mail cadastrado não pode ser trocado depois.
  • decisao Qual CNPJ vai ser o "dono" do cadastro de parceiro?
  • atencao MEI provavelmente não serve: não aceita mais de um sócio (somos 3) e, sendo prestação de serviço de software, normalmente não tem Inscrição Estadual — documento que a Shopee exige. Confirmar com contador se precisa virar LTDA.
  • decisao Qual e-mail vai ser o oficial do cadastro? (não muda nunca mais)
  • Reunir o Comprovante de Inscrição e Situação Estadual em imagem jpg/jpeg
  • Levantar Razão Social, endereço completo, CEP e telefone do responsável
  • Conferir que o CNPJ está ativo e os dados batem com Receita/Sefaz
Etapa 2 · A mais crítica

Produto vivo, com integração real ao Mercado Livre

Travada
Por quêCritério de elegibilidade literal: o produto precisa estar ativo, com integrações de e-commerce existentes e ativas identificáveis numa área "Integrações" da conta de teste. Não existe prazo mínimo oficial encontrado, mas o formulário pergunta quantos vendedores já são atendidos — vale ter uso real antes de submeter.
Como funcionaO avaliador vai procurar a seção "Integrações" mostrando conexão ativa com outro marketplace. O Mercado Livre foi escolhido porque o cadastro deles é self-service.
NotaÉ a única etapa que exige código rodando — roda em paralelo com as Etapas 1, 3 e 4.
  • decisao Confirmar em time: a integração ML entra como produto de verdade, não só "pra passar na Shopee"
  • Criar/usar conta Mercado Livre ativa e cadastrar aplicação (APP_ID + SECRET_KEY)
  • Construir a integração real: puxar pedidos/produtos de verdade de contas ML
  • Criar a seção "Integrações" visível no painel, com dados reais fluindo
  • Publicar numa URL ao vivo com HTTPS + TLS 1.2 ou superior
  • Testar a nota de segurança do domínio (ex: SSL Labs) — rating "A" pedido
  • compliance Revisar que nada viola as regras: nada de venda de contas nem extração de dados de anúncios pra transação fora da Shopee
Etapa 3

Conta de teste que a Shopee vai usar pra avaliar

Travada
Por quê"Test URL / Test Account cannot be accessed" é um dos seis motivos oficiais de rejeição — o mais evitável de todos.
Como funcionaOs mesmos usuário/senha vão no formulário de solicitação e podem ser reaproveitados no Go-Live.
  • Criar usuário/senha de teste dedicado, com todos os recursos habilitados
  • Popular a conta de teste com dados de exemplo realistas
  • Combinar em time: ninguém troca essa senha durante o período de análise
Etapa 4

Criar o login na Shopee Open Platform

Travada
Por quêO e-mail cadastrado não pode ser alterado nunca mais — por isso vem depois da decisão de e-mail da Etapa 1.
Como funcionaCadastro de e-mail → aceite do Developer Agreement → código de verificação → senha (6-16 caracteres) → login.
Ir fazer issoopen.shopee.com
  • Criar a conta em open.shopee.com com o e-mail oficial decidido
  • Verificar o e-mail e criar a senha
  • Guardar as credenciais em gerenciador de senhas do time
Etapa 5 · Ponto de não-retorno

Preencher o perfil Third-party Partner Platform e submeter

Travada
Por quêJunta tudo que veio antes numa solicitação formal. Cada rejeição reabre um novo processo de análise do zero.
Como funcionaPersonal Center → Account Information → Third-party Partner Platform. Preencher dados, aceitar a Data Protection Policy, e o Profile (serviços, URL, credenciais de teste, plataformas já integradas).
  • Selecionar tipo de conta "Third-party Partner Platform"
  • Preencher dados empresariais + anexar Comprovante de Inscrição Estadual
  • Ler e aceitar a Data Protection Policy
  • decisao Redigir juntos a resposta de "What services do your app provide"
  • Preencher URL, credenciais de teste, nº de vendedores, plataformas integradas
  • Revisão final em time → Submit
Etapa 6

Análise da Shopee: aprovação ou correção-e-reenvio

Travada
Por quêSLA oficial: 10 dias úteis. Relatos reais mostram casos de semanas a meses.
Como funcionaResultado chega por e-mail e na App List. Se rejeitado, motivo aparece no painel; corrigir e reenviar via Edit.
  • Monitorar diariamente e-mail e App List
  • atencao A Shopee NÃO contata por WhatsApp e nunca pede senha — qualquer contato assim é golpe
  • Se rejeitar: corrigir só o motivo apontado, reenviar
  • Se passar de ~15 dias úteis: abrir ticket pedindo posição por escrito
Etapa 7

Criar o App — nascem as credenciais de verdade

Travada
Por quêSó existe depois da aprovação. Nasce o partner_id/partner_key que assina toda chamada de API.
Como funcionaApp Type recomendado: "ERP System" (acessa todas as APIs exceto Chat e Ads). Nome, região Brazil, descrição, logo.
  • decisao Escolher entre "ERP System" (recomendado) e "Accounting and Finance"
  • Preencher nome, região, descrição e logo → Submit
  • Guardar partner_id/partner_key em cofre de segredos
Etapa 8

Sandbox: validar o fluxo completo antes de produção

Travada
Por quêLink de autorização expira em 5min, code em 10min, tokens são separados por shop_id — pegadinhas melhores de errar no sandbox.
Como funcionaAuth sandbox BR: open.sandbox.test-stable.shopee.com.br/auth · API sandbox: openplatform.sandbox.test-stable.shopee.sg · Produção BR: openplatform.shopee.com.br.
NotaSandbox é limitado — alguns recursos só funcionam em produção.
  • Configurar Test/Live Redirect URL Domain no console do App
  • Testar fluxo completo: link → autorização → code → tokens
  • Validar renovação: access_token 4h, refresh_token 30 dias
  • Testar caso "main account": split de tokens por loja no primeiro refresh
  • Registrar expiração de autorização por vendedor (7-365 dias) + alerta
  • Configurar webhook: status de pedido, rastreio, expiração de autorização
Etapa 9 · Última

Go-Live: acesso de produção

Travada
Por quêDiferente da Etapa 6, é 100% automático — resposta em ~48h.
Como funcionaBotão Go-Live → URL, credenciais de teste, explicação de uso, 1-10 screenshots.
NotaCompromissos pós Go-Live: produção em até 90 dias, ≥90% de sucesso diário de chamadas, retenção de dados pessoais máx. 90 dias, possível pentest anual custeado por nós.
  • Preencher URL, credenciais e breve introdução de uso
  • Anexar 1-10 screenshots da interface
  • Aguardar ~48h e conferir status (Live Partner_id + Live Key)
  • Produção liberada — arquitetura definitiva pode ser desenhada
Leitura pendente

Documentos oficiais que ainda vale ler na íntegra

A página oficial referencia estes documentos. Dois já foram mapeados a fundo; os demais ainda valem uma leitura completa antes de submeter a solicitação (Etapa 5):

  • Regras para Parceiros da Plataforma — já mapeadas (guia oficial 34)obrigações contínuas: produção em 90 dias, ≥90% de sucesso diário de chamadas, 1 chamada a cada 90 dias. Proibições: scraping, coleta além do declarado, migração de listings pra concorrente. Íntegra em open.shopee.com/developer-guide/34.
  • Política de Proteção de Dados — já mapeada (guia oficial 32)retenção máxima de 90 dias pra dados pessoais/restritos; pentest/assessment anual custeado por nós; vazamento = notificar em 24h. Íntegra em open.shopee.com/developer-guide/32.
  • Termos de Serviço + Documentação de desenvolvimento V2.0 + Políticas e Regras de Vendaainda não lidos na íntegra — linkados na seção "Documentações de Apoio" da página oficial.
  • Canal certo pra dúvidas: Sistema de Ticketdúvidas de desenvolvimento vão no Sistema de Ticket da Open Platform (não no atendimento de vendedor).
Perguntas em aberto pro time

O que só a gente consegue responder

  • Backend: como foi a aprovação anterior de vocês?quanto tempo levou de fato, o que a Shopee pediu, teve rejeição/reenvio? Esse dado de primeira mão pode encurtar ou reordenar etapas.
  • Qual CNPJ e qual e-mail oficial?MEI provavelmente não serve (não aceita 3 sócios, e serviço de software geralmente não tem Inscrição Estadual, documento exigido pela Shopee). Confirmar com contador se o caminho é abrir LTDA.
  • Marketing: o que dizer em "What services do your app provide"?é o pitch do produto pro avaliador — o time comercial pode ajudar bastante a redigir isso (Etapa 5).
  • Tempo mínimo de ML rodando antes de aplicar?não encontrado em nenhuma fonte oficial — o critério é sobre estado ("ativo"), não sobre prazo. Mas o formulário pergunta quantos vendedores já são atendidos, então vale ter uso real antes de submeter.