Skip to main content

Bill of materials, shopping cart and order links

Easy PV and HeatpünkHeatpunk 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 based on the bill of materials generated by the software for a given project. The bill of materials for the project is refreshed every time you visit the overview page of the project is opened by a projectuser in Easy PV or Heatpünk.Heatpunk.

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 ordercart linkarray isreturns anthe easyfull waybill of materials as a JSON. This contains all the products that have been specified in the project. 

The midsummerOrderLink returns a URL that can be used 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.

Create or modify order link strings

In its simplest form, an order can be just an object with an 'items' property. For each item, specify the property.the products by providing the product ID and the quantity required.

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 yourthe order,JSON simplyobject containing the products required for the project ou can create an order string by stringifyingfollowing these steps

  1. Stringify the object,object
    2. then
  2. Base64 encoding the result, then URL encodingencode the result Thenof gothe stringified object
  3. URL encode the base64 encoded string
  4. Append your string to the following URL to create your custom order link https://midsummerwholesale.co.uk/upload?order=[result string]

In JavaScript the function you need to generate an order is:

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