Manage Subscriptions subflow: Change address

LFS version: requires Limio for Salesforce v12.39 or later

Limio version requirement: requires Limio v93 or later

In previous versions, this process was referred to as "Change Delivery Address" and it only allowed customers to update their delivery address. The updated process now allows customers to update their billing address as well, or both their billing and delivery addresses, all in a single order.

Action visibility rules

Change address action is allowed if a subscription is not a purchased gift and its end date is in the future. This rule can be customised if needed via Apex: Flow Customisation: Override Supported Subscription Actions

Flow overview

This flow consists of the following elements:

Input properties of this flow include recordId (which is passed form the parent flow) and current subscription in context of which the flow is being run.

1. Specify address type
   For bundle or physical subscriptions, users will have to choose which address type they want to amend: delivery, billing, or both:
   
   Labels on this screen are configurable in the flow builder.
   
   This step is omitted for digital subscriptions: users are navigated straight to the form to update a Billing address if the subscription is digital.
   
   
2. Change address form
   
   Label at the top of the form reflects the address type chosen on the previous step or defaults to Billing for digital subscriptions.
   If selected "Both", the label changes to "Delivery and Billing Address Details":
   - This component includes an Address book feature. It is a dropdown menu that displays previously used customer addresses. Users can select an address from the dropdown to automatically fill in the form fields with the corresponding values.
   
   - Built-in validation of the postal/zip code comes from the metadata config and can be customised: Flow Customisation: How to enforce address postcode validation using regular expressions, and add custom validation message
   
   - The available countries in the dropdown menu of the form are determined by the list of allowed countries specified in the associated offer.
   Note: To customise the country list, provide a list of iso2Code strings in the Allowed Countries input property. To see all countries, simply clear the Allowed Countries input property.
   
   
3. Order Summary Screen

The final screen provides a summary of the address type being modified and the corresponding value:

Known limitations

Customer Timeline component will reflect an event for change_address order type, but the content is not available in the current Limio version.

Implementation details

Note: a new package version installation does not affect your existing flow copies.
With the new version, Change address becomes available to all subscriptions (digital and physical). To make sure that your flow works as expected, navigate to you Change address flow copy and make the necessary changes, there are several options:

1. Use selectedSubscription.hasDelivery property to verify if you expect the Change Address action to be available.
2. Optional: Add a screen with radio buttons to let users select the address type to update: delivery, billling or all.
3. Populate Address type to update input property on Limio Delivery Address and Limio Order Summary components with "delivery" to execute the flow only for Delivery address updates. Alternatively, pass the selected choice from the radio buttons:
   
   

Related articles

1. Flow Customisation: Override Supported Subscription Actions
2. Flow Customisation: How to enforce address postcode validation using regular expressions, and add custom validation message