Categorias do seller

Categorias organizam o catálogo em árvore (Roupas > Camisetas > Manga longa) e definem onde cada produto aparece na vitrine. No marketplace existem três coisas diferentes com o nome "categoria do seller", e confundi-las é o erro mais comum: as categorias da loja (criadas pelo administrador, que todos usam), as categorias próprias do seller (criadas e mantidas por ele) e a lista de categorias liberadas (uma permissão que o administrador dá ao seller). Esta seção cobre as duas últimas.

Como funciona

Conceitos importantes

Dono da categoria

Toda rota de categoria própria resolve o seller pelo token e só enxerga categorias dele. Uma categoria da loja, ou de outro seller, responde 404 como se não existisse. O mesmo vale para parent_id: o pai também precisa ser seu.

Quem pode chamar

As rotas de categoria própria pedem um privilégio de configurações do seller (vendor_settings ou um dos seus irmãos, como vendor_view_settings). GET /categories e check só exigem ser seller. categories/export e feature-template pedem privilégio de catálogo/importação.

Endpoints

Erros comuns

1. Chamar GET /categories esperando a árvore. Ele devolve as categorias liberadas (e 404 se o recurso estiver desligado). Para as suas categorias use /categories/own.
2. Usar parent_id de categoria da loja. Só o seu próprio pai é aceito; a resposta é 404 parent category not found.
3. Repetir o nome sob o mesmo pai. Duas categorias irmãs com o mesmo nome são recusadas (volta 500 com a mensagem no detail).
4. Passar de 6 níveis. Também volta 500 com detail.
5. Excluir sem pensar no cascade. ?cascade=true apaga subcategorias e os produtos delas.
6. Mandar status com palavra desconhecida. Qualquer valor fora de A, H, D, T (ou dos nomes active, hidden, disabled, deleted) vira A sem aviso.

Próximos passos