---
schema_version: "1"
id: ae7e190c98a7d33dfb892326e46f278f028382363c1d4fe2f2fa9a2f4e29638c
title: Custom B2C Commerce Storefront Data Integration
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/commerce/264-0-0/om_impl_int_custom_b2ce_data.md
canonical_url: https://help.salesforce.com/s/articleView?id=commerce.om_impl_int_custom_b2ce_data.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: f78423d0ae9d0b287bb93ed3518d1ae38fe7a6ed68388dbf36b2b7a454a8794e
description: You can pass custom data on certain B2C Commerce objects to Order Management by adding custom attributes to objects in B2C Commerce and matching custom fields to the corresponding objects in Order Management. When an attribute ID and field name match, and the data types also match, the values are included in the created Order Management records. If you also create a matching field on the corresponding summary object, Order Management includes the custom data when it creates a summary record.
products:
  - Commerce
  - Salesforce Order Management
release: "264"
---
# Custom B2C Commerce Storefront Data Integration

You can pass custom data on certain B2C Commerce objects to Order Management by adding custom attributes to objects in B2C Commerce and matching custom fields to the corresponding objects in Order Management. When an attribute ID and field name match, and the data types also match, the values are included in the created Order Management records. If you also create a matching field on the corresponding summary object, Order Management includes the custom data when it creates a summary record.

Only the B2C Commerce attribute ID and the Order Management field name at the API level are compared. UI labels aren’t considered.

If order data includes a custom attribute value but the corresponding Salesforce object has no matching custom field, the attribute is ignored. If a custom field exists in Salesforce and order data doesn’t include a matching custom attribute value, the field is ignored.

Also consider datatype compatibility between your storefront and Salesforce. All text values in order data that exceed the size of the corresponding field in Salesforce by three characters less than the datatype size limit and appends three periods (...). For example, if order data includes the value `Albuquerque` for a custom field with a maximum length of 10 characters, the value is stored as `Albuque...` in Salesforce.

![Important](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-commerce-om_order_management-264-0-0-production-enus/4c4844e3-a194-4a65-95b7-17291a6dbefa/images/icon_important.png)

Important If a custom field in Salesforce is required, and it corresponds to a custom storefront attribute, order data must include a value for that attribute. Otherwise, Order Management can’t create the corresponding Salesforce record and an error occurs.

At the API level, Salesforce custom field names always end in `__c`. Don’t include `__c` in the names of the matching attributes on your storefront objects. However, if you include a custom namespace in a custom field name, also include it in the name of the matching storefront object attribute. For example, if the API name of your custom field in Salesforce is `mynamespace_FieldName__c`, name your matching storefront object attribute mynamespace\_FieldName. Limit your custom field names to 40 characters (37 plus \_\_c).

You can use matching custom attributes and fields on these objects.

We don’t support custom object mapping or custom object lookup. If you try to map a custom attribute with a custom object lookup, the mapping fails.

 
| B2C Commerce | Salesforce Order Management |
| --- | --- |
| Gift Certificate Line Item, Order Line Item, and Shipping Line Item | OrderItem and OrderItemSummary |
| Order | Order and Order Summary |
| Order Payment Instrument and Payment Transaction | AlternativePaymentMethod, CardPaymentMethod, DigitalWallet, Payment, PaymentAuthorization, and PaymentGatewayLog |
| Shipment | OrderDeliveryGroup and OrderDeliveryGroupSummary |
| Buyer Address on Order | Account (including PersonAccount) and Contact |

#### See Also

- [Implement Order Management](https://help.salesforce.com/s/articleView?id=commerce.om_impl_intro.htm&release=264.0.0&type=5 "Order Management can run with all Commerce products. After configuration, there are some additional steps B2C Commerce orgs must take to link their stores with Order Management.")