Bulky Waste configuration - new April 2024

From April 2024 the following additions have been made to the Bulky Waste form functionality.

Dynamic Item List Look up

The Item List displayed in the form is dynamically retrieved in real time from the waste system meaning that the configuration is only maintained in one place. The following configuration supports this

{
      "key": "BulkyItemTypesSource",
      "value": "wasteapi"
    }

Note: where this option is used the form will display the item description used in the waste system and there is no facility to amend this in the form configuration.

This functionality is dependent on the waste management system providing an api to support it and has initially been developed for use with Alloy.

Provider Discounts

Discounts can be configured based on data held in the waste system. For example if collections for council owned properties are discounted and if the address is flagged as council owned in the waste system this can be used to set a Provider Discount price.

In the example below the providerCustomDiscount is set where the premise is Hackney Housing:

],
  "priceLists": [
    {
      "priceListItems": [
        {
          "minItemQuantity": 1,
          "maxItemQuantity": 5,
          "basePrice": 21.35,
          "baseDiscountedPrice": 0,
          "pricePerItem": null,
          "discountedPricePerItem": null,
          "providerCustomDiscounts": [
            {
              "fieldValueMatch": "True",
              "discountTypeId": "PremisesHackneyHousing",
              "basePrice": 0,
              "pricePerItem": 0
            }
          ],
          "formCustomDiscounts": [
            {
              "fieldValueMatch": "Yes",
              "discountTypeId": "FormCustomDiscountQuestion1",
              "basePrice": 0,
              "pricePerItem": 0
            }
          ]

Note: this functionality will require additional development in order to configure to specific use cases for each council.

Form Custom Discounts

It is now possible to add custom questions to the form to be used to drive the setting of certain discounts and it is possible to configure whether the question is displayed if the form is accessed via OneVu, ServiceVu or standalone (outside of both).

For example where collections are discounted for Universal Credit, since this cannot be verified in real time, a question can be added to the form to support this and it can be set to only display in ServiceVu. In the example configuration below the Custom Discount Question 1 is set to only display in ServiceVu (CSVu)

 "formCustomDiscountTypes": [
    {
      "Id": "FormCustomDiscountQuestion1",
      "CSVuVisible": true,
      "OneVuVisible": false,
      "StandaloneVisible": false
    }
  ],

The question label is configured in Resources. Up to 3 Custom Discount questions can be supported. Currently the questions are all of a yes/no type and are all placed on the who are you page in a fixed position.

Note: further additional development may be required depending on the nature of the specific discount required.

Form Custom Questions

Custom questions can be added to the form and can enable additional integration with the waste management system. An example of this functionality is a custom question that asks whether a collection is assisted or not with a yes/no response. The answer to this question can then drive integration to the waste system to set a marker on the collection job that it is assisted.

 "formCustomQuestions": [
    {
      "Id": "FormCustomQuestion1",
      "SendToProvider": true
    }
  ],

The question label is maintained in Resources.

This functionality is designed to enhance the flexibility of the standard form where a council has additional policies that they need to cater for. Currently only one custom question is supported of a yes/no type and the placement of the question is fixed.

Note: further additional development will be required depending on the nature of the question and the integration it is designed to support.

Address filter - Alloy specific

An address filter can be configured to limit the search to a specific prefix on the waste system

In this example addreses with a preifx of R in the BlpuClass will be returned to the form and any others will be excluded

"addressSearchFilters": [
    {
      "filter": "attributes_premisesBlpuClass",
      "include": true,
      "stringMatch": "Prefix",
      "value": "R"
    }
  ],