Siebel CRM Web Services Reference > Siebel CRM Primary Web Services >
PromotionWebService
NOTE: This version of PromotionWebService is available only for implementations of Siebel CRM from version 8.1 and later. To use PromotionWebService with Siebel CRM version 8.0, see version 8.0 of Siebel CRM Web Services Reference.
Use this Web service to get product promotion information, apply product promotion, get promotion commitment information and to upgrade a promotion. PromotionWebService Operations
For a list of operations associated with this Web service, see Table 909.
Table 909. PromotionWebService Operations
|
|
getProductPromotionDefinition |
Returns promotion detail information. |
ApplyProductPromotion |
Add a promotion and all default components to a quote or order. |
getPromotionCommitments |
Get promotion commitment information for a given promotion asset. |
UpgradePromotionToQuote |
Upgrade or migrate a promotion instance to another promotion and generate a quote with the updated assets information. |
UpgradePromotionToOrder |
Upgrade or migrate a promotion instance to another promotion and generate an order with the updated assets information. |
Request Message Description: GetProductPromotionDefinition
For a description of this request message, see Table 910.
Table 910. Request Message Description: GetProductPromotionDefinition
|
|
|
EligibilityMode |
Optional, default value as 2. Could be 0, 1, 2. |
Not applicable |
PricingMode |
Optional, default value as Y. Y or N. |
Not applicable |
LoadAllDomainFlag |
Required value of Y or N. |
Not applicable |
LoadDefaultDomainFlag |
Required value of Y or N. |
Not applicable |
LoadPromDefFlag |
Required value of Y or N. |
Not applicable |
ContextMode |
Required, Siebel Context or External Context. |
Not applicable |
Context |
Required, in SiebelMessage format of IO PDS Catalog Context. |
Not applicable |
ProdPromRuleType |
Optional, Product or Pricing. |
Not applicable |
Response Message Description: GetProductPromotionDefinition
For a description of this response message, see Table 911.
Table 911. Response Message Description: GetProductPromotionDefinition
|
|
|
ProdPromDefinition |
In SiebelMessage format of the integration object ISS Promotion Definition for WS. |
Not applicable |
PromDomainProduct |
In SiebelMessage format of the integration object PDS Product Interface'. Could be either default domain product details or all domain product details depending on input arguments. |
Not applicable |
Err_spcCode |
Error Code if error occurred. |
Not applicable |
Err_spcMessage |
Error Message if error occurred. |
Not applicable |
Request Message Description: ApplyProductPromotion
For a description of this request message, see Table 912.
Table 912. Request Message Description: ApplyProductPromotion
|
|
|
EligibilityMode |
Optional. The default value is 2. Could be 0, 1, 2. |
Not applicable |
PricingMode |
Optional. The default value as Y. Possible values are Y or N. |
Not applicable |
ProdPromId |
Required. |
Not applicable |
ProdPromInstanceId |
Optional, depending on usage scenarios. This parameter lets you add a promotion to an existing quote and associate products already on the quote with the promotion. For more information on using this parameter, see My Oracle Support and query for Doc ID: 1924501.1. |
Not applicable |
LineItemId |
Optional, depending on usage scenarios. |
Not applicable |
Quantity |
Optional. The default value is 1. |
Not applicable |
SiebelMessage |
Required, in SiebelMessage format of the integration object PDS Quote. |
Not applicable |
Response Message Description: ApplyProductPromotion
For a description of this response message, see Table 913.
Table 913. Response Message Description: ApplyProductPromotion
|
|
|
SiebelMessage |
Required. In SiebelMessage format of the integration object PDS Quote. |
Not applicable |
Err_spcCode |
Error code if one occurred. |
Not applicable |
Err_spcMessage |
Error message if one occurred. |
Not applicable |
Request Message Description: getPromotionCommitments
For a description of this request message, see Table 914.
Table 914. Request Message Description: getPromotionCommitments
|
|
|
Asset Integration Id |
Required. Asset Integration ID of the Promotion Instance Asset. |
String |
Response Message Description: getPromotionCommitments
For a description of this response message, see Table 915.
Table 915. Response Message Description: getPromotionCommitments
|
|
|
PromotionCommitments |
An instance of the integration object ISS Promotion Commitments. |
Integration Object |
Request Message Description: UpgradePromotionToQuote
For a description of this request message, see Table 916.
Table 916. Request Message Description: UpgradePromotionToQuote
|
|
|
NewPromotionId |
Required. RowId of new promotion. |
String |
AssetNumber |
Asset number of the selected promotion asset. Provide either AssetNumber or AssetIntegrationId. |
String |
AssetIntegrationId |
Asset integration ID of the selected promotion asset. Provide either AssetNumber or AssetIntegrationId. |
String |
ActiveDocumentId |
A Document in Siebel Order Management refers to a Quote or an Order. Each Document can have multiple children (Quote Items or Order Line Items). ActiveDocumentId refers to the current active Document that the current process is working on. In this Web service call, it is the Quote ID of the active Quote to which the generated quote item has to be added. This is an optional input. |
String |
AccountId |
Account ID of the account that owns the selected promotion asset being upgraded. |
String |
OverridePenaltyAmount |
Penalty amount for upgrading the promotion, if any. |
String |
OverrideProratePlanId |
If there is a penalty for upgrading the promotion, also pass in the prorate plan used to prorate this penalty, if any. |
String |
Response Message Description: UpgradePromotionToQuote
For a description of this response message, see Table 917.
Table 917. Response Message Description: UpgradePromotionToQuote
|
|
|
QuoteIO |
An instance of the integration object PDS Quote. |
Integration Object |
Request Message Description: UpgradePromotionToOrder
For a description of this request message, see Table 918.
Table 918. Request Message Description: UpgradePromotionToOrder
|
|
|
NewPromotionId |
Required. RowId of new promotion. |
String |
AssetNumber |
Asset Number of the selected promotion asset. Provide either AssetNumber or AssetIntegrationId. |
String |
AssetIntegrationId |
Asset Integration ID of the selected promotion asset. Provide either AssetNumber or AssetIntegrationId. |
String |
ActiveDocumentId |
A Document in Siebel Order Management refers to a Quote or an Order. Each Document can have multiple children (Quote Items or Order Line Items). ActiveDocumentId refers to the current active Document that the current process is working on. In this Web service call, it is the Order ID of the active Order to which the generated order item has to be added. This is an optional input. |
String |
AccountId |
Account ID of the account that owns the selected promotion asset being upgraded. |
String |
OverridePenaltyAmount |
Penalty amount for upgrading the promotion, if any. |
String |
OverrideProratePlanId |
If there is a penalty for upgrading the promotion, also pass in the prorate plan used to prorate this penalty, if any. |
String |
Response Message Description: UpgradePromotionToOrder
For a description of this response message, see Table 919.
Table 919. Response Message Description: UpgradePromotionToOrder
|
|
|
OrderIO |
An instance of the integration object PDS Order. |
Integration Object |
PromotionWebService Application Interface
This topic describes the application objects called by this Web service. For more information on application implementation, refer to your application development documentation on Oracle Technology Network. Service Object (Business Service or Workflow)
For a description of the service objects for this Web service, see Table 920.
Table 920. PromotionWebService Service Objects
|
|
ISS Promotion WS - GetPromotionCommitments |
Workflow |
ISS Promotion WS-Upgrade Promotion-Quote |
Workflow |
ISS Promotion WS-Upgrade Promotion-Order |
Workflow |
Data Object (Integration Object)
For a description of data objects for this Web service, see Table 921.
Table 921. PromotionWebService Data Objects
|
|
ISS Promotion Commitments |
ISS Promotion Commitments |
PDS Quote |
PDS Quote |
PDS Order |
PDS Order |
Example Package for PromotionWebService
To view an example of messages for this Web service, navigate to the documentation library for Siebel Business Applications on Oracle Technology Network, and click the Related Files link next to the link for Siebel CRM Web Services Reference to access a zip file. Extract the files in the zip file. Interface Description (WSDL) for PromotionWebService
To view the interface description for this Web service, navigate to the documentation library for Siebel Business Applications on Oracle Technology Network, and click the Related Files link next to the link for Siebel CRM Web Services Reference to access a zip file. Extract the files in the zip file. ...\PromotionWebService\PromotionWebService.wsdl
|