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

Vendas (valor líquido)

O repasse do marketplace mais o que o cliente pagou direto à loja na entrega (maquininha, dinheiro). É o "total do faturamento" do marketplace, e o primeiro número da visão geral. Com pagamento na entrega, o card mostra as duas parcelas.

Vendas (valor líquido estimado)

O mesmo indicador quando o repasse ainda não foi informado pelo marketplace. É estimativa, não extrato: para conferência financeira, vale o documento do marketplace.

Valor dos itens (antes de descontos)

Soma do valor de tabela dos itens vendidos no período, antes de qualquer desconto e sem a taxa de entrega. Responde quanto a loja vendeu de produto.

Valor das vendas

Os itens mais a taxa de entrega, menos o desconto que a própria loja bancou em promoção. É o número que aparece na tela de desempenho do marketplace, e por isso serve para conferir uma tela contra a outra. O desconto patrocinado pelo marketplace não sai daqui, porque ele é devolvido à loja no repasse.

Líquido sobre bruto

Quanto da venda bruta sobrou para a loja depois de taxas e descontos. Só aparece quando o valor líquido real chegou em todos os dias do período.

Ticket médio

O valor das vendas dividido pelos pedidos concluídos. É o ticket que aparece na tela de desempenho do marketplace.

Ticket médio dos itens

O valor dos itens dividido pelos mesmos pedidos concluídos. Valor calculado, não sincronizado.

Ticket médio líquido

O valor líquido dividido pelos mesmos pedidos concluídos. Os três tickets usam o mesmo divisor, senão não dariam para comparar entre si.

Cancelamentos

Pedidos cancelados mais os concluídos com estorno parcial, sobre o total de pedidos, como o marketplace conta. 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

Seis componentes com peso fixo e público: crescimento e vendas, cancelamentos, disponibilidade, avaliações, ticket médio e execução do plano de ação. Componente sem dado 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.

Ver a fórmula completa, com a conta aberta →