--- schema_version: "1" id: bb0575b11ae8a1857ef721b634350ed9ce9d88ae61837b96eb97016ce771f5bd title: Order Schema (Version 3.x) collection: developer version: current locale: en-us portal_url: https://docs.salesforce.com/developer/current/en-us/data-cloud/data-cloud-engagement-mobile-sdk/guides/c360a-api-engagement-mobile-sdk-order-schema-v3.md canonical_url: https://developer.salesforce.com/docs/data/data-cloud-engagement-mobile-sdk/guide/c360a-api-engagement-mobile-sdk-order-schema-v3.html source_site: developer.salesforce.com content_type: documentation content_hash: 72329e125843d1ea83db7d93b564e1bd07139a41f8f11f508586be02c6e877b1 products: - Data 360 Engagement Mobile SDK - Data 360 Developer Documentation --- # Order Schema (Version 3.x) An order interaction is a commerce action that captures actions performed by a user to manage new, in progress, or completed orders. | Source Event Property | Target Schema Developer Name | Field Type | Description | Customer 360 Data Model Object / Attribute | | ----------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | | \ | `eventId` | text | **Required**. Typically the primary key for the engagement events. | Engagement / Engagement Id | | \ | `dateTime` | datetime | **Required**. Used for data partitioning for engagement events. ISO 8601 supported format. | Engagement / Engagement Date Time | | \ | `eventType = "order"` | text | **Required**. The `developerName` of an event defined in the [Web Connector schema](https://help.salesforce.com/s/articleView?id=c360_a_mobile_web_sdk_schema_quick_guide.htm&type=5). | - | | \ | `sessionId` | text | **Required**. The identifier of the session. | - | | \ | `deviceId` | text | **Required**. Typically, the primary key for profile events. | Product Order Engagement / Individual | | \ | `category = "Engagement"` | text | **Required**. Possible values are:
  • `Engagement`
  • `Profile`
| - | | \ | `interactionName = "Cancel" \| "Deliver" \| "Exchange" \| "Preorder" \| "Purchase" \| "Return" \| "Ship"` | text | **Required**. A descriptive name for the event. | Product Order Engagement / Product Order Event Type | | \ | `channel = "mobile"` | text | The SDK event channel. For Engagement Mobile SDK, the value is `mobile`. | Engagement / Engagement Channel Type | | \ | `longitude` | number | The longitudinal coordinate in decimal degrees reported by the device at the time the event was captured. | Engagement / Device Longitude | | \ | `latitude` | number | The latitudinal coordinate in decimal degrees reported by the device at the time the event was captured. | Engagement / Device Latitude | | order.id | `orderId` | text | A unique identifier representing the order. | Engagement / Sales Order Product Engagement Action / Order Product Number | | order.totalValue | `orderTotalValue` | number | The total value of the order. | Product Order Engagement / Sales Order Product Engagement Action / Net Order Amount | | order.currency | `orderCurrency` | text | The currency of the total value for the order. | Product Order Engagement / Currency | | order.attributes | Refer to [Schema Field Naming Rules](https://developer.salesforce.com/docs/data/data-cloud-engagement-mobile-sdk/guide/c360a-api-engagement-mobile-sdk-mobile-schema-support.md) | object | A dictionary of user-supplied values. | - | Each [Line Item Attribute](https://developer.salesforce.com/docs/data/data-cloud-engagement-mobile-sdk/guide/c360a-api-engagement-mobile-sdk-line-item-attribute.md) contained in the [Order Event](https://developer.salesforce.com/docs/data/data-cloud-engagement-mobile-sdk/guide/c360a-api-engagement-mobile-sdk-order-event.md) gets mapped to a child event where order `EventId` is set to the `eventId` of the parent order event: | Source Event Property | Target Schema Developer Name | Data Type | Description | Customer 360 Data Model Object / Attribute | | ---------------------------------- | ---------------------------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------ | | \ | `eventId` | text | **Required**. Typically, the primary key for the engagement events. | - | | \ | `dateTime` | datetime | **Required**. Used for data partitioning for engagement events. ISO8601 supported format. | - | | \ | `eventType = "orderItem"` | text | **Required**. The `developerName` of an event defined in the [Web Connector schema](https://help.salesforce.com/s/articleView?id=c360_a_mobile_web_sdk_schema_quick_guide.htm&type=5). | - | | \ | `sessionId` | text | **Required**. An identifier for a session. | - | | \ | `deviceId` | text | **Required**. Typically, the primary key for profile events. | - | | \ | `category = "Engagement"` | text | **Required**. Possible values are:
  • `Engagement`
  • `Profile`
| - | | \ | `orderEventId` | text | **Required**. The `eventId` of the order event containing this Line Item. | Product Order Engagement | | `lineItem.catalogObjectType` | `catalogObjectType` | text | **Required**. A type name of the catalog object referenced in the line item. | - | | `lineItem.catalogObjectId` | `catalogObjectId` | text | **Required**. A unique identifier representing the catalog object referenced in the line item. | - | | `lineItem.quantity` | `quantity` | number | The number of catalog objects in the line item. | Product Order Engagement / Currency | | `lineItem.price` | `price` | number | The price of the catalog object referenced in the line item. | Product Order Engagement / Currency | | `lineItem.currency` | `currency` | text | The currency for the price field. | Product Order Engagement / Currency | | `lineItem.attributes.customField0` | `attributeCustomField0` | any | A user-supplied value. | - | | `lineItem.attributes.customFieldN` | `attributeCustomFieldN` | any | A user-supplied value. | - | **note:** Properties added to `lineItem.attributes` aren't automatically defined in the recommended schema. They're shown to demonstrate how the source properties are mapped to the target schema. Manually add the properties to the schema.