Nesta seção são apresentadas as orientações para a criação e atualização da warehouse, além de informações sobre a consulta de estoque por CD
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
Accept
application/json
Content-Type
application/json
X-Accountmanager-Key
token_account único de cada Plataforma/ERP
Authorization
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:
Atributo
Descrição
EXPEDITION
Incluir caso seja possível realizar a expedição de um pedido através do CD
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:
