Central de pendências
Fila única de pendências do time administrativo: aprovações, moderações e análises criadas automaticamente, com atribuição, adiamento e conclusão.
A central de pendências é a fila única de tudo o que precisa de uma pessoa do time administrativo. Você não cria pendências pela API: a plataforma as abre sozinha quando um evento acontece (um cadastro de cliente que espera aprovação, um produto para moderar, uma devolução solicitada) e as fecha sozinha quando o evento que resolve acontece. A API serve para ler a fila e para organizar o trabalho: pegar, atribuir, adiar, concluir e reabrir.
Como funciona
Estados e transições:
| Estado | Significado |
|---|---|
open | Aberta, sem responsável. |
in_progress | Tem responsável (pegou ou foi atribuída). |
snoozed | Adiada até snoozed_until (no máximo 30 dias). |
done | Resolvida, manualmente ou pelo fechamento automático. |
cancelled | Estado previsto no modelo; nenhuma rotina da plataforma o define hoje. Se existir, pode ser reaberta. |
| Tipo | Origem |
|---|---|
product_moderation | Produto de seller aguardando moderação. |
return_request | Devolução solicitada. |
review_moderation | Avaliação aguardando moderação. |
pending_user | Cadastro de cliente aguardando aprovação. |
kyc_review | Análise de documentos (KYC). |
order_approval | Pedido que exige aprovação. |
chargeback | Contestação de pagamento. |
rfq | Pedido de cotação. |
Conceitos principais
Prazo e SLA
Cada pendência nasce com due_at igual à criação mais o SLA do tipo. O padrão é 48 horas; a loja pode definir outro valor por tipo. Atrasada é a pendência open ou in_progress com due_at no passado.
Fechamento automático
Quando o evento que resolve acontece (produto aprovado ou rejeitado, cadastro aprovado, pedido aprovado...), a plataforma conclui a pendência. Por isso a resolução é feita na tela de origem (link), não nesta API.
Título não é texto
title é um código estável igual ao tipo. Monte a frase na sua interface a partir de type e metadata.
Endpoints
| Método | Caminho | Para que serve | Página |
|---|---|---|---|
| GET | /api/v1/admin/tasks | Lista as pendências, as que vencem primeiro no topo | Consultar pendências |
| GET | /api/v1/admin/tasks/summary | Contagem de pendências abertas e atrasadas por tipo e por responsável | Consultar pendências |
| POST | /api/v1/admin/tasks/{id}/claim | Assume uma pendência sem responsável | Agir nas pendências |
| POST | /api/v1/admin/tasks/{id}/assign | Atribui a pendência a um usuário (gestor) | Agir nas pendências |
| POST | /api/v1/admin/tasks/{id}/snooze | Adia uma pendência por até 30 dias | Agir nas pendências |
| POST | /api/v1/admin/tasks/{id}/done | Marca como resolvida | Agir nas pendências |
| POST | /api/v1/admin/tasks/{id}/reopen | Reabre uma pendência | Agir nas pendências |
Erros comuns
- Tentar criar pendências por
POST /admin/tasks: a rota não existe; elas nascem de eventos. - Interpretar 409 de
claimsó como "já tem dono": ele também é devolvido para id inexistente ou fora deopen/snoozed. - Enviar
snoozecom mais de 30 dias: responde 422. - Usar
titlecomo texto de tela. - Confiar no 200 de
done,assignoureopencomo prova de mudança. - Mandar corpo malformado em
assigne remover o responsável sem querer.