Purchasing new commerce license-based services
Applies to:
- Partner Center
Note
The new commerce experiences for license-based services include many new capabilities and are available to all Cloud Solution Provider (CSPs). For more information, see new commerce experiences overview.
You can purchase, create, and manage new commerce experience license-based services using the Partner Center APIs. The process is similar to such as Azure plan and Marketplace offers.
Prerequisites
- Partner Center authentication credentials. The new commerce experience supports authentication with both standalone App and App+User credentials.
- The customer identifier. If you don't have a customer's identifier, follow the steps in Get a list of customers. Alternatively, sign in to Partner Center, choose the customer from the list of customers, select Account, then save their Microsoft ID.
- Confirmation of the customer's acceptance of the Microsoft Customer Agreement.
Get the catalog item for new commerce license-based services
You need to retrieve new commerce license-based services catalog items. Retrieve catalog items using the existing Partner Center catalog APIs with the following resource models:
- Product: A grouping construct for purchasable goods or services. A product itself isn't a purchasable item.
- SKU: A purchasable Stock Keeping Unit (SKU) under a product. SKUs represent the different shapes of the product.
- Availability: A configuration in which a SKU is available for purchase (such as country/region, currency, or industry segment).
To obtain the catalog items for new commerce license-based services offers:
Follow the steps in Get a list of products for products and specify the targetView as OnlineServices. (If you already know the product identifier for the offer you want to purchase, you can follow the steps in Get a product using the product ID instead.)
Retrieve the SKU from the product for the offer you are looking for. Follow the steps in Get a list of SKUs for a product. (If you already know the SKU identifier for the offer you want, you can follow the steps in Get a SKU using the SKU ID instead.)
Retrieve the availability from the SKU for the offer. Different offers support specific terms. Some SKUs have more than one availability. Follow the steps in Get a list of availabilities for a SKU. (If you already know the identifier for the availability you need, you can follow the steps in Get an availability using the availability ID instead.) Be sure to note the value of the CatalogItemId property of the availability for the offer. You will need this value to create an order.
Create and submit an order
To submit your order for an Azure plan (including new commerce orders), follow these steps:
Create a cart to hold the collection of catalog items that you intend to buy. When you create a cart, the cart line items are automatically grouped based on what can be purchased together in the same order. (You can also update a cart.)
Check out the cart, which results in the creation of an order.
Get order details
You can retrieve the details of an individual order using the order ID. You can also retrieve a list of all orders for a specific customer.
Note
After you submit an order, there is a delay of up to 15 minutes before the order appears in that customer's order list. Currently, EU partners can only purchase new commerce offers for: 1. New customers 2. Existing customers who don’t have a pre-existing Azure plan, marketplace, software subscriptions or perpetual software in a currency other than the partner’s country/region currency.
Manage new commerce subscriptions
After the order is successfully processed, a Partner Center Subscription resource will be created for the Azure plan. You can use the following methods for managing Partner Center Subscription resources to manage the Azure plan:
There are differences and new capabilities specific to new commerce.
Invoice and reconciliation
You can manage invoices and reconciliation data using the following methods: