Changed on:
14 Oct 2024
Plugin Name | Store |
---|
Components for managing instore processes.
Store version
fc.mystique.fields.basicpack
The Multi-Parcel field component provides the following features that enable users to submit additional and resourceful data during the packing operation:
`fc.mystique.fields.basicpack`
`custom`
`"minWeight"`
`"maxWeight"`
`custom`
`CONFIRM PACK`
`filled + rejected quantities = requested quantity`
The Multi-Parcel field is configurable via the `fc.mystique.fields.basicpack`
Name | Required | Type | Description |
query | No | String | An optional override for the default GraphQL query used to populate the basicpack component. The default query is provided below. The basicpack field requires certain data to be retrieved to function correctly, so if you need to retrieve more data than the default provides it is recommended to use the default query as a base and add additional fields to that, rather than generate a new query from scratch. |
attributes | No | Array | Optional overrides for the data shown in each column of the multi-parcel component. Configuration details and default values are captured in the Attributes Configuration section. By default without overrides the following fields are shown in the table: Order Reference, Customer Name, Order Type and Fulfilment Status. |
allowMultipleParcelsPerItem | No | Boolean | Determines whether to enable validation that limits the number of parcels that can be added to the fulfilment. When this setting is
|
defaultParcel | No | String | The default parcel type. This value will be preselected on the parcel type dropdown when the page first loads. This creates a more efficient packing process, however may increase user error. If no value is defined, then the initial state of the dropdown will be blank. This forces the user to explicitly choose a parcel each time. The string must match the name of the parcel types under parcels. Otherwise, the default will remain blank. |
parcels | No | Array of parcels | A list of parcels. Each entry in the array represents one option in the dropdown. Configuration details are captured in the Parcels data dictionary section. |
The following is the default query that is used to populate them basicpack component. If the
`query`
1query ($waveId: ID!) {
2 waveById(id: $waveId) {
3 id
4 ref
5 status
6 location {
7 id
8 ref
9 attributes {
10 name
11 type
12 value
13 }
14 }
15 fulfilments(first: 100) {
16 edges {
17 node {
18 id
19 ref
20 status
21 toAddress {
22 id
23 ref
24 }
25 items(first: 100) {
26 edges {
27 node {
28 ref
29 filledQuantity
30 rejectedQuantity
31 requestedQuantity
32 }
33 }
34 }
35 order {
36 id
37 ref
38 type
39 status
40 fulfilmentChoice {
41 deliveryType
42 }
43 customer {
44 firstName
45 lastName
46 primaryEmail
47 primaryPhone
48 }
49 }
50 }
51 }
52 }
53 }
54}
Language: plain_text
Name: Basicpack base query
Description:
[Warning: empty required content area]When not explicitly specified, the following configuration is displayed by default:
Name | Required | Type | Description |
value | No | String | The value for a corresponding cell in a given column. For example if you were to display the order reference number you would use
|
label | No | String | The column label. This is a template string For example if you were to display the label "Order Reference" you would use
|
hideBelow | No |
| Optional to hide columns and values below certain breakpoints. |
1 {
2 "attributes": [
3 {
4 "value": "{{data.order.ref}}",
5 "label": ["fc.sf.ui.wave.pickAndPack.list.pack.multiparcel.column.order.ref.heading", "Order reference"],
6 "hideBelow": "sm"
7 },
8 {
9 "value": "{{data.order.customer.firstName}} {{data.order.customer.lastName}}",
10 "label": ["fc.sf.ui.wave.pickAndPack.list.pack.multiparcel.column.customer.name.heading", "Customer name"]
11 },
12 {
13 "value": "{{orderType}}",
14 "label": ["fc.sf.ui.wave.pickAndPack.list.pack.multiparcel.column.order.type.heading", "Order type"]
15 },
16 {
17 "value": "{{data.status}}",
18 "label": ["fc.sf.ui.wave.pickAndPack.list.pack.multiparcel.column.fulfilment.status.heading", "Fulfilment status"]
19 }
20 ]
Language: plain_text
Name: Default Attributes
Description:
[Warning: empty required content area]Add the details about each individual parcel in the parcels object below
Name | Required | Type | Description |
name | Yes | String | The name of the parcel. This is what will be displayed on the dropdown to the end user. |
length(cm) | Yes | Number | The length of the parcel in centimetres |
width(cm) | Yes | Number | The width of the parcel in centimetres |
height(cm) | Yes | Number | The height of the parcel in centimetres |
barcode | No | String | This property will eventually be used for barcode scanning capabilities in the future. |
deafultWeight | No | Number | The default value of the weight. The weight field will be preselected with this value when this parcel is selected. |
minWeight | No | Number | The minimum weight of this parcel. If defined, the user has to input a weight value higher than this number. |
maxWeight | No | Number | The maximum weight of this parcel. If defined, the user has to input a weight value lower than this number. |
1{
2 "allowMultipleParcelsPerItem": false,
3 "parcelTypes": {
4 "defaultParcel": "small",
5 "parcels": [
6 {
7 "name": "small",
8 "length": "10",
9 "width": "10",
10 "height": "10",
11 "barcode": "10",
12 "defaultWeight": "10",
13 "minWeight": "10",
14 "maxWeight": "19"
15 },
16 {
17 "name": "medium",
18 "length": "20",
19 "width": "20",
20 "height": "20",
21 "barcode": "20",
22 "defaultWeight": "20",
23 "minWeight": "20",
24 "maxWeight": "29"
25 },
26 {
27 "name": "large",
28 "length": "30",
29 "width": "30",
30 "height": "30",
31 "barcode": "30",
32 "defaultWeight": "30",
33 "minWeight": "30",
34 "maxWeight": "39"
35 }
36 ]
37 }
38}
Language: json
Initial changelog entry.
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.