Produto Variável

Nesta página mostraremos como realizar atualizações em variações previamente criadas

PUT - Atualizando a variação de um produto

Será necessário o método PUT com os mesmos headers para realizar a atualização da variação, porém o endpoint utilizado é o /variations seguido do SKU da variação conforme abaixo:

https://api.skyhub.com.br/variations/{SKU_VARIACAO}

Request headers:

Key	Value
X-User-Email	email_de_usuario
x-Api-Key	token_de_integracao de sua conta SkyHub
x-accountmanager-key	token_account único de cada Plataforma/ERP
Accept	application/json
Content-Type	application/json

Request body:

{
  "variation": {
    "images": [
      "https://foo"
    ],
    "ean": "0000000000000",
    "qty": "10",
    "specifications": [
      {
        "value": "Atributo",
        "key": "Valor"
      }
    ]
  }
}

O objeto product deve ser substituído pelo variation e não pode ser retirado da requisição, caso contrário um erro será retornado na tentativa de atualizar a variação.

Example request:

curl --location -g --request PUT 'https://api.skyhub.com.br/variations/{SKU_VARIACAO}' \
--header 'X-User-Email: email_de_usuario' \
--header 'x-Api-Key: token_de_integracao de sua conta SkyHub' \
--header 'x-accountmanager-key: token_account único de cada Plataforma/ERP' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
  "variation": {
    "images": [
      "https://images-americanas.b2w.io/produtos/2638788562/imagens/regata-basic-feminina-canelada-branca/2638788562_1_xlarge.jpg"
    ],
    "ean": "0123456789012",
    "qty": "5",
    "specifications": [
      {
        "value": "crossdocking",
        "key": "3"
      }
    ]
  }
}'

Response esperado:

204 [Success] - No content

Para a atualização de imagens é necessário atentar-se a URL indexada: Para realizar alterações nas imagens de um produto é preciso encaminhar uma nova URL, ou seja, não é possível reutilizar a URL previamente enviada; somente com URLs diferentes a nova imagem será refletida pelo marketplace.

[Ver Comunicado: Envio de Imagens para o Marketplace]

Como atualizar preço e estoque

Assim como quaisquer atualizações em variações, para alterações nos campos de preço (price e promotional_price) e estoque deve ser utilizado o método PUT no /variations/{SKU_VARIACAO}.

Deve ser realizado um PUT por variação.

A seguir temos exemplos de requisições para as atualizações de preço e estoque para variações:

Atualização de preço por variação:

curl --location -g --request PUT 'https://api.skyhub.com.br/variations/{SKU_VARIACAO}' \
--header 'X-User-Email: email_de_usuario' \
--header 'x-Api-Key: token_de_integracao de sua conta SkyHub' \
--header 'x-accountmanager-key: token_account único de cada Plataforma/ERP' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
  "variation": {
  	"specifications": [
  		{
  			"key": "price",
  			"value": "50.00"
  		},
  		{
  			"key": "promotional_price",
  			"value": "45.00"
  		}
  	]
  }
}'

Atualização de estoque por variação:

curl --location -g --request PUT 'https://api.skyhub.com.br/variations/{SKU_VARIACAO}' \
--header 'X-User-Email: email_de_usuario' \
--header 'x-Api-Key: token_de_integracao de sua conta SkyHub' \
--header 'x-accountmanager-key: token_account único de cada Plataforma/ERP' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
  "variation": {
      "qty": 1
  }
}'

Atualização de preço e estoque:

curl --location -g --request PUT 'https://api.skyhub.com.br/variations/{SKU_VARIACAO}' \
--header 'X-User-Email: email_de_usuario' \
--header 'x-Api-Key: token_de_integracao de sua conta SkyHub' \
--header 'x-accountmanager-key: token_account único de cada Plataforma/ERP' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
  "variation": {
    "qty": 5,
  	"specifications": [
  		{
  			"key": "price",
  			"value": "185.90"
  		},
  		{
  			"key": "promotional_price",
  			"value": "180.90"
  		}
  	]
  }
}'

Caso deseje realizar alterações no SKU agrupador é possível seguir as orientações da guia Atualização de Produto > Produto Simples.