Fluent Commerce Logo
Docs
Sign In

Enable Fluent Store Multi-Parcel

How-to Guide

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.

Steps

Step arrow right iconUpdate 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`
 ruleset to:

  • 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`
 ruleset:

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]

Step arrow right iconModify the manifest for the Waves Wizard

  • The proposed changes assume that you are using the supplied 
    `fc.mystique.manifest.store.fragment.waves`
     fragment and configuring from there.
  • 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 
    `fc.mystique.manifest.store.fragment.waves`
     fragment with the following changes:
    • Remove the 
      `fc.list`
       component from descendants within the 
      `fc.pages.wizard`
       component, within the 
      `step`
       where 
      `title`
       = 
      `"i18n:fc.sf.ui.waves.wizard.pack.title"`
    • Add 
      `noCard: true`
       to the props of the 
      `fc.page.wizard.action`
       component located within the same aforementioned 
      `step`
      titled 
      `"i18n:fc.sf.ui.waves.wizard.pack.title"`


Step arrow right iconConfigure 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 
    `fc.mystique.fields.basicpack`
     setting. Details about this setting can be found within the Multi-Parcel field component page

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
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

`String`

The name of the parcel type. This value will be used as the dropdown option name.

depth

`Number`

The depth (aka the length) of this parcel type.

width

`Number`

The width of this parcel type.

height

`Number`

The height of this parcel type.

maxWeight

`Number`
(Optional) 

The maximum weight of this parcel type. The form will not accept a weight value higher than this number. Can be empty or omitted.

Copyright © 2024 Fluent Retail Pty Ltd (trading as Fluent Commerce). All rights reserved. No materials on this docs.fluentcommerce.com site may be used in any way and/or for any purpose without prior written authorisation from Fluent Commerce. Current customers and partners shall use these materials strictly in accordance with the terms and conditions of their written agreements with Fluent Commerce or its affiliates.

Fluent Logo