Validate Product Discovery (POST)

Validate that a product is discoverable at runtime by checking price book entries, selling models, pricing procedures, and decision table configurations.

Use this resource at design time to confirm that a product’s discovery-related setup is correct before runtime product discovery. Provide a product ID, product code, or developer name. The API resolves the target product and validates pricing, price book entries, and selling model configurations that would otherwise surface as failures during discovery.

Validations include confirming that at least one product identifier is provided; that the product exists; that an active price book entry with a unit price greater than zero is associated with an active price book; and that the product is associated with an active product selling model option. When the Select Pricing Procedure preference is enabled, the API also checks that a product discovery pricing procedure is configured with an active version, that an active decision table with source object PricebookEntry exists, and that the product’s price book entry can be resolved by that decision table.

When the discovery setup is valid, isValid is true. When setup fails, isValid is false and errors parameter includes the failure details. Discovery setup failures are returned in the response body with HTTP status 200. Examples include:

SF-INS-DSAV-00011 — the product doesn’t have a price book entry.
SF-INS-DSAV-00004 — the product isn’t associated with a product selling model option.
SF-INS-DSAV-00040 — the product discovery pricing procedure isn’t configured.
SF-INS-DSAV-00047 — no active decision table with source object PricebookEntry was found.
SF-INS-DSAV-00046 — the product’s price book entries aren’t included in any active decision table.

Request-level failures are also returned in errors. A missing product identifier returns SF-INS-DSAV-00038 with HTTP status 400. A product that can’t be found returns SF-INS-DSAV-00044 with HTTP status 400. Insufficient access, or Digital Insurance not enabled for the org, returns INSUFFICIENT_ACCESS with HTTP status 403. An unexpected failure returns INTERNAL_SERVER_ERROR with HTTP status 500.

Informational messages appear in infos. For example, SF-INS-DSAV-00042 indicates that pricing is disabled for product discovery and pricing procedure validation was skipped, and SF-INS-DSAV-00043 reminds you to refresh decision tables after recent changes.

Resource

1/connect/insurance/design-advisor/product-discovery-validation

Resource Example

Replace {yourInstance} with the My Domain name of your Salesforce org.

1https://{yourInstance}.salesforce.com/services/data/v68.0/connect/insurance/design-advisor/product-discovery-validation

Available Version

68.0

HTTP Methods

POST

Request Body for POST

JSON Example

1{
2  "productId": "01txx0000006iPnAAI"
3}

Properties

Specify at least one of productId, productCode, or productName. If none is provided, validation fails with error code SF-INS-DSAV-00038.

Name	Type	Description	Required or Optional	Available Version
`productCode`	String	Product code used to look up the insurance product to validate for discovery setup.	Required if `productId` and `productName` aren’t specified	68.0
`productId`	String	Product2 ID of the insurance product to validate for discovery setup.	Required if `productCode` and `productName` aren’t specified	68.0
`productName`	String	Developer name used to look up the insurance product to validate for discovery setup.	Required if `productId` and `productCode` aren’t specified	68.0

Response Body for POST

Insurance Product Discovery Validation Response