Orders API v1

GET {merchantAPIEndpoint}/orders

GET {merchantAPIEndpoint}/orders?page=1&itemsPerPage=10

{
    "params": {
        "page": 1,  // Current page number
        "items_per_page": 10,  // Number of items displayed per page
        "total_items": 9,  // Total number of available orders
        "status": null,  // Order status filter (null means no filter applied)
        "date_from": "2020-01-01 00:00:00",  // Start date for order filtering
        "date_to": "2025-01-31 10:51:00"  // End date for order filtering
    },
    "orders": [
        {
            "order_id": 3005,  // The order ID in shopflix.gr
            "order_reference": "GR--3278--MER78",  // Reference code for the order
            "timestamp": 1738087382,  // Order registration date (Unix timestamp)
            "firstname": "Sarah",  // Customer's first name
            "lastname": "Muller",  // Customer's last name
            "company_id": "12345",  // The store ID in shopflix.gr
            "company": "",  // Company name of the customer
            "email": "sarah@example.com",  // Customer's email address
            "phone": "425-222-45-76",  // Customer's phone number
            "status": "G",  // Order status (G = In processing)
            "total": "48.92"  // Total order cost
        },
        {
            "order_id": 3004,
            "order_reference": "GR--3278--MER78",
            "timestamp": 1738079222,
            "firstname": "Sarah",
            "lastname": "Muller",
            "company_id": "12345",
            "company": "",
            "email": "sarah@example.com",
            "phone": "425-222-45-76",
            "status": "H",  // Order status (H = Ready for shipment)
            "total": "48.92"
        }
 
        // More orders can be listed here...
    ]
}

GET {merchantAPIEndpoint}/orders/{orderId}

{
  "order_id": 3257,  // Order ID in shopflix.gr
  "user_id": 2,  // User ID who placed the order
  "order_reference": "GR--3257--MER78", // Reference code for the order
  "status": "H",  // Order status (H = Ready for shipment)
  "timestamp": 1757680716, // UNIX timestamp of the order creation
  "total": "22.00",  // Total order amount
  "subtotal": "1.00", // Subtotal before discounts
  "discount": 0,  // Discount applied
  "company_id": "",  // Vendor’s company ID (if any)
  "notes": null,  // Any notes for the order
  "firstname": "Maria", // Customer first name
  "lastname": "Williams",  // Customer last name
 
  // Billing address
  "b_firstname": "Maria",  // Billing first name
  "b_lastname": "Williams",  // Billing last name
  "b_address": "Αιόλου",  // Billing street address
  "b_address_2": "12",  // Additional billing address info
  "b_city": "ΑΘΗΝΑ",  // Billing city
  "b_state": "ΑΤΤ",  // Billing state code
  "b_country": "GR",  // Billing country code
  "b_zipcode": "10552",  // Billing postal code
  "b_phone": "",  // Billing phone number
 
  // Shipping address
  "s_firstname": "Maria",  // Shipping first name
  "s_lastname": "Williams",  // Shipping last name
  "s_address": "Σοφοκλέους",  // Shipping street address
  "s_address_2": "5",  // Additional shipping address info
  "s_city": "ΑΘΗΝΑ",  // Shipping city
  "s_state": "ΑΤΤ",  // Shipping state code
  "s_country": "GR",  // Shipping country code
  "s_zipcode": "10555",  // Shipping postal code
  "s_phone": "",  // Shipping phone number
  "s_address_type": "",  // Shipping address type
 
  "phone": "6973311422",  // Customer phone number
  "email": "maria.williams@spryker.com",  // Customer email
 
  // invoice details
  "fields": {
    "115": "Y", // Has invoice? (Y/N)
    "116": "Company Name",  // Invoice company name
    "117": "123 Main Street, Athens", // Invoice address
    "118": "1201",  // Tax office code (DOY)
    "119": "EL123456789",  // VAT number
    "120": "Athens A’ DOY",  // Tax office name (DOY name)
    "151": "N",  // Article 39 eligible? (Y/N)
    "152": "ΔΙ ΔΙΑΒΑΤΗΡΙΟ",  // Article 39 identity type
    "153": "ΑΒ1234567",  // Article 39 identity number
    "154": "425-222-45-76",  // Article 39 mobile phone
    "155": "842315",  // Article 39 OTP
    "156": ""  // Occupation
  },
 
  "b_country_descr": "Greece",  // Billing country description
  "s_country_descr": "Greece",  // Shipping country description
  "b_state_descr": "ΑΤΤΙΚΉ",  // Billing state description
  "s_state_descr": "ΑΤΤΙΚΉ",  // Shipping state description
 
  "shipment_ids": [  // List of shipment IDs
    462
  ],
  "company_name": null,  // Vendor’s company name
  "last_order_change": "",  // Last order change timestamp
 
  "payment_method": {
    "payment": "cod"  // Payment method (cash on delivery)
  },
 
  "shipping": {
    "name": "Diakinisis (Diakinisis Standard)",  // Carrier name
    "method": "Diakinisis Standard",  // Carrier method
    "delivery_key": "diakinisis_standard"  // Delivery key
  },
 
  "invoices": [
    {
      "id": 42,
      "url": "https://s3.{region}.amazonaws.com/{bucket}/invoices/GR--3257--MER78/invoice-1.pdf",  // Example public invoice URL
      "created_at": "2026-04-10T12:30:00Z"  // Invoice upload timestamp
    },
    {
      "id": 43,
      "url": "https://s3.{region}.amazonaws.com/{bucket}/invoices/GR--3257--MER78/invoice-2.pdf",
      "created_at": "2026-04-11T09:15:00Z"
    }
  ],
 
  "products": {
    "307": {
      "item_id": 307,  // Order item ID
      "order_id": 3257,  // Parent order ID
      "product_id": "SF-1",  // Product ID
      "product_code": "213123123",  // Product SKU/code
      "price": "1.00",  // Price per unit
      "total_price": "1.00",  // Total price (amount * price)
      "status_a39": "0",  // Article 39 status
      "amount": 1,  // Quantity ordered
      "product": "Wireless Bluetooth Speaker", // Product name
      "product_status": "A",  // Product status
      "master_product_code": "SF-1",  // Master product code
      "company_id": "",  // Vendor’s company ID for product
      "base_price": "1.00",  // Base price
      "original_price": "1.00",  // Original price
      "ean": null,  // Barcode (if any)
      "product_url": "https://shopflix.gr/p/SF-1",  // Product URL
      "extended_attributes": [],  // Extra product attributes
      "extra": {
        "pickup_date": "17/09/2025",  // Pickup date
        "delivery_date": "18/09/2025"  // Delivery date
      }
    }
  }
}

{
    "message": "The order with id {orderId} was not found"
}

PUT {merchantAPIEndpoint}/orders/{orderId}

{
    "status":"G"
}

{
	"message": "success"
}

{
    "message": "Cannot Accept Order"
}

{
    "status":"D",
    "reason": "damaged" // optional
}

{
	"message": "success"
}

{
    "message": "Cannot Reject Order"
}

{
    "message": "Reason Is Not Valid"
}

POST {merchantAPIEndpoint}/orders/{orderId}/invoices

{
  "filename": "invoice-5009.pdf",
  "contentBase64": "JVBERi0xLjcKJcfs..."
}

{
  "message": "success",
  "invoice": {
    "id": 42,
    "url": "https://s3.{region}.amazonaws.com/{bucket}/invoices/GR--5009--MER78/invoice_GR--5009--MER78_27_04_2026_10_00_00.pdf",
    "created_at": "2026-04-21T10:15:00Z"
  }
}

{
  "message": "Invalid payload."
}

{
  "message": "The file type is not supported."
}

{
  "message": "The file size is too big."
}

{
  "message": "You cannot upload more than 3 files."
}

{
  "message": "The order with id {orderId} was not found"
}

{
  "message": "There were errors during the upload."
}

DELETE {merchantAPIEndpoint}/orders/{orderId}/invoices/{invoiceId}

{
  "message": "success",
  "invoices": [
    {
      "id": 43,
      "url": "https://s3.{region}.amazonaws.com/{bucket}/invoices/GR--5009--MER78/invoice-2.pdf",
      "created_at": "2026-04-11T09:15:00Z"
    }
  ]
}

{
  "message": "Invalid request params."
}

{
  "message": "The invoice was not found."
}