Contrato Pickup
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: [email protected]' ' \-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 | |
x-api-key | String | Required | Token da loja | SuaApiKey |
x-accountmanager-key | String | Required | Código identificador da sua Integração | SUAXACCOUNT |
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.
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)
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: [email protected]'
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 | |
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": "[email protected]","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"