Créer un abonnement pour les produits de la place de marché commercialCreate a subscription for commercial marketplace products

S’applique à :Applies to:

  • Espace partenairesPartner Center

Vous pouvez créer un abonnement pour des produits de la place de marché commerciale à l’aide des API de l’Espace partenaires.You can create a subscription for commercial marketplace products using Partner Center APIs. Vous devez obtenir une liste des offres pour un marché, créer et envoyer une commande pour un abonnement de la place de marché commercial, puis récupérer un lien d’activation.You must get a list of offers for a market, create and submit an order for a commercial marketplace subscription, then retrieve an activation link.

Vous pouvez également effectuer la gestion du cycle de vie et gérer les factures pour ces abonnements.You can also perform lifecycle management and manage invoices for these subscriptions.

PrérequisPrerequisites

  • Informations d' authentification de l’espace partenaires .Partner Center authentication credentials. Ce scénario prend en charge l’authentification avec les informations d’identification de l’application autonome et de l’application + utilisateur.This scenario supports authentication with both standalone App and App+User credentials.
  • Identificateur du client.The customer identifier. Si vous n’avez pas d’identificateur de client, suivez les étapes de la section obtenir une liste de clients.If you don't have a customer's identifier, follow the steps in Get a list of customers. Vous pouvez également vous connecter à l’espace partenaires, choisir le client dans la liste des clients, sélectionner un compte, puis enregistrer son identifiant Microsoft.Alternatively, sign in to Partner Center, choose the customer from the list of customers, select Account, then save their Microsoft ID.

Obtenir la liste des offres d’un marchéGet a list of offers for a market

Vous pouvez vérifier les offres disponibles pour un marché à l’aide des modèles d’API de l’espace partenaires suivants :You can check the available offers for a market using the following Partner Center API models:

  • Produit: construction de regroupement pour les biens ou services pouvant être achetés.Product: A grouping construct for purchasable goods or services. Un produit lui-même n’est pas un élément pouvant être acheté.A product itself isn't a purchasable item.
  • Référence (SKU) : une référence SKU (Stock Keeping Unit) sous un produit.SKU: A purchasable Stock Keeping Unit (SKU) under a product. Celles-ci représentent les différentes formes du produit.These represent the different shapes of the product.
  • Disponibilité: configuration dans laquelle une référence (SKU) est disponible à l’achat (par exemple, pays, devise ou secteur).Availability: A configuration in which a SKU is available for purchase (such as country, currency, or industry segment).

Avant d’acheter une réservation Azure, procédez comme suit :Before you purchase an Azure reservation, complete the following steps:

  1. Identifiez et récupérez le produit et la référence (SKU) que vous souhaitez acheter.Identify and retrieve the product and SKU that you want to purchase. Si vous connaissez déjà l’ID de produit et l’ID de référence (SKU), sélectionnez-les.If you already know the Product ID and SKU ID, select them.

    Notes

    Vous pouvez identifier les produits de la place de marché commercial en fonction de leur propriété ProductType « Azure » et de leur propriété de sous-type « Saas ».You can identify commercial marketplace products by their ProductType property of "Azure" and their SubType property of "SaaS".

  2. Si les références SKU sont marquées d’un prérequis InventoryCheck , Vérifiez l’inventaire d’une référence (SKU).If the SKUs are tagged with an InventoryCheck prerequisite, check the inventory for a SKU.

    Notes

    À ce stade, aucun produit de la place de marché commercial ne prend en charge la vérification de stock ou est marqué avec un prérequis InventoryCheck .At this time, there are no commercial marketplace products that support inventory check or are tagged with an InventoryCheck prerequisite.

  3. Récupérez la disponibilité de la référence SKU.Retrieve the availability for the SKU. Vous aurez besoin de la CatalogItemId de disponibilité lors de la mise en place de la commande, que vous pouvez récupérer via les API suivantes :You will need the CatalogItemId of the availability when placing the order, which you can retrieve through the following APIs:

Créer et envoyer une commandeCreate and submit an order

Pour soumettre votre commande de réservation Azure, procédez comme suit :To submit your Azure reservation order, follow these steps:

  1. Créez un panier pour stocker la collection d’éléments de catalogue que vous souhaitez acheter.Create a cart to hold the collection of catalog items that you intend to buy. Lorsque vous créez un panier, les éléments de ligne de panier sont automatiquement regroupés en fonction de ce qui peut être acheté ensemble dans le même ordre.When you create a cart, the cart line items are automatically grouped based on what can be purchased together in the same order. (Vous pouvez également mettre à jour un panier.)(You can also update a cart.)
  2. Extraire le panier, ce qui entraîne la création d’une commande.Check out the cart, which results in the creation of an order.

Recevoir les détails de la commandeGet order details

Vous pouvez récupérer les détails d’une commande individuelle à l’aide de l’ID de commande.You can retrieve the details of an individual order using the order ID. Vous pouvez également récupérer une liste de toutes les commandes pour un client spécifique.You can also retrieve a list of all orders for a specific customer.

Notes

Après l’envoi d’une commande, un délai de 15 minutes maximum s’écoule avant que la commande apparaisse dans la liste de commandes de ce client.After an order is submitted, there is a delay of up to 15 minutes before the order appears in that customer's order list.

Le partenaire ou le client doit activer les abonnements aux produits de la place de marché Azure.The partner or customer must activate subscriptions to Azure Marketplace products. Vous pouvez recevoir un lien d’activation par élément de ligne de commande.You can get an activation link by order line item. Vous pouvez également obtenir un abonnement par ID, puis énumérer sa propriété Links pour créer un lien d’activation.You can also get a subscription by ID, then enumerate its Links property to create an activation link.

Gestion du cycle de vieLifecycle management

Vous pouvez gérer le cycle de vie de vos abonnements à des produits de la place de marché commercial à l’aide des méthodes suivantes :You can manage the lifecycle of your subscriptions to commercial marketplace products using the following methods:

Gestion des quantitésQuantity management

La quantité d’un abonnement au marché commercial doit être comprise dans les limites définies par la référence SKU associée (voir les attributs minimumQuantity et maximumQuantity ).The quantity of a commercial marketplace subscription must be within the limits defined by its associated SKU (see the minimumQuantity and maximumQuantity attributes). Pour mettre à jour la quantité d’un abonnement à la place de marché commercial, utilisez la méthode suivante :To update the quantity of a commercial marketplace subscription, use the following method:

Facture et rapprochementInvoice and reconciliation

Vous pouvez gérer les factures client (y compris les frais liés aux abonnements à des produits de la place de marché commercial) à l’aide des méthodes suivantes :You can manage customer invoices (including charges for subscriptions to commercial marketplace products) using the following methods:

Test à l’aide du compte sandbox d’intégrationTest using integration sandbox account

En production, après avoir créé un abonnement aux produits SaaS de la place de marché commercial, vous devez récupérer un lien d’activation personnalisé auprès de l’espace partenaires et visiter le site de l’éditeur pour terminer le processus d’installation.In production, after you have created a subscription to commercial marketplace SaaS products, you need to retrieve a personalized activation link from Partner Center and visit the publisher's site to complete the setup process. La facturation de l’abonnement commence uniquement une fois l’installation terminée.Subscription billing will begin only after setup is complete.

Dans l’environnement du bac à sable (sandbox) CSP, il n’existe aucune intégration avec les éditeurs de logiciels indépendants.In the CSP sandbox environment, there is no integration with ISVs. Si vous essayez de récupérer un lien d’activation à partir de l’espace partenaires, un lien factice est renvoyé.If you try to retrieve an activation link from Partner Center, a dummy link will be returned. Vous ne pouvez pas utiliser ce lien factice pour terminer le processus d’installation sur le site de l’éditeur.You cannot use this dummy link to complete the setup process at the publisher's site. Pour utiliser le compte de bac à sable (sandbox) d’intégration afin de tester la facturation des abonnements aux produits SaaS de la place de marché commercial, utilisez la méthode suivante pour activer l’abonnement.To use the integration sandbox account to test billing for subscriptions to commercial marketplace SaaS products, use the following method to activate the subscription instead. La facturation de l’abonnement commencera après l’activation réussie :Subscription billing will begin after successful activation: