SubscriptionManagementSettings

Represents the settings used to manage recurring subscriptions.

Parent Type and Manifest Access

This type extends the Metadata metadata type and inherits its fullName field.

In the package manifest, all the settings metadata types for the org are accessed using the “Settings” name. See Settings for more details.

File Suffix and Directory Location

SubscriptionManagementSettings values are stored in the subscriptionmanagement.settings file in the settings folder. The .settings files are different from other named components, because there’s only one settings file for each settings component.

Version

SubscriptionManagementSettings components are available in API version 55.0 and later.

Special Access Rules

This metadata type is available with Subscription Management.

Fields

Field Name Field Type Description
enableBillingDocGen boolean Indicates whether document generation is enabled in the org (true) or not (false). The default value is false.
enableConvert​NegativeInvoiceLines​ToCreditMemo​AndApply boolean Indicates whether to convert negative invoice lines into a credit note (true) or not (false). This credit note holds a positive balance that you can later use to apply against future invoices. The default value is false.
enableInvHeaderLvlSettlement boolean Indicates whether payments can be applied on the whole invoice (true) or only on invoice lines (false). The default value is false.
enablePaymentScheduleAutomation boolean Indicates whether the payment schedule and payment schedule item are created automatically (true) or not (false). The default value is false.
enableRefundAutomation boolean Indicates whether refunds are processed automatically (true) or not (false). The default value is false.
enableRevSubMgmtBlngOptOut boolean Indicates whether the billing schedules in Subscription Management are disabled (true) or not (false). The default value is false.
enableSubscriptionManagement boolean Indicates whether Subscription Management is enabled (true) or not (false). The default value is false.

Declarative Metadata Sample Definition

This example shows a sample SubscriptionManagementSettings component.

<?xml version="1.0" encoding="UTF-8"?>
<SubscriptionManagementSettings xmlns="http://soap.sforce.com/2006/04/metadata">
    <enableSubscriptionManagement>true</enableSubscriptionManagement>
</SubscriptionManagementSettings>

This example shows a sample package.xml that references the previous definition.

<?xml version="1.0" encoding="UTF-8"?>
<Package xmlns="http://soap.sforce.com/2006/04/metadata">
    <types>
        <members>SubscriptionManagementSettings</members>
        <name>Settings</name>
    </types>
    <version>63.0</version>
</Package>

Wildcard Support in the Manifest File

The wildcard character * (asterisk) in the package.xml manifest file doesn’t apply to metadata types for feature settings. The wildcard applies only when retrieving all settings, not for an individual setting. For details, see Settings. For information about using the manifest file, see Deploying and Retrieving Metadata with the Zip File.