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

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