TMF637 v4 Product Inventory Management - Outbound Notification
Use TMF637 Outbound Notification API to retrieve product inventory information. Outbound notifications are triggered for these events. They are triggered only for the parent entity (Asset entity).
/api/notification/productCreateEvent/api/notification/productAttributeValueChangeEvent/api/notification/productStateChangeEvent(status field)
The user must configure the notification framework to detect CDC events and invoke the relevant TMF Open API implementations that generate the event payloads and forward them to the target systems configured within the API.
This API has been tested with an external system using TMF-aligned customizations. It may not include all optional fields and may not work out-of-the-box with your system. Customizations will likely be required. We recommend a thorough evaluation to ensure it meets your specific needs.
This API is available in the managed package.
- MuleSoft License required: MuleSoft Direct for Communications Cloud (add-on for Communications Cloud) or MuleSoft Anypoint Base Subscription.
- Communications cloud license required: Communications Cloud Growth.
- Lifecycle Management license with AssetLifecycleManagementAddon.
- Org Perm check: IndustriesCPQService
- The notification uses a fire-and-forget approach. Salesforce does not process or store the response in any objects. MuleSoft logs and tracks all received notifications.
- In alignment with TMF v4 standards for event notifications, the system sends the same payload, which includes the full product resource and the supported related sub-resources, for all events.
- Access to the target system is authenticated using the OAuth 2.0 Client Credentials grant type.
- In case of failure when invoking the target system endpoint, the request is retried up to three times, with a two second interval between attempts.
- TMF637 v4 Inbound API response may include optional fields. According to TMF specifications, if the outbound Event Notification payload contains unsupported optional parameters, the downstream system may reject it with a 4xx error. To avoid this, tailor the payload to include only the optional fields supported by the client.
- Salesforce and MuleSoft do not have a centralized event hub configured by default. Customers are responsible for setting up their own event hub to manage subscribers. Outbound notifications are generated and sent directly to a single, client-defined target endpoint.
Below is a summary of the change events supported for the Asset entity, along with the required configuration to trigger them through the notification framework.
When configuring Object Integration Definitions, use the exact RelatedFieldName values listed in the table below.
| TMF Resource | Salesforce Entity | Scenario | changeEventType Supported | Notification Event Path | RelatedFieldName |
|---|---|---|---|---|---|
| Product | Asset | Creation of a new Asset | Create | /api/notification/productCreateEvent | "RelatedFieldName":"vlocity_cmt__AssetReferenceId__c" |
| Updates to attributes of an existing Asset record | Update | /api/notification/productAttributeValueChangeEvent | "RelatedFieldName":"vlocity_cmt__AssetReferenceId__c" | ||
| Updates to the Asset.Asset.vlocity_cmt__ProvisioningStatus__c attribute | Update | /api/notification/productStateChangeEvent | "RelatedFieldName":"vlocity_cmt__AssetReferenceId__c" |
This is a sample payload sent to the target system endpoint for the event Type: ProductCreateEvent.
The event notification payload is same for all three events (ProductCreateEvent, ProductAttributeValueChangeEvent, ProductAttributeValueChangeEvent). The eventType value will differ between the three events.
| TMF Field | TMF Type | Is it Mandatory ? | Supported | Mappings |
|---|---|---|---|---|
| id | string | No | TRUE | Mule correlation Id |
| eventId | string | No | TRUE | inputPayload.eventId |
| eventTime | string | No | TRUE | inputPayload.commitTimestamp as UTC |
| eventType | string | No | TRUE | ProductCreateEvent or ProductAttributeValueChangeEvent or ProductStateChangeEvent |
| correlationId | string | No | TRUE | inputPayload.correlationId |
| timeOcurred | string | No | TRUE | inputPayload.commitTimestamp as UTC |
| event.product | object | Yes | TRUE | TMF637v4 Inbound response payload |
- Sub-Resources with Parent-Mapped Attributes
Fields from TMF sub-resources such as
RelatedParty,BillingAccountandProductCharacteristicare mapped to the parent Asset. Attribute change notifications must be configured on Asset and published to/api/notification/productAttributeValueChangeEvent. Separate configurations for these sub-resources are not required. - Sub-Resource Changes Leading to Asset Creation
For the TMF sub-resource
ProductOrderItem, actions such as Modify or Change of Plan create new Asset entities. Notifications for these events must be configured to/api/notification/productCreateEvent. Similarly, updates to Product Offering or Product Specification also trigger new orders and asset creations, requiring notifications to the same endpoint.