Neste guia estão descritas as ações referentes ao Multi CD que dependem da rota rehub (ver seção Solicitar Credenciais). Para as requisições descritas nesta seção serão utilizados os headers disponibilizados a seguir:
Request headers:
Key
Value
POST - Criando uma warehouse (CD)
A criação de um CD será realizada através de um POST para o endpoint a seguir, utilizando os headers para a rota rehub descritos acima:
https://api.skyhub.com.br/rehub/stores
Request body:
{
"store": {
"code": "{store_code}", // Código/ID do CD
"name": "Nome do CD",
"open_hours": "Horário de funcionamento",
"phone": "1154664644",
"address": {
"street": "Rua/Avenida",
"number": "Número",
"detail": "Complemento",
"neighborhood": "Bairro",
"city": "Cidade",
"region": "Estado",
"post_code": CEP, // Int
"reference": "Referência"
},
"email": "emai@exemplo.com",
"latitude": -23.584195,
"longitude": -46.635511,
"max_delivery_distance": 2, // Distância máxima de entrega em km (de 0 a 2)
"schedules": { // Detalhes sobre o horário de funcionamento (definidos por dias da semana)
"monday": {
"start": "09:00",
"end": "18:00"
},
"tuesday": {
"start": "09:00",
"end": "18:00"
},
"wednesday": {
"start": "09:00",
"end": "18:00"
},
"thursday": {
"start": "09:00",
"end": "18:00"
},
"friday": {
"start": "09:00",
"end": "18:00"
},
"saturday": {
"start": null,
"end": null
},
"sunday": {
"start": null,
"end": null
}
},
"properties": [ // Propriedades do CD
""
]
}
}
Atributos da requisição:
É possível definir as características do CD através do array properties. Abaixo temos os possíveis valores a serem adicionados, caso façam parte das propriedades da warehouse:
Após criar um CD será preciso informar ao marketplace se ele está ativo (active) ou inativo (inactive). Para a definição do status da warehouse (CD) é necessário utilizar o método POST, contendo os headers da rota rehub, para o endpoint a seguir:
O campo store_code deverá ser substituído pelo código do CD, definido em sua criação.
Ao ser inativado, o CD não será mais disponibilizado para as vendas da loja até que haja uma ativação.
Request body:
{
"statuses": [
{
"platform": "B2W",
"status": "active" // active = ativa o CD / inactive = inativa o CD
}
]
}
Example Request
curl --location --request POST 'https://api.skyhub.com.br/rehub/stores/loja1/statuses' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'X-Accountmanager-Key: token_account único de cada Plataforma/ERP' \
--header 'Authorization: Bearer eyJhbGci...........Ckc0PW1g' \
--data '{
"statuses": [
{
"platform": "B2W",
"status": "active"
}
]
}'
Response esperado:
204 [Success] - No content
GET - Consultando as warehouses (CDs)
É possível realizar a consulta dos CDs criados via API através de uma requisição contendo o método GET, utilizando os headers descritos no início deste guia, para o endpoint:
https://api.skyhub.com.br/rehub/stores
Example request:
curl --location --request GET 'https://api.skyhub.com.br/rehub/stores' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'X-Accountmanager-Key: token_account único de cada Plataforma/ERP' \
--header 'Authorization: Bearer eyJhbGci...........Ckc0PW1g'
Response esperado:
200 [Success] - OK: O retorno seguirá o modelo visualizado a seguir, contendo uma listagem de todas as warehouses criadas via API:
Uma vez criado o CD é possível realizar alterações em sua estrutura ao executar o método PUT, utilizando os headers padronizados para a rota rehub - para o seguinte endpoint:
Além da consulta geral de estoque por SKU - que traz o estoque de todas as warehouses para o produto selecionado - também é possível filtrar o produto e o CD a serem visualizados.
Para realizar essa consulta basta efetuar uma requisição contendo o método GET, utilizando os headers descritos no início deste guia, para o endpoint:
