Enable Fluent Store Multi-Parcel
Author:
Fluent Commerce
Changed on:
13 Nov 2023
Key Points
- This document serves as a practical hands-on guide to enable Multi-Parcel in your account.
- It is recommended to be used alongside the Multi-Parcel field document.
Prerequisites
Steps
Update the Store Location workflow
If you have customised the Store Location workflow you may need to refer to your Fluent Partner or team for a customised guide on implementing Multi-Parcel
Within the “Store” Location workflow, edit the
`WaveDispatch`
- Add the rule
`FLUENTRETAIL.base.SendEventForAllFulfilmentsFromWaveWithArticleInfo`
If your workflow contains either of the following rules they can now be removed:
`FLUENTRETAIL.base.SendEventForAllFulfilmentsFromWave`
`SendEventWithAttributesForAllFulfilments`
Add the following attributes to the same
`WaveDispatch`
1"attributes": [
2 {
3 "name": "allFulfilmentArticles",
4 "label": "All Fulfilment Articles",
5 "type": "MULTI_PARCEL_FIELD",
6 "source": "",
7 "defaultValue": "",
8 "mandatory": true
9 }
10]
Language: json
Name: WaveDispatch Ruleset
Description:
[Warning: empty required content area]Modify the manifest for the Waves Wizard
- The proposed changes assume that you are using the supplied fragment and configuring from there.
`fc.mystique.manifest.store.fragment.waves`
- If you have customised or aren’t using the supplied waves fragment, then you may be able to skip this step entirely or refer to your Fluent Partner or team for a customised guide.
- You will notice that the Pack page will have excess components that we no longer need, resulting in a suboptimal UX. To combat this, we recommend editing the fragment with the following changes:
`fc.mystique.manifest.store.fragment.waves`
- Remove the component from descendants within the
`fc.list`
component, within the`fc.pages.wizard`
where`step`
=`title`
`"i18n:fc.sf.ui.waves.wizard.pack.title"`
- Add to the props of the
`noCard: true`
component located within the same aforementioned`fc.page.wizard.action`
titled`step`
`"i18n:fc.sf.ui.waves.wizard.pack.title"`
- Remove the
Configure your Parcel types
Two options exist for populating the various parcel types that appear on the packing screen. Please note, you can configure different parcel types on all Context levels. Meaning that you can have different Stores with different configurations.
Option A (recommended):
- Use the setting. Details about this setting can be found within the Multi-Parcel field component page
`fc.mystique.fields.basicpack`
Option B (legacy):
Supported for backwards compatibility purposes, parcel types can be configured as a location attribute. Please note this option has less fields and supported features, we strongly recommend using Option A.
- Add a location level attribute
- Name =
`PACKAGING`
- Type =
`OBJECT`
- Value = an array of parcel types, see below example and data dictionary
- Name =
1[
2 {
3 "name": "Attributes Small Box",
4 "depth": "10",
5 "width": "10",
6 "height": "10",
7 "maxWeight": "10"
8 },
9 {
10 "name": "Attributes Medium Box",
11 "depth": "20",
12 "width": "20",
13 "height": "20",
14 "maxWeight": "20"
15 },
16 {
17 "name": "Attributes Large Box",
18 "depth": "30",
19 "width": "30",
20 "height": "30",
21 "maxWeight": ""
22 }
23]
Language: json
Name: SAMPLE LOCATION ATTRIBUTE
Description:
[Warning: empty required content area]Legacy Location Data Dictionary:
Name | Type | Description |
name |
| The name of the parcel type. This value will be used as the dropdown option name. |
depth |
| The depth (aka the length) of this parcel type. |
width |
| The width of this parcel type. |
height |
| The height of this parcel type. |
maxWeight |
| The maximum weight of this parcel type. The form will not accept a weight value higher than this number. Can be empty or omitted. |