Enable partners to create late renewal orders

Subscription auto-renewal is enabled by default for all applicable Adobe products. In the rare event of a failed renewal, partners can submit VIP Marketplace renewal orders up to 14 days after the anniversary date.

Prerequisites

Before creating late renewal orders, ensure the following prerequisites are met:

• Set up Adobe integration, if not done already. Refer to Configure and sell Adobe products for more details.

• Obtain the following from Adobe Partner Support, if not already available -

  • Adobe API collection.
  • Latest Adobe API documentation.

• Ensure the customer account exists on the marketplace.

  📝 Note: Double-check all prerequisites and marketplace settings as specified in this section, even if previously configured.

Instructions

Identify eligible subscriptions for late renewal

Use the following Adobe API to identify and select the subscription to create a late renewal order. Subscriptions eligible for manual renewal are indicated by the “allowedActions": ["MANUAL_RENEWAL"] parameter.

Request: GET <adobe-base-url>/v3/customers/subscriptions

Response body:

 {
    "totalCount": 2,
    "items": [
        {
            "subscriptionId": "1e6e9fe5a947238589f2dfc5e8be84NA",
            "offerId": "65305348CA01A12",
            "currentQuantity": 2,
            "usedQuantity": 1,
            "autoRenewal": {
                "enabled": false,
                "renewalQuantity": 2
            },
            "creationDate": "2024-12-06T05:56:51Z",
            "renewalDate": "2024-12-06",
            "status": "1004",
            "currencyCode": "USD",
            "allowedActions": [
                "MANUAL_RENEWAL"
            ],
            "links": {
                "self": {
                    "uri": "/v3/customers/P1005155121/subscriptions/1e6e9fe5a947238589f2dfc5e8be84NA",
                    "method": "GET",
                    "headers": []
                }
            }
        },
        {
            "subscriptionId": "b27f0e439b4da19d6a147cb37c1ce2NA",
            "offerId": "65305409CA01A12",
            "currentQuantity": 4,
            "usedQuantity": 1,
            "autoRenewal": {
                "enabled": true,
                "renewalQuantity": 4
            },
            "creationDate": "2024-12-06T05:57:28Z",
            "renewalDate": "2024-12-06",
            "status": "1000",
            "currencyCode": "USD",
            "links": {
                "self": {
                    "uri": "/v3/customers/P1005155121/subscriptions/b27f0e439b4da19d6a147cb37c1ce2NA",
                    "method": "GET",
                    "headers": []
                }
            }
        }
    ],
    "links": {
        "self": {
            "uri": "/v3/customers/P1005155121/subscriptions",
            "method": "GET",
            "headers": []
        }
    }
}

Create a late renewal order

Use the following Adobe API to create a late renewal order for the eligible subscriptions. After the renewal order is created, wait for the subscription status to update to "1000" (Active). You can verify the subscription status using the get-all-subscriptions API in the above section.

Request: POST <adobe-base-url>/v3/customers/orders

Request body:

 {
    "externalReferenceId": "4b6b9a80-cf98-469c-9927-42bd36a4acf",
    "orderType": "RENEWAL",
    "lineItems":
    [
        {
            "extLineItemNumber": 1,
            "offerId": "65305348CA01A12",
            "quantity": 1,
            "subscriptionId": "1e6e9fe5a947238589f2dfc5e8be84NA”
        }
    ]
}

Guidelines for creating a renewal order

Following are the guidelines for creating a renewal order:

• You can create a renewal only for expired subscriptions.
• The license quantities must be less than or equal to the customer’s current subscription quantities.

Migrate the subscription to the marketplace

Migrate the renewed subscriptions to the marketplace. To migrate, complete the following:

• Prepare the company entitlements file for the customer’s late-renewed subscriptions or contact your AppDirect Technical Representative for assistance.

  Ensure the following columns have data in the company entitlements file:

  Header	Description
  EXTERNAL_ID	Random UUID.
  EDITION_PRICING_UUID	Edition pricing UUID to be used for the entitlement.
  COMPANY_EXTERNAL_ID	External Identifier of the user’s company.
  PURCHASED_BY_EXTERNAL_ID	User external ID.
  PRICING_UNIT	USER or TRANSACTION.
  UNITS	Number of units for the subscription.
  ORDER_STATUS	ACTIVE
  SALES_REP_EXTERNAL_ID	External ID of the sales representative user.
  SALES_REP_COMPANY_EXTERNAL_ID	External ID of the sales representative company.
  START_DATE	Start date for the subscription.
  END_DATE	End date for the subscription.
  ISV:TRANSFER_ID	NA (Warning: Use NA only).
  ISV:VIP_MEMBERSHIP_ID	Adobe customer account ID of the customer.
  ISV:VIP_SUBSCRIPTION_ID	The Adobe subscription ID for specific subscription being remigrated.
  ISV:ADOBE_RESELLER_ID	Configured Adobe reseller ID.
  ISV:VOLUME_QUANTITY	Number of units for the subscription.

• Migrate the company entitlements using the marketplace migration tool or contact your AppDirect Technical Representative for assistance. Refer to Migrate data for more details.

Frequently Asked Questions (FAQs)

Have more questions about the late renewals feature? This section provides answers to some of the commonly asked questions related to late renewals.

How do I check if a customer account exists on the marketplace?

You can check this by navigating to Marketplace > Companies > Company | Vendor Information | Adobe. If this section has data, the customer account exists on the marketplace.