Ajuda

Como conectar uma loja

A conexão usa o fluxo oficial de autorização do marketplace. Em nenhum momento pedimos senha, cookie ou token copiado à mão — se alguém pedir isso em nosso nome, não é legítimo.

No painel, em Integrações, você inicia a conexão. O responsável pela loja recebe um link e um código, abre o portal do marketplace, autoriza o aplicativo e devolve o código de confirmação. A partir daí a sincronização começa.

O responsável pode revogar o acesso quando quiser, direto no portal do marketplace. A revogação pode levar alguns minutos para aparecer no painel — nesse intervalo, a loja ainda consta como conectada.

O que cada indicador significa

Faturamento bruto

Soma do valor dos pedidos no período, antes de taxas e descontos.

Valor líquido estimado

Estimativa do que sobra após taxas. É estimativa, não extrato — para conferência financeira, vale o documento do marketplace.

Ticket médio

Faturamento dividido por pedidos. Valor calculado, não sincronizado.

Cancelamentos

Percentual de pedidos cancelados sobre o total. O motivo de cada cancelamento não é exposto pela integração.

Nota média

Média das avaliações válidas, normalmente considerando os últimos três meses.

Lojas conectadas / com erro

Estado da integração de cada loja na última verificação.

Pulse Score

Nota de 0 a 100 por loja. Clique no número para ver a composição.

Por que alguns números têm um selo de origem

Todo dado no painel mostra de onde veio: sincronizado com o marketplace, importado, informado manualmente, calculado por nós ou estimado.

A razão é simples: decisão tomada em cima de estimativa apresentada como fato é decisão errada. Preferimos mostrar a incerteza a escondê-la.

Quando um valor não pode ser confirmado, o painel diz isso — em vez de repetir o último número conhecido como se ainda valesse.

Por que campanha é registro manual

A API do marketplace não expõe campanhas: não há como listar quais existem, qual o status, o orçamento, nem quem ativou ou desativou.

Em vez de fingir sincronização, a campanha é cadastrada e confirmada por quem a gerencia. O painel registra quem informou e quando.

Quando a confirmação envelhece, o status passa a "não confirmado". Não é falha: é o painel se recusando a afirmar o que não pode verificar.

Como o Pulse Score é calculado

Crescimento e vendas pesam 30%, cancelamentos 20%, disponibilidade 15%, avaliações 15%, ticket médio 10% e execução do plano de ação 10%.

Se faltar dado para um componente, ele sai da conta e os pesos restantes são redistribuídos. Se sobrar menos da metade do peso, a loja não recebe nota — aparece "sem dados", que é diferente de nota baixa.

A versão da fórmula fica guardada junto do resultado, para que comparação entre períodos não misture critérios diferentes.