Deal Price List Assignment Update Request and Response - Tags in the XML Format

Note: We recommend you to refer the topics Deal Price List Assignment Update Request in the XML Format and Deal Price List Assignment Update Response in the XML Format in parallel while understanding the below mentioned tags. This will help you to understand how the tags are nested in the XML format.

Before calling the C1-DealPricelistAssignmentBS business service through an inbound web service, you need to ensure that the deal price list assignment update request contains the following tags:

Tag Name Tag Description Mandatory (Yes or No)
dealIdentifier Used to update the price list assignment of an entity (i.e. existing or prospect person or account) in the entity hierarchy of a deal which is created using a particular deal identifier. Yes (Conditional)
Note: This data is required if you do not specify the dealID or modelID tags.
dealId Used to specify the deal for which you want to update the price list assignment. Yes (Conditional)
Note: This data is required if you do not specify the dealIdentifier or modelID tags.
modelId Used to specify the deal version for which you want to update the price list assignment. Yes (Conditional)
Note: This data is required if you do not specify the dealIdentifier or dealID tags.
pricelistassignmentlist Used to update the price list assignment of the entities (i.e. existing or prospect person or account) in the entity hierarchy of the deal. Yes
entityId Used to specify the entity (i.e. existing or prospect person or account) whose price list assignment you want to update. Yes
entityType Used to indicate the type of the entity whose price list assignment you want to update. The valid values are:
  • PERS

  • ACCT

Yes
actionFlag Used to indicate that you want to create a request to update the price list assignment. The valid value is:
  • UPD

Note: If you do not specify the value in this tag, the system considers it as an Add action.
Yes
priceListAssignmentId Used to specify the price list assignment which you want to update. Yes
startDate Used to specify the date from when the price list assignment is effective for the entity (i.e. existing or prospect person or account).
Note:

The price list assignment start date must be equal to the deal start date.

The price list assignment start date cannot be later than the price list assignment end date.

If you do not specify the value in this tag, the system considers the deal start date as the price list assignment start date.

Yes
endDate Used to specify the date till when the price list assignment is effective for the entity (i.e. existing or prospect person or account).
Note:

The price list assignment end date cannot be later than the deal end date.

The price list assignment end date cannot be earlier than the price list assignment start date.

Yes
priority Used to specify the priority in which the price list is considered to determine the price item pricing.
Note:

The priority of the price list assignment must be greater than zero.

You cannot have same priority for price list assignments having the same effective start date and end date.

Yes
priceListId Used to specify the price list that you want to assign to the entity (i.e. existing or prospect person or account). Yes
priceListInheritanceSw Used to indicate whether the price item pricing is inherited from the parent price list hierarchy defined for the price list which is assigned to the entity (i.e. existing or prospect person or account). The valid values are:
  • Y

  • N

Note: If you do not specify the value in this tag, the system considers it as N.
Yes
Note: When you create a request to update a price list assignment, the system replaces the price list assignment data instead of editing it. Therefore, you should provide all details of the price list assignment including the data that you want to change.

Once the deal price list assignment is updated, all the details of deal price list assignment are listed in the above mentioned tags.

Related Topics

For more information on... See...
Sample deal price list assignment update request and response in the XML format Sample Deal Price List Assignment Update Request and Response in the XML Format