---
schema_version: "1"
id: 7487cf38a7e434b1011f35cd4314de65007df910163b8ee63a2d22b24e2b70dc
title: Derive and Copy Promotions with MetadataWizard and Business Object API
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/retail_api/cg_tpm_derive_copy_promo_mw_bo_api.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.retail_api.meta/retail_api/cg_tpm_derive_copy_promo_mw_bo_api.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 7d7a85b17831ba6d9415b92b0627843afa64f54829d3c5b8e8ae3ba4abe92bf9
description: The Derive and Copy Promotion features use Metadata wizard and Business Object API. This allows complete customization of the UI Wizards, and the Derive and Copy Apex processes for promotions by leveraging MetadataWizard and Business Object API customization capabilities.
---
# Derive and Copy Promotions with MetadataWizard and Business Object API

The Derive and Copy Promotion features use Metadata wizard and Business Object API. This allows complete customization of the UI Wizards, and the Derive and Copy Apex processes for promotions by leveraging MetadataWizard and Business Object API customization capabilities.

## Licensing

In order to use this feature, your users must have the TPM License.

## CGCloud System Configuration

To enable this feature, the required configuration records need to be created for your sales orgs. They can be created with the following Apex commands:

cgcloud.TPMSetupData.setupMetadataWizard('<sales org name>');

cgcloud.TPMSetupData.setupBOApi('<sales org name>');

## Details

When executing Derive or Copy functionalities, the system checks for the following conditions:

- The selected promotion is a TPM Promotion
- A BO API Workflow for Promotion, the user current Sales Org and for the operation exists
- A MetadataWizard configuration, the user current Sales Org and for the operation exists

If the above conditions are met, the system will execute the Derive or Copy Process by using MetadataWizard and Business Object API. If the conditions are not met, the legacy wizards are used instead.