Re-migrate Adobe Subscriptions

You can use this section to remigrate soft-cancelled Adobe subscriptions for various use cases. It provides detailed instructions for preparing the entitlement files and migrating them using the marketplace migration tool.

Prerequisites

The subscriptions to be re-migrated must have been soft-cancelled before initiating the re-migration process. Contact your AppDirect Technical Representative for assistance.

Instructions

1. Prepare the Entitlement File

   The entitlement file should be prepared based on the format requirements listed below.

2. Migrate the Company Entitlement

   Use the Marketplace Migration Tool to migrate the company entitlement. For details on migration, refer to Migrate data.

   Common Headers for Company Entitlement File

   Header	Description
   EXTERNAL_ID	Random UUID.
   EDITION_PRICING_UUID	Edition pricing UUID for the entitlement.
   COMPANY_EXTERNAL_ID	External Identifier of the user’s company.
   PURCHASED_BY_EXTERNAL_ID	External ID of the user purchasing the subscription.
   PRICING_UNIT	Pricing unit type (USER or TRANSACTION).
   UNITS	Number of units for the subscription.
   ORDER_STATUS	ACTIVE.
   SALES_REP_EXTERNAL_ID	External ID of the sales representative.
   SALES_REP_COMPANY_EXTERNAL_ID	External ID of the sales representative’s company.
   START_DATE	Start date for the subscription.
   END_DATE	End date for the subscription.

   Important Notes for START_DATE and END_DATE Fields

   • Format for dates: YYYY-MM-DDTHH:MM:SS+00:00 (Example: 2025-11-25T00:00:00+00:00)
   • Adobe’s system operates on the UTC timezone. To ensure that the dates in the marketplace align with Adobe’s system, use accurate timestamps.
   • If the marketplace is in a timezone behind UTC, apply the appropriate offset to the dates to match Adobe’s system. Example: For a marketplace in the America/New_York timezone (UTC - 5), to correctly migrate an Adobe subscription with an end date of 2025-11-25, the end date should be set as: 2025-11-25T05:00:00+00:00.

3. Update Existing Subscription

   To update an existing subscription (Example: changes in pricing plan, seat count, subscription ID, and so on), use the following format for the company entitlement file:

   ISV-specific columns need to be added in addition to the common columns mentioned above -

   Header	Value	Description
   ISV:TRANSFER_ID	Dummy	Use the hardcoded value.
   ISV:VIP_MEMBERSHIP_ID	Dummy	Use the hardcoded value.
   ISV:VIP_SUBSCRIPTION_ID	<Adobe subscription ID>	The Adobe subscription ID for the specific subscription being re-migrated.
   ISV:ADOBE_RESELLER_ID	<Adobe reseller ID>	Configured Adobe reseller ID.
   ISV:VOLUME_QUANTITY	<quantity>	Number of units for the subscription.

4. Migrate Missing Subscription or Customer

   Step 1: Check for Existing Customer Account

   Check if a customer account entry exists for the company in the app_connector.customer_accounts table.

   SELECT * 
   FROM app_connector.customer_accounts ca
   JOIN app_connector.connectors c ON c.uuid = ca.connector_id
   WHERE ca.customer_company_id = <company_uuid> 
       AND c.code = 'ADOBE' 
       AND ca.status = 'ACTIVE';

   If the customer account entry does not exist, proceed to prepare the DEVELOPER_CUSTOMER_ACCOUNTS.csv file and migrate the file using the Marketplace Migration tool.

   Header	Value
   TENANT_ID	Adobe customer account ID.
   ISV:COMPANY_EXTERNAL_ID	Company external ID.
   ISV:ADOBE_RESELLER_ID	Adobe reseller ID.
   ISV:ADOBE_RESELLER_COMPANY_ID	Adobe reseller company ID.

   Step 2: Migrate the Subscriptions

   For migrating or re-migrating the customer’s subscriptions, use the following format for the company entitlement file.

   ISV-specific columns need to be added in addition to the common columns mentioned above -

   Header	Value	Description
   ISV:TRANSFER_ID	NA	Use the hardcoded value.
   ISV:VIP_MEMBERSHIP_ID	<Adobe customer account ID>	Adobe customer account ID.
   ISV:VIP_SUBSCRIPTION_ID	<Adobe subscription ID>	The Adobe subscription ID for the specific subscription being re-migrated.
   ISV:ADOBE_RESELLER_ID	<Adobe reseller ID>	Configured Adobe reseller ID.
   ISV:VOLUME_QUANTITY	<quantity>	Number of units for the subscription.