Clonar produto

Duplica um produto, com opções, características, imagens, tags, faixas de preço, variações e relacionados, e devolve a cópia para você ajustar.

Use esta operação para criar um produto parecido com outro sem recadastrar tudo: uma caneca em outra cor, um item de uma mesma linha, um modelo para a equipe preencher. O clone copia os dados do produto original (nome, descrição, preço, estoque, dimensões, categorias, SEO e regras de quantidade) e, conforme as opções que você enviar, também os itens ligados a ele.

A clonagem cria um produto novo a partir de um produto que já existe.

O clone nasce com algumas diferenças em relação ao original, e elas são de propósito:

O nome ganha o sufixo (Copy) e o slug é gerado a partir dele (com -2, -3 em caso de repetição).
O SKU fica vazio, porque o SKU é único na loja. Defina um novo com Alterar produto.
O status é R (aguardando aprovação), com o intended_status do original guardado. O clone não aparece na loja até alguém aprová-lo ou você enviar status: "A" no PUT.
As contagens (visualizações, vendas, avaliações) começam do zero.
O estoque é copiado (quantity igual ao do original). Ajuste antes de ativar, para não contar o mesmo estoque duas vezes.

POST/api/v1/admin/products/{id}/cloneAdmin

Clona um produto

Autenticação: Authorization: Bearer <token> de um usuário administrador com o privilégio manage_catalog. O corpo é opcional.

Path parameters

iduuidobrigatório

UUID do produto a clonar.

Corpo da requisição

clone_optionsboolean

Copia as opções do produto (campos que o cliente preenche na compra) e os valores delas.

clone_featuresboolean

Copia os valores de características (marca, cor, material...).

clone_imagesboolean

Copia as imagens.

clone_tagsboolean

Copia as tags.

clone_price_tiersboolean

Copia as faixas de preço por quantidade.

clone_variationsboolean

Copia as variações (produtos filhos).

clone_relationsboolean

Copia os produtos relacionados, cross-sell e acessórios.

Exemplo de requisição

Resposta

201Produto clonado

Exemplo abreviado: o objeto product traz todos os campos descritos em Consultar produto.

Campos da resposta

productobject

O produto novo, com os mesmos campos de Consultar produto. Note sku ausente, status: "R" e approval_status: "pending".

original_namestring

Nome do produto original.

cloned_namestring

Nome do clone (original mais (Copy)).

Erros

Status	Quando	Corpo
401	Sem credenciais ou token expirado	`{"error":"invalid or expired token"}`
403	Usuário sem o privilégio `manage_catalog`	`{"error":"insufficient privileges","required":"manage_catalog"}`
404	O produto não existe ou está na lixeira	`{"error":"product not found"}`
429	Limite de requisições	`{"error":"rate limit exceeded","detail":"too many requests, please try again later"}`
500	`{id}` que não é UUID (por limitação conhecida, não é 400), ou falha interna	`{"error":"failed to clone product","detail":"o valor \"abc\" não é um uuid válido. Corrija o campo e reenvie."}`

Falhas ao copiar um item ligado (por exemplo, as imagens) não derrubam a chamada: o produto é criado e o erro fica só no registro do servidor. Confira o clone antes de ativá-lo.

Veja também