POST
/
carts
/
{cartId}
/
actions
/
split-line-item
curl --request POST \
  --url https://api.fabric.inc/v3/carts/{cartId}/actions/split-line-item \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-fabric-tenant-id: <x-fabric-tenant-id>' \
  --data '{
  "lineItemId": "d7e78a21-bee3-4448-bf1c-d5b5461dbda2",
  "quantities": [
    1
  ]
}'
{
  "id": "c695af14-5e33-402c-9d8d-71edcf4856a8",
  "createdAt": "2022-09-06T14:07:17.000Z",
  "updatedAt": "2022-09-06T14:07:17.000Z",
  "name": "cart_it",
  "description": "IT department cart",
  "lineItems": [
    {
      "id": "12gved0f-7645-40cb-y7b0-167f8bggdb3z",
      "itemId": 234343,
      "position": 1,
      "name": "Varnet Garden Light Kit",
      "sku": "16B2GS8LD5FDS",
      "productAttributes": [
        {
          "attributeId": "60c2a358eb2ec30008ae70a1",
          "name": "gift wrapping (small)",
          "description": "Gift wrapping for a small package",
          "mapping": "ITEM",
          "type": "GIFT",
          "value": "true",
          "price": 10,
          "level": "order"
        }
      ],
      "createdAt": "2022-09-06T14:07:17.000Z",
      "updatedAt": "2022-09-06T14:07:17.000Z",
      "quantity": 15,
      "priceListId": 108674,
      "isActive": true,
      "price": "<any>",
      "discounts": [
        {
          "amount": 100.15,
          "quantity": 1,
          "proratedAmount": 100.15,
          "proratedQuantity": 1,
          "application": 1,
          "promotion": {
            "id": "6197ec46e836ff000952d668",
            "value": 2000.15,
            "groupId": "61a6354d0d70e30009415f16",
            "level": 1,
            "isStackable": true,
            "isAlwaysApplied": true,
            "name": "20% OFF",
            "type": "Coupon",
            "discountType": "AMOUNT_OFF"
          }
        }
      ],
      "groups": [
        "61d38e117162b7dba69c3d6d"
      ],
      "attributes": {
        "productFamily": "Laptop computers"
      },
      "channel": "12",
      "isPickup": true,
      "warehouseId": "XYZ-1234",
      "shippingDetails": {
        "id": "fef78121-bee3-4448-bf1c-d5b5461dbda2",
        "createdAt": "2022-09-06T14:07:17.000Z",
        "updatedAt": "2022-09-06T14:07:17.000Z",
        "address": {
          "addressLine1": "123 Main St.",
          "addressLine2": "Suite 100",
          "addressLine3": "Seventh floor",
          "addressLine4": "Attention: Pat E. Kake",
          "city": "Seattle",
          "region": "WA",
          "country": "USA",
          "postalCode": "98121",
          "attention": "Billing manager",
          "email": "test@example.com",
          "type": "shipping",
          "name": "Pat E Kake",
          "phone": {
            "number": "123-456-7899",
            "type": "MOBILE"
          }
        },
        "type": "SHIP_TO_ADDRESS",
        "taxCode": "FR1000",
        "isPickup": true,
        "altPickupPerson": {
          "name": "Pat E Kake",
          "phone": {
            "number": "123-456-7899",
            "type": "MOBILE"
          },
          "email": "test@example.com"
        },
        "pickupPerson": {
          "name": "Pat E Kake",
          "phone": {
            "number": "123-456-7899",
            "type": "MOBILE"
          },
          "email": "test@example.com"
        },
        "warehouseId": "XYZ-1234",
        "storeId": "ABC-123",
        "shippingCost": 150.25,
        "shippingMethodId": "dfsae-2d32113-32lpdd",
        "shippingDiscount": 150.25,
        "shippingMethodName": "Express Delivery"
      },
      "fulfillment": {
        "type": "WEB_SDD",
        "networkCode": "ShipToHome",
        "channelId": "12",
        "inventoryType": "availableToPurchase",
        "inventory": {
          "inventoryId": "723910d81723",
          "sku": "SKU1",
          "itemId": 12345,
          "locationNumber": 12345,
          "region": "North America",
          "channelId": "channel_xyz",
          "vendorId": "vendor1",
          "createdAt": "2022-08-01T18:03:28.483Z",
          "updatedAt": "2022-08-01T20:03:28.483Z",
          "leadTime": "5 days",
          "type": "primary",
          "hasInfiniteInventory": true,
          "backorderShipmentAt": "2022-08-01T20:03:28.483Z",
          "preorderShipmentAt": "2022-08-01T20:03:28.483Z",
          "backorderLimit": 50,
          "preorderLimit": 40,
          "safetyStock": 10,
          "lowStock": 10,
          "networkCode": "ShipToHome",
          "counters": {
            "onHand": 100,
            "allocated": 10,
            "shipped": 20
          },
          "customAttributes": {
            "isBopis": true
          },
          "networkCounters": {
            "softReserve": 10
          },
          "virtualCounters": {
            "availableToPurchase": 60
          }
        }
      },
      "fees": [
        {
          "feeId": "73bc09d0-874a-4c3d-84d0-df1670d03578",
          "name": "gift",
          "type": "gift_wrap",
          "amount": 10.5,
          "attributes": {
            "from": "sam"
          }
        }
      ],
      "adjustments": [
        {
          "id": "c695af14-5e33-402c-9d8d-71edcf4856a8",
          "amount": 60.5,
          "reason": "CSR Adjustment",
          "attributes": {
            "productFamily": "Laptop computers"
          },
          "createdAt": "2022-09-06T14:07:17.000Z",
          "updatedAt": "2022-09-06T14:07:17.000Z"
        }
      ]
    }
  ],
  "totalItems": 3,
  "totalUniqueItems": 2,
  "status": "PENDING",
  "accountId": "5f689caa4216e7000750d1ef",
  "configuration": {
    "allowAnonymousUser": true,
    "orderNumberSource": "CART_ID",
    "isSoftReservationEnabled": true,
    "orderSequence": {
      "sequenceName": "ORDER_NUMBER",
      "sequenceKey": "LOCATE"
    },
    "orderNumberGeneration": "AUTO"
  },
  "customerContext": {
    "id": "d7e78a21-bee3-4448-bf1c-d5b5461dbda2",
    "type": "EMPLOYEE",
    "attributes": {
      "isAdmin": false
    },
    "segments": [
      [
        {
          "name": "category",
          "value": [
            "GOLD",
            "YELLOW"
          ]
        }
      ]
    ]
  },
  "totalAmount": 10,
  "totalDiscount": 10,
  "totalFees": 10,
  "subTotal": 10,
  "currency": "USD",
  "attributes": {
    "approver": "620d8896058edb0009385311"
  },
  "appliedDiscounts": [
    [
      {
        "promotionId": "6197ec46e836ff000952c665",
        "promotionName": "Buy shoes get socks for free",
        "couponCode": "SUPERCOUPON20",
        "type": "COUPON",
        "amount": 105.15
      }
    ]
  ],
  "fees": [
    {
      "feeId": "73bc09d0-874a-4c3d-84d0-df1670d03578",
      "name": "gift",
      "type": "gift_wrap",
      "amount": 10.5,
      "attributes": {
        "from": "sam"
      }
    }
  ],
  "suggestedProducts": [
    {
      "promotionId": "6197ec46e836ff000952c665",
      "promotionName": "Buy shoes get socks for free",
      "itemId": 234343,
      "itemIds": [
        500001
      ],
      "sku": "SHOE1234",
      "skus": [
        "SHOE-4"
      ],
      "eligiblePriceLists": [
        1000
      ],
      "quantity": 2,
      "promotionQuantity": 10,
      "isFree": true,
      "discountType": "PERCENTAGE_OFF",
      "amount": 100.15
    }
  ],
  "orderNumber": "121213",
  "error": {
    "prices": [
      {
        "price": "<any>",
        "kind": "PROMOTION",
        "channel": "12",
        "position": 1,
        "discounts": [
          {
            "amount": 100.15,
            "quantity": 1,
            "proratedAmount": 100.15,
            "proratedQuantity": 1,
            "application": 1,
            "promotion": {
              "id": "6197ec46e836ff000952d668",
              "value": 2000.15,
              "groupId": "61a6354d0d70e30009415f16",
              "level": 1,
              "isStackable": true,
              "isAlwaysApplied": true,
              "name": "20% OFF",
              "type": "Coupon",
              "discountType": "AMOUNT_OFF"
            }
          }
        ]
      }
    ],
    "promotionErrors": [
      {
        "itemId": 234343,
        "sku": "16B2GS8LD5FDS",
        "code": "UNKNOWN_ERROR",
        "detail": "Item is out of stock",
        "position": 1
      }
    ],
    "inventoryErrors": [
      {
        "itemId": 234343,
        "sku": "16B2GS8LD5FDS",
        "code": "UNKNOWN_ERROR",
        "detail": "Item is out of stock",
        "position": 1
      }
    ]
  }
}

Authorizations

Authorization
string
headerrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

x-fabric-tenant-id
string
required

Merchant's 24-character tenant ID

x-fabric-channel-id
string

Sales channel ID

x-fabric-request-id
string

Unique request ID

Path Parameters

cartId
string
required

Cart ID

Body

application/json
lineItemId
string
required

Line item id

quantities
integer[]
required

Line item quantities for each split line item, meaning quantities assigned to each individual line item after the original line item (by lineItemId) is split into multiple line items.

Response

200 - application/json
id
string | null

Unique cart identifier

createdAt
string

Time cart was created

updatedAt
string

Time cart was last updated

name
string | null

Cart name

description
string | null

Cart description

lineItems
object[]
totalItems
integer | null

Number of line items in the cart

totalUniqueItems
integer | null

Number of different (unique) line items in the cart based on line item ID

status
enum<string>

Cart status <br/> PENDING - Cart is in pending state <br/> DELETED - Cart is in deleted state

Available options:
PENDING,
DELETED
accountId
string | null

Customer account ID

configuration
object

Cart configurations

customerContext
object

Customer context

totalAmount
number | null

Total price of line items after discount, including shipping and shipping discount

totalDiscount
number | null

Total discount applied to cart

totalFees
number | null

Total fees applied to cart

subTotal
number | null

Total price of line items, including shipping, without discount

currency
string
default: USD

Currency type

attributes
object

Cart attributes

appliedDiscounts
array

Applied discounts

fees
object[] | null
suggestedProducts
object[] | null

Suggested free products

orderNumber
string | null

The order number

error
object

Errors in this cart