Comissões da Shopee: exportação do relatório e endpoints da API de afiliados
Como obter comissões por SubID em CSV e o que o módulo AMS da Shopee Open Platform oferece em relatório de conversões e validação.
Resposta curta: o caminho mais comum para o afiliado é exportar o relatório de comissões da plataforma de afiliados em CSV, com SubID, data do pedido e comissão. Shopee também tem, na Open Platform, endpoints do módulo de marketing de afiliados (AMS) para relatório de conversões e validação, mas eles são voltados a vendedores e integradores; confirme o que a sua conta pode usar.
Exportação do relatório (CSV)
O relatório de comissões traz, por pedido ou item, a data, o valor da venda, a comissão e o SubID usado no link. Para a análise por campanha, agregue por SubID e por data do pedido. Agregações úteis: pedidos, itens, valor de vendas e comissão líquida por SubID, canal, dia da semana e hora.
API de afiliados da Shopee (AMS)
| Endpoint | Para que serve |
|---|---|
/api/v2/ams/get_conversion_report | Detalhes de pedidos convertidos e desempenho dos itens, para conciliação e atribuição. |
get_validation_list e get_validation_report | Lista e detalhe dos relatórios de validação (comissão validada x pendente). |
- Autenticação: exige identificador do parceiro, carimbo de tempo, token de acesso e assinatura (HMAC-SHA256) gerada com a chave do parceiro.
- Limites: as consultas costumam ter janela máxima de tempo e paginação; para histórico grande, itere por períodos.
- Brasil: a Open Platform tem endereço próprio para o mercado brasileiro; use o da sua região.
Controles de qualidade
- Comissão pendente x validada: não trate pendente como receita garantida.
- Reprocessamento: recarregue períodos recentes, pois valores mudam por cancelamentos e devoluções.
- Chave única: use identificador do pedido para não duplicar linhas ao reimportar.
- SubID em branco: classifique como "Sem SubID" e monitore a participação.
Aviso
Regras de programa, endpoints e permissões mudam. Consulte a documentação oficial e os termos do programa de afiliados antes de automatizar.