Criar e Consultar CD - Via API

Para a criação de CD (Ou Warehouse como alguns chamam) será necessário informar uma serie de informações como o código do CD, endereço , horário, telefone, etc, mas a baixo será possivel visualizar o body para ficar mais claro.
Como criar uma CD (Warehouse) via API:
Para criar um CD (Warehouse), será necessário utilizar o método POST e a seguinte endpoint:
1
https://api.skyhub.com.br/rehub/stores
Copied!
Request Body:
1
{
2
  "store": {
3
    "code": "loja1",
4
    "name": "Loja 1",
5
    "open_hours": "Seg-Sex: 09:00 às 20:30, Sáb: 09:00 às 18:00, Dom: 09:00 às 14:00",
6
    "phone": "(11) 3454-3258",
7
    "address": {
8
      "street": "R. Fidêncio Ramos",
9
      "number": "302",
10
      "detail": "2° andar",
11
      "neighborhood": "Vila Olímpia",
12
      "city": "São Paulo",
13
      "region": "SP",
14
      "post_code": 1233416,
15
      "reference": "Próximo ao Shopping Vila Olímpia"
16
    },
17
    "email": "[email protected]",
18
    "latitude": -23.594721,
19
    "longitude": -46.686015,
20
    "max_delivery_distance": 1.2,
21
    "schedules": {
22
      "monday": {
23
        "start": "08:00",
24
        "end": "16:00"
25
      },
26
      "tuesday": {
27
        "start": "08:00",
28
        "end": "16:00"
29
      },
30
      "wednesday": {
31
        "start": "08:00",
32
        "end": "16:00"
33
      },
34
      "thursday": {
35
        "start": "08:00",
36
        "end": "16:00"
37
      },
38
      "friday": {
39
        "start": "08:00",
40
        "end": "16:00"
41
      },
42
      "saturday": {
43
        "start": "08:00",
44
        "end": "12:00"
45
      },
46
      "sunday": {
47
        "start": null,
48
        "end": null
49
      }
50
    },
51
    "properties": [
52
      "CONFIRM_STOCK",
53
      "AME_FLASH"
54
    ]
55
  }
56
}
Copied!
Como podemos observar no body acima, pode criar algumas duvidas, por exemplo:
code: se refere ao código da warehouse.
name: nome da warehouse ou do ponto de retirada 
open_hours: Horário de funcionamento
properties: [CONFIRM_STOCK, AME_FLASH, EXPRESS_DELIVERY, EXPEDITION,PICK_UP_STORE] 
CONFIRM_STOCK:
 Confirma estoque? Sim ou Não
EXPEDITION:
 A loja expede? sim ou não
Neste caso o envio é feito pela loja.
EXPRESS_DELIVERY
A loja faz entrega expressa. A entrega será feita via motoboy, mas por conta da loja
AME_FLASH
A loja usa a forma de entrega Ame Flash. 
PICK_UP_STORE 
Referente ao contrato pickup (retire na loja).
Example Request:
1
curl --location --request POST 'https://api.skyhub.com.br/rehub/stores' \
2
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiR............................pXVCJy3ZagAECk' \
3
--header 'Content-type: application/json' \
4
--data-raw '{
5
  "store": {
6
    "code": "loja1",
7
    "name": "Loja 1",
8
    "open_hours": "Seg-Sex: 09:00 às 20:30, Sáb: 09:00 às 18:00, Dom: 09:00 às 14:00",
9
    "phone": "(11) 3454-3258",
10
    "address": {
11
      "street": "R. Fidêncio Ramos",
12
      "number": "302",
13
      "detail": "2° andar",
14
      "neighborhood": "Vila Olímpia",
15
      "city": "São Paulo",
16
      "region": "SP",
17
      "post_code": 1233416,
18
      "reference": "Próximo ao Shopping Vila Olímpia"
19
    },
20
    "email": "[email protected]",
21
    "latitude": -23.594721,
22
    "longitude": -46.686015,
23
    "max_delivery_distance": 1.2,
24
    "schedules": {
25
      "monday": {
26
        "start": "08:00",
27
        "end": "16:00"
28
      },
29
      "tuesday": {
30
        "start": "08:00",
31
        "end": "16:00"
32
      },
33
      "wednesday": {
34
        "start": "08:00",
35
        "end": "16:00"
36
      },
37
      "thursday": {
38
        "start": "08:00",
39
        "end": "16:00"
40
      },
41
      "friday": {
42
        "start": "08:00",
43
        "end": "16:00"
44
      },
45
      "saturday": {
46
        "start": "08:00",
47
        "end": "12:00"
48
      },
49
      "sunday": {
50
        "start": null,
51
        "end": null
52
      }
53
    },
54
    "properties": [
55
      "EXPEDITION",
56
      "AME_FLASH"
57
    ]
58
  }
59
}'
Copied!
AME_FLASH e EXPRESS_DELIVERY são referentes ao contrato SHIP_FROM_STORE
Não é possivel trabalhar com AME_FLASH e EXPRESS_DELIVERY simultaneamente. Será um ou outro.
Request Headers
Name
Type
Required
Description
Example
Content-type
String
Required
​
application/json
Authorization
String
Required
​
Bearer eyJhbGciOiJIUzI1NiR............................pXVCJy3ZagAECk
x-accountmanager-key
String
Required
Código identificador da sua Integração
SUAXACCOUNT
Responses:
201 - Created
400 - Bad request
Como Atualizar uma Warehouse:
Caso o cliente precise atualizar alguma informação é possível também após a criação. É importante também saber que depois de criar uma Warehouse, você precisará dizer se ela estará ATIVA (active) ou INATIVA (inactive) através do status, onde fará referência direta se o parceiro irá trabalhar com ela ou não. Para atualizar uma warehouse será necessário utilizar o método PUT e a seguinte endpoint:
1
https://api.skyhub.com.br/rehub/stores/{code}
Copied!
Request Body:
1
{
2
	"store": {
3
		"code": "775",
4
		"name": "nome da loja",
5
		"email": "[email protected]",
6
		"open_hours": "Dom: 16:00 às 22:00",
7
		"phone": "1100000000",
8
		"latitude": null,
9
		"longitude": null,
10
		"max_delivery_distance": 2.0,
11
		"address": {
12
			"street": "Rua",
13
			"number": "569",
14
			"detail": "Loja 151",
15
			"neighborhood": "Consolação",
16
			"city": "São Paulo",
17
			"region": "SP",
18
			"post_code": "00000000",
19
			"reference": null
20
		},
21
		"properties": [
22
			"PICK_UP_STORE",
23
			"CONFIRM_STOCK"
24
		],
25
		"store_status": [{
26
			"platform": "B2W",
27
			"status": "inactive",
28
			"remote_code": "775"
29
		}]
30
	}
31
}
Copied!
Example Request:
1
curl --location --request PUT 'https://api.skyhub.com.br/rehub/stores/{code}' \
2
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiR............................pXVCJy3ZagAECk' \
3
--header 'Content-type: application/json' \
4
--header 'accept: application/json' \
5
--data-raw '{
6
	"store": {
7
		"code": "775",
8
		"name": "nome da loja",
9
		"email": "[email protected]",
10
		"open_hours": "Dom: 16:00 às 22:00",
11
		"phone": "1100000000",
12
		"latitude": null,
13
		"longitude": null,
14
		"max_delivery_distance": 2.0,
15
		"address": {
16
			"street": "Rua",
17
			"number": "569",
18
			"detail": "Loja 151",
19
			"neighborhood": "Consolação",
20
			"city": "São Paulo",
21
			"region": "SP",
22
			"post_code": "00000000",
23
			"reference": null
24
		},
25
		"properties": [
26
			"PICK_UP_STORE",
27
			"CONFIRM_STOCK"
28
		]
29
	}
30
}'
Copied!
Como consultar um CD (Warehouse):
Nesta rota, será possível consultar todos os CDs (Warehouses) que a loja possui.
Para consultar os CDs, é necessário utilizar o método GET e a endpoint a baixo:
1
https://api.skyhub.com.br/rehub/stores
Copied!
Example Request:
1
curl --location --request GET 'https://api.skyhub.com.br/rehub/stores' \
2
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiR............................pXVCJy3ZagAECk' \
3
--header 'Content-type: application/json'
Copied!
Request Headers
Name
Type
Required
Description
Example
Content-type
String
Required
​
application/json
Authorization
String
Required
​
Bearer eyJhbGciOiJIUzI1NiR............................pXVCJy3ZagAECk
x-accountmanager-key
String
Required
Código identificador da sua Integração
SUAXACCOUNT
Responses:
200 - OK
1
{
2
  "store": {
3
    "name": "Loja 1",
4
    "open_hours": "Seg-Sex: 09:00 às 20:30, Sáb: 09:00 às 18:00, Dom: 09:00 às 14:00",
5
    "phone": "(11) 3454-3258",
6
    "address": {
7
      "street": "R. Fidêncio Ramos",
8
      "number": "302",
9
      "detail": "2° andar",
10
      "neighborhood": "Vila Olímpia",
11
      "city": "São Paulo",
12
      "region": "SP",
13
      "post_code": 1233416,
14
      "reference": "Próximo ao Shopping Vila Olímpia"
15
    },
16
    "email": "[email protected]",
17
    "latitude": -23.594721,
18
    "longitude": -46.686015,
19
    "max_delivery_distance": 1.2,
20
    "schedules": {
21
      "monday": {
22
        "start": "08:00",
23
        "end": "16:00"
24
      },
25
      "tuesday": {
26
        "start": "08:00",
27
        "end": "16:00"
28
      },
29
      "wednesday": {
30
        "start": "08:00",
31
        "end": "16:00"
32
      },
33
      "thursday": {
34
        "start": "08:00",
35
        "end": "16:00"
36
      },
37
      "friday": {
38
        "start": "08:00",
39
        "end": "16:00"
40
      },
41
      "saturday": {
42
        "start": "08:00",
43
        "end": "12:00"
44
      },
45
      "sunday": {
46
        "start": null,
47
        "end": null
48
      }
49
    },
50
    "properties": [
51
      "CONFIRM_STOCK"
52
    ]
53
  }
54
}
Copied!
Como consultar um CD (Warehouse) especifica:
Uma vez que a loja possui muitos CDs ou gostaria de verificar se ela foi cadastrada, é possível consultar especificamente, de acordo com o código que ela foi criada no campo "code".
Para efetuar a consulta é necessário utilizar o método GET e seguinte endpoint:
1
https://api.skyhub.com.br/rehub/stores/{code}
Copied!
Example Request:
1
curl --location --request GET 'https://api.skyhub.com.br/rehub/stores/{code}' \
2
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiR............................pXVCJy3ZagAECk' \
3
--header 'Content-type: application/json'
Copied!
Request Headers
Name
Type
Required
Description
Example
Content-type
String
Required
​
application/json
Authorization
String
Required
​
Bearer eyJhbGciOiJIUzI1NiR............................pXVCJy3ZagAECk
x-accountmanager-key
String
Required
Código identificador da sua Integração
SUAXACCOUNT
Responses:
200 - OK
1
{
2
  "store": {
3
    "name": "Loja 1",
4
    "open_hours": "Seg-Sex: 09:00 às 20:30, Sáb: 09:00 às 18:00, Dom: 09:00 às 14:00",
5
    "phone": "(11) 3454-3258",
6
    "address": {
7
      "street": "R. Fidêncio Ramos",
8
      "number": "302",
9
      "detail": "2° andar",
10
      "neighborhood": "Vila Olímpia",
11
      "city": "São Paulo",
12
      "region": "SP",
13
      "post_code": 1233416,
14
      "reference": "Próximo ao Shopping Vila Olímpia"
15
    },
16
    "email": "[email protected]",
17
    "latitude": -23.594721,
18
    "longitude": -46.686015,
19
    "max_delivery_distance": 1.2,
20
    "schedules": {
21
      "monday": {
22
        "start": "08:00",
23
        "end": "16:00"
24
      },
25
      "tuesday": {
26
        "start": "08:00",
27
        "end": "16:00"
28
      },
29
      "wednesday": {
30
        "start": "08:00",
31
        "end": "16:00"
32
      },
33
      "thursday": {
34
        "start": "08:00",
35
        "end": "16:00"
36
      },
37
      "friday": {
38
        "start": "08:00",
39
        "end": "16:00"
40
      },
41
      "saturday": {
42
        "start": "08:00",
43
        "end": "12:00"
44
      },
45
      "sunday": {
46
        "start": null,
47
        "end": null
48
      }
49
    },
50
    "properties": [
51
      "CONFIRM_STOCK"
52
    ]
53
  }
54
}'
Copied!
404 - Not Found
Status do CD (Warehouse):
Cada CD (Warehouse) criada pode ser ativada e inativada via API. Por exemplo: 
A loja não quer mais que o produto seja vendido por determinado CD, desta forma ele pode inativar.
Caso decida utilizar o CD (Warehouse) novamente, basta ativa-la.
Para que tanto a ativação quanto a inativação ocorram, é necessário utilizar o método POST e a seguinte Endpoint:
1
https://api.skyhub.com.br/rehub/stores/{code}/statuses
Copied!
No campo {code} será necessário informar o código do CD
Example body:
1
{
2
  "statuses": [
3
    {
4
      "platform": "B2W",
5
      "status": "active"
6
    }
7
  ]
8
}
Copied!
Os possíveis valores a serem informado em "status" é:
active: para ativar
inactive: para inativar
Example Request
1
curl --location --request POST 'https://api.skyhub.com.br/rehub/stores/{code}/statuses' \
2
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiR............................pXVCJy3ZagAECk' \
3
--header 'Content-type: application/json' \
4
--data-raw '{
5
  "statuses": [
6
    {
7
      "platform": "B2W",
8
      "status": "active"
9
    }
10
  ]
11
}'
Copied!
​⚠
Para deletar uma warehouse é necessário realizar tal ação diretamente no portal.
Request Headers
Name
Type
Required
Description
Example
Content-type
String
Required
​
application/json
Authorization
String
Required
​
Bearer eyJhbGciOiJIUzI1NiR............................pXVCJy3ZagAECk
x-accountmanager-key
String
Required
Código identificador da sua Integração
SUAXACCOUNT
204 - No content (success)
400 - Bad request
404 - Not found
422 - Unprocessable entity
Como consultar estoque por produto:
Para consultar o estoque de determinado sku, é necessário efetuar o método GET e a seguinte endpoint:
1
https://api.skyhub.com.br/rehub/products/{sku}/store_stocks
Copied!
Na consulta acima será listado o estoque de todas os CDs (Warehouses) do sku informado na endpoint.
Example Request:
1
curl --location --request GET 'https://api.skyhub.com.br/rehub/products/{sku}/store_stocks' \
2
--header 'Authorization: application/json' \
3
--header 'Content-type: Bearer eyJhbGciOiJIUzI1NiR............................pXVCJy3ZagAECk'
Copied!
Responses:
200 - OK
1
{
2
  "store_stocks": [
3
    {
4
      "store_code": "18",
5
      "sku_code": "sku-001",
6
      "qty": 200,
7
      "cross_docking": 3
8
    },
9
    {
10
      "store_code": "L001",
11
      "sku_code": "sku-001",
12
      "qty": 2,
13
      "cross_docking": 0
14
    },
15
    {
16
      "store_code": "998",
17
      "sku_code": "sku-001",
18
      "qty": 0,
19
      "cross_docking": 15
20
    }
21
  ]
22
}
Copied!
Como consultar estoque:
Para consultar o estoque de um determinado SKU em seus respectivos cds, é necessário utilizar o método GET e a seguinte endpoint.
1
https://api.skyhub.com.br/rehub/products/{sku}/store_stocks?store_code={store_code}
Copied!
Como é possível observar, será necessário incluir a query "store_code", que será, o código do CD.
 Example Request:
1
curl --location --request GET 'https://api.skyhub.com.br/rehub/products/{sku}/store_stocks?store_code={store_code}' \
2
--header 'Authorization: application/json' \
3
--header 'Content-type: Bearer eyJhbGciOiJIUzI1NiR............................pXVCJy3ZagAECk'
Copied!
Request Headers:
Name
Type
Required
Description
Example
Content-type
String
Required
​
application/json
Authorization
String
Required
​
Bearer eyJhbGciOiJIUzI1NiR............................pXVCJy3ZagAECk
x-accountmanager-key
String
Required
Código identificador da sua Integração
SUAXACCOUNT
Multi Origem - Previous
O que é? E como solicitar credenciais
Next - Multi Origem
Criação e Atualização de Estoque
Last modified 2d ago
Copy link
Contents
Como criar uma CD (Warehouse) via API:
Como Atualizar uma Warehouse:
Como consultar um CD (Warehouse):
Como consultar um CD (Warehouse) especifica:
Status do CD (Warehouse):
Como consultar estoque por produto:
Como consultar estoque: