webhook.html.md.erb

---
parent: smart_cart
title: webhook
---

<%= partial 'partials/page_locales' %>

# Webhook <%= 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/webhook#webhook-events)

Smart Cart webhook 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.

You may find a high level overview of the service and descriptive guides for its activation in the
[merchant support guidelines](https://<%= settings.merchants_domain %>/merchants/support/guidelines/skroutz_marketplace_integration).

<%= partial 'partials/toc' %>

## Setup

In order to be able to use the webhook, a **webhook URL** should be registered
by the merchant from within
[Smart Cart settings](https://<%= settings.merchants_domain %>/merchants/account/shop/ecommerce_details)
page in merchant's panel (Merchants > Services > [Skroutz Marketplace](https://<%= settings.merchants_domain %>/merchants/account/shop/ecommerce_details)).

Webhook requests are sent to your specified URL from the following IP ranges:

**IPv4:**

* **185.6.76.0/22**
* **3.73.204.153/32**
* **3.72.204.195/32**
* **3.67.183.221/32**
* **63.34.193.172/32**
* **54.195.53.34/32**
* **108.129.50.199/32**

**IPv6:**

* **2a03:e40::/32**

Please ensure these IPs are whitelisted in your firewall or security tools to prevent webhook delivery failures.

> You can also access the IP ranges in [JSON format](/ip_ranges.json) for programmatic consumption.

> <i class="fa fa-exclamation-triangle"></i>
> The **webhook URL should match the shop's domain** and it should follow secure **HTTP (HTTPS)**

##### Webhook URL example

Shop URL | Webhook URL
-------- | ----------
`https://shop.gr` | `https://shop.gr/smart_cart_orders`

## Webhook requests

An HTTP `POST` request is sent to the predefined webhook URL once an event has been triggered.

### Handling failures / retries

Any failed request (including server timeouts or non -`200` responses) would be **retried automatically**
within the next 20 minutes. There is a retry limit of 4 requests in total for every order/event.

The merchant can also trigger sending (or retrying the latest) an **order webhook request** at any time from within
the order page.

The expected request payload would be the same in both scenarios.

### The anatomy of a request

##### Request
<pre class="terminal">
POST {webhook_url}
</pre>

##### Request headers

Header         | Value
-------------- | -----
`Content-Type` | `application/json; charset=utf-8`
`User-Agent`   | `Skroutz OrderNotifier v1`

##### Expected request response

<pre class="terminal">
200
</pre>

## Webhook events

The available webhook events for which a request is performed are:

* **new order** events
* **order update** events

### New order

A **new order** webhook request is triggered upon the placement of a new order.

### Order updates

An **order update** event is triggered upon the update of an order. As of right now, an update
event notification is sent for the following cases:

* When an order is **cancelled** (either by the user or our support team).
* When an order is **extended** (allowing more time to handle the order).
* When an order's courier voucher is **created** (for the associated shipment).
* **From 5/7/2021 onwards**: When an order's **state changes** to one of the following states `[:accepted, :rejected, :expired, :dispatched, :cancelled, :partially_returned, :returned]` (either by the user, our support team, or the merchant)

#### Request payload

Name           | Type   | Value | Description
-------------- | ------ | ----- | ------------------
`event_type`   | String | `new_order`, `order_updated`| Order event type
`event_time`   | Date String in format<br> `YYYY-MM-DDTHH:MM:SS+HH:M` | | Event creation time
`order`        | Object |            | [Order details](#order-object)
`changes` | Object |  | [Order changes with old and new values (optional)](#order-changes-object)

#### Order changes object

Name           | Type   | Value | Description
-------------- | ------ | ----- | -------------
`state` | Object | `{ "old": "open", "new": "cancelled" }` | The state changed values (optional)
`expires_at` | Object | `{ "old": "2019-11-02T13:15:43+02:00", "new": "2019-11-04T13:15:00+02:00" }` | The order's current expiration time changes (optional)
`dispatch_until` | Object | `{ "old": "2019-11-03T12:00:00+02:00", "new": "2019-11-04T18:00:00+02:00" }` | The order's current time until dispatching changes (optional)
`courier` | Object | `{ "old": "Skroutz Last Mile", "new": "ACS" }` | The order's shipment serving courier changes (optional)
`courier_voucher` | Object | `{ "old": null, "new": "https://b.scdn.gr/path-to/voucher.pdf" }` | The order's shipment courier voucher URL (optional)
`courier_tracking_codes` | Object | `{ "old": [], "new": ["123456789"] }` | The order's shipment courier tracking codes (optional)
`fbs_delivery_note` | Object | `{ "old": null, "new": "ΤΛΑΠΟ0454022" }` | The order's fulfilled by Skroutz warehouse delivery note (optional)
`fbs_delivery_note_url` | Object | `{ "old": null, "new": "https://b.scdn.gr/path-to/fbs_delivery_note.pdf" }` | The order's fulfilled by Skroutz warehouse digital delivery note PDF url (optional)
`pickup_window` | Object | `{ "old": null, "new: { from: "2019-11-02T15:00:00+02:00", "to": "2019-11-02T16:00:00+02:00" } }` | The order's shipment pickup window (optional). It is sent when the order is accepted.
`number_of_parcels` | Integer | `{ "old": null, "new": 2 }` | The order's shipment number of parcels (optional). It is sent when the order is accepted.
`pickup_address` | String | `{ "old": null, "new": "Πανεπιστημίου 2, Τ.Κ. 12345, Αθήνα, Αττική" }` | The order's pickup address (optional).

> The order object included in webhook payload is the sames as the one when
> retrieving a single order via the [orders API](/smart_cart/orders_api).

> Field behavior notes:
> - `invoice_document` is always present with one of: `receipt`, `invoice`, `invoice_39a`, `invoice_vies`
> - `fees` is always present as an object (`{}` when no fees apply)
> - Fee sub-fields are present only when their values are positive
> - `replacements` and `replaced` are omitted entirely when not applicable

<%= partial 'localizable/smart_cart/order_object' %>

## Test requests (sandbox)

For [demo orders](/smart_cart/orders_api/#test-requests-sandbox), separate **API endpoints** are available to **trigger different
kinds of Webhook requests** for testing. In the following examples, `:code` should be replaced with one of the following values:

- `DEMO-OPEN`
- `DEMO-ACCEPTED`
- `DEMO-REJECTED`
- `DEMO-INVOICE`
- `DEMO-INVOICE39A`
- `DEMO-FBS`
- `DEMO-FBS-DISPATCHED`
- `DEMO-STORE-PICKUP`
- `DEMO-FEES`
- `DEMO-REPLACEMENT`
- `DEMO-REPLACED`
- `DEMO-INVOICE-VIES`

An order creation or order update event should be received at the webhook url of the shop, depending on the request action.
Sending any of the following requests should request in a successful response (`200 OK`):

<pre class="terminal">
  {
    "success": true
  }
</pre>


> Note: Demo webhook requests are not executed instantly, so they may take from a few seconds up to a few minutes to be processed and sent.
> After getting a successful response (200 OK), you would just have to wait a bit, before trying another one.
> All requests will be sent to the live Webhook URL that is already set-up in the Merchants panel for your shop.

#### New order

This sends a Webhook request payload just like if the order is new, with `"event_type": "new_order"`.

<pre class="terminal">
  POST /merchants/ecommerce/orders/:code/trigger_webhook_request/creation
</pre>

#### Courier voucher issued

This sends a Webhook request payload just like if the order was updated with a PDF voucher
file, with `"event_type": “order_updated”`.

<pre class="terminal">
  POST /merchants/ecommerce/orders/:code/trigger_webhook_request/voucher_update
</pre>

#### Order extended

This sends a Webhook request payload just like if the order acceptance period was extended by Skroutz support,
with `"event_type": “order_updated”`.

<pre class="terminal">
  POST /merchants/ecommerce/orders/:code/trigger_webhook_request/extension
</pre>

#### Order cancelled

Would send a Webhook request payload just like if the order was cancelled by the user, with
`"event_type": “order_updated”`.

<pre class="terminal">
  POST /merchants/ecommerce/orders/:code/trigger_webhook_request/cancellation
</pre>

## Payload Examples

#### Example 1

~~~ json
{
  "event_type": "new_order",
  "event_time": "2019-11-28T13:24:37+02:00",
  "order": {
    "code": "191029-5130474",
    "state": "open",
    "customer": {
      "id": "PA4oqvpz8x",
      "first_name": "John",
      "last_name": "Doe",
      "address":{
        "street_name":"Πανεπιστημίου",
        "street_number":"4",
        "zip":"12345",
        "city":"Αθήνα",
        "region":"Αττικής",
        "country_code": "GR",
        "pickup_from_collection_point": false
      }
    },
    "invoice": false,
    "uploaded_invoice_file": null,
    "comments": "Παράδοση στο γραφείο",
    "courier": "ACS",
    "courier_voucher": null,
    "courier_tracking_codes": [],
    "line_items": [
      {
        "id": "l39vKqxqwe",
        "shop_uid": "100",
        "product_name": "L'Oreal Professionel Salon Steam Pod V2 White",
        "quantity": 2,
        "unit_price": 10.40,
        "total_price": 20.80,
        "price_includes_vat": true,
        "commission": 1.73,
        "commission_rate": 8.34,
        "island_vat_discount_applied": false,
        "ean": "1234567890123",
        "mpn": "JA-1059",
        "serial_numbers": null,
        "tags": ["plus_deal", "coupon_deal", "two_plus_deal", "price_optimizer", "cc_installments"]
      },
      {
        "id": "l39vKqxqh2",
        "shop_uid": "10",
        "product_name": "Paul Mitchell Ultimate Color Repair 200ml",
        "quantity": 1,
        "unit_price": 25,
        "total_price": 25,
        "price_includes_vat": true,
        "commission": 2.32,
        "commission_rate": 9.28,
        "island_vat_discount_applied": false,
        "serial_numbers": null
      }
    ],
    "created_at": "2019-11-28T13:24:37+02:00",
    "expires_at": "2019-12-04T10:24:00+02:00",
    "dispatch_until": "2019-12-04T18:00:00+02:00",
    "express": false,
    "gift_wrap": false,
    "fulfilled_by_skroutz": false,
    "store_pickup": false,
    "commission": 4.05,
    "fbs_delivery_note": null,
    "fbs_delivery_note_url": null,
    "paid_by_user": true,
    "payment_method": "card",
    "accept_options": {
      "number_of_parcels": [
        1
      ],
      "pickup_location": [
        {
          "id": "YlpD0KROym",
          "label": "Πανεπιστημίου 2, Τ.Κ. 12345, Αθήνα, Αττική"
        },
        {
          "id": "onpL6DXG4l",
          "label": "Σταδίου 1, Τ.Κ. 12345, Αθήνα, Αττική"
        },
        {
          "id": "wgO1N22OaQ",
          "label": "Κρήτης 50, Τ.Κ. 73100, Χανιά, Χανιά"
        }
      ],
      "pickup_window": [
        {
          "id": 1,
          "label": "15:00 - 18:00, Τρί 03/12/19"
        },
        {
          "id": 2,
          "label": "10:00 - 12:00, Τετ 04/12/19"
        },
        {
          "id": 3,
          "label": "12:00 - 15:00, Τετ 04/12/19"
        },
        {
          "id": 4,
          "label": "15:00 - 18:00, Τετ 04/12/19"
        }
      ]
    },
    "reject_options": {
      "line_item_rejection_reasons": [
        {
          "id": 1,
          "label": "Εκτός αποθέματος στο κατάστημα ή στον προμηθευτή",
          "requires_available_quantity": false
        },
        {
          "id": 2,
          "label": "Λάθος καταχωρημένη τιμή(ες)",
          "requires_available_quantity": false
        },
        {
          "id": 4,
          "label": "Περιορισμένα τεμάχια",
          "requires_available_quantity": true
        },
        {
          "id": 5,
          "label": "To προϊόν καταργήθηκε",
          "requires_available_quantity": false
        }
      ]
    }
  }
}
~~~

#### Example 2 (with size-related fields)

~~~ json
{
  "event_type": "new_order",
  "event_time": "2019-11-28T13:24:37+02:00",
  "order": {
    "code": "191025-0111363",
    "state": "open",
    "customer": {
      "id": "PA4oqvpz8x",
      "first_name": "John",
      "last_name": "Doe",
      "address":{
        "street_name":"Πανεπιστημίου",
        "street_number":"4",
        "zip":"12345",
        "city":"Αθήνα",
        "region":"Αττικής",
        "country_code": "GR",
        "pickup_from_collection_point": false
      }
    },
    "invoice": false,
    "uploaded_invoice_file": null,
    "comments": "",
    "courier": "ACS",
    "courier_voucher": null,
    "courier_tracking_codes": [],
    "line_items": [
      {
        "id": "l39vKqzp2a",
        "shop_uid": "405753",
        "shop_variation_uid": "40575312-14",
        "product_name": "adidas Perormance Badge of Sport Swimsuit PS/GS ( DQ3375 )",
        "quantity": 2,
        "size": {
            "label": "Ηλικία",
            "value": "14 χρονών",
            "shop_value": "12-14",
            "shop_variation_uid": "40575312-14",
            "ean": "1234567890321",
            "mpn": "JA-1059"
        },
        "unit_price": 17.99,
        "total_price": 35.98,
        "price_includes_vat": true,
        "commission": 3.00,
        "commission_rate": 8.34,
        "island_vat_discount_applied": false,
        "ean": "1234567890123",
        "mpn": "JA-1059",
        "serial_numbers": null
      },
      {
        "id": "l39vKqzpll",
        "shop_uid": "10",
        "product_name": "Paul Mitchell Ultimate Color Repair 200ml",
        "quantity": 1,
        "unit_price": 25,
        "total_price": 25,
        "price_includes_vat": true,
        "commission": 2.32,
        "commission_rate": 9.28,
        "island_vat_discount_applied": false,
        "serial_numbers": null
      }
    ],
    "created_at": "2019-11-28T13:24:37+02:00",
    "expires_at": "2019-12-04T10:24:00+02:00",
    "dispatch_until": "2019-12-04T18:00:00+02:00",
    "express": false,
    "gift_wrap": false,
    "fulfilled_by_skroutz": false,
    "store_pickup": false,
    "commission": 5.32,
    "fbs_delivery_note": null,
    "fbs_delivery_note_url": null,
    "paid_by_user": true,
    "payment_method": "card",
    "accept_options": {
      "number_of_parcels": [
        1
      ],
      "pickup_location": [
        {
          "id": "YlpD0KROym",
          "label": "Πανεπιστημίου 2, Τ.Κ. 12345, Αθήνα, Αττική"
        },
        {
          "id": "onpL6DXG4l",
          "label": "Σταδίου 1, Τ.Κ. 12345, Αθήνα, Αττική"
        },
        {
          "id": "wgO1N22OaQ",
          "label": "Κρήτης 50, Τ.Κ. 73100, Χανιά, Χανιά"
        }
      ],
      "pickup_window": [
        {
          "id": 1,
          "label": "15:00 - 18:00, Τρί 03/12/19"
        },
        {
          "id": 2,
          "label": "10:00 - 12:00, Τετ 04/12/19"
        },
        {
          "id": 3,
          "label": "12:00 - 15:00, Τετ 04/12/19"
        },
        {
          "id": 4,
          "label": "15:00 - 18:00, Τετ 04/12/19"
        }
      ]
    },
    "reject_options": {
      "line_item_rejection_reasons": [
        {
          "id": 1,
          "label": "Εκτός αποθέματος στο κατάστημα ή στον προμηθευτή",
          "requires_available_quantity": false
        },
        {
          "id": 2,
          "label": "Λάθος καταχωρημένη τιμή(ες)",
          "requires_available_quantity": false
        },
        {
          "id": 4,
          "label": "Περιορισμένα τεμάχια",
          "requires_available_quantity": true
        },
        {
          "id": 5,
          "label": "To προϊόν καταργήθηκε",
          "requires_available_quantity": false
        }
      ]
    }
  }
}
~~~

#### Example 3 (cancellation)

~~~ json
{
  "event_type": "order_updated",
  "event_time": "2019-10-29T10:39:23+02:00",
  "order": {
    "code": "191029-5130474",
    "state": "cancelled",
    "customer": {
      "id": "PA4oqvpz8x",
      "first_name": "John",
      "last_name": "Doe",
      "address":{
        "street_name":"Πανεπιστημίου",
        "street_number":"4",
        "zip":"12345",
        "city":"Αθήνα",
        "region":"Αττικής",
        "country_code": "GR",
        "pickup_from_collection_point": false
      }
    },
    "invoice": false,
    "uploaded_invoice_file": null,
    "comments": "Παράδοση στο γραφείο",
    "courier": "ACS",
    "courier_voucher": null,
    "courier_tracking_codes": [],
    "line_items": [
      {
        "id": "l39vKqwezt",
        "shop_uid": "100",
        "product_name": "L'Oreal Professionel Salon Steam Pod V2 White",
        "quantity": 2,
        "unit_price": 10.40,
        "total_price": 20.80,
        "price_includes_vat": true,
        "commission": 1.73,
        "commission_rate": 8.34,
        "island_vat_discount_applied": false,
        "ean": "1234567890123",
        "mpn": "JA-1059",
        "serial_numbers": null
      },
      {
        "id": "l39vKqzpll",
        "shop_uid": "10",
        "product_name": "Paul Mitchell Ultimate Color Repair 200ml",
        "quantity": 1,
        "unit_price": 25,
        "total_price": 25,
        "price_includes_vat": true,
        "commission": 2.32,
        "commission_rate": 9.28,
        "island_vat_discount_applied": false,
        "serial_numbers": null
      }
    ],
    "created_at": "2019-10-29T10:39:23+02:00",
    "expires_at": "2019-10-29T16:39:23+02:00",
    "dispatch_until": "2019-10-30T15:00:00+02:00"
    "express": false,
    "gift_wrap": false,
    "fulfilled_by_skroutz": false,
    "store_pickup": false,
    "commission": 4.05,
    "fbs_delivery_note": null,
    "fbs_delivery_note_url": null,
    "paid_by_user": true,
    "payment_method": "Card"
  },
  "changes": {
    "state": {
      "old": "open",
      "new": "cancelled"
    }
  }
}
~~~

#### Example 4 (extension)

~~~ json
{
  "event_type": "order_updated",
  "event_time": "2019-10-29T10:39:23+02:00",
  "order": {
    "code": "191029-5130474",
    "state": "open",
    "customer": {
      "id": "PA4oqvpz8x",
      "first_name": "John",
      "last_name": "Doe",
      "address":{
        "street_name":"Πανεπιστημίου",
        "street_number":"4",
        "zip":"12345",
        "city":"Αθήνα",
        "region":"Αττικής",
        "country_code": "GR",
        "pickup_from_collection_point": false
      }
    },
    "invoice": false,
    "uploaded_invoice_file": null,
    "comments": "Παράδοση στο γραφείο",
    "express": false,
    "gift_wrap": false,
    "fulfilled_by_skroutz": false,
    "store_pickup": false,
    "fbs_delivery_note": null,
    "fbs_delivery_note_url": null,
    "courier": "ACS",
    "courier_voucher": null,
    "courier_tracking_codes": [],
    "line_items": [
      {
        "id": "qw3rtyab34",
        "shop_uid": "100",
        "product_name": "L'Oreal Professionel Salon Steam Pod V2 White",
        "quantity": 2,
        "unit_price": 10.40,
        "total_price": 20.80,
        "price_includes_vat": true,
        "commission": 1.73,
        "commission_rate": 8.34,
        "island_vat_discount_applied": false,
        "ean": "1234567890123",
        "mpn": "JA-1059",
        "serial_numbers": null
      },
      {
        "id": "l39vKqzpll",
        "shop_uid": "10",
        "product_name": "Paul Mitchell Ultimate Color Repair 200ml",
        "quantity": 1,
        "unit_price": 25,
        "total_price": 25,
        "price_includes_vat": true,
        "commission": 2.32,
        "commission_rate": 9.28,
        "island_vat_discount_applied": false,
        "serial_numbers": null
      }
    ],
    "created_at": "2019-10-29T10:39:23+02:00",
    "expires_at": "2019-10-29T16:39:23+02:00",
    "dispatch_until": "2019-10-30T15:00:00+02:00",
    "express": false,
    "gift_wrap": false,
    "fulfilled_by_skroutz": false,
    "store_pickup": false,
    "commission": 4.05,
    "fbs_delivery_note": null,
    "fbs_delivery_note_url": null,
    "paid_by_user": true,
    "payment_method": "card",
    "accept_options": {
      "number_of_parcels": [
        1
      ],
      "pickup_location": [
        {
          "id": "YlpD0KROym",
          "label": "Πανεπιστημίου 2, Τ.Κ. 12345, Αθήνα, Αττική"
        },
        {
          "id": "onpL6DXG4l",
          "label": "Σταδίου 1, Τ.Κ. 12345, Αθήνα, Αττική"
        },
        {
          "id": "wgO1N22OaQ",
          "label": "Κρήτης 50, Τ.Κ. 73100, Χανιά, Χανιά"
        }
      ],
      "pickup_window": [
        {
          "id": 1,
          "label": "15:00 - 18:00, Τρί 30/10/19"
        },
        {
          "id": 2,
          "label": "10:00 - 12:00, Τετ 31/10/19"
        },
        {
          "id": 3,
          "label": "12:00 - 15:00, Τετ 31/10/19"
        },
        {
          "id": 4,
          "label": "15:00 - 18:00, Τετ 31/10/19"
        }
      ]
    },
    "reject_options": {
      "line_item_rejection_reasons": [
        {
          "id": 1,
          "label": "Εκτός αποθέματος στο κατάστημα ή στον προμηθευτή",
          "requires_available_quantity": false
        },
        {
          "id": 2,
          "label": "Λάθος καταχωρημένη τιμή(ες)",
          "requires_available_quantity": false
        },
        {
          "id": 4,
          "label": "Περιορισμένα τεμάχια",
          "requires_available_quantity": true
        },
        {
          "id": 5,
          "label": "To προϊόν καταργήθηκε",
          "requires_available_quantity": false
        }
      ]
    }
  },
  "changes": {
    "expires_at": {
      "old": "2019-11-02T13:15:43+02:00",
      "new": "2019-11-04T13:15:00+02:00"
    },
    "dispatch_until": {
      "old": "2019-11-03T12:00:00+02:00",
      "new": "2019-11-04T18:00:00+02:00"
    }
  }
}
~~~

#### Example 5 (courier voucher creation)

~~~ json
{
  "event_type": "order_updated",
  "event_time": "2019-10-29T10:39:23+02:00",
  "order": {
    "code": "191029-5130474",
    "state": "accepted",
    "customer": {
      "id": "PA4oqvpz8x",
      "first_name": "John",
      "last_name": "Doe",
      "address":{
        "street_name":"Πανεπιστημίου",
        "street_number":"4",
        "zip":"12345",
        "city":"Αθήνα",
        "region":"Αττικής",
        "country_code": "GR",
        "pickup_from_collection_point": false
      }
    },
    "invoice": false,
    "uploaded_invoice_file": null,
    "comments": "Παράδοση στο γραφείο",
    "courier": "ACS",
    "courier_voucher": "https://b.scdn.gr/path-to/voucher.pdf",
    "courier_tracking_codes": ["123456789"],
    "line_items": [
      {
        "id": "l39vpqzZ1l",
        "shop_uid": "100",
        "product_name": "L'Oreal Professionel Salon Steam Pod V2 White",
        "quantity": 2,
        "unit_price": 10.40,
        "total_price": 20.80,
        "price_includes_vat": true,
        "commission": 1.73,
        "commission_rate": 8.34,
        "island_vat_discount_applied": false,
        "ean": "1234567890123",
        "mpn": "JA-1059",
        "serial_numbers": null
      },
      {
        "id": "l39vKqzpll",
        "shop_uid": "10",
        "product_name": "Paul Mitchell Ultimate Color Repair 200ml",
        "quantity": 1,
        "unit_price": 25,
        "total_price": 25,
        "price_includes_vat": true,
        "commission": 2.32,
        "commission_rate": 9.28,
        "island_vat_discount_applied": false,
        "serial_numbers": null
      }
    ],
    "created_at": "2019-10-29T10:39:23+02:00",
    "expires_at": "2019-10-29T16:39:23+02:00",
    "dispatch_until": "2019-10-30T15:00:00+02:00",
    "express": false,
    "gift_wrap": false,
    "fulfilled_by_skroutz": false,
    "store_pickup": false,
    "commission": 4.05,
    "fbs_delivery_note": null,
    "fbs_delivery_note_url": null,
    "paid_by_user": true,
    "payment_method": "card",
    "pickup_window": { from: "2019-11-02T15:00:00+02:00", "to": "2019-11-02T16:00:00+02:00" },
    "number_of_parcels": 1,
    "pickup_address": "Πανεπιστημίου 2, Τ.Κ. 12345, Αθήνα, Αττική"
  },
  "changes": {
    "courier_voucher": {
      "old": null,
      "new": "https://b.scdn.gr/path-to/voucher.pdf"
    },
    "courier_tracking_codes": {
      "old": [],
      "new": ["123456789"]
    }
  }
}
~~~

#### Example 6 (invoice requested, without VAT exclusion)

~~~ json
{
  "event_type": "new_order",
  "event_time": "2019-11-28T13:24:37+02:00",
  "order": {
    "code": "191029-5130474",
    "state": "open",
    "customer": {
      "id": "PA4oqvpz8x",
      "first_name": "John",
      "last_name": "Doe",
      "address":{
        "street_name":"Πανεπιστημίου",
        "street_number":"4",
        "zip":"12345",
        "city":"Αθήνα",
        "region":"Αττικής",
        "country_code": "GR",
        "pickup_from_collection_point": false
      }
    },
    "invoice": true,
    "uploaded_invoice_file": null,
    "invoice_details": {
      "company":"ACME",
      "profession":"Internet Services",
      "vat_number":"111119191",
      "doy":"ΙΒ Αθηνών",
      "address": {
        "street_name":"Πανεπιστημίου",
        "street_number":"4",
        "zip":"12345",
        "city":"Αθήνα",
        "region":"Αττικής"
      },
      "vat_exclusion_requested":false
    },
    "comments": "Παράδοση στο γραφείο",
    "express": false,
    "gift_wrap": false,
    "fulfilled_by_skroutz": false,
    "store_pickup": false,
    "fbs_delivery_note": null,
    "fbs_delivery_note_url": null,
    "courier": "ACS",
    "courier_voucher": null,
    "courier_tracking_codes": [],
    "line_items": [
      {
        "id": "l39vKqxqwe",
        "shop_uid": "100",
        "product_name": "L'Oreal Professionel Salon Steam Pod V2 White",
        "quantity": 2,
        "unit_price": 10.40,
        "total_price": 20.80,
        "price_includes_vat": true,
        "commission": 1.73,
        "commission_rate": 8.34,
        "island_vat_discount_applied": false,
        "ean": "1234567890123",
        "mpn": "JA-1059",
        "serial_numbers": null
      },
      {
        "id": "l39vKqxqh2",
        "shop_uid": "10",
        "product_name": "Paul Mitchell Ultimate Color Repair 200ml",
        "quantity": 1,
        "unit_price": 25,
        "total_price": 25,
        "price_includes_vat": true,
        "commission": 2.32,
        "commission_rate": 9.28,
        "island_vat_discount_applied": false,
        "serial_numbers": null
      }
    ],
    "created_at": "2019-11-28T13:24:37+02:00",
    "expires_at": "2019-12-04T10:24:00+02:00",
    "dispatch_until": "2019-12-04T18:00:00+02:00",
    "express": false,
    "gift_wrap": false,
    "fulfilled_by_skroutz": false,
    "store_pickup": false,
    "commission": 4.05,
    "fbs_delivery_note": null,
    "fbs_delivery_note_url": null,
    "paid_by_user": true,
    "payment_method": "card",
    "accept_options": {
      "number_of_parcels": [
        1
      ],
      "pickup_location": [
        {
          "id": "YlpD0KROym",
          "label": "Πανεπιστημίου 2, Τ.Κ. 12345, Αθήνα, Αττική"
        },
        {
          "id": "onpL6DXG4l",
          "label": "Σταδίου 1, Τ.Κ. 12345, Αθήνα, Αττική"
        },
        {
          "id": "wgO1N22OaQ",
          "label": "Κρήτης 50, Τ.Κ. 73100, Χανιά, Χανιά"
        }
      ],
      "pickup_window": [
        {
          "id": 1,
          "label": "15:00 - 18:00, Τρί 03/12/19"
        },
        {
          "id": 2,
          "label": "10:00 - 12:00, Τετ 04/12/19"
        },
        {
          "id": 3,
          "label": "12:00 - 15:00, Τετ 04/12/19"
        },
        {
          "id": 4,
          "label": "15:00 - 18:00, Τετ 04/12/19"
        }
      ]
    },
    "reject_options": {
      "line_item_rejection_reasons": [
        {
          "id": 1,
          "label": "Εκτός αποθέματος στο κατάστημα ή στον προμηθευτή",
          "requires_available_quantity": false
        },
        {
          "id": 2,
          "label": "Λάθος καταχωρημένη τιμή(ες)",
          "requires_available_quantity": false
        },
        {
          "id": 4,
          "label": "Περιορισμένα τεμάχια",
          "requires_available_quantity": true
        },
        {
          "id": 5,
          "label": "To προϊόν καταργήθηκε",
          "requires_available_quantity": false
        }
      ]
    }
  }
}
~~~

#### Example 7 (invoice requested, with VAT exclusion)

~~~ json
{
  "event_type": "new_order",
  "event_time": "2019-11-28T13:24:37+02:00",
  "order": {
    "code": "191029-5130474",
    "state": "open",
    "customer": {
      "id": "PA4oqvpz8x",
      "first_name": "John",
      "last_name": "Doe",
      "phone": "2109999999",
      "mobile": "(+30) 6999999999",
      "address":{
        "street_name":"Πανεπιστημίου",
        "street_number":"4",
        "zip":"12345",
        "city":"Αθήνα",
        "region":"Αττικής",
        "country_code": "GR",
        "pickup_from_collection_point": false
      }
    },
    "invoice": true,
    "uploaded_invoice_file": null,
    "invoice_details": {
      "company":"ACME",
      "profession":"Internet Services",
      "vat_number":"111119191",
      "doy":"ΙΒ Αθηνών",
      "address": {
        "street_name":"Πανεπιστημίου",
        "street_number":"4",
        "zip":"12345",
        "city":"Αθήνα",
        "region":"Αττικής"
      },
      "vat_exclusion_requested":true,
      "vat_exclusion_verification_method":"service",
      "vat_exclusion_representative": {
        "id_type":"ΑΤ Αστυνομική Ταυτότητα",
        "id_number":"12345",
        "otp":"123456",
        "mobile": "(+30) 6999999999"
      }
    },
    "comments": "Παράδοση στο γραφείο",
    "courier": "ACS",
    "courier_voucher": null,
    "courier_tracking_codes": [],
    "line_items": [
      {
        "id": "l39vKqxqwe",
        "shop_uid": "100",
        "product_name": "Smartphone 123",
        "quantity": 2,
        "unit_price": 100,
        "total_price": 200,
        "price_includes_vat": false,
        "commission": 16.68,
        "commission_rate": 8.34,
        "island_vat_discount_applied": false,
        "ean": "1234567890123",
        "mpn": "JA-1059",
        "serial_numbers": null
      },
      {
        "id": "l39vKqxqh2",
        "shop_uid": "10",
        "product_name": "Smartphone case Silver",
        "quantity": 1,
        "unit_price": 25,
        "total_price": 25,
        "price_includes_vat": true,
        "commission": 2.32,
        "commission_rate": 9.28,
        "island_vat_discount_applied": false,
        "serial_numbers": null
      }
    ],
    "created_at": "2019-11-28T13:24:37+02:00",
    "expires_at": "2019-12-04T10:24:00+02:00",
    "dispatch_until": "2019-12-04T18:00:00+02:00",
    "express": false,
    "gift_wrap": false,
    "fulfilled_by_skroutz": false,
    "store_pickup": false,
    "commission": 19.00,
    "fbs_delivery_note": null,
    "fbs_delivery_note_url": null,
    "paid_by_user": true,
    "payment_method": "card",
    "accept_options": {
      "number_of_parcels": [
        1
      ],
      "pickup_location": [
        {
          "id": "YlpD0KROym",
          "label": "Πανεπιστημίου 2, Τ.Κ. 12345, Αθήνα, Αττική"
        },
        {
          "id": "onpL6DXG4l",
          "label": "Σταδίου 1, Τ.Κ. 12345, Αθήνα, Αττική"
        },
        {
          "id": "wgO1N22OaQ",
          "label": "Κρήτης 50, Τ.Κ. 73100, Χανιά, Χανιά"
        }
      ],
      "pickup_window": [
        {
          "id": 1,
          "label": "15:00 - 18:00, Τρί 03/12/19"
        },
        {
          "id": 2,
          "label": "10:00 - 12:00, Τετ 04/12/19"
        },
        {
          "id": 3,
          "label": "12:00 - 15:00, Τετ 04/12/19"
        },
        {
          "id": 4,
          "label": "15:00 - 18:00, Τετ 04/12/19"
        }
      ]
    },
    "reject_options": {
      "line_item_rejection_reasons": [
        {
          "id": 1,
          "label": "Εκτός αποθέματος στο κατάστημα ή στον προμηθευτή",
          "requires_available_quantity": false
        },
        {
          "id": 2,
          "label": "Λάθος καταχωρημένη τιμή(ες)",
          "requires_available_quantity": false
        },
        {
          "id": 4,
          "label": "Περιορισμένα τεμάχια",
          "requires_available_quantity": true
        },
        {
          "id": 5,
          "label": "To προϊόν καταργήθηκε",
          "requires_available_quantity": false
        }
      ]
    }
  }
}
~~~

#### Example 8 (invoice requested, with VAT exclusion via uploaded documents)

~~~ json
{
  "event_type": "new_order",
  "event_time": "2019-11-28T13:24:37+02:00",
  "order": {
    "code": "191029-5130474",
    "state": "open",
    "customer": {
      "id": "PA4oqvpz8x",
      "first_name": "John",
      "last_name": "Doe",
      "phone": "2109999999",
      "mobile": "(+30) 6999999999",
      "address":{
        "street_name":"Πανεπιστημίου",
        "street_number":"4",
        "zip":"12345",
        "city":"Αθήνα",
        "region":"Αττικής",
        "country_code": "GR",
        "pickup_from_collection_point": false
      }
    },
    "invoice": true,
    "uploaded_invoice_file": null,
    "invoice_details": {
      "company":"ACME",
      "profession":"Internet Services",
      "vat_number":"111119191",
      "doy":"ΙΒ Αθηνών",
      "address": {
        "street_name":"Πανεπιστημίου",
        "street_number":"4",
        "zip":"12345",
        "city":"Αθήνα",
        "region":"Αττικής"
      },
      "vat_exclusion_requested":true,
      "vat_exclusion_verification_method":"documents",
      "vat_exclusion_documents": [
        "https://b.scdn.gr/path-to/document.pdf"
      ]
    },
    "comments": "Παράδοση στο γραφείο",
    "courier": "ACS",
    "courier_voucher": null,
    "courier_tracking_codes": [],
    "line_items": [
      {
        "id": "l39vKqxqwe",
        "shop_uid": "100",
        "product_name": "Smartphone 123",
        "quantity": 2,
        "unit_price": 100,
        "total_price": 200,
        "price_includes_vat": false,
        "commission": 16.68,
        "commission_rate": 8.34,
        "island_vat_discount_applied": false,
        "ean": "1234567890123",
        "mpn": "JA-1059",
        "serial_numbers": null
      },
      {
        "id": "l39vKqxqh2",
        "shop_uid": "10",
        "product_name": "Smartphone case Silver",
        "quantity": 1,
        "unit_price": 25,
        "total_price": 25,
        "price_includes_vat": true,
        "commission": 2.32,
        "commission_rate": 9.28,
        "island_vat_discount_applied": false,
        "serial_numbers": null
      }
    ],
    "created_at": "2019-11-28T13:24:37+02:00",
    "expires_at": "2019-12-04T10:24:00+02:00",
    "dispatch_until": "2019-12-04T18:00:00+02:00",
    "express": false,
    "gift_wrap": false,
    "fulfilled_by_skroutz": false,
    "store_pickup": false,
    "commission": 19.00,
    "fbs_delivery_note": null,
    "fbs_delivery_note_url": null,
    "paid_by_user": true,
    "payment_method": "card",
    "accept_options": {
      "number_of_parcels": [
        1
      ],
      "pickup_location": [
        {
          "id": "YlpD0KROym",
          "label": "Πανεπιστημίου 2, Τ.Κ. 12345, Αθήνα, Αττική"
        },
        {
          "id": "onpL6DXG4l",
          "label": "Σταδίου 1, Τ.Κ. 12345, Αθήνα, Αττική"
        },
        {
          "id": "wgO1N22OaQ",
          "label": "Κρήτης 50, Τ.Κ. 73100, Χανιά, Χανιά"
        }
      ],
      "pickup_window": [
        {
          "id": 1,
          "label": "15:00 - 18:00, Τρί 03/12/19"
        },
        {
          "id": 2,
          "label": "10:00 - 12:00, Τετ 04/12/19"
        },
        {
          "id": 3,
          "label": "12:00 - 15:00, Τετ 04/12/19"
        },
        {
          "id": 4,
          "label": "15:00 - 18:00, Τετ 04/12/19"
        }
      ]
    },
    "reject_options": {
      "line_item_rejection_reasons": [
        {
          "id": 1,
          "label": "Εκτός αποθέματος στο κατάστημα ή στον προμηθευτή",
          "requires_available_quantity": false
        },
        {
          "id": 2,
          "label": "Λάθος καταχωρημένη τιμή(ες)",
          "requires_available_quantity": false
        },
        {
          "id": 4,
          "label": "Περιορισμένα τεμάχια",
          "requires_available_quantity": true
        },
        {
          "id": 5,
          "label": "To προϊόν καταργήθηκε",
          "requires_available_quantity": false
        }
      ]
    }
  }
}
~~~

#### Example 9 (invoice requested, with reduced VAT applied in a line item)

~~~ json
{
  "event_type": "new_order",
  "event_time": "2019-11-28T13:24:37+02:00",
  "order": {
    "code": "191029-5130474",
    "state": "open",
    "customer": {
      "id": "PA4oqvpz8x",
      "first_name": "John",
      "last_name": "Doe",
      "address":{
        "street_name":"Πανεπιστημίου",
        "street_number":"4",
        "zip":"12345",
        "city":"Αθήνα",
        "region":"Αττικής",
        "country_code": "GR",
        "pickup_from_collection_point": false
      }
    },
    "invoice": true,
    "uploaded_invoice_file": null,
    "invoice_details": {
      "company":"ACME",
      "profession":"Internet Services",
      "vat_number":"111119191",
      "doy":"Χίου",
      "address": {
        "street_name":"25ης Μαρτίου",
        "street_number":"1",
        "zip":"82100",
        "city":"Χίος",
        "region":"Χίου"
      },
      "vat_exclusion_requested":false
    },
    "comments": "Παράδοση στο γραφείο",
    "courier": "ACS",
    "courier_voucher": null,
    "courier_tracking_codes": [],
    "line_items": [
      {
        "id": "l39vKqxqwe",
        "shop_uid": "100",
        "product_name": "Smartphone 123",
        "quantity": 2,
        "unit_price": 100,
        "total_price": 200,
        "price_includes_vat": true,
        "commission": 16.68,
        "commission_rate": 8.34,
        "island_vat_discount_applied": true,
        "ean": "1234567890123",
        "mpn": "JA-1059",
        "serial_numbers": null
      },
      {
        "id": "l39vKqxqh2",
        "shop_uid": "10",
        "product_name": "Smartphone case Silver",
        "quantity": 1,
        "unit_price": 25,
        "total_price": 25,
        "price_includes_vat": true,
        "commission": 2.32,
        "commission_rate": 9.28,
        "island_vat_discount_applied": false,
        "serial_numbers": null
      }
    ],
    "created_at": "2019-11-28T13:24:37+02:00",
    "expires_at": "2019-12-04T10:24:00+02:00",
    "dispatch_until": "2019-12-04T18:00:00+02:00",
    "express": false,
    "gift_wrap": false,
    "fulfilled_by_skroutz": false,
    "store_pickup": false,
    "commission": 19.00,
    "fbs_delivery_note": null,
    "fbs_delivery_note_url": null,
    "paid_by_user": true,
    "payment_method": "card",
    "accept_options": {
      "number_of_parcels": [
        1
      ],
      "pickup_location": [
        {
          "id": "YlpD0KROym",
          "label": "Πανεπιστημίου 2, Τ.Κ. 12345, Αθήνα, Αττική"
        },
        {
          "id": "onpL6DXG4l",
          "label": "Σταδίου 1, Τ.Κ. 12345, Αθήνα, Αττική"
        },
        {
          "id": "wgO1N22OaQ",
          "label": "Κρήτης 50, Τ.Κ. 73100, Χανιά, Χανιά"
        }
      ],
      "pickup_window": [
        {
          "id": 1,
          "label": "15:00 - 18:00, Τρί 03/12/19"
        },
        {
          "id": 2,
          "label": "10:00 - 12:00, Τετ 04/12/19"
        },
        {
          "id": 3,
          "label": "12:00 - 15:00, Τετ 04/12/19"
        },
        {
          "id": 4,
          "label": "15:00 - 18:00, Τετ 04/12/19"
        }
      ]
    },
    "reject_options": {
      "line_item_rejection_reasons": [
        {
          "id": 1,
          "label": "Εκτός αποθέματος στο κατάστημα ή στον προμηθευτή",
          "requires_available_quantity": false
        },
        {
          "id": 2,
          "label": "Λάθος καταχωρημένη τιμή(ες)",
          "requires_available_quantity": false
        },
        {
          "id": 4,
          "label": "Περιορισμένα τεμάχια",
          "requires_available_quantity": true
        },
        {
          "id": 5,
          "label": "To προϊόν καταργήθηκε",
          "requires_available_quantity": false
        }
      ]
    }
  }
}
~~~

#### Example 10 (pickup from collection point selected)

~~~ json
{
  "event_type": "new_order",
  "event_time": "2019-11-28T13:24:37+02:00",
  "order": {
    "code": "191029-5130474",
    "state": "open",
    "customer": {
      "id": "PA4oqvpz8x",
      "first_name": "John",
      "last_name": "Doe",
      "address":{
        "street_name":"",
        "street_number":"",
        "zip":"",
        "city":"",
        "region":"",
        "country_code": "",
        "pickup_from_collection_point": true,
        "collection_point_address": "Κατάστημα ACS: ΠΕΤΡΟΥ ΡΑΛΛΗ 45, ΤΑΥΡΟΣ, 17778"
      }
    },
    "invoice": false,
    "uploaded_invoice_file": null,
    "comments": "Παράδοση στο γραφείο",
    "courier": "ACS",
    "courier_voucher": null,
    "courier_tracking_codes": [],
    "line_items": [
      {
        "id": "l39vKqxqwe",
        "shop_uid": "100",
        "product_name": "L'Oreal Professionel Salon Steam Pod V2 White",
        "quantity": 2,
        "unit_price": 10.40,
        "total_price": 20.80,
        "price_includes_vat": true,
        "commission": 1.73,
        "commission_rate": 8.34,
        "island_vat_discount_applied": false,
        "serial_numbers": null
      },
      {
        "id": "l39vKqxqh2",
        "shop_uid": "10",
        "product_name": "Paul Mitchell Ultimate Color Repair 200ml",
        "quantity": 1,
        "unit_price": 25,
        "total_price": 25,
        "price_includes_vat": true,
        "commission": 2.32,
        "commission_rate": 9.28,
        "island_vat_discount_applied": false,
        "serial_numbers": null
      }
    ],
    "created_at": "2019-11-28T13:24:37+02:00",
    "expires_at": "2019-12-04T10:24:00+02:00",
    "dispatch_until": "2019-12-04T18:00:00+02:00",
    "express": false,
    "gift_wrap": false,
    "fulfilled_by_skroutz": false,
    "store_pickup": false,
    "commission": 4.05,
    "fbs_delivery_note": null,
    "fbs_delivery_note_url": null,
    "paid_by_user": true,
    "payment_method": "card",
    "accept_options": {
      "number_of_parcels": [
        1
      ],
      "pickup_location": [
        {
          "id": "YlpD0KROym",
          "label": "Πανεπιστημίου 2, Τ.Κ. 12345, Αθήνα, Αττική"
        },
        {
          "id": "onpL6DXG4l",
          "label": "Σταδίου 1, Τ.Κ. 12345, Αθήνα, Αττική"
        },
        {
          "id": "wgO1N22OaQ",
          "label": "Κρήτης 50, Τ.Κ. 73100, Χανιά, Χανιά"
        }
      ],
      "pickup_window": [
        {
          "id": 1,
          "label": "15:00 - 18:00, Τρί 03/12/19"
        },
        {
          "id": 2,
          "label": "10:00 - 12:00, Τετ 04/12/19"
        },
        {
          "id": 3,
          "label": "12:00 - 15:00, Τετ 04/12/19"
        },
        {
          "id": 4,
          "label": "15:00 - 18:00, Τετ 04/12/19"
        }
      ]
    },
    "reject_options": {
      "line_item_rejection_reasons": [
        {
          "id": 1,
          "label": "Εκτός αποθέματος στο κατάστημα ή στον προμηθευτή",
          "requires_available_quantity": false
        },
        {
          "id": 2,
          "label": "Λάθος καταχωρημένη τιμή(ες)",
          "requires_available_quantity": false
        },
        {
          "id": 4,
          "label": "Περιορισμένα τεμάχια",
          "requires_available_quantity": true
        },
        {
          "id": 5,
          "label": "To προϊόν καταργήθηκε",
          "requires_available_quantity": false
        }
      ]
    }
  }
}
~~~

#### Example 11 (with extra_info in line_items)

~~~ json
{
  "event_type": "new_order",
  "event_time": "2019-11-28T13:24:37+02:00",
  "order": {
    "code": "191029-5130474",
    "state": "open",
    "customer": {
      "id": "PA4oqvpz8x",
      "first_name": "John",
      "last_name": "Doe",
      "address":{
        "street_name":"Πανεπιστημίου",
        "street_number":"4",
        "zip":"12345",
        "city":"Αθήνα",
        "region":"Αττικής",
        "country_code": "GR",
        "pickup_from_collection_point": false
      }
    },
    "invoice": false,
    "uploaded_invoice_file": null,
    "comments": "Παράδοση στο γραφείο",
    "courier": "ACS",
    "courier_voucher": null,
    "courier_tracking_codes": [],
    "line_items": [
      {
        "id": "RPJJ8gG5Pg",
        "shop_uid": "768",
        "product_name": "AIR OPTIX COLORS MHNIAIOI",
        "quantity": 2,
        "unit_price": 25.5,
        "total_price": 51,
        "price_includes_vat": true,
        "commission": 4.73,
        "commission_rate": 9.28,
        "island_vat_discount_applied": false,
        "extra_info": "Χρώμα: Πράσινο\nΒαθμοί SPH: -6.50",
        "serial_numbers": null
      }
    ],
    "created_at": "2019-11-28T13:24:37+02:00",
    "expires_at": "2019-12-04T10:24:00+02:00",
    "dispatch_until": "2019-12-04T18:00:00+02:00",
    "express": false,
    "gift_wrap": false,
    "fulfilled_by_skroutz": false,
    "store_pickup": false,
    "commission": 4.73,
    "fbs_delivery_note": null,
    "fbs_delivery_note_url": null,
    "paid_by_user": true,
    "payment_method": "card",
    "accept_options": {
      "number_of_parcels": [
        1
      ],
      "pickup_location": [
        {
          "id": "YlpD0KROym",
          "label": "Πανεπιστημίου 2, Τ.Κ. 12345, Αθήνα, Αττική"
        },
        {
          "id": "onpL6DXG4l",
          "label": "Σταδίου 1, Τ.Κ. 12345, Αθήνα, Αττική"
        },
        {
          "id": "wgO1N22OaQ",
          "label": "Κρήτης 50, Τ.Κ. 73100, Χανιά, Χανιά"
        }
      ],
      "pickup_window": [
        {
          "id": 1,
          "label": "15:00 - 18:00, Τρί 03/12/19"
        },
        {
          "id": 2,
          "label": "10:00 - 12:00, Τετ 04/12/19"
        },
        {
          "id": 3,
          "label": "12:00 - 15:00, Τετ 04/12/19"
        },
        {
          "id": 4,
          "label": "15:00 - 18:00, Τετ 04/12/19"
        }
      ]
    },
    "reject_options": {
      "line_item_rejection_reasons": [
        {
          "id": 1,
          "label": "Εκτός αποθέματος στο κατάστημα ή στον προμηθευτή",
          "requires_available_quantity": false
        },
        {
          "id": 2,
          "label": "Λάθος καταχωρημένη τιμή(ες)",
          "requires_available_quantity": false
        },
        {
          "id": 4,
          "label": "Περιορισμένα τεμάχια",
          "requires_available_quantity": true
        },
        {
          "id": 5,
          "label": "To προϊόν καταργήθηκε",
          "requires_available_quantity": false
        }
      ]
    }
  }
}
~~~

#### Example 12 (shipped to Cyprus)

~~~ json
{
  "event_type": "new_order",
  "event_time": "2019-11-28T13:24:37+02:00",
  "order": {
    "code": "191029-5130474",
    "state": "open",
    "customer": {
      "id": "PA4oqvpz8x",
      "first_name": "John",
      "last_name": "Doe",
      "address":{
        "street_name":"Αρτέμιδος",
        "street_number":"4",
        "zip":"6031",
        "city":"Λάρνακα",
        "region":"Λάρνακας",
        "country_code": "CY",
        "pickup_from_collection_point": false
      }
    },
    "invoice": false,
    "uploaded_invoice_file": null,
    "comments": "Παράδοση στο γραφείο",
    "courier": "DHL",
    "courier_voucher": null,
    "courier_tracking_codes": [],
    "line_items": [
      {
        "id": "l39vKqxqwe",
        "shop_uid": "100",
        "product_name": "L'Oreal Professionel Salon Steam Pod V2 White",
        "quantity": 2,
        "unit_price": 10.40,
        "total_price": 20.80,
        "price_includes_vat": true,
        "commission": 1.73,
        "commission_rate": 8.34,
        "island_vat_discount_applied": false,
        "ean": "1234567890123",
        "mpn": "JA-1059",
        "serial_numbers": null
      },
      {
        "id": "l39vKqxqh2",
        "shop_uid": "10",
        "product_name": "Paul Mitchell Ultimate Color Repair 200ml",
        "quantity": 1,
        "unit_price": 25,
        "total_price": 25,
        "price_includes_vat": true,
        "commission": 2.32,
        "commission_rate": 9.28,
        "island_vat_discount_applied": false,
        "serial_numbers": null
      }
    ],
    "created_at": "2019-11-28T13:24:37+02:00",
    "expires_at": "2019-12-04T10:24:00+02:00",
    "dispatch_until": "2019-12-04T18:00:00+02:00",
    "express": false,
    "gift_wrap": false,
    "fulfilled_by_skroutz": false,
    "store_pickup": false,
    "commission": 4.05,
    "fbs_delivery_note": null,
    "fbs_delivery_note_url": null,
    "paid_by_user": true,
    "payment_method": "card",
    "accept_options": {
      "number_of_parcels": [
        1
      ],
      "pickup_location": [
        {
          "id": "YlpD0KROym",
          "label": "Πανεπιστημίου 2, Τ.Κ. 12345, Αθήνα, Αττική"
        },
        {
          "id": "onpL6DXG4l",
          "label": "Σταδίου 1, Τ.Κ. 12345, Αθήνα, Αττική"
        },
        {
          "id": "wgO1N22OaQ",
          "label": "Κρήτης 50, Τ.Κ. 73100, Χανιά, Χανιά"
        }
      ],
      "pickup_window": [
        {
          "id": 1,
          "label": "15:00 - 18:00, Τρί 03/12/19"
        },
        {
          "id": 2,
          "label": "10:00 - 12:00, Τετ 04/12/19"
        },
        {
          "id": 3,
          "label": "12:00 - 15:00, Τετ 04/12/19"
        },
        {
          "id": 4,
          "label": "15:00 - 18:00, Τετ 04/12/19"
        }
      ]
    },
    "reject_options": {
      "line_item_rejection_reasons": [
        {
          "id": 1,
          "label": "Εκτός αποθέματος στο κατάστημα ή στον προμηθευτή",
          "requires_available_quantity": false
        },
        {
          "id": 2,
          "label": "Λάθος καταχωρημένη τιμή(ες)",
          "requires_available_quantity": false
        },
        {
          "id": 4,
          "label": "Περιορισμένα τεμάχια",
          "requires_available_quantity": true
        },
        {
          "id": 5,
          "label": "To προϊόν καταργήθηκε",
          "requires_available_quantity": false
        }
      ]
    }
  }
}
~~~

#### Example 12 (with fees)

~~~ json
{
  "event_type": "new_order",
  "event_time": "2021-06-24T13:08:30+03:00",
  "order": {
    "code": "191029-5130474",
    "state": "accepted",
    "customer": {
      "id": "PA4oqvpz8x",
      "first_name": "John",
      "last_name": "Doe",
      "address": {
        "street_name": "Πανεπιστημίου",
        "street_number": "4",
        "zip": "12345",
        "city": "Αθήνα",
        "region": "Αττικής",
        "country_code": "GR",
        "pickup_from_collection_point": false
      }
    },
    "invoice": false,
    "invoice_details": null,
    "invoice_document": "receipt",
    "uploaded_invoice_file": null,
    "comments": "Παράδοση στο γραφείο",
    "courier": "ACS",
    "courier_voucher": null,
    "courier_tracking_codes": [],
    "line_items": [
      {
        "id": "l39vKqxqwe",
        "shop_uid": "100",
        "product_name": "L'Oreal Professionel Salon Steam Pod V2 White",
        "quantity": 1,
        "unit_price": 10.40,
        "total_price": 10.40,
        "price_includes_vat": true,
        "commission": 0.87,
        "commission_rate": 8.34,
        "island_vat_discount_applied": false,
        "ean": "1234567890123",
        "serial_numbers": null,
        "tags": ["cc_installments"]
      }
    ],
    "created_at": "2021-06-24T13:08:30+03:00",
    "expires_at": "2021-06-25T13:08:30+03:00",
    "dispatch_until": "2021-06-28T13:08:30+03:00",
    "express": false,
    "gift_wrap": false,
    "fulfilled_by_skroutz": false,
    "store_pickup": false,
    "fbs_delivery_note": null,
    "fbs_delivery_note_url": null,
    "commission": 0.87,
    "fees": {
      "handling_fee": 1.50,
      "skroutz_coins_fee": 2.00,
      "installments_fee": 3.50
    },
    "fulfillment_mode": "core"
  }
}
~~~

#### Example 13 (replacements)

~~~ json
{
  "event_type": "new_order",
  "event_time": "2021-06-24T13:08:30+03:00",
  "order": {
    "code": "191029-5130474",
    "state": "accepted",
    "customer": {
      "id": "PA4oqvpz8x",
      "first_name": "John",
      "last_name": "Doe",
      "address": {
        "street_name": "Πανεπιστημίου",
        "street_number": "4",
        "zip": "12345",
        "city": "Αθήνα",
        "region": "Αττικής",
        "country_code": "GR",
        "pickup_from_collection_point": false
      }
    },
    "invoice": false,
    "invoice_details": null,
    "invoice_document": "receipt",
    "uploaded_invoice_file": null,
    "comments": "",
    "courier": "ACS",
    "courier_voucher": null,
    "courier_tracking_codes": [],
    "line_items": [
      {
        "id": "l39vKqxqwe",
        "shop_uid": "100",
        "product_name": "L'Oreal Professionel Salon Steam Pod V2 White",
        "quantity": 1,
        "unit_price": 10.40,
        "total_price": 10.40,
        "price_includes_vat": true,
        "commission": 0.87,
        "commission_rate": 8.34,
        "island_vat_discount_applied": false,
        "ean": "1234567890123",
        "serial_numbers": null
      }
    ],
    "created_at": "2021-06-24T13:08:30+03:00",
    "expires_at": "2021-06-25T13:08:30+03:00",
    "dispatch_until": "2021-06-28T13:08:30+03:00",
    "express": false,
    "gift_wrap": false,
    "fulfilled_by_skroutz": false,
    "store_pickup": false,
    "fbs_delivery_note": null,
    "fbs_delivery_note_url": null,
    "fees": {},
    "replacements": [
      {
        "code": "DEMO-REPLACEMENT-1",
        "type": "from_service"
      }
    ]
  }
}
~~~

#### Example 14 (replaced)

~~~ json
{
  "event_type": "new_order",
  "event_time": "2021-06-24T13:08:30+03:00",
  "order": {
    "code": "191029-5130474",
    "state": "accepted",
    "customer": {
      "id": "PA4oqvpz8x",
      "first_name": "John",
      "last_name": "Doe",
      "address": {
        "street_name": "Πανεπιστημίου",
        "street_number": "4",
        "zip": "12345",
        "city": "Αθήνα",
        "region": "Αττικής",
        "country_code": "GR",
        "pickup_from_collection_point": false
      }
    },
    "invoice": false,
    "invoice_details": null,
    "invoice_document": "receipt",
    "uploaded_invoice_file": null,
    "comments": "",
    "courier": "ACS",
    "courier_voucher": null,
    "courier_tracking_codes": [],
    "line_items": [
      {
        "id": "l39vKqxqwe",
        "shop_uid": "100",
        "product_name": "L'Oreal Professionel Salon Steam Pod V2 White",
        "quantity": 1,
        "unit_price": 10.40,
        "total_price": 10.40,
        "price_includes_vat": true,
        "commission": 0.87,
        "commission_rate": 8.34,
        "island_vat_discount_applied": false,
        "ean": "1234567890123",
        "serial_numbers": null
      }
    ],
    "created_at": "2021-06-24T13:08:30+03:00",
    "expires_at": "2021-06-25T13:08:30+03:00",
    "dispatch_until": "2021-06-28T13:08:30+03:00",
    "express": false,
    "gift_wrap": false,
    "fulfilled_by_skroutz": false,
    "store_pickup": false,
    "fbs_delivery_note": null,
    "fbs_delivery_note_url": null,
    "fees": {},
    "replaced": "ORIGINAL-ABC123"
  }
}
~~~

#### Example 15 (VIES invoice)

~~~ json
{
  "event_type": "new_order",
  "event_time": "2021-06-24T13:08:30+03:00",
  "order": {
    "code": "191029-5130474",
    "state": "accepted",
    "customer": {
      "id": "PA4oqvpz8x",
      "first_name": "John",
      "last_name": "Doe",
      "phone": "2109999999",
      "mobile": "(+30) 6999999999",
      "address": {
        "street_name": "Πανεπιστημίου",
        "street_number": "4",
        "zip": "12345",
        "city": "Αθήνα",
        "region": "Αττικής",
        "country_code": "GR",
        "pickup_from_collection_point": false
      }
    },
    "invoice": true,
    "invoice_details": {
      "company": "ACME EU",
      "profession": "Internet Services",
      "vat_number": "DE111119191",
      "doy": "ΙΒ Αθηνών",
      "address": {
        "street_name": "Πανεπιστημίου",
        "street_number": "4",
        "zip": "12345",
        "city": "Αθήνα",
        "region": "Αττικής"
      },
      "vat_exclusion_requested": true
    },
    "invoice_document": "invoice_vies",
    "uploaded_invoice_file": null,
    "comments": "Παράδοση στο γραφείο",
    "courier": "ACS",
    "courier_voucher": null,
    "courier_tracking_codes": [],
    "line_items": [
      {
        "id": "l39vKqxqwe",
        "shop_uid": "100",
        "product_name": "Smartphone 123",
        "quantity": 2,
        "unit_price": 100,
        "total_price": 200,
        "price_includes_vat": false,
        "commission": 16.68,
        "commission_rate": 8.34,
        "island_vat_discount_applied": false,
        "ean": "1234567890123",
        "serial_numbers": null
      }
    ],
    "created_at": "2021-06-24T13:08:30+03:00",
    "expires_at": "2021-06-25T13:08:30+03:00",
    "dispatch_until": "2021-06-28T13:08:30+03:00",
    "express": false,
    "gift_wrap": false,
    "fulfilled_by_skroutz": false,
    "store_pickup": false,
    "fbs_delivery_note": null,
    "fbs_delivery_note_url": null
  }
}
~~~

#### Example 15 (VIES invoice)
~~~ json
{
    "order": {
        "code": "DEMO-RETURN",
        "state": "accepted",
        "customer": {
            "id": "user1234",
            "first_name": "John",
            "last_name": "Doe",
            "address": {
                "street_name": "Πανεπιστημίου",
                "street_number": "4",
                "zip": "12345",
                "city": "Αθήνα",
                "region": "Αττικής",
                "pickup_from_collection_point": false
            }
        },
        "invoice": false,
        "invoice_document": "receipt",
        "uploaded_invoice_file": "https://skroutz.gr/merchants/samples/demo_uploaded_invoice.pdf",
        "comments": "Παράδοση στο γραφείο",
        "courier": "CourierCenter",
        "courier_voucher": "https://skroutz.gr/merchants/sample_vouchers/courier_center.pdf",
        "courier_tracking_codes": [
            "123456789"
        ],
        "line_items": [
            {
                "id": "KmdDmkl0xb",
                "shop_uid": "405753",
                "shop_variation_uid": "40575312-14",
                "product_name": "Adidas Perormance Badge of Sport Swimsuit PS/GS",
                "quantity": 2,
                "size": {
                    "label": "Ηλικία",
                    "value": "14 χρονών",
                    "shop_value": "12-14",
                    "shop_variation_uid": "40575312-14",
                    "ean": "1234567890321"
                },
                "unit_price": 17.99,
                "total_price": 35.98,
                "price_includes_vat": true,
                "ean": "1234567890123",
                "serial_numbers": null,
                "tags": [
                    "plus_deal",
                    "price_optimizer"
                ]
            },
            {
                "id": "xWMlznlYJR",
                "shop_uid": "10",
                "product_name": "Smartphone 123",
                "quantity": 2,
                "unit_price": 100,
                "total_price": 200,
                "price_includes_vat": true,
                "serial_numbers": null,
                "tags": [
                    "coupon_deal"
                ]
            },
            {
                "id": "RN4rJ9l8KE",
                "shop_uid": "768",
                "product_name": "AIR OPTIX COLORS MHNIAIOI",
                "quantity": 2,
                "unit_price": 25.5,
                "total_price": 51,
                "price_includes_vat": true,
                "extra_info": "Χρώμα: Πράσινο\\nΒαθμοί SPH: -6.50",
                "serial_numbers": null,
                "tags": [
                    "two_plus_deal"
                ]
            }
        ],
        "created_at": "2026-04-01T23:03:59+03:00",
        "expires_at": "2026-04-02T23:03:59+03:00",
        "dispatch_until": "2026-04-03T23:03:59+03:00",
        "express": false,
        "fulfilled_by_skroutz": false,
        "fbs_delivery_note": null,
        "fbs_delivery_note_url": null,
        "number_of_parcels": 2,
        "pickup_window": {
            "from": "2026-04-01T12:00:00+03:00",
            "to": "2026-04-01T14:00:00+03:00"
        },
        "pickup_address": "Αλέκου Παναγούλη 91, Τ.Κ 14234, Νέα Ιωνία",
        "paid_by_user": true,
        "payment_method": "card",
        "store_pickup": false,
        "fees": {},
        "returns": [
            {
                "return_uuid": "KmdDmkl0xb",
                "tracking_ids": [
                    "9WDEE48L66D7Y"
                ]
            },
            {
                "return_uuid": "xWMlznlYJR",
                "tracking_ids": [
                     "94GO8X0Q2PD6J",
                     "94GO8X0Q2PD6K"
                ]
            }
        ]
    }
}
~~~

~~~ json
{
  "event_type": "new_order",
  "event_time": "2019-11-28T13:24:37+02:00",
  "order": {
    "code": "191029-5130474",
    "state": "open",
    "customer": {
      "id": "PA4oqvpz8x",
      "first_name": "John",
      "last_name": "Doe",
      "address":{
        "street_name":"Αρτέμιδος",
        "street_number":"4",
        "zip":"6031",
        "city":"Λάρνακα",
        "region":"Λάρνακας",
        "country_code": "CY",
        "pickup_from_collection_point": false
      }
    },
    "invoice": false,
    "uploaded_invoice_file": null,
    "comments": "Παράδοση στο γραφείο",
    "courier": "DHL",
    "courier_voucher": null,
    "courier_tracking_codes": [],
    "line_items": [
      {
        "id": "l39vKqxqwe",
        "shop_uid": "100",
        "product_name": "L'Oreal Professionel Salon Steam Pod V2 White",
        "quantity": 2,
        "unit_price": 10.40,
        "total_price": 20.80,
        "price_includes_vat": true,
        "commission": 1.73,
        "commission_rate": 8.34,
        "island_vat_discount_applied": false,
        "ean": "1234567890123",
        "mpn": "JA-1059",
        "serial_numbers": null
      },
      {
        "id": "l39vKqxqh2",
        "shop_uid": "10",
        "product_name": "Paul Mitchell Ultimate Color Repair 200ml",
        "quantity": 1,
        "unit_price": 25,
        "total_price": 25,
        "price_includes_vat": true,
        "commission": 2.32,
        "commission_rate": 9.28,
        "island_vat_discount_applied": false,
        "serial_numbers": null
      }
    ],
    "created_at": "2019-11-28T13:24:37+02:00",
    "expires_at": "2019-12-04T10:24:00+02:00",
    "dispatch_until": "2019-12-04T18:00:00+02:00",
    "express": false,
    "gift_wrap": false,
    "fulfilled_by_skroutz": false,
    "store_pickup": false,
    "commission": 4.05
    "fbs_delivery_note": null,
    "fbs_delivery_note_url": null,
    "accept_options": {
      "number_of_parcels": [
        1
      ],
      "pickup_location": [
        {
          "id": "YlpD0KROym",
          "label": "Πανεπιστημίου 2, Τ.Κ. 12345, Αθήνα, Αττική"
        },
        {
          "id": "onpL6DXG4l",
          "label": "Σταδίου 1, Τ.Κ. 12345, Αθήνα, Αττική"
        },
        {
          "id": "wgO1N22OaQ",
          "label": "Κρήτης 50, Τ.Κ. 73100, Χανιά, Χανιά"
        }
      ],
      "pickup_window": [
        {
          "id": 1,
          "label": "15:00 - 18:00, Τρί 03/12/19"
        },
        {
          "id": 2,
          "label": "10:00 - 12:00, Τετ 04/12/19"
        },
        {
          "id": 3,
          "label": "12:00 - 15:00, Τετ 04/12/19"
        },
        {
          "id": 4,
          "label": "15:00 - 18:00, Τετ 04/12/19"
        }
      ]
    },
    "reject_options": {
      "line_item_rejection_reasons": [
        {
          "id": 1,
          "label": "Εκτός αποθέματος στο κατάστημα ή στον προμηθευτή",
          "requires_available_quantity": false
        },
        {
          "id": 2,
          "label": "Λάθος καταχωρημένη τιμή(ες)",
          "requires_available_quantity": false
        },
        {
          "id": 4,
          "label": "Περιορισμένα τεμάχια",
          "requires_available_quantity": true
        },
        {
          "id": 5,
          "label": "To προϊόν καταργήθηκε",
          "requires_available_quantity": false
        }
      ]
    }
  }
}
~~~