Moderação de produtos e sellers

Em um marketplace, o produto cadastrado por um seller (lojista) pode não ir ao ar direto: ele fica numa fila de pré-moderação até um administrador aprovar. Esta seção cobre essa fila, as ações em lote e a análise das candidaturas de sellers (a decisão de deixar um seller novo vender). Quando o produto é aprovado ele assume o status que o seller pretendia; quando é recusado o seller vê o motivo no produto.

Como funciona

1. Produto entra na fila

   Quando o seller está sujeito à aprovação de produtos (campo products_require_approval do cadastro dele), o produto novo nasce com status = R e o status que ele terá depois fica em intended_status.

2. Você revisa

   Liste a fila (por padrão só R) e abra cada produto.

3. Você decide

   Aprove ou recuse um produto, ou em lote. A aprovação dispara o aviso ao seller, reindexa a busca e tenta ligar o produto ao catálogo mestre.

Status de produto que aparecem aqui

Estados da candidatura de seller

pending, under_review, approved, rejected. Aqui eles saem como palavras.

Conceitos-chave

Aprovar não confere o estado atual

Aprovar grava status = intended_status em qualquer produto que exista, mesmo que ele já esteja ativo ou tenha sido recusado antes. Aprovar um produto recusado o reabre. Recusar grava X em qualquer produto, inclusive um que já está no ar. Confira o status antes de recusar.

Moderação não é a mesma coisa que KYC

KYC verifica documentos da empresa (veja Verificação KYC). A candidatura decide se o seller entra no marketplace. A moderação de produto decide o que ele pode publicar.

Endpoints

Erros comuns

• Aprovar um id que não existe. Devolve 500 failed to approve product com product not found, não 404.
• Recusar sem motivo. reason (ou rejected_reason, ou notes) é obrigatório: 400 rejected_reason is required.
• Esperar que o lote falhe por inteiro. bulk ignora em silêncio os ids que falham e só informa updated. bulk-approve e bulk-reject devolvem o resultado de cada id.
• Mandar filter sem simulate antes. O lote por filtro responde 428 simulate_required até você simular e repetir com o confirm_token.
• Esperar [] na fila vazia. products vem null quando não há itens. Trate null como lista vazia.
• Passar um id que não é UUID. Volta 500 com a mensagem do banco traduzida, não 400.

Próximos passos