v1

latestOpenAPI 3.0.02026-07-26376212496.4 KB
Catálogo - SKUs

Atualizar SKU

Atualiza o SKU de um produto

put/{alias}/catalog/skus/{id}

Path parameters

aliasstring required

Alias da loja

idinteger required

ID do SKU

Request body

idinteger
store_idinteger
product_idinteger required
skustring required
tokenstring
erp_idinteger
barcodestring
allow_sell_without_customizationboolean
price_costnumber float required
price_salenumber float required
price_discountnumber float
weightnumber float required
heightnumber float required
widthnumber float required
lengthnumber float required
quantity_managedboolean required
availabilityinteger required
availability_soldoutinteger required
blocked_saleboolean required
orderinteger
variations_values_idsstring[] required
customizations_idsinteger[]

Example request

{
  "images": [
    {
      "url": "https://www.site.com/image1.jpg"
    }
  ]
}

Response

SKU atualizado com sucesso

idinteger

ID do SKU

product_idinteger

ID do produto ao qual o SKU pertence

seller_idinteger

ID do vendedor

skustring

Código do SKU

tokenstring

Token único do SKU

erp_idstring

ID do SKU no ERP

blocked_saleboolean

Vendas bloqueadas

barcodestring

Código de barras do SKU

titlestring

Título completo do SKU

allow_sell_without_customizationboolean

Permite vender sem personalização obrigatória

price_costnumber float

Preço de custo do SKU

price_salenumber float

Preço de venda do SKU

price_discountnumber float

Preço com desconto aplicado

combinationsstring[]

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

weightnumber float

Peso do SKU em kg

heightnumber float

Altura do SKU em cm

widthnumber float

Largura do SKU em cm

lengthnumber float

Comprimento do SKU em cm

quantity_managedboolean

Indica se o controle de estoque está habilitado

availabilityinteger

Quantidade disponível em estoque

availability_soldoutinteger

Quantidade disponível mesmo após esgotado

orderinteger

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

days_availability_formatedstring

Disponibilidade formatada em dias

total_in_stockinteger

Quantidade total em estoque

stock_status'in_stock' | 'out_of_stock' | 'low_stock'

Status do estoque

total_ordersinteger

Número total de pedidos realizados

image_reference_sku_idinteger

ID do SKU de referência da imagem

purchase_urlstring url

URL para a compra do produto

Example response

{
  "sku": "SKU-TEST-API",
  "erp_id": "01-753-Rose",
  "barcode": "barcode-test",
  "title": "Produto X - Variação 030303 Amarelo",
  "allow_sell_without_customization": true,
  "quantity_managed": true,
  "created_at": {
    "date": "2000-08-17 10:24:24",
    "timezone_type": 3,
    "timezone": "America/Sao_Paulo"
  },
  "updated_at": {
    "date": "2000-08-17 10:24:24",
    "timezone_type": 3,
    "timezone": "America/Sao_Paulo"
  },
  "customizations": {
    "data": [
      {
        "name": "Primeira Letra",
        "description": "Descrição",
        "type": "select",
        "required": true,
        "max_chars": 1
      }
    ]
  }
}