Deal Price Assignments and Commitments through Inbound Web Service

Oracle Revenue Management and Billing enables you to override, edit, recommend, and delete a price item pricing of an entity in a deal through a web service. It also enables you to add or update the commitments of a price item and pricing parameters combination in a deal through a web service. In addition, it enables you to view the pricing and commitment details of a deal through a web service.

You can send a request from the external system to do the following through an inbound web service:

  • Override a price item pricing of an existing or prospect customer or account in a deal

  • Edit or delete a price item pricing of a deal

  • Recommend a price item pricing for an existing or prospect customer or account in a deal

  • Add or edit commitments of a price item and pricing parameters combination

  • View the price item pricing and commitments details of a deal

At a time, you can send a request either for viewing the pricing and/or commitments details of all or particular entity in a deal, or for creating, updating, recommending, and/or deleting one or more pricing of a deal and/or for adding or editing commitments of one or more price item and pricing parameters combinations in a deal. We have shipped the following two inbound web services in this release:

  • C1-DealPriceAsgnCommitments - This is a SOAP based web service. You can use this web service when you want to send the above requests with respect to pricing and commitments in the XML format.

  • C1-DealPriceAsgnCommitmentsREST - This is a REST based web service. You can use this web service when you want to send the above requests with respect to pricing and commitments in the XML or JSON format.

Both these inbound web services call the C1-DealPriceAsgnCommitmentBS business service. This business service is used to do the following:

  • Override a price item pricing of an existing or prospect customer or account in a deal - While overriding a price item pricing of a customer or an account in a deal, you need to:

    • Specify the deal version ID or deal ID or deal identifier to determine the deal version in which you want to override the pricing of an entity

    • Specify the entity (i.e. person or account) whose pricing you want override and thereby create an agreed pricing

    • Specify the price assignment ID

    • Specify the pricing details including pricing parameters, characteristics, and flat and tiered price components

    • Specify the tiering criteria and eligibility for the required price components

    • Set the action flag to OVRD

    On processing the request, the system creates an agreed pricing for the entity in the deal in the Proposed status.

  • Edit a price item pricing of a deal - While editing a price item pricing of an entity in a deal, you need to:

    • Specify the deal version ID or deal ID or deal identifier to determine the deal version whose proposed pricing you want to edit

    • Specify the entity (i.e. person or account) whose pricing you want edit

    • Specify the price assignment ID

    • Set the action flag to UPD

    During the update operation, the system replaces the pricing data instead of editing it. Therefore, you should provide all details of the pricing including the data that you want to change.

  • Delete a price item pricing of a deal - While deleting a price item pricing of an entity in a deal, you need to:

    • Specify the deal version ID or deal ID or deal identifier to determine the deal version whose proposed pricing you want to delete

    • Specify the entity (i.e. person or account) whose pricing you want to delete

    • Specify the price assignment ID

    • Set the action flag to DEL

    On processing the request, the system deletes the proposed pricing of the entity from the deal.

  • Recommend a price item pricing for an existing or prospect customer or account in a deal - While recommending a price item pricing for an entity in a deal, you need to:

    • Specify the deal version ID or deal ID or deal identifier to determine the deal version in which you want to recommend pricing for an entity

    • Specify the entity (i.e. person or account) for whom you want to recommend a pricing

    • Specify the price assignment ID

    • Set the action flag to RECM

    During the update operation, the system replaces the pricing data instead of editing it. Therefore, you should provide all details of the pricing including the data that you want to change.

  • Add commitments for a price item pricing - While adding commitments for a pricing in a deal, you need to:

    • Specify the deal version ID or deal ID or deal identifier to determine the deal version in which you want to add commitments for the price item and pricing parameters combination

    • Specify the entity (i.e. person or account) for whom you want to add commitments

    • Specify the price item and pricing parameters combination for which you want to add commitments

    • Specify the commitments for the SQIs

    • Set the action flag to ADD

    On processing the request, the system adds commitments for the price item and pricing parameters combination in the deal in the Proposed status.

  • Edit commitments of a price item pricing - While editing commitments of a price item and pricing parameters combination in a deal, you need to:

    • Specify the deal version ID or deal ID or deal identifier to determine the deal version whose proposed commitments you want to edit

    • Specify the entity (i.e. person or account) whose commitments you want to edit

    • Specify the price item and pricing parameters combination whose commitments you want to edit

    • Set the action flag to UPD

    During the update operation, the system replaces the commitment data instead of editing it. Therefore, you should provide all commitment details including the data that you want to change.

  • View the price item pricing and/or commitments details - While viewing the pricing and/or commitment details of a deal, you need to:

    • Specify the deal version ID or deal ID or deal identifier to determine the deal version whose pricing and commitment details you want to view

    • Set the action flag to READ

    On processing the request, the system then displays the pricing and commitment details of all customers and accounts in the deal version. You can also view the pricing and commitment details of a particular entity in the deal version. In addition, you can opt to view either pricing or commitment details or both pricing and commitment details of a deal version. If you want to view the pricing details of a deal version, you must set the inquiry mode to PRIC. If you want to view the commitment details of a deal version, you must set the inquiry mode to COMT. And, if you want to view both the pricing and commitment details of a deal version, you must set the inquiry mode to BOTH. Note that the system displays all active, proposed, and recommended price item pricing of the entities and all active and proposed commitments of the price item and parameters combination in the response.

If both the deal version and deal ID or deal identifier are given in the request, the system considers the deal version. However, if only the deal ID or deal identifier is given in the request, the system derives the deal version. Note that an error occurs when the given deal has multiple deal versions. The system allows you to override, edit, delete, or recommend pricing and/or add or edit commitments for multiple entities of a deal in the same request. For more information about the Deal Pricing Management functionality, refer to Oracle Revenue Management and Billing Banking User Guide.