developer.skroutz.gr/source/localizable/smart_cart/index.html.md.erb at master · skroutz/developer.skroutz.gr · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
---
parent: smart_cart
title: overview
---

<%= partial 'partials/skroutz_experts_callout' %>

# Overview <%= edit_link %>

> <i class="fa fa-exclamation-triangle"></i>
> **Important update:** From 5/7/2021 onwards, more order state updates will be sent via Webhook requests. [Read more](/smart_cart/orders_webhook#webhook-events)

There are currently two tools for Merchants that can be used to integrate Smart Cart orders
into their existing system, the [Orders API](/smart_cart/orders_api) and
[Webhook Orders](/smart_cart/orders_webhook).

<%= partial 'partials/toc' %>

## Orders API

Orders API allows Skroutz Merchants to perform actions on their Smart Cart orders,
such as accepting or rejecting an order.

[Orders API documentation](/smart_cart/orders_api)

## Returns API

Returns API allows Skroutz Merchants to retrieve and manage their returns.

[Returns API documentation](/smart_cart/returns_api)

## Fulfilled by Skroutz API

Fulfilled by Skroutz API allows Skroutz Merchants to retrieve information about their
purchase orders and the items that are available in our warehouses after these orders,
as well as create new purchase orders. Moreover, a merchant may access their related Fullfilled by Skroutz suppliers and create new or update existing ones.

[Fulfilled by Skroutz API documentation](/smart_cart/fbs_api)

## Webhook Orders

Webhook Orders allows Skroutz Merchants to automatically receive order details to their
platform when a new Smart Cart order is placed or an existing one is updated.

[Webhook Orders documentation](/smart_cart/orders_webhook)

## Webhook Returns

Webhook Returns allows Skroutz Merchants to automatically receive return details to their
platform when a new return is created or an existing one is updated.

[Webhook Returns documentation](/smart_cart/returns_webhook)

## Use cases

Both [Webhook Orders](/smart_cart/orders_webhook) and [Orders API](/smart_cart/orders_api) can be enabled and
used separately. For a full orders integration though, it would require to implement both services,
since Webhook Orders can be utilized to get notified about new orders (or order updates) and the Orders
API can be used to interact with that orders later on.

An order coming through a Webhook event has a unique `code`. You can use this code to
perform the API requests for that specific order.

#### Rejecting orders

<pre>
— User places an order on Skroutz
→ [Webhook] Your website gets a "new_order" payload, including the available options to accept or reject the order
  — The stock of the product is checked, and there is limited stock for an item
  ← [Orders API] Your website issues a "reject" request, indicating the line item and the available stock
    — Skroutz reprocesses the order (your website could receive a new order for the available items)
</pre>

#### Accepting orders

<pre>
— User places an order on Skroutz
→ [Webhook] Your website gets a "new_order" payload, including the available options to accept or reject the order
  - The stock of the product is checked, and the order can be processed
  ← [Orders API] Your website issues an "accept" request to the to accept the order
    — Skroutz processes the order and creates the courier voucher
      → [Webhook] Your website gets an "order_updated" payload, including the courier voucher (PDF)
      — The courier voucher gets printed
</pre>