API atual/Referência completa/Perfil e verificação do seller

Reputação do seller

Consulta a nota e a faixa de reputação do seller, o termômetro que a vitrine usa para dar confiança ao cliente, com os principais pontos a melhorar.

A reputação resume, num número de 0 a 100 e numa cor, como o seller vem atendendo seus pedidos recentes. A plataforma recalcula tudo uma vez por dia. A vitrine usa a faixa para mostrar um termômetro ao cliente, e esta rota mostra ao próprio seller onde ele está e o que puxa a nota para baixo.

`band`	Significado
`green`	Nota de 80 a 100. Bom desempenho.
`yellow`	Nota de 50 a 79. Atenção.
`red`	Nota abaixo de 50. Desempenho ruim.
`neutral`	Sem termômetro: vendedor novo (poucos pedidos) ou reputação ocultada pela loja.

Consultar a reputação

GET/api/v1/vendor/reputationSeller

Reputação do seller autenticado

Devolve a reputação do seller dono do token, como calculada pela última rotina diária. Não aceita parâmetros.

Exemplo de requisição

bash

curl "$BASE_URL/api/v1/vendor/reputation" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Reputação do seller

json

{
  "vendor_id": "94bd7e9a-fdad-4d01-8fc2-ba9d677d8b36",
  "score": 71,
  "band": "yellow",
  "hidden": false,
  "cold_start": false,
  "top_issues": ["cancellation_rate"],
  "orders_in_window": 3237
}

Campos da resposta

vendor_iduuid

Seller avaliado.

scoreinteger

Nota de 0 a 100. Vem 0 quando o termômetro está suprimido (neutral por ocultação).

bandstring

greenyellowredneutral

Faixa da reputação.

hiddenboolean

true quando a loja ocultou a reputação deste seller.

cold_startboolean

true quando o seller ainda tem menos de 10 pedidos entregues no período avaliado; a faixa fica neutral.

top_issuesarray

cancellation_ratelate_dispatch_ratereturn_raterating_avg

Até 3 pontos fracos, na ordem em que a plataforma os mede: muitos cancelamentos, muitos despachos fora do prazo prometido, muitas devoluções aceitas, nota média dos produtos baixa. Lista vazia quando nada preocupa.

orders_in_windowinteger

Pedidos entregues considerados no período recente avaliado.

Erros

Status	Quando	Corpo de exemplo
401	Sem token.	`{"error":"authentication required"}`
403	O usuário não é de um seller.	`{"error":"no vendor account associated with this user"}`
500	Falha ao carregar.	`{"error":"failed to load reputation","detail":"..."}`

Veja também