Por que a gente foi tão a fundo nisso antes de tocar em código
Quando decidimos refazer o sistema do zero, surgiu uma pergunta simples: por onde a gente começa? A resposta que fomos construindo juntos, documento por documento, foi: nenhuma decisão de arquitetura (banco, backend, frontend) faz sentido antes da gente saber se — e como — vamos conseguir acesso real aos dados da Shopee. É a fundação de tudo: sem esse acesso aprovado, não existe coleta de dados, e sem coleta não existe produto.
Então, em vez de começar a programar e descobrir os obstáculos burocráticos no meio do caminho, decidimos mapear o caminho inteiro primeiro. Fizemos isso em várias rodadas: primeiro uma pesquisa geral sobre como a Shopee Open Platform funciona; depois, quando conseguimos acesso direto às páginas oficiais (que normalmente nem abrem pra ferramenta nenhuma de busca automática, porque são construídas em JavaScript), substituímos toda suposição por texto literal da própria Shopee — processo de solicitação, critérios de aprovação, motivos de rejeição, e depois o fluxo técnico completo de autenticação. A partir daí, três novas frentes de pesquisa: o que ainda faltava sobre as regras e a política de dados da Shopee, a API do Mercado Livre por completo, e como está o mercado brasileiro de concorrentes, pra entender contra quem competimos e confirmar que a dor que o produto resolve é real.
E por que a gente vai usar a API do Mercado Livre primeiro?
Foi a própria pesquisa que revelou isso, não uma escolha de gosto: a Shopee só aprova parceiro que já tem um produto rodando de verdade, integrado a outro marketplace — não aceita ideia nem protótipo. Ou seja, sem essa integração prévia, a solicitação pra Shopee nem entra na fila de análise. Entre as alternativas de marketplace pra cumprir esse requisito, o Mercado Livre se destacou porque o cadastro de desenvolvedor deles é self-service: não exige aprovação manual, não pede um produto pronto antes, e a gente consegue credenciais de teste no mesmo dia. Ou seja, o Mercado Livre não é só "mais um marketplace" — é literalmente a peça que destrava a Shopee.
Sempre que uma informação vem de texto oficial (colado direto das páginas logadas da Shopee, ou confirmado na fonte), está marcada como confirmado; quando vem de estimativa de terceiros sem confirmação oficial, está marcada como parcial — pra ninguém do time tratar um palpite como fato definitivo.
O panorama da pesquisa, em linguagem simples
Cada card abaixo explica, na prática, o que vai acontecer no nosso processo real — com nossos vendedores e com a plataforma — antes de trazer o detalhe técnico.
Modelo de conta certo confirmado
O modelo certo é "Third-party Partner Platform" (ISV) — o único que permite 1 parceiro atender N vendedores diferentes. O outro modelo, "Shopee Seller", só serve pra automatizar a própria loja de quem vende.
Pré-requisito bloqueante confirmado
A Shopee só aprova parceiro com produto já ativo e integrado a outro marketplace — não aceita protótipo nem promessa.
Caminho de desbloqueio confirmado
Integrar com o Mercado Livre primeiro resolve isso — o cadastro deles é self-service, sem esse pré-requisito.
Prazo de aprovação confirmado
SLA oficial: 10 dias úteis. Relatos reais (Reclame Aqui) mostram casos de semanas a meses, mesmo cumprindo os critérios.
Autenticação Shopee confirmado
OAuth por vendedor; access_token dura 4h; refresh_token dura 30 dias; a autorização em si expira entre 7 e 365 dias (o vendedor escolhe) e precisa ser renovada com ele.
Endpoint-coração do produto confirmado
Shopee: get_escrow_detail devolve o breakdown contábil completo do pedido.
No ML, a combinação é Orders + Payments + Billing.
Retenção de dados confirmado
A política de dados da Shopee limita a 90 dias a retenção de dados pessoais/de pedido — o histórico de lucro precisa ser guardado de forma agregada, não como pedido bruto.
Custo recorrente de ser parceiro confirmado
A Shopee pode exigir pentest/assessment de segurança anual, custeado por nós — não é só "API gratuita", tem custo operacional continuado.
Limites de uso (rate limit) parcial
Mercado Livre: 1.500 requisições/min por vendedor (documentado). Shopee: sem tabela oficial pública — estimativas de ~100 req/min circulam, não confirmadas.
Autenticação Mercado Livre confirmado
Mesmo desenho conceitual da Shopee, mas access_token dura 6h e o refresh_token é de uso único — exige persistência cuidadosa no nosso backend.
Concorrência confirmado
Existe concorrente quase idêntico (Lucras) — mesmo trial de 15 dias, cobra por volume de pedidos (~R$277/mês na faixa média).
Tamanho de mercado confirmado
~3 milhões de vendedores Shopee no Brasil; ~3,3 milhões no Mercado Livre — mercado validado, dor real e recorrente.