---
schema_version: "1"
id: c2ae53f5aeefaddb635e1fc3dea424a96cae2c96bc5c8e1411eabe73f34a14e1
title: Expected Revenue (PATCH)
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/insurance_developer_guide/connect_resources_expected_revenue.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.insurance_developer_guide.meta/insurance_developer_guide/connect_resources_expected_revenue.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: fe2206ded0fa08847b791bb85869ff0cdbc21c809cfe4451611d40a4dd2e3f4f
description: Calculate the expected revenue, derived both from an Insurance Rate Plan Commission object, such as a flat fee and percentage premium, and the premium, fee, or premium equivalent amount on Insurance Rate Plan. The expected revenue amount is rolled up from Insurance Rate Plan to Insurance Coverage and Insurance Policy expected revenue amount.
---
# Expected Revenue (PATCH)

Calculate the expected revenue, derived both from an Insurance Rate Plan Commission object, such as a flat fee and percentage premium, and the premium, fee, or premium equivalent amount on Insurance Rate Plan. The expected revenue amount is rolled up from Insurance Rate Plan to Insurance Coverage and Insurance Policy expected revenue amount.

## Resource

{policyId} is a placeholder.

/connect/insurance/brokerage/policies/{policyId}/expected-revenue

## Resource Example

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

https://{yourInstance}.salesforce.com/services/data/v68.0/connect/insurance/brokerage/policies/0YTSG0000000o9h4AA/expected-revenue?businessSObjectType=InsuranceRatePlan&recordId=1CcSG00000000fx0AA

## Available Version

63.0

## HTTP Methods

PATCH

## Path Parameter for PATCH

<table class="featureTable sort_table" summary="">





            <thead class="thead sorted" align="left">
              <tr>
                <th class="featureTableHeader vertical-align-top " id="d34709e120">Name</th>

                <th class="featureTableHeader vertical-align-top " id="d34709e123">Type</th>

                <th class="featureTableHeader vertical-align-top " id="d34709e126">Description</th>

                <th class="featureTableHeader vertical-align-top " id="d34709e129">Required or Optional</th>

                <th class="featureTableHeader vertical-align-top " id="d34709e132">Available Version</th>

              </tr>

            </thead>

            <tbody class="tbody">
              <tr>
                <td class="entry" headers="d34709e120" data-title="Name">
                  <samp class="codeph nolang">policyId</samp>
                </td>

                <td class="entry" headers="d34709e123" data-title="Type">String</td>

                <td class="entry" headers="d34709e126" data-title="Description">
                  <p class="p" id="creditMemoLineInvoiceLineId"><a name="creditMemoLineInvoiceLineId"><!-- --></a>ID of parent policy for which the expected
                    revenue is calculated. </p>

                </td>

                <td class="entry" headers="d34709e129" data-title="Required or Optional">Required</td>

                <td class="entry" headers="d34709e132" data-title="Available Version">63.0</td>

              </tr>

            </tbody>

          </table>

## Request Parameters for PATCH

<table class="featureTable sort_table" summary="">





            <thead class="thead sorted" align="left">
              <tr>
                <th class="featureTableHeader vertical-align-top " id="d34709e197">Parameter Name</th>

                <th class="featureTableHeader vertical-align-top " id="d34709e200">Type</th>

                <th class="featureTableHeader vertical-align-top " id="d34709e203">Description</th>

                <th class="featureTableHeader vertical-align-top " id="d34709e206">Required or Optional</th>

                <th class="featureTableHeader vertical-align-top " id="d34709e209">Available Version</th>

              </tr>

            </thead>

            <tbody class="tbody">
              <tr>
                <td class="entry" headers="d34709e197" data-title="Parameter Name">
                  <samp class="codeph nolang">businessSObjectType</samp>
                </td>

                <td class="entry" headers="d34709e200" data-title="Type">String</td>

                <td class="entry" headers="d34709e203" data-title="Description">Name of the business sObject to calculate expected revenue. Possible
                  values are: <ul class="ul bulletList">
                    <li class="li">
                      <samp class="codeph nolang"> InsurancePolicy</samp>
                    </li>

                    <li class="li">
                      <samp class="codeph nolang"> InsurancePolicyCoverage</samp>
                    </li>

                    <li class="li">
                      <samp class="codeph nolang"> InsuranceRatePlan</samp>
                    </li>

                  </ul>

                </td>

                <td class="entry" headers="d34709e206" data-title="Required or Optional">Optional</td>

                <td class="entry" headers="d34709e209" data-title="Available Version">63.0</td>

              </tr>

              <tr>
                <td class="entry" headers="d34709e197" data-title="Parameter Name">
                  <samp class="codeph nolang">recordId</samp>
                </td>

                <td class="entry" headers="d34709e200" data-title="Type">String</td>

                <td class="entry" headers="d34709e203" data-title="Description">ID of the business sObject for which expected revenue must be calculated. </td>

                <td class="entry" headers="d34709e206" data-title="Required or Optional">Optional</td>

                <td class="entry" headers="d34709e209" data-title="Available Version">63.0</td>

              </tr>

            </tbody>

          </table>

## Request Body for PATCH

### JSON Example

{
  "expressionSetName": "expressionSetName",
  "ratePlanCommissions": \[
    {
      "Name": "RPC-1",
      "Type": "GradedPercent",
      "amountStartRange": 0,
      "amountEndRange": 1000
    },
    {
      "Name": "RPC-1",
      "Type": "GradedPercent",
      "amountStartRange": 1001,
      "amountEndRange": 100000
    }
  \]
}

### Properties

| Name | Type | Description | Required or Optional | Available Version |
| --- | --- | --- | --- | --- |
| expressionSetName | String | Name of expression set to be used for expected revenue calculation. If unspecified, a value from the InsPolicyManagementConfig setup object is taken. | Optional | 63.0 |
| ratePlanCommissions | List | List of rate plan commissions to be used for expected revenue calculation. This is a valid input only when businessSObjectType is InsuranceRatePlan. | Optional | 63.0 |

## Response Body for PATCH

[Expected Revenue](https://developer.salesforce.com/docs/atlas.en-us.insurance_developer_guide.meta/insurance_developer_guide/connect_responses_expected_revenue_output.htm "Output representation of the details of the expected revenue.")