Skip to main content
POST
Criar SKU

Authorizations

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

Path Parameters

alias
string
required

Alias da loja

Body

application/json

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

product_id
integer
required

ID do produto ao qual o SKU pertence. Em produtos sem variação, só é aceito um SKU por produto.

sku
string
required

Código do SKU. Deve ser único na loja.

Maximum string length: 40
price_cost
number<float>
required

Preço de custo do SKU, usado internamente para cálculo de margem

price_sale
number<float>
required

Preço de tabela do SKU, sem descontos aplicados

weight
number<float>
required

Peso do SKU em kg. Obrigatório, exceto em produtos digitais.

height
number<float>
required

Altura do SKU em cm. Obrigatória, exceto em produtos digitais.

width
number<float>
required

Largura do SKU em cm. Obrigatória, exceto em produtos digitais.

length
number<float>
required

Comprimento do SKU em cm. Obrigatório, exceto em produtos digitais.

quantity_managed
boolean
required

Habilita o controle de estoque do SKU. Só com este campo habilitado o campo current_stock é considerado.

availability
integer
required

Prazo de disponibilidade do SKU, em dias, somado ao prazo de entrega do estoque

availability_soldout
integer
required

Comportamento quando o estoque zera. -1: torna o SKU indisponível. 0: continua vendendo sem prazo adicional. >0: define um novo prazo de entrega em dias.

blocked_sale
boolean
required

Bloqueia a venda deste SKU

variations_values_ids
integer[]
required

IDs dos valores de variação que identificam o SKU. Obrigatório em produtos com variação, com exatamente um valor por variação cadastrada no produto.

Example:

"[490, 491]"

erp_id
integer

ID do SKU no ERP

barcode
string

Código de barras do SKU. Na criação, precisa ser um código de barras válido.

allow_sell_without_customization
boolean

Permite finalizar a compra sem preencher as personalizações vinculadas ao SKU

price_discount
number<float>

Preço promocional do SKU. Quando maior que zero, substitui o preço de tabela na loja.

order
integer

Ordem de exibição do SKU na página do produto

customizations_ids
integer[]

IDs das personalizações vinculadas ao SKU

Example:

"[1,2,3]"

current_stock
object[]

Informações de estoque do SKU. Pode ser enviado como um único objeto ou um array de objetos.

images
object[]

Imagens a serem importadas para o SKU a partir de URLs públicas.

Response

SKU criado com sucesso

Recursos adicionais do SKU, retornados sob demanda via parâmetro include.

id
integer

ID do SKU

product_id
integer

ID do produto ao qual o SKU pertence

seller_id
integer

ID do vendedor

sku
string

Código do SKU

Example:

"SKU-TEST-API"

token
string

Token único do SKU

erp_id
string

ID do SKU no ERP

Example:

"01-753-Rose"

blocked_sale
boolean

Vendas bloqueadas

Example:

false

barcode
string

Código de barras do SKU

Example:

"barcode-test"

title
string

Título completo do SKU

Example:

"Produto X - Variação 030303 Amarelo"

allow_sell_without_customization
boolean

Permite vender sem personalização obrigatória

Example:

true

price_cost
number<float>

Preço de custo do SKU

price_sale
number<float>

Preço de venda do SKU

price_discount
number<float>

Preço com desconto aplicado

combinations
string[]

Combinações de variações associadas ao SKU

weight
number<float>

Peso do SKU em kg

height
number<float>

Altura do SKU em cm

width
number<float>

Largura do SKU em cm

length
number<float>

Comprimento do SKU em cm

quantity_managed
boolean

Indica se o controle de estoque está habilitado

Example:

true

availability
integer

Prazo de disponibilidade do SKU, em dias, somado ao prazo de entrega do estoque

availability_soldout
integer

Comportamento quando o estoque zera. -1: torna o SKU indisponível. 0: continua vendendo sem prazo adicional. >0: define um novo prazo de entrega em dias.

order
integer

Ordem de exibição do SKU para a página de produtos

variations
object[]

Lista de variações do produto

days_availability_formated
string

Disponibilidade formatada em dias

total_in_stock
integer

Quantidade total em estoque

stock_status
enum<string>

Status do estoque

Available options:
in_stock,
out_of_stock,
low_stock
total_orders
integer

Número total de pedidos realizados

image_reference_sku_id
integer

ID do SKU de referência da imagem

purchase_url
string<url>

URL para a compra do produto

created_at
object
updated_at
object
customizations
object

Personalizações do produto