Concurrent Synchronization of Both Fusion Products and Salesforce Products

Beginning in Oracle CPQ 25D, Oracle CPQ introduces a new system attribute for Parts called the Fusion Part ID.

Prior to Oracle CPQ 25D, the existing Partner Part ID attribute was used as an external identifier for both Fusion Products and Salesforce Products. This introduced a limitation where CPQ could not link its Parts to both Fusion Products and Salesforce Products at once.

The new Fusion Part ID field has been added as a dedicated external identifier for Fusion Product Integrations. When integrating with Fusion Products all Oracle managed and seeded product-part syncs will leverage this field as a linking attribute and external ID.

Steps to Enable

If you are setting up a Salesforce Products integration for the first time, you do not need to take any additional steps. Any seeded integrations will be pre-mapped to use the original Partner Part ID attribute.

If you have an existing Salesforce Products integration you do not need to take any action. Existing integration files and field mappings will remain unchanged and will continue to use the Partner Part ID for all flows.

If you are setting up a Fusion Products integration for the first time, you do not need to take any additional steps to use the Fusion Part ID. It is available immediately upon upgrade and any managed or seeded integrations will use this attribute.

Note: If your site was provisioned prior to Oracle CPQ 25D and you have not previously set up the Fusion Products integration it is likely that the older seeded integration files will still reference the Partner Part ID field. You should modify these files to use the Fusion Part ID prior to enabling the integration.

For each of these conditions, you will be able to set up both the Fusion Product and Salesforce Product integrations at the same time using the out of the box integration setups.

If you have an existing Fusion Product integration setup on your site, the values stored in the Partner Part ID attribute will be copied to the Fusion Part ID attribute at the time of upgrade. Any Oracle managed integration flows will begin using the Fusion Part ID immediately. Any previously seeded Fusion integration files - those that were provided to sites provisioned prior to 25D - and custom integrations will continue to point at the old Partner Part ID.

To ensure that both patterns continue working without disruption we have provided a new setting on the Configuration Settings page called Update Partner Part ID with Fusion Part ID value. This property will ensure that the Fusion Part ID and Partner Part IDs are the same. Any updates to the Fusion Part ID as part of Fusion Product syncs will propagate to the Partner Part ID.

The Update Partner Part ID with Fusion Part ID value will be set to Yes at the time of upgrade if you have a Fusion Product integration defined and do not have a Salesforce Product integration set up. If you wish to set up a Salesforce Product Integration and a Fusion Product Integration up at the same time, this must be set to No. You must also refactor any seeded Fusion Products integration files and custom integrations to use the Fusion Part ID exclusively.

If you want to turn this setting off, follow these steps:

  1. Navigate to the Admin Home > Configuration Settings page.
  2. Click No to disable Update Partner Part ID with Fusion Part ID value within the Options - Unified Products Sync section. 

Disable Update Partner part ID with Fusion Part ID Value

  1. Click Save. 

Tips And Considerations

  • Salesforce Product integrations will continue using the existing Partner Part ID attribute for Parts Syncs. There are no changes in behavior for Salesforce Product integrations.
  • The Fusion Part ID field should not be used to store any information other than Fusion Product IDs. Doing so may cause upgrade issues and integration issues with other Fusion applications.
  • The Update Partner Part ID with Fusion Part ID value setting is a one-way sync. It will copy the Fusion Part ID to the Partner Part ID. It does not work the other way, any updates to the Partner Part ID mapping will not propagate to the Fusion Part ID.
  • The Update Partner Part ID with Fusion Part ID value setting will only be available for existing customers who already have a Fusion Product Integration defined. New customers and customers only using a Salesforce integration will not see this setting.
  • All customers with an existing Fusion Products integration that leverages the Partner Part ID should consider updating those integrations to leverage the Fusion Part ID exclusively to ensure that you can take advantage of future enhancements.