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
[email protected]
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
[email protected]
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
Copied!
Importante saber que toda conta Americanas, já vem com uma Warehouse (CD) cadastrada por padrão de ID (store_code) "98", sendo assim, também é possível realizar a atualização em lote mesmo que a conta não tenha mais de uma Warehouse, porém não recomendamos tal ação, pois as informações de estoque e cross docking para o CD 98 são enviadas através da estrutura do produto. 

Uma vez que realizar a alteração de estoque em lote para o CD 98, quando houver uma atualização do produto, o estoque enviado em lote será sobreposto por aquele que consta na estrutura do item.  
​
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
[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
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

Serviço O2O - Previous

Warehouse (CD)

Next - Serviço O2O

Contrato Pickup

Last modified 5mo ago

Copy link

Contents

Como criar Estoque:

Como atualizar estoque?

Como criar/atualizar estoque em lote: