Bulky Waste Configuration
This is the only area with any complexity in the set up of this form. There is a file in the Files area of Forms System Management for the Bulky Waste form called:
configuration/serviceconfigurationmappings.json
This file contains:
the pricing model you have
the list of all items that can be collected and
the code associated with this in your back office waste management system
detail on whether the item is classed as white goods or not
This file is in JSON format and so takes a little time to review but is simple when you know how.
Pricing Config
In the file there is a section like this which is outlines the price for Bulky Waste Items.
In summary this section of JSON below is saying:
1 item is £19.60 (basePrice) and there is no discount (baseDiscountedPrice) for one item
2-5 items is £32.60 (basePrice) and a discounted price of £25.50 (baseDiscountedPrice) if they are on benefits
6-20 items is £32.60 (basePrice) and there a discounted price of £25.50 (baseDiscountedPrice) if they are on benefits and for each item beyond 5 items there is a cost of £11.70 (pricePerItem) or £10.70 (discountedPricePerItem) if they're on benefits.
"priceListItems": [ { "minItemQuantity": 1, "maxItemQuantity": 1, "basePrice": 19.6, "baseDiscountedPrice": null, "pricePerItem": null, "discountedPricePerItem": null }, { "minItemQuantity": 2, "maxItemQuantity": 5, "basePrice": 32.6, "baseDiscountedPrice": 25.5, "pricePerItem": null, "discountedPricePerItem": null }, { "minItemQuantity": 6, "maxItemQuantity": 20, "basePrice": 32.6, "baseDiscountedPrice": 25.5, "pricePerItem": 11.7, "discountedPricePerItem": 10.7 } ], "name": "Bulky waste items",
The same exists for white goods but with different info.
In summary this section of JSON below is saying:
There is only one price rule and for any number of items between 1 and 9 the cost is £26.70 (pricePerItem) per item.
"priceListItems": [ { "minItemQuantity": 1, "maxItemQuantity": 9, "basePrice": null, "baseDiscountedPrice": null, "pricePerItem": 26.7, "discountedPricePerItem": null } ], "name": "Bulky white goods"
There is therefore an enormous amount of flexibility in how you do your pricing. You can have:
A set cost per item
A set cost per item where they are in receipt of benefits
A cost for a range e.g. 1-3 items
A cost for a range e.g. 1-3 items where they are in receipt of benefits
A mix of costs / ranges e.g.
1 item costs £20.00
2-5 costs £30.00
6-10 costs £50.00
11+ is £50 + £20 for each additional item
And these can be different for regular goods vs bulky white goods.
Payment Integration - Whitespace
The following section contains details of the information that is relevant to the payment system.
In summary this section is holding details to say:
When the item(s) to be collected is/are regular bulky waste:
the payment reference for your payment system is r1
the fund code for your payment system is f1
the description the customer will see when making a payment in your payment system will be Bulky waste items collection
When the item(s) to be collected is/are bulky white goods:
the payment reference for your payment system is r2
the fund code for your payment system is f2
the description the customer will see when making a payment in your payment system will be Bulky white goods collection
"bulkyWasteItemGroups": [ { "groupId": "29", "groupName": "Bulky waste items", "purchasableItemDetails": { "reference": "r1", "fundCode": "f1", "description": "Bulky waste items collection", "price": null } }, { "groupId": "30", "groupName": "Bulky white goods", "purchasableItemDetails": { "reference": "r2", "fundCode": "f2", "description": "Bulky white goods collection", "price": null } }
Payment Integration - Bartec Collective
For Bartec, payment integration is controlled within the 'Bulky Waste Item Groups section.
Per the example section below this holds:
Details of different Bulky Collections
Standard Bulky Waste Items
Small Electrical Goods
Bulky Electrical Goods
The groupId is how this is known to the Bartec system
The purchasable item details holds the following which are used to pass the details to your payment system:
The payment reference
The fund code
The description for the receipt from the payment system
The price
The VAT code for the payment system
Bulky Waste Items that can be collected
The next section contains the list of all items that can be collected by type.
The section below contains:
The id for each bulky waste item that can be collected
The name that will be shown to the customer
The following are just some examples:
"bulkyWasteItemLists": [ { "bulkyWasteItemTypes": [ { "id": "201", "name": "5 Black Bags As One Item" }, { "id": "202", "name": "Armchair" }, { "id": "203", "name": "Bed Base" },
So if I want to add a new item I'd literally just find out the id of the item as it is known in the back office. So if my item was a Canvas Painting with an id of 999 I'd add:
{ "id": "999", "name": "Canvas Painting" }
The IDs are used to know what to add to the job that is created.
At the bottom of the list is a number that identifies the items as being regular bulky items:
"bulkyWasteGroupId": "29"
Bulky White Goods Items that can be collected
The next section contains the list of all items that can be collected by type.
The section below contains:
The id for each bulky white good item that can be collected
The name that will be shown to the customer
The following are just some examples:
"bulkyWasteItemTypes": [ { "id": "218", "name": "Cooker (Gas Or Electric)" }, { "id": "225", "name": "Dishwasher" }, { "id": "236", "name": "Freezer (Empty)" },
The IDs are used to know what to add to the job that is created.
At the bottom of the list is a number that identifies the items as being bulky white goods:
"bulkyWasteGroupId": "30"
So whilst the JSON file is a little complex it is remarkably simple to update/configure additional flexibility.
Example File - Bartec Collective
Example File - Whitespace
Last updated
Was this helpful?