Criação e Atualização de Estoque

Diferente das chamadas criar e consultar CD (Warehouse), onde é necessário gerar o Beader Token, na criação e atualização de estoque de Multi Origem é utilizado como credenciais a X-Api-Key e X-User-Email, que é enviado ao seller na criação da conta.

A baixo será possível verificar como efetuar esses processos.

Como criar estoque?

Após a criação do CD (Warehouse) é necessário criar o estoque do seu produto que estará vinculado a ele, e para isso primeiro é necessário seguir o processo abaixo:

https://api.skyhub.com.br/stores/{store_code}/skus

{store_code} = código do CD {code} = sku do produto Request Body:

{
"sku": {
"code": " skudoproduto"
"qty": 0,
"cross_docking": 0
}
}

Example Request:

curl -X POST \
https://api.skyhub.com.br/stores/L01/skus \
-H 'accept: application/json' \
-H 'content-type: application/json' \
-H 'x-api-key: SuaApiKey' \
-H 'x-accountmanager-key: SUAXACCOUNT' \
-H 'x-user-email: [email protected]' \
-d '{
"sku": {
"code": " skudoproduto"
"qty": 0,
"cross_docking": 0
}
}'

Request Headers:

Name

Type

Required

Description

Example

accept

String

Required

application/json

Content-type

String

Required

application/json

x-user-email

String

Required

E-mail da loja

[email protected]

x-api-key

String

Required

Token da loja

SuaApiKey

x-accountmanager-key

String

Required

identificador da sua Integração

SUAXACCOUNT

Possíveis retornos para o relacionamento entre os produtos:

Código HTTP

Descrição

204

No Content

404

Not found

422

Unprocessable entity

Como atualizar estoque?

Depois de vincular o estoque de um item a algum CD (Warehouse), as próximas atualizações devem seguir conforme o processo abaixo:

https://api.skyhub.com.br/stores/{store_code}/skus/{sku}

{store_code} = código do CD {sku} = sku do produto

Request Body:

{
"store_id": " seucodigoCD ",
"sku_code": " skudoproduto ",
"sku": {
"qty": 0,
"cross_docking": 0
}
}

Example Request:

curl -X PUT \
https://api.skyhub.com.br/stores/L01/skus/4278038 \
-H 'accept: application/json' \
-H 'content-type: application/json' \
-H 'x-api-key: SuaApiKey' \
-H 'x-accountmanager-key: SUAXACCOUNT' \
-H 'x-user-email: [email protected]' \
-d '{
"store_id": "seucodigoCD",
"sku_code": "skudoproduto",
"sku": { "qty": 0, "cross_docking": 0 }
}'

Request Headers:

Name

Type

Required

Description

Example

accept

String

Required

application/json

Content-type

String

Required

application/json

x-user-email

String

Required

E-mail da loja

[email protected]

x-api-key

String

Required

Token da loja

SuaApiKey

x-accountmanager-key

String

Required

identificador da sua Integração

SUAXACCOUNT

Possíveis retornos para o relacionamento entre os produtos:

Código HTTP

Descrição

204

No Content

404

Not found

422

Unprocessable entity

Como criar/atualizar estoque em lote:

Uma vez que a loja possui muitos itens e muitos CDs ((Warehouses), acreditamos que seria inviável criar/atualizar produto a produto.

Neste caso é possível criá-los/atualiza-los em lote (batch). Para que isto, você irá atualizar o warehouse que deseja com quantos SKUs precisar, e para que isso ocorra é necessário utilizar o método POST e o seguinte endpoint:

https://api.skyhub.com.br/stores/{store_code}/batch

Request Body:

{
"skus": [
{
"code": "sku-001",
"qty": 200,
"cross_docking": 3
}
]
}

Example Request:

curl --location --request POST 'https://api.skyhub.com.br/stores/{store_code}/batch' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'x-api-key: SuaApiKey' \
--header 'x-accountmanager-key: SUAXACCOUNT' \
--header 'x-user-email: [email protected]' \
--data-raw '{
"skus": [
{
"code": "sku-001",
"qty": 200,
"cross_docking": 3
}
]
}'

Request Headers:

Name

Type

Required

Description

Example

accept

String

Required

application/json

Content-type

String

Required

application/json

x-user-email

String

Required

E-mail da loja

[email protected]

x-api-key

String

Required

Token da loja

SuaApiKey

x-accountmanager-key

String

Required

identificador da sua Integração

SUAXACCOUNT

Response:

207 - Multi-Status

{
"data": [
{
"code": "1523-1",
"status": 200
},
{
"code": "1523-2",
"status": 404,
"error": "Não foi possível encontrar a plataforma B2W"
},
{
"code": "1523-3",
"status": 404,
"error": "Não foi possível encontrar Sku: 1523-3"
},
{
"code": "1523-4",
"status": 422,
"errors": [
{
"attribute": "cross_docking",
"error_message": "deve ser maior ou igual a 0"
},
{
"attribute": "qty",
"error_message": "não é válido"
}
]
},
{
"code": "1523-5",
"status": 500,
"error": "Encontramos um erro inesperado, tente novamente mais tarde"
}
],
"metadata": {
"failures": 4,
"success": 1,
"total": 5
}
}

400 - Bad Request

413 - Request entity too large