Sitecore API catalog/OrderCloud/
/
Create or update a cart l...

Create or update a cart line item

Request

Security
OAuth2(Required scopes: FullAccessOrderContributorShopper)
Path
lineItemIDstringrequired

ID of the line item.

Bodyapplication/jsonrequired
ProductIDstringrequired
Example:""
IDstring, <= 100 characters
Example:""
Quantityinteger, (int32), >= 1
Default:1
Example:0
UnitPricenumber, (float)

Auto calculated price per quantity. Modification requires OverrideUnitPrice role.

Example:0
CostCenterstring

For reference only, does not influence any OrderCloud behavior.

Example:""
DateNeededstring, (date-time)
Example:"2018-01-01T00:00:00-06:00"
ShippingAccountstring

For reference only, does not influence any OrderCloud behavior.

Example:""
ShippingAddressIDstring
Example:""
ShipFromAddressIDstring

Marketplace owner or supplier AddressID where the product will be shipped from. Can be used to calculate shipping costs.

Example:""
InventoryRecordIDstring

InventoryRecordID of which product inventory location to use. Cannot be modified once an order is submitted.

Example:""
SpecsArray of objects(LineItemSpec)
Example:
[
  {
    "SpecID": "",
    "Name": "",
    "OptionID": "",
    "Value": "",
    "PriceMarkupType": "NoMarkup",
    "PriceMarkup": 0
  }
]
xpobject
Example:
{}
curl -i -X PUT \
  'https://api.ordercloud.io/v1/cart/lineitems/{lineItemID}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "ID": "",
    "ProductID": "",
    "Quantity": 0,
    "BundleItemID": "",
    "IsBundle": false,
    "DateAdded": "2018-01-01T00:00:00-06:00",
    "QuantityShipped": 0,
    "UnitPrice": 0,
    "PromotionDiscount": 0,
    "BaseDiscount": 0,
    "DiscountID": "",
    "LineTotal": 0,
    "LineSubtotal": 0,
    "CostCenter": "",
    "DateNeeded": "2018-01-01T00:00:00-06:00",
    "ShippingAccount": "",
    "ShippingAddressID": "",
    "ShipFromAddressID": "",
    "Product": {
      "ID": "",
      "Name": "",
      "Description": "",
      "Returnable": false,
      "QuantityMultiplier": 0,
      "ShipWeight": 0,
      "ShipHeight": 0,
      "ShipWidth": 0,
      "ShipLength": 0,
      "DefaultSupplierID": "",
      "ParentID": "",
      "xp": {}
    },
    "Variant": {
      "ID": "",
      "Name": "",
      "Description": "",
      "ShipWeight": 0,
      "ShipHeight": 0,
      "ShipWidth": 0,
      "ShipLength": 0,
      "xp": {}
    },
    "ShippingAddress": {
      "ID": "",
      "DateCreated": "2018-01-01T00:00:00-06:00",
      "CompanyName": "",
      "FirstName": "",
      "LastName": "",
      "Street1": "",
      "Street2": "",
      "City": "",
      "State": "",
      "Zip": "",
      "Country": "",
      "Phone": "",
      "AddressName": "",
      "xp": {}
    },
    "ShipFromAddress": {
      "ID": "",
      "DateCreated": "2018-01-01T00:00:00-06:00",
      "CompanyName": "",
      "FirstName": "",
      "LastName": "",
      "Street1": "",
      "Street2": "",
      "City": "",
      "State": "",
      "Zip": "",
      "Country": "",
      "Phone": "",
      "AddressName": "",
      "xp": {}
    },
    "SupplierID": "",
    "InventoryRecordID": "",
    "PriceScheduleID": "",
    "IsOnSale": false,
    "PriceOverridden": false,
    "Specs": [
      {
        "SpecID": "",
        "Name": "",
        "OptionID": "",
        "Value": "",
        "PriceMarkupType": "NoMarkup",
        "PriceMarkup": 0
      }
    ],
    "IncomingOrderID": "",
    "OutgoingOrderID": "",
    "xp": {}
  }'

Responses

Bodyapplication/json
IDstring, <= 100 characters
Example:""
ProductIDstring
Example:""
Quantityinteger, (int32), >= 1
Default:1
Example:0
BundleItemIDstringread-only

The ID of the line item that represents the bundle. Signifies that the product is being purchased as part of a bundle.

Example:""
IsBundlebooleanread-only

When true, this item represents a bundle being purchased.

Example:false
DateAddedstring, (date-time)read-only
Example:"2018-01-01T00:00:00-06:00"
QuantityShippedinteger, (int32)read-only

Sum of QuantityShipped from all shipment items.

Example:0
UnitPricenumber, (float)

Auto calculated price per quantity. Modification requires OverrideUnitPrice role.

Example:0
PromotionDiscountnumber, (float)read-only

Sum of all line item level promotion discount amounts applied.

Example:0
BaseDiscountnumber, (float)read-only

Discount amount from discount assignments applied to this line item.

Example:0
DiscountIDstringread-only

ID of the discount applied to this line item.

Example:""
LineTotalnumber, (float)read-only

LineSubtotal - BaseDiscount - PromotionDiscount

Example:0
LineSubtotalnumber, (float)read-only

UnitPrice x Quantity

Example:0
CostCenterstring

For reference only, does not influence any OrderCloud behavior.

Example:""
DateNeededstring, (date-time)
Example:"2018-01-01T00:00:00-06:00"
ShippingAccountstring

For reference only, does not influence any OrderCloud behavior.

Example:""
ShippingAddressIDstring
Example:""
ShipFromAddressIDstring

Marketplace owner or supplier AddressID where the product will be shipped from. Can be used to calculate shipping costs.

Example:""
Productobject(LineItemProduct)read-only
Example:
{
  "ID": "",
  "Name": "",
  "Description": "",
  "Returnable": false,
  "QuantityMultiplier": 0,
  "ShipWeight": 0,
  "ShipHeight": 0,
  "ShipWidth": 0,
  "ShipLength": 0,
  "DefaultSupplierID": "",
  "ParentID": "",
  "xp": {}
}
Variantobject(LineItemVariant)read-only
Example:
{
  "ID": "",
  "Name": "",
  "Description": "",
  "ShipWeight": 0,
  "ShipHeight": 0,
  "ShipWidth": 0,
  "ShipLength": 0,
  "xp": {}
}
ShippingAddressobject(Address)read-only
Example:
{
  "ID": "",
  "DateCreated": "2018-01-01T00:00:00-06:00",
  "CompanyName": "",
  "FirstName": "",
  "LastName": "",
  "Street1": "",
  "Street2": "",
  "City": "",
  "State": "",
  "Zip": "",
  "Country": "",
  "Phone": "",
  "AddressName": "",
  "xp": {}
}
ShipFromAddressobject(Address)read-only
Example:
{
  "ID": "",
  "DateCreated": "2018-01-01T00:00:00-06:00",
  "CompanyName": "",
  "FirstName": "",
  "LastName": "",
  "Street1": "",
  "Street2": "",
  "City": "",
  "State": "",
  "Zip": "",
  "Country": "",
  "Phone": "",
  "AddressName": "",
  "xp": {}
}
SupplierIDstringread-only
Example:""
InventoryRecordIDstring

InventoryRecordID of which product inventory location to use. Cannot be modified once an order is submitted.

Example:""
PriceScheduleIDstringread-only

PriceScheduleID used to determine unit price.

Example:""
IsOnSalebooleanread-only

True when the price schedule and price break has an active SalePrice.

Example:false
PriceOverriddenbooleanread-only

If true, UnitPrice was overridden.

Example:false
SpecsArray of objects(LineItemSpec)
Example:
[
  {
    "SpecID": "",
    "Name": "",
    "OptionID": "",
    "Value": "",
    "PriceMarkupType": "NoMarkup",
    "PriceMarkup": 0
  }
]
IncomingOrderIDstringread-only

ID of the original order. Only returns a value for the marketplace owner.

Example:""
OutgoingOrderIDstringread-only

ID of the split or forwarded order. Only returns a value for the marketplace owner.

Example:""
InvitationIDstringread-only
xpobject
Example:
{}
Response
{
  "ID": "",
  "ProductID": "",
  "Quantity": 0,
  "BundleItemID": "",
  "IsBundle": false,
  "DateAdded": "2018-01-01T00:00:00-06:00",
  "QuantityShipped": 0,
  "UnitPrice": 0,
  "PromotionDiscount": 0,
  "BaseDiscount": 0,
  "DiscountID": "",
  "LineTotal": 0,
  "LineSubtotal": 0,
  "CostCenter": "",
  "DateNeeded": "2018-01-01T00:00:00-06:00",
  "ShippingAccount": "",
  "ShippingAddressID": "",
  "ShipFromAddressID": "",
  "Product": {
    "ID": "",
    "Name": "",
    "Description": "",
    "Returnable": false,
    "QuantityMultiplier": 0,
    "ShipWeight": 0,
    "ShipHeight": 0,
    "ShipWidth": 0,
    "ShipLength": 0,
    "DefaultSupplierID": "",
    "ParentID": "",
    "xp": {}
  },
  "Variant": {
    "ID": "",
    "Name": "",
    "Description": "",
    "ShipWeight": 0,
    "ShipHeight": 0,
    "ShipWidth": 0,
    "ShipLength": 0,
    "xp": {}
  },
  "ShippingAddress": {
    "ID": "",
    "DateCreated": "2018-01-01T00:00:00-06:00",
    "CompanyName": "",
    "FirstName": "",
    "LastName": "",
    "Street1": "",
    "Street2": "",
    "City": "",
    "State": "",
    "Zip": "",
    "Country": "",
    "Phone": "",
    "AddressName": "",
    "xp": {}
  },
  "ShipFromAddress": {
    "ID": "",
    "DateCreated": "2018-01-01T00:00:00-06:00",
    "CompanyName": "",
    "FirstName": "",
    "LastName": "",
    "Street1": "",
    "Street2": "",
    "City": "",
    "State": "",
    "Zip": "",
    "Country": "",
    "Phone": "",
    "AddressName": "",
    "xp": {}
  },
  "SupplierID": "",
  "InventoryRecordID": "",
  "PriceScheduleID": "",
  "IsOnSale": false,
  "PriceOverridden": false,
  "Specs": [
    { … }
  ],
  "IncomingOrderID": "",
  "OutgoingOrderID": "",
  "xp": {}
}