Fluent Commerce Logo
Docs
Sign In

Multi-Parcel Component

UI Component

Changed on:

16 Oct 2024

Overview

  • Multi-Parcel is an alternative Wave configuration to the Packing step for Fluent Store. The Multi-Parcel field component supports the ability to create multiple parcels per fulfilment.
  • It supports the ability to create common parcel types for a location. These parcel types can contain useful information such as dimensions and weight attributes to improve the packing process.
  • To get started with the Multi-Parcel field component in your Fluent Store configuration we recommend the following knowledge base guide.
No alt text provided
Plugin NameStore

Components for managing instore processes.

2023-10-12

v1.0.0

Store version

Alias

MULTI_PARCEL_FIELD, fc.action.field.multiparcel

Detailed technical description

Use Cases

The Multi-Parcel field component provides the following features that enable users to submit additional and resourceful data during the packing operation:

  • Create and submit more than one parcel per order fulfillment
  • Define common parcel types, enabling you to do the following:
    • Define a preselected default parcel type value. This allows in-store associates to skip having to select a parcel type for each fulfilment, particularly useful if the Operation only has one primary parcel type
    • Optionally disable preselected parcel types on the ‘select parcel type’ dropdown. This ensures that in-store associates select a parcel type each time
    • Specify dimensional data for each parcel type
    • Option to specify minimum and maximum weights for each parcel type, to ensure users enter reasonable values to avoid under/overstating cost implications with Carriers
    • Option to define a default weight for each parcel type so that users don’t always need to manually capture the weight of each parcel resulting in a more efficient packing time per order
    • Capture custom parcel dimensions to cater for situations where none of the usual parcels are suitable for the fulfilment
    • Set different parcel types at different contexts or locations so that individual stores can have their own unique preset packaging options
    • Supports mobile views
No alt provided

Field behaviour

Adding and Removing parcels

  • In-Store Associates are able to add another parcel to the top of the table via the ADD PARCEL button
  • When there is more than one parcel, a REMOVE button appears on each row, allowing the users to remove that row.

Choosing a Parcel type

  • The parcel type can be chosen from a dropdown and should reflect the physical container the Packer has chosen to put the items into. These are sourced from either the 
    `fc.mystique.fields.basicpack`
     setting or the legacy attributes solution. See configuration behaviour for more details.
  • If no parcel types are configured, then the only available option will be 
    `custom`
     and preselected for the user.

Parcel Dimensions and Weights

  • After selecting a parcel type, the user must specify a weight. If the parcel type has a default weight, this field will be preselected with that value, allowing the user to accept a default if it is suitable for their operation.
  • The "weight" field will accept positive values in kilograms (kg) to two decimal places between 
    `"minWeight"`
     and 
    `"maxWeight"`
     (if defined, see configuration).
  • When a 
    `custom`
     parcel type is chosen the Packer will be prompted to enter the dimensions for the parcel, these must be positive values to a maximum of one decimal place.
  • Otherwise, if a preconfigured parcel type has been chosen, these dimensions will be used downstream.

Submission

  • Upon 
    `CONFIRM PACK`
     the end-user will be met with an error message if they have attempted to submit with any values blank. Otherwise, the user will then progress onto step 3 of the Wave Wizard - Dispatch.

Field Logic

  • The Multi-Parcel field refreshes the Wave data until it is deemed ready for parcel creation. Specifically, until each of the items is
    `filled + rejected quantities = requested quantity`
    . If this statement does not return true then the field component will not load.

Configuration Options

The Multi-Parcel field is configurable via the 

 setting.


Properties

The multi parcel field component is a field and needs to be configured via the 

 setting. Please refer to that setting's page for information on its properties.

Version History

0000-00-00

v1.0.0

Initial changelog entry.

Recommended Placement

N/A