{"title":"Cart Object Reference","slug":"cart-object-reference","url":"https://support.storeconnect.com/articles/cart-object-reference","url_markdown":"https://support.storeconnect.com/articles/cart-object-reference.md","subtitle":null,"summary":"The customer\u0026#39;s shopping cart, holding Cart Items until checkout converts it to an Order. Usually created by the storefront, with lookups for store, contact and account, price book, promotion, shipping rate and carrier, collection point, and the user assisting the sale.","type":"Developer_Documentation","video_url":"","keywords":"salesforce, object reference, Cart, s_c__Cart__c, api","last_modified":"2026-08-21T07:12:35+0000","body_markdown":"## Overview\n\nThe customer's shopping cart holding Cart Items. The record is often generated from the Store website.\n\n| Property | Value |\n|----------|-------|\n| **API Name** | `s_c__Cart__c` |\n| **Label** | Cart |\n| **Plural Label** | Carts |\n| **Type** | Custom Object |\n\n## Fields\n\n| Field Label | API Name | Type | Required | Description |\n|-------------|----------|------|----------|-------------|\n| Abandoned | `s_c__Abandoned__c` | Checkbox | No | Determines whether the cart was abandoned. |\n| Account | `s_c__Account_Id__c` | Lookup ([Account](account-object-reference)) | No | The Account associated with this cart. |\n| Assisted By User | `s_c__Assisted_By_User_Id__c` | Lookup ([User](user-object-reference)) | No | The User who assisted with this cart. |\n| Billing City | `s_c__Billing_City__c` | Text(40) | No | The city of the customer's billing address. |\n| Billing Country Code | `s_c__Billing_Country_Code__c` | Text(80) | No | The country code of the customer's billing address. |\n| Billing Country | `s_c__Billing_Country__c` | Text(80) | No | The country of the customer's billing address. |\n| Billing Postal Code | `s_c__Billing_Postal_Code__c` | Text(20) | No | The postal code of the customer's billing address. |\n| Billing State Code | `s_c__Billing_State_Code__c` | Text(80) | No | The state code of the customer's billing address. |\n| Billing State | `s_c__Billing_State__c` | Text(80) | No | The state of the customer's billing address. |\n| Billing Street | `s_c__Billing_Street__c` | Text(255) | No | The street of the customer's billing address. |\n| Browser Country | `s_c__Browser_Country__c` | Text(255) | No | The country of the customer's browser. |\n| Browser Device Type | `s_c__Browser_Device_Type__c` | Text(255) | No | The device type of the customer's browser. |\n| Browser Geolocation | `s_c__Browser_Geolocation__c` | Location | No | The geolocation of the customer's browser. |\n| Browser Ip Address | `s_c__Browser_Ip_Address__c` | Text(255) | No | The IP address of the customer's browser. |\n| Browser Language | `s_c__Browser_Language__c` | Text(255) | No | The language of the customer's browser. |\n| Browser Name | `s_c__Browser_Name__c` | Text(255) | No | The name of the customer's browser. |\n| Browser Platform | `s_c__Browser_Platform__c` | Text(255) | No | The platform of the customer's browser. |\n| Browser Screen Resolution | `s_c__Browser_Screen_Resolution__c` | Text(255) | No | The screen resolution of the customer's browser. |\n| Browser Timezone | `s_c__Browser_Timezone__c` | Text(255) | No | The timezone of the customer's browser. |\n| Browser User Agent | `s_c__Browser_User_Agent__c` | Text(255) | No | The user agent of the customer's browser. |\n| Checkout Deposit Amount | `s_c__Checkout_Deposit_Amount__c` | Currency(18,2) | No | The deposit amount the customer chose to pay now at web checkout, with the balance collected later. Blank when no deposit is set. |\n| Checkout Email | `s_c__Checkout_Email__c` | Text(255) | No | The email used during checkout. |\n| Checkout Phone | `s_c__Checkout_Phone__c` | Text(255) | No | The phone number used during checkout. |\n| Checkout Shipping Email | `s_c__Checkout_Shipping_Email__c` | Text(255) | No | The shipping email used during checkout. |\n| Checkout Shipping Phone | `s_c__Checkout_Shipping_Phone__c` | Text(255) | No | The shipping phone number used during checkout. |\n| Collection Point | `s_c__Collection_Point_Id__c` | Lookup ([s_c__Collection_Point__c](collection-point-object-reference)) | No | The Collection_Point__c associated with this cart. |\n| Collection Point Stock Location | `s_c__Collection_Point_Stock_Location_Id__c` | Lookup ([s_c__Stock_Location__c](stock-location-object-reference)) | No | The Stock_Location__c associated with this cart. |\n| Contact | `s_c__Contact_Id__c` | Lookup ([Contact](contact-object-reference)) | No | The Contact associated with this cart. |\n| Customer Notes | `s_c__Customer_Notes_Long__c` | LongTextArea(10000) | No | Holds any notes supplied by the customer during checkout. |\n| Discount Amount | `s_c__Discount_Amount__c` | Currency(18,2) | No | The discount amount (dollar value) for the cart-wide discount. |\n| Discount Mode | `s_c__Discount_Mode__c` | Picklist | No | The mode of cart-wide discount applied. Can be: amount or percentage. |\n| Discount Percentage | `s_c__Discount_Percentage__c` | Number(18,2) | No | The discount percentage for the cart-wide discount. |\n| Order | `s_c__Order_Id__c` | Lookup ([Order](order-object-reference)) | No | The Order associated with this cart. |\n| Pricebook | `s_c__Pricebook_Id__c` | Lookup ([Pricebook2](pricebook2-object-reference)) | No | The Pricebook that this cart belongs to. |\n| Promotion | `s_c__Promotion_Id__c` | Lookup ([s_c__Promotion__c](promotion-object-reference)) | No | The Promotion__c associated with this cart. |\n| Ship To Account | `s_c__Ship_To_Account_Id__c` | Lookup ([Account](account-object-reference)) | No | The Account the cart's order will ship to. |\n| Ship To Contact | `s_c__Ship_To_Contact_Id__c` | Lookup ([Contact](contact-object-reference)) | No | The Contact the cart's order will ship to. |\n| Shipping Carrier Product | `s_c__Shipping_Carrier_Product_Id__c` | Lookup ([s_c__Shipping_Carrier_Product__c](shipping-carrier-product-object-reference)) | No | The Shipping_Carrier_Product__c associated with this cart. |\n| Shipping City | `s_c__Shipping_City__c` | Text(40) | No | The city of the customer's shipping address. |\n| Shipping Country Code | `s_c__Shipping_Country_Code__c` | Text(80) | No | The country code of the customer's shipping address. |\n| Shipping Country | `s_c__Shipping_Country__c` | Text(80) | No | The country of the customer's shipping address. |\n| Shipping Postal Code | `s_c__Shipping_Postal_Code__c` | Text(20) | No | The postal code of the customer's shipping address. |\n| Shipping Rate | `s_c__Shipping_Rate_Id__c` | Lookup ([s_c__Shipping_Rate__c](shipping-rate-object-reference)) | No | The Shipping_Rate__c associated with this cart. |\n| Shipping State Code | `s_c__Shipping_State_Code__c` | Text(80) | No | The state code of the customer's shipping address. |\n| Shipping State | `s_c__Shipping_State__c` | Text(80) | No | The state of the customer's shipping address. |\n| Shipping Street | `s_c__Shipping_Street__c` | Text(255) | No | The street of the customer's shipping address. |\n| Source | `s_c__Source__c` | Picklist | No | Where the cart was created. Can be: web, pos, api, or manual. |\n| Status | `s_c__Status__c` | Picklist | No | The current step of the cart, can be: open, customer, shipping, terms_and_conditions, payment, payment_processing, paid, complete, failed, quotation_requested. |\n| Store | `s_c__Store_Id__c` | Lookup ([s_c__Store__c](store-object-reference)) | No | The Store__c associated with this cart. |\n| Tax Provider Error | `s_c__Tax_Provider_Error__c` | Text(255) | No | The error returned from the tax provider service. |\n| Test Order | `s_c__Test_Order__c` | Checkbox | No | Determines whether the cart is a test order. |\n| StoreConnect External ID | `s_c__sC_Id__c` | Text(36) | No | StoreConnect External ID, do not modify in Salesforce |\n\n## Relationships\n\n| Field | Type | Related Object | Relationship Name |\n|-------|------|----------------|-------------------|\n| `s_c__Account_Id__c` | Lookup | [Account](account-object-reference) | Cart_Accounts |\n| `s_c__Assisted_By_User_Id__c` | Lookup | [User](user-object-reference) | Cart_Assisted_By_Users |\n| `s_c__Collection_Point_Id__c` | Lookup | [s_c__Collection_Point__c](collection-point-object-reference) | Cart_Collection_Points |\n| `s_c__Collection_Point_Stock_Location_Id__c` | Lookup | [s_c__Stock_Location__c](stock-location-object-reference) | Cart_Collection_Point_Stock_Locations |\n| `s_c__Contact_Id__c` | Lookup | [Contact](contact-object-reference) | Cart_Contacts |\n| `s_c__Order_Id__c` | Lookup | [Order](order-object-reference) | Cart_Orders |\n| `s_c__Pricebook_Id__c` | Lookup | [Pricebook2](pricebook2-object-reference) | Cart_Pricebooks |\n| `s_c__Promotion_Id__c` | Lookup | [s_c__Promotion__c](promotion-object-reference) | Cart_Promotions |\n| `s_c__Ship_To_Account_Id__c` | Lookup | [Account](account-object-reference) | Cart_Ship_To_Accounts |\n| `s_c__Ship_To_Contact_Id__c` | Lookup | [Contact](contact-object-reference) | Cart_Ship_To_Contacts |\n| `s_c__Shipping_Carrier_Product_Id__c` | Lookup | [s_c__Shipping_Carrier_Product__c](shipping-carrier-product-object-reference) | Cart_Shipping_Carrier_Products |\n| `s_c__Shipping_Rate_Id__c` | Lookup | [s_c__Shipping_Rate__c](shipping-rate-object-reference) | Cart_Shipping_Rates |\n| `s_c__Store_Id__c` | Lookup | [s_c__Store__c](store-object-reference) | Cart_Stores |\n\n## Referenced by\n\nThese objects hold a lookup or master-detail relationship to **Cart** (`s_c__Cart__c`). Where the referring record exists to join things together, **Also links to** shows what it connects this object to.\n\n| Object | Field | Type | Relationship Name | Also links to |\n|--------|-------|------|-------------------|---------------|\n| [s_c__Cart_Campaign__c](cart-campaign-object-reference) | `s_c__Cart_Id__c` | Lookup | Cart_Campaigns | — |\n| [s_c__Cart_Fulfillment__c](cart-fulfillment-object-reference) | `s_c__Cart_Id__c` | Lookup | Cart_Fulfillments | — |\n| [s_c__Cart_Item__c](cart-item-object-reference) | `s_c__Cart_Id__c` | Lookup | Cart_Cart_Items | — |\n| [s_c__Cart_Promotion2__c](cart-promotion2-object-reference) | `s_c__Cart_Id__c` | Lookup | Cart_Promotions_v2_Cart | [s_c__Promotion2__c](promotion2-object-reference) |\n\n\u003c!-- DIAGRAM OPPORTUNITY\n     This object is a hub: 13 outbound and 4 inbound relationships. An entity-relationship diagram grouping these by functional area would let a reader see its place in the model without reading two long tables.\n     Deferred to the diagram phase; remove this comment when a diagram is added. --\u003e"}