Purchase 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 Providers (CSPs). For more information, see the overview of new commerce experiences.
You can purchase, create, and manage license-based services for the new commerce experience by using the Partner Center APIs. The process is similar to 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, and then save the Microsoft ID value.
- Confirmation of the customer's acceptance of the Microsoft Customer Agreement.
Get the catalog item for new commerce license-based services
Retrieve catalog items for new commerce license-based services by 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 varieties 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 license-based service offers in the new commerce experience:
Follow the steps in Get a list of products (by country/region) for products. Specify
targetView
asOnlineServices
. (If you already know the product identifier for the offer that you want to purchase, you can follow the steps in Get a product by ID instead.)Retrieve the SKU from the product for the offer that you're looking for. Follow the steps in Get a list of SKUs for a product (by country/region). (If you already know the SKU identifier for the offer that you want, you can follow the steps in Get a SKU by 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 (by country/region). (If you already know the identifier for the availability that you need, you can follow the steps in Get an availability by ID instead.)
Be sure to note the value of the
CatalogItemId
property of the availability for the offer. You 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 by using the order ID. You can also retrieve a list of all orders for a specific customer.
After you submit an order, there's a delay of up to 15 minutes before the order appears in that customer's order list.
Note
Currently, EU partners can purchase new commerce offers only for:
- New customers.
- Existing customers who don't have a preexisting Azure plan, a 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 is 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.
Manage invoices and reconciliation
You can manage invoices and reconciliation data by using the following methods:
- Get a collection of invoices
- Get invoice estimate links
- Get an invoice by ID
- Get an invoice statement
- Get invoice summaries
- Get invoice billed consumption line items
- Get invoice unbilled consumption line items
- Get invoice billed reconciliation line items
- Get invoice unbilled reconciliation line items