SubscriptionManagementSettings
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. |
enableConvertNegativeInvoiceLinesToCreditMemoAndApply | 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.