Shopping cart and order links

Easy PV and Heatpünk generate a full bill of materials for a project, and for our UK and Ireland sites you can very quickly place an order for the components from Midsummer. So you may like to import the shopping cart into your application and display an ordering link. Users love the ease of ordering all the kit for an installation.

The cart is refreshed every time you visit the overview page of a project in Easy PV or Heatpünk.

To fetch project data, including the cart and order link, use the api/v1/projects/data endpoint. You need to pass in the project ID, and the user you are acting as. The user must have view rights to the project. You will get back an object which includes a cart array and a midsummerOrderLink string. Both should be self explanatory.

The order link is an easy way to order everything needed for a project from Midsummer. However, if you offer the ability to edit the cart, you may like to generate your own order link. If you do this, you can also add some additional parameters such as a delivery address or order reference to the order.

In its simplest form, an order can be just an object with an 'items' property. For each item, specify the property.

const order = {
    "items": {
        "2586": {
            "qty": 99
        },
       "4258": {
            "qty": 99
       }
   }
}

Here is a more complex order, with a shipping address, despatch date and reference:

const order = {
    "items": {
        "2586": {
            "qty": 99
        },
   },
  "deliveryOption": "standard",
  "shippingAddress": {
    "postcode": "CB24 6AZ",
    "add1": "Midsummer Energy",
    "add2": "Cambridge Road Industrial Estate",
    "add3": "Milton",
    "add4": "",
    "email": "sales@midsummerenergy.co.uk",
    "phone": "01223 858414",
    "firstname": "Andy",
    "lastname": "Rankin"
  },
  "despatchDate": "2023-02-08",
  "reference": "trial order"
}

Once you have created your order, simply create an order string by stringifying the object, then Base64 encoding the result, then URL encoding the result Then go to https://midsummerwholesale.co.uk/upload?order=[result string]

In JavaScript the function you need is:

 function createOrderLink(order) {
      return "https://midsummerwholesale.co.uk/upload?order="+encodeURIComponent(btoa(JSON.stringify(order)))
  }