Categorias permitidas do seller
Define em quais categorias de produto um seller pode vender, quando a loja usa o recurso de categorias por seller.
Algumas lojas limitam onde cada seller pode vender: um seller de eletrônicos não cadastra produtos em "Alimentos". Essa lista de categorias permitidas só vale quando o recurso categories_by_vendor está ligado nas configurações da loja. Com o recurso desligado, as rotas respondem 404 categories_by_vendor feature is not enabled. O privilégio exigido é manage_vendor_categories ou manage_vendors.
Ler as categorias do seller
/api/v1/admin/vendors/{vendorId}/categoriesAdminLista as categorias em que o seller pode vender
Parâmetros de caminho
vendorIduuidobrigatórioA resposta esperada é uma lista de vínculos:
[
{
"id": "3a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d",
"vendor_id": "94bd7e9a-fdad-4d01-8fc2-ba9d677d8b36",
"category_id": "ae6f8f8b-7cbe-4725-84fa-247cce138143",
"created_at": "2026-10-01T12:00:00Z",
"category_name": "Eletrônicos",
"category_slug": "eletronicos"
}
]Campos da resposta
iduuidvendor_iduuidcategory_iduuidcategory_namestringcategory_slugstringcreated_atstringDefinir todas as categorias
Substitui a lista inteira: apaga os vínculos atuais e grava os enviados, numa única transação. Devolve a lista nova.
/api/v1/admin/vendors/{vendorId}/categoriesAdminSubstitui as categorias permitidas de um seller
Parâmetros de caminho
vendorIduuidobrigatórioCorpo da requisição
category_idsarrayobrigatórioPermitir uma categoria
/api/v1/admin/vendors/{vendorId}/categories/{categoryId}AdminPermite uma categoria para o seller
Parâmetros de caminho
vendorIduuidobrigatóriocategoryIduuidobrigatórioResponde 201 com o vínculo criado.
Retirar uma categoria
/api/v1/admin/vendors/{vendorId}/categories/{categoryId}AdminRetira uma categoria do seller
Parâmetros de caminho
vendorIduuidobrigatóriocategoryIduuidobrigatório{ "message": "vendor category removed" }Erros
| Status | Quando | Corpo de exemplo |
|---|---|---|
| 400 | Hoje, em toda chamada (defeito descrito acima). | {"error":"vendor id is required"} |
| 400 | Corpo do PUT não é JSON. | {"error":"invalid request body","detail":"..."} |
| 400 | Falha ao permitir a categoria (por exemplo, categoria inexistente). | {"error":"failed to add vendor category","detail":"..."} |
| 404 | Recurso categories_by_vendor desligado na loja. | {"error":"categories_by_vendor feature is not enabled"} |
| 500 | Falha ao gravar ou retirar. | {"error":"failed to set vendor categories","detail":"..."} |
| 401 / 403 | Sem token ou sem privilégio. | {"error":"missing authorization header"} |