Estoque

Como criar Estoque:

Uma vez que é possível criar diversos warehouses e cada um pode possuir o mesmo sku, será necessário ter/criar estoque por warehouse discernindo entre eles.
Por exemplo:
A loja possui 3 warehouses (local de retirada), cada um possui o mesmo sku: 123.
Neste caso é necessário que seja criado um estoque por warehouse para o sku 123.
Para criar um estoque é necessário utilizar o método POST na seguinte endpoint:
1
https://api.skyhub.com.br/stores/{store_code}/skus
Copied!
Como pode é possivel observar, em {store_code}, é necessário informar o código da warehouse.
Request Body:
1
{
2
"sku": {
3
"code": "sku-001",
4
"qty": 200,
5
"cross_docking": 3
6
}
7
}
Copied!
Campo "code" é referente ao sku do item
Example Request:
1
curl --location --request POST 'https://api.skyhub.com.br/stores/{store_code}/skus' \
2
--header 'accept: application/json' \
3
--header 'content-type: application/json' \
4
--header 'x-api-key: SuaApiKey' \
5
--header 'x-accountmanager-key: SUAXACCOUNT' \
6
--header 'x-user-email: [email protected]' \
7
--header 'Content-Type: text/plain' \
8
--data-raw '{
9
"sku": {
10
"code": "sku-001",
11
"qty": 200,
12
"cross_docking": 3
13
}
14
}'
Copied!
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
x-api-key
String
Required
Token da loja
SuaApiKey
x-accountmanager-key
String
Required
identificador da sua Integração
SUAXACCOUNT
Response:
200 – success
400 - Bad request

Como atualizar estoque?

Para efetuar a atualização depois que o produto é criado, será necessário efetuar o método PUT na seguinte endpoint:
1
https://api.skyhub.com.br/stores/{store_code}/skus/{sku}
Copied!
Request Body:
1
{
2
"sku": {
3
"qty": 0,
4
"cross_docking": 0
5
}
6
}
Copied!
Example Request:
1
curl -X PUT \
2
https://api.skyhub.com.br/stores/L01/skus/4278038 \
3
-H 'accept: application/json' \
4
-H 'content-type: application/json' \
5
-H 'x-api-key: SuaApiKey' \
6
-H 'x-accountmanager-key: SUAXACCOUNT' \
7
-H 'x-user-email: [email protected]' \
8
-d '{
9
"sku": { "qty": 0, "cross_docking": 0 }
10
}'
Copied!
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
x-api-key
String
Required
Token da loja
SuaApiKey
x-accountmanager-key
String
Required
identificador da sua Integração
SUAXACCOUNT
Response:
200 – success

Como criar/atualizar estoque em lote:

Uma vez que a loja possui muitos itens e muitos 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:
1
https://api.skyhub.com.br/stores/{store_code}/batch
2
Copied!
Request Body:
1
{
2
"skus": [
3
{
4
"code": "sku-001",
5
"qty": 200,
6
"cross_docking": 3
7
}
8
]
9
}
Copied!
Example Request:
1
curl --location --request POST 'https://api.skyhub.com.br/stores/{store_code}/batch' \
2
--header 'accept: application/json' \
3
--header 'content-type: application/json' \
4
--header 'x-api-key: SuaApiKey' \
5
--header 'x-accountmanager-key: SUAXACCOUNT' \
6
--header 'x-user-email: [email protected]' \
7
--header 'Content-Type: text/plain' \
8
--data-raw '{
9
"skus": [
10
{
11
"code": "sku-001",
12
"qty": 200,
13
"cross_docking": 3
14
}
15
]
16
}'
Copied!
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
x-api-key
String
Required
Token da loja
SuaApiKey
x-accountmanager-key
String
Required
identificador da sua Integração
SUAXACCOUNT
Response:
207 - Multi-Status
1
{
2
"data": [
3
{
4
"code": "1523-1",
5
"status": 200
6
},
7
{
8
"code": "1523-2",
9
"status": 404,
10
"error": "Não foi possível encontrar a plataforma B2W"
11
},
12
{
13
"code": "1523-3",
14
"status": 404,
15
"error": "Não foi possível encontrar Sku: 1523-3"
16
},
17
{
18
"code": "1523-4",
19
"status": 422,
20
"errors": [
21
{
22
"attribute": "cross_docking",
23
"error_message": "deve ser maior ou igual a 0"
24
},
25
{
26
"attribute": "qty",
27
"error_message": "não é válido"
28
}
29
]
30
},
31
{
32
"code": "1523-5",
33
"status": 500,
34
"error": "Encontramos um erro inesperado, tente novamente mais tarde"
35
}
36
],
37
"metadata": {
38
"failures": 4,
39
"success": 1,
40
"total": 5
41
}
42
}
Copied!
400 - Bad Request
413 - Request entity too large
Last modified 19d ago