Catálogo mestre
Vincula e desvincula um produto do seller a um produto do catálogo mestre da loja.
O catálogo mestre reúne produtos "oficiais" curados pela loja. Vários sellers podem vender o mesmo produto mestre, cada um com o seu preço e estoque (as "ofertas"). Ao vincular, você aproveita descrição, imagens e ficha técnica já prontas.
Vincular
Liga um produto seu a um produto do catálogo mestre. A plataforma copia para o seu produto os dados canônicos do mestre (nome, descrição, categoria, imagem principal, características) e passa a mantê-lo alinhado. Preço, estoque, SKU e status continuam seus.
/api/v1/vendor/products/{id}/link-masterSellerVincular ao catálogo mestre
Cabeçalhos
AuthorizationstringobrigatórioBearer $TOKEN. Token de acesso do usuário seller (veja Tokens).Parâmetros de caminho
idstring (uuid)obrigatórioId do produto.
Corpo da requisição
master_product_idstring (uuid)obrigatórioId do produto do catálogo mestre.
Exemplo de requisição (vincular)
bash
curl -X POST "$BASE_URL/api/v1/vendor/products/$PRODUCT_ID/link-master" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"master_product_id": "4d5e6f70-8192-4a3b-8c4d-5e6f70819203"
}'Resposta (vincular)
200Vinculado
json
{
"message": "product linked to master"
}Campos da resposta
messagestringConfirmação fixa.
Erros (vincular)
| Status | Quando | Corpo |
|---|---|---|
| 401 | Token ausente, inválido ou expirado. | {"error":"missing authorization header"} |
| 403 | Token que não é de seller. | {"error":"insufficient permissions"} |
| 400 | master_product_id ausente. | {"error":"master_product_id is required"} |
| 403 | O produto não é do seu seller. | {"error":"product does not belong to your store"} |
| 404 | O recurso de catálogo mestre está desligado na loja, ou o produto/mestre não existe. | {"error":"feature not enabled","detail":"enable master_products via admin settings"} |
| 500 | Produto não está em status vendável (A ou H), ou você já tem outro produto ligado a esse mestre. | {"error":"product is not in a sellable status (R). It must pass moderation before linking to a master"} |
Desvincular
Remove o vínculo. Os dados já copiados permanecem, mas o produto volta a ser livre para edição em todos os campos.
/api/v1/vendor/products/{id}/unlink-masterSellerDesvincular do catálogo mestre
Cabeçalhos
AuthorizationstringobrigatórioBearer $TOKEN. Token de acesso do usuário seller (veja Tokens).Parâmetros de caminho
idstring (uuid)obrigatórioId do produto.
Exemplo de requisição (desvincular)
bash
curl -X DELETE "$BASE_URL/api/v1/vendor/products/$PRODUCT_ID/unlink-master" \
-H "Authorization: Bearer $TOKEN"Resposta (desvincular)
200Desvinculado
json
{
"message": "product unlinked from master"
}Campos da resposta
messagestringConfirmação fixa.
Erros (desvincular)
| Status | Quando | Corpo |
|---|---|---|
| 401 | Token ausente, inválido ou expirado. | {"error":"missing authorization header"} |
| 403 | Token que não é de seller. | {"error":"insufficient permissions"} |
| 403 | O produto não é do seu seller. | {"error":"product does not belong to your store"} |
| 404 | Catálogo mestre desligado na loja, ou produto inexistente. | {"error":"feature not enabled"} |