Contrato Pickup

Atualização de pedido:

Atualização do status "confirm_stock":

O "Pegue na Loja" possui um fluxo de confirmação do estoque quando é gerado um pedido. Neste fluxo a aprovação do pagamento só ocorre após o Seller ter confirmado o estoque na loja. Para ficar mais claro, o pedido nasce na B2W e é consumido pela Skyhub e a loja consome na fila de integração de pedidos

Posteriormente a B2W irá atualizar o status do pedido para aguardando confirmação de estoque, que é consumido pela Skyhub e a loja consome na fila de integração de pedidos.

Uma vez consumido, a loja deve atualizar para a Skyhub o status onde ele vai confirmar estoque (confirm_stock) e enviar a atualização para a Skyhub que irá enviar para a B2W.

Segue abaixo um exemplo de como este status é enviado para a SkyHub: Para efetuar a atualização será necessário efetuar o método POST na seguinte endpoint:

https://api.skyhub.com.br/orders/{code}/confirm_stock

Request Body:

{
"confirmed": true,
"reason": ""
}

Caso envie false, significa que a loja não possui estoque e o pedido será cancelado.

Example Request:

curl -X POST \
https://api.skyhub.com.br/orders/{code}/confirm_stock \
-H 'accept: application/json' \
-H 'content-type: application/json' \
-H 'x-api-key: SuaApiKey' \
-H 'x-accountmanager-key: SUAXACCOUNT' \
-H 'x-user-email: seu@email.com' ' \
-d '{
"confirmed": true,
"reason": ""
}

Request Headers:

Name

Type

Required

Description

Example

accept

String

Required

application/json

application/json

Content-type

String

Required

application/json

application/json

x-user-email

String

Required

E-mail da loja

seu@email.com

x-api-key

String

Required

Token da loja

SuaApiKey

x-accountmanager-key

String

Required

Código identificador da sua Integração

SUAXACCOUNT

Contrato PICKUP:

Neste contrato, quando o cliente estiver efetuando a compra, ao inserir o cep em alguma das lojas B2W (Americanas, Submarino ou Shoptime), será apresentado a warehouse mais próxima do cep do cliente, para que possa retirar o pedido.

Fluxo de atualização do pedido:

Caso o contrato seja PICKUP, após confirmar estoque e a B2W recebe-la, o pedido será atualizado para aprovado, que será consumido pela Skyhub e disponibilizado para a loja consumir na fila de integração de pedidos (queues).

Após este passo a loja deve atualizar o pedido para aguardando retirada na loja (process_store)

Atualização do status “process_store”:

Uma vez que o pedido for atualizado, o status deve ser enviado para a Skyhub, que atualizará a B2W. Para efetuar a atualização será necessário efetuar o método POST na seguinte endpoint:

https://api.skyhub.com.br/orders/{code}/process_store

Request Body:

{ "status": "processing_store" }

Example Request

curl -X POST \
https://api.skyhub.com.br/orders/{code}/process_store \
-H 'accept: application/json' \
-H 'content-type: application/json' \
-H 'x-api-key: SuaApiKey' \
-H 'x-accountmanager-key: SUAXACCOUNT' \
-H 'x-user-email: seu@email.com'

Request Headers

Name

Type

Required

Description

Example

accept

String

Required

application/json

application/json

Content-type

String

Required

application/json

application/json

x-user-email

String

Required

E-mail da loja

seu@email.com

x-api-key

String

Required

Token da loja

SuaApiKey

x-accountmanager-key

String

Required

Código identificador da sua Integração

SUAXACCOUNT

Após a atualização, a Skyhub irá receber e enviar para a B2W e enviar um e-mail ao cliente solicitando a retirada do pedido na loja. Uma vez que o pedido estiver aguardando retirada na loja, a loja deve atualizar para faturado.

Assim que o pedido for faturado e o status enviado para a Skyhub, a mesma enviará para a B2W que irá receber o status, desta forma, o pedido será atualizado para entregue. O Status entregue será consumido pela Skyhub que disponibilizará o pedido na fila de integração de pedidos (queues)

Segue a baixo um exemplo de Json de pedido PICKUP:

{
"placed_at": "2019-10-24T14:34:34-03:00",
"calculation_type": null,
"seller_shipping_cost": 0.0,
"status": {
"type": "DELIVERED",
"label": "Completo (entregue) (SkyHub)",
"code": "complete"
},
"shipping_estimate_id": "",
"shipped_date": "",
"tags": [],
"payments": [{
"value": 989.1,
"transaction_date": "2019-10-24T14:51:00-03:00",
"status": null,
"sefaz": {
"type_integration": "1",
"payment_indicator": "1",
"name_payment": "Cartão de Débito",
"name_card_issuer": "null",
"id_payment": "4",
"id_card_issuer": "null"
},
"parcels": 1,
"method": "DEBIT_CARD",
"description": "No valor de: 989.1",
"card_issuer": "null",
"autorization_id": "null"
}],
"import_info": {
"ss_name": "Lojas Americanas",
"remote_id": "02-5036653662",
"remote_code": "1503665366259"
},
"shipping_cost": 0.0,
"estimated_delivery_shift": null,
"billing_address": {
"street": "Rua Capitão Salomão",
"secondary_phone": "79 000000000",
"region": "SE",
"reference": null,
"postcode": "49000000",
"phone": "79 000000000",
"number": "150",
"neighborhood": "Jardim Serra Dourada",
"full_name": "Giceli",
"detail": "",
"country": "BR",
"complement": null,
"city": "Estancia"
},
"shipping_method": null,
"discount": 109.9,
"customer": {
"vat_number": "76860543817",
"phones": ["79 000000000", "79 000000000"],
"name": "Giceli",
"gender": "",
"email": "04119612503@email.com.br",
"date_of_birth": "1992-08-17"
},
"total_ordered": 989.1,
"shipping_address": {
"street": "Rua Capitão Salomão",
"secondary_phone": "79 000000000",
"region": "SE",
"reference": null,
"postcode": "49000000",
"phone": "79 999282948",
"number": "100",
"neighborhood": "Jardim Serra Dourada",
"full_name": "Giceli",
"detail": "",
"country": "BR",
"complement": null,
"city": "Estancia"
},
"exported_at": "2019-10-24T14:56:22-03:00",
"updated_at": "2019-10-24T14:51:26-03:00",
"sync_status": "SYNCED",
"delivered_date": "2019-10-24T15:18:03-03:00",
"items": [{
"special_price": 989.1,
"shipping_cost": 0.0,
"remote_store_id": null,
"qty": 1,
"product_id": "4283250",
"original_price": 1099.0,
"name": "MOTO G8 PLAY XT2015 32GB VERMELHO",
"id": "4283250",
"gift_wrap": null,
"detail": null
}],
"approved_date": "2019-10-24T17:55:37.473000",
"channel": "Lojas Americanas",
"pick_ups": [{
"store_code": "1066",
"items": [{
"qty": 1,
"product_id": "4283250",
"id": "4283250"
}],
"agent": {
"vat_number": "76860543817",
"name": "Giceli"
}
}],
"invoices": [{
"volume_qty": 1,
"number": "000011111",
"line": "001",
"key": "12345678901234567890123456789012345678901234",
"issue_date": "2019-10-24T15:18:03-03:00"
}],
"code": "Lojas Americanas-271271841201",
"interest": 0.0,
"delivery_contract_type": "PICKUP",
"estimated_delivery": "2019-10-24T00:00:00-03:00",
"shipping_carrier": "",
"shipments": [{
"tracks": [{
"url": null,
"method": null,
"code": "Não informado",
"carrier": null
}],
"items": [{
"sku": "4283250",
"qty": 1
}],
"code": "Não informado"
}, {
"tracks": [{
"url": null,
"method": null,
"code": null,
"carrier": "SPREADSHEET"
}],
"items": [{
"sku": "4283250",
"qty": 1
}],
"code": "Lojas Americanas-1503665366259"
}],
"imported_at": "2019-10-24T14:38:31-03:00"