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:
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.
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.
