Overview Edit the file on GitHub

Important update: From 5/7/2021 onwards, more order state updates will be sent via Webhook requests. Read more

There are currently two tools for Merchants that can be used to integrate Smart Cart orders into their existing system, the Orders API and Webhook.

Table of Contents

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

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

Webhook

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.

Webhook documentation

Use cases

Both Webhook and Orders API can be enabled and used separately. For a full orders integration though, it would require to implement both services, since Webhook 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

— 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)

Accepting orders

— 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