API atual/Referência completa/Moderação de produtos e sellers

Candidaturas de sellers

Lista as candidaturas de novos sellers e decide cada uma, ativando ou recusando o seller.

Quando uma empresa quer vender no marketplace, ela envia uma candidatura pelo painel de seller. Estas duas rotas mostram a fila de candidaturas e registram a decisão. O módulo vendor-moderation precisa estar ligado. Para ler, basta acesso de leitura ao catálogo; para decidir, manage_vendor_moderation ou manage_catalog.

Listar candidaturas

Devolve todas as candidaturas que casam com o filtro, sem paginação.

GET/api/v1/admin/moderation/vendor-applicationsAdmin

Lista as candidaturas de sellers

Parâmetros de consulta

statusstring

pendingunder_reviewapprovedrejectedall

Filtra pelo estado da candidatura. Vazio ou all lista todas.

Exemplo de requisição

bash

curl "$BASE_URL/api/v1/admin/moderation/vendor-applications?status=under_review" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Candidaturas

json

{
  "applications": [
    {
      "id": "5bd98df9-8942-4cd2-b5b6-3806703d0c84",
      "vendor_id": "94bd7e9a-fdad-4d01-8fc2-ba9d677d8b36",
      "vendor_name": "Loja Seller Teste",
      "status": "rejected",
      "submitted_at": "2026-05-29T19:54:40Z",
      "reviewed_at": "2026-07-11T14:12:29Z",
      "reviewed_by": "67bf291c-0846-4053-9528-8cfd5ab0ebf1",
      "rejection_reason": "Documentação incompleta, favor reenviar o CNPJ.",
      "created_at": "2026-05-29T19:54:40Z",
      "updated_at": "2026-07-11T14:12:29Z"
    }
  ],
  "total": 1
}

Campos da resposta

applicationsarray

Candidaturas. Lista vazia se não houver nenhuma.

applications[].iduuid

Id da candidatura. É o que a rota de decisão usa.

applications[].vendor_iduuid

Seller candidato.

applications[].vendor_namestring

Razão social do seller.

applications[].statusstring

pendingunder_reviewapprovedrejected

Estado, como palavra.

applications[].submitted_atstring

Quando o seller enviou (RFC 3339, UTC).

applications[].reviewed_atstring

Quando foi decidida. Ausente enquanto aberta.

applications[].reviewed_byuuid

Quem decidiu.

applications[].rejection_reasonstring

Motivo, só em recusadas e se informado.

totalinteger

Quantidade devolvida.

Os documentos anexados à candidatura não vêm nesta lista. Para ver a candidatura de um seller com os documentos, use Candidatura do seller.

Decidir uma candidatura

Aprova ou recusa. A decisão muda o próprio seller: aprovar ativa o seller (status A, grava approved_at e approved_by, e devolve ao ar produtos que estavam ocultos por suspensão); recusar marca o seller como recusado (R) e guarda o motivo.

PUT/api/v1/admin/moderation/vendor-applications/{id}/reviewAdmin

Aprova ou recusa uma candidatura

Parâmetros de caminho

iduuidobrigatório

Id da candidatura (applications[].id), não o id do seller.

Corpo da requisição

decisionstringobrigatório

approvedrejected

A decisão. Qualquer outro valor é recusado.

reasonstring

Motivo. Fica em rejection_reason e também no seller recusado. Recomendado ao recusar.

200Candidatura decidida

json

{
  "message": "application reviewed",
  "application_id": "5bd98df9-8942-4cd2-b5b6-3806703d0c84",
  "decision": "rejected"
}

Erros

Status	Quando	Corpo de exemplo
400	`decision` diferente de `approved`/`rejected`.	`{"error":"decision must be 'approved' or 'rejected'"}`
400	Corpo não é JSON.	`{"error":"invalid request body","detail":"..."}`
500	Candidatura não existe.	`{"error":"failed to review application","detail":"application 0000... not found"}`
401 / 403	Sem token, módulo desligado ou sem privilégio.	`{"error":"module_disabled","module":"vendor-moderation"}`

Veja também

Candidaturas de sellers

Lista as candidaturas de novos sellers e decide cada uma, ativando ou recusando o seller.

Listar candidaturas

Devolve todas as candidaturas que casam com o filtro, sem paginação.

GET/api/v1/admin/moderation/vendor-applicationsAdmin

Lista as candidaturas de sellers

Parâmetros de consulta

statusstring

pendingunder_reviewapprovedrejectedall

Filtra pelo estado da candidatura. Vazio ou all lista todas.

Exemplo de requisição

bash

curl "$BASE_URL/api/v1/admin/moderation/vendor-applications?status=under_review" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Candidaturas

json

{
  "applications": [
    {
      "id": "5bd98df9-8942-4cd2-b5b6-3806703d0c84",
      "vendor_id": "94bd7e9a-fdad-4d01-8fc2-ba9d677d8b36",
      "vendor_name": "Loja Seller Teste",
      "status": "rejected",
      "submitted_at": "2026-05-29T19:54:40Z",
      "reviewed_at": "2026-07-11T14:12:29Z",
      "reviewed_by": "67bf291c-0846-4053-9528-8cfd5ab0ebf1",
      "rejection_reason": "Documentação incompleta, favor reenviar o CNPJ.",
      "created_at": "2026-05-29T19:54:40Z",
      "updated_at": "2026-07-11T14:12:29Z"
    }
  ],
  "total": 1
}

Campos da resposta

applicationsarray

Candidaturas. Lista vazia se não houver nenhuma.

applications[].iduuid

Id da candidatura. É o que a rota de decisão usa.

applications[].vendor_iduuid

Seller candidato.

applications[].vendor_namestring

Razão social do seller.

applications[].statusstring

pendingunder_reviewapprovedrejected

Estado, como palavra.

applications[].submitted_atstring

Quando o seller enviou (RFC 3339, UTC).

applications[].reviewed_atstring

Quando foi decidida. Ausente enquanto aberta.

applications[].reviewed_byuuid

Quem decidiu.

applications[].rejection_reasonstring

Motivo, só em recusadas e se informado.

totalinteger

Quantidade devolvida.

Os documentos anexados à candidatura não vêm nesta lista. Para ver a candidatura de um seller com os documentos, use Candidatura do seller.

Decidir uma candidatura

PUT/api/v1/admin/moderation/vendor-applications/{id}/reviewAdmin

Aprova ou recusa uma candidatura

Parâmetros de caminho

iduuidobrigatório

Id da candidatura (applications[].id), não o id do seller.

Corpo da requisição

decisionstringobrigatório

approvedrejected

A decisão. Qualquer outro valor é recusado.

reasonstring

Motivo. Fica em rejection_reason e também no seller recusado. Recomendado ao recusar.

200Candidatura decidida

json

{
  "message": "application reviewed",
  "application_id": "5bd98df9-8942-4cd2-b5b6-3806703d0c84",
  "decision": "rejected"
}

Erros

Status	Quando	Corpo de exemplo
400	`decision` diferente de `approved`/`rejected`.	`{"error":"decision must be 'approved' or 'rejected'"}`
400	Corpo não é JSON.	`{"error":"invalid request body","detail":"..."}`
500	Candidatura não existe.	`{"error":"failed to review application","detail":"application 0000... not found"}`
401 / 403	Sem token, módulo desligado ou sem privilégio.	`{"error":"module_disabled","module":"vendor-moderation"}`