Skip to main content
PUT
Atualizar produto
Envie somente os campos obrigatórios e os que deseja alterar, para reduzir validações desnecessárias. Caso não envie um campo, o mesmo será mantido com o valor atual.

Authorizations

User-Token
string
header
required
User-Secret-Key
string
header
required

Path Parameters

alias
string
required

Alias da loja

id
integer
required

ID do produto

Body

application/json

Representa os dados necessários para criar ou atualizar um produto

simple
boolean
required

Produto possui ou não variações

Example:

true

brand_id
integer
required

ID da marca

active
boolean
required

Indica se o produto está ativo

Example:

true

name
string
required

Nome do produto. O valor é sanitizado e normalizado automaticamente.

erp_id
integer

ID de ERP

searchable
boolean

Indica se o produto é buscável

Example:

true

is_digital
boolean

Indica se o produto é digital

Example:

true

buy_similars
boolean

Sugerir carrossel de produtos similares na compra

Example:

true

priority
integer

Nível de relevância (1 ->Padrão, 2 -> Média, 3 -> Alta)

rating
integer
Example:

4

ncm
string

Código NCM

slug
string

Utilizado em URL e listagens

Example:

"nome-do-produto"

video
string

Vídeo do produto

description
string

Descrição do produto. O valor é sanitizado e normalizado automaticamente.

specifications
string

Especificações do produto. O valor é sanitizado e normalizado automaticamente.

measures
string

Medidas do produto (ex: 10x20x30 cm). O valor é sanitizado e normalizado automaticamente.

gift_value
number<float>

Valor de presente associado ao produto

seo_title
string

Título do produto para SEO

seo_description
string

Descrição do produto para SEO

seo_keywords
string

Palavras-chave para SEO

canonical_url
string

URL canônica do produto

google_category
string

Categoria Google do produto

search_terms
string

Termos extras de busca do produto

categories_ids
integer[]

IDs das categorias vinculadas

flags_ids
integer[]

IDs das flags vinculadas

filters_values_ids
integer[]

IDs dos valores de filtros vinculados

variations_ids
integer[]

IDs das variações do produto

similars_ids
integer[]

IDs de produtos similares

collections_ids
integer[]

IDs das coleções vinculadas

skus
object[]
create_redirect
object

Se presente na requisição, cria um redirect junto com a atualização. A presença do nó é o que sinaliza a intenção — o conteúdo descreve o redirect.

Response

Produto atualizado com sucesso

Representa um produto do catálogo

id
integer
Example:

12345678

merchant_id
integer
read-only

ID da loja

Example:

1

affiliation_id
integer

ID de afiliação do produto

erp_id
integer

ID do produto no ERP

seller_id
integer

ID do vendedor

active
boolean

Indica se o produto está ativo

Example:

true

searchable
boolean

Indica se o produto é buscável

Example:

true

is_digital
boolean

Indica se o produto é digital

Example:

true

rating
integer
Example:

4

priority
integer

Nível de relevância (1 -> Padrão, 2 -> Média, 3 -> Alta)

ncm
string

Código NCM do produto

name
string

Nome do produto

slug
string

Slug (URL amigável) do produto

Example:

"nome-do-produto"

warranty
integer

Garantia em meses

custom_shipping
boolean

Indica se o Frete é customizado

Example:

true

shipping_price
number<float>

Valor do frete customizado em reais

Example:

39.9

gift_value
number<float>

Valor de presente (se aplicável)

simple
boolean

Indica se o produto é simples

Example:

true