Configuring Split Line Items

Splitting line items allows the user to split a single line item into multiple line items based on quantity.

Prerequisites

The following prerequisites must be completed sequentially to configure splitting line items.

1. Create a cart.
2. Add an item to the cart that needs to be split.

The sum of the quantities of the split items must not exceed the total quantity of the line item.

Split Line Items Initialization

All information from the original item is copied to the split items except for the item ID, quantity, createdAt, and updatedAt timestamps. Adjustments, fees, and fulfillment can be copied to split items based on configuration. The default setting is NONE, meaning these elements aren’t copied to split items unless specified.

The following code sample provides an example for split line items request payload:

Click to expand the JSON example.

    {
        "quantities": [2,1],
        "adjustmentsBehaviour": "COPY",
        "feesBehaviour": "COPY",
        "fulfillmentBehaviour": "COPY"
    }

The quantities array allows users to specify the number and quantity of split items. The total number of split items is quantities.size + 1.
In this example, a line item with 6 units and quantities set to [2, 1] splits into 3 items with quantities [2, 1, 3], where the last quantity represents the remainder. With adjustmentsBehaviour, feesBehaviour, and fulfillmentBehaviour set to COPY, adjustments, fees, and fulfillment details from the original item are copied to each split item.

The quantities array lets users specify the number and quantity of split items. The total number of split items will be quantities.size plus 1.

For example, if a line item has 6 units and quantities is [2, 1], it will be split into 3 items with quantities [2, 1, 3], where the last quantity is the remainder.

The following code sample provides an example for split line items request payload with the quantities:

Split line items request payload

Click to expand the JSON example.

    {
        "quantities": [2,1],
        "adjustmentsBehaviour": "COPY",
        "feesBehaviour": "COPY",
        "fulfillmentBehaviour": "COPY"
    }

Examples

The item is available in limited quantities at multiple warehouses

Use the split line items endpoint to split and ship items from different locations as in the following example:

Click to expand the curl example.

In this example, 4 units are available in Warehouse A, and the remaining units are in Warehouse B.

curl --location '{{modular_cart_domain}}/carts/9877b7ab-092d-4d67-ad42-b070ac778df8/items/806d6671-801d-4554-976d-0d38e525a852/actions/split' \
--header 'x-fabric-tenant-id:  {tenantId}' \
--header 'Content-Type: application/json' \
--data '{
    "quantities": [4,5],
    "adjustmentsBehaviour": "COPY",
    "feesBehaviour": "COPY",
    "fulfillmentBehaviour": "COPY"
}'

Sending individual items in the order to different addresses as gifts

Use the split line items endpoint to split items in the cart and send them to different addresses as in the following example:

Click to expand the curl example.

curl --location '{{modular_cart_domain}}/carts/9877b7ab-092d-4d67-ad42-b070ac778df8/items/806d6671-801d-4554-976d-0d38e525a852/actions/split' \
--header 'x-fabric-tenant-id:  {tenantId}' \
--header 'Content-Type: application/json' \
--data '{
    "quantities": [4,5],
    "adjustmentsBehaviour": "COPY",
    "feesBehaviour": "COPY",
    "fulfillmentBehaviour": "COPY"
}'

Splitting items for promotional bundles or discounts

Use the split line items endpoint to split the items in the cart and item prices will adjust appropriately as in the following example:

Click to expand the curl example.

curl --location '{{modular_cart_domain}}/carts/9877b7ab-092d-4d67-ad42-b070ac778df8/items/806d6671-801d-4554-976d-0d38e525a852/actions/split' \
--header 'x-fabric-tenant-id:  {tenantId}' \
--header 'Content-Type: application/json' \
--data '{
    "quantities": [4,5],
    "adjustmentsBehaviour": "COPY",
    "feesBehaviour": "COPY",
    "fulfillmentBehaviour": "COPY"
}'