Espace partenaires Microsoft [DÉCONSEILLÉ]
Ce connecteur vous permet de vous connecter à l’API MPC et de collecter certaines informations, notamment les détails du client, les commandes et les abonnements.
Ce connecteur est disponible dans les produits et régions suivants :
| Service | classe | Régions |
|---|---|---|
| Copilot Studio | Norme | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Applications logiques | Norme | Toutes les régions Logic Apps , à l’exception des suivantes : - Régions Azure Government - Régions Azure Chine - Us Department of Defense (DoD) |
| Power Apps | Norme | Toutes les régions Power Apps , à l’exception des suivantes : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Norme | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Contact | |
|---|---|
| Nom | Microsoft |
| URL | https://support.microsoft.com |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | Microsoft |
| Website | https://docs.microsoft.com/en-us/partner-center/develop/ |
| Politique de confidentialité | https://privacy.microsoft.com/en-us/privacystatement |
| Catégories | Opérations informatiques ; Gestion de l’entreprise |
Création d’une connexion
Le connecteur prend en charge les types d’authentification suivants :
| Par défaut | Paramètres de création de connexion. | Toutes les régions | Non partageable |
Faire défaut
Applicable : Toutes les régions
Paramètres de création de connexion.
Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.
Limitations
| Nom | Appels | Période de renouvellement |
|---|---|---|
| Appels d’API par connexion | 100 | 60 secondes |
Actions
| Obtenir des abonnements client (déconseillé) [DÉPRÉCIÉ] |
Obtient une collection de tous les abonnements pour un client spécifié (déconseillé). |
| Obtenir des commandes client (déconseillées) [DÉCONSEILLÉE] |
Obtient une collection de toutes les commandes d’un client spécifié (déconseillé). |
| Obtenir des factures (déconseillées) [DÉCONSEILLÉE] |
Obtenir une collection de factures (déconseillée). |
| Obtenir les détails du client (déconseillé) [DÉPRÉCIÉ] |
Obtient une ressource client qui correspond à un ID client (déconseillé). |
| Obtenir tous les clients (déconseillés) [DÉCONSEILLÉ] |
Obtenir la liste des clients (déconseillés). |
Obtenir des abonnements client (déconseillé) [DÉPRÉCIÉ]
Obtient une collection de tous les abonnements pour un client spécifié (déconseillé).
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de locataire du client
|
CustomerTenantID | True | string |
ID de locataire d’un client. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Nombre total
|
totalCount | integer |
Nombre total d’abonnements pour le client. |
|
items
|
items | array of object |
items |
|
ID
|
items.id | string |
Identificateur d’abonnement. |
|
ID de l’offre
|
items.offerId | string |
Identificateur de l’offre. |
|
Nom de l’offre
|
items.offerName | string |
Nom de l’offre. |
|
Nom convivial
|
items.friendlyName | string |
Nom convivial de l’abonnement défini par le partenaire pour aider à désambiguer. |
|
ID
|
items.productType.id | string |
Identificateur d’abonnement. |
|
Nom d’affichage
|
items.productType.displayName | string |
Nom complet. |
|
Quantité
|
items.quantity | integer |
Fournit la quantité d’abonnement après l’approvisionnement. |
|
Type d’unité
|
items.unitType | string |
Unités définissant la quantité de l’abonnement. |
|
Has Purchasable Addons
|
items.hasPurchasableAddons | boolean |
Valeur indiquant si l’abonnement a des modules complémentaires pouvant être purchassables. |
|
Date de création
|
items.creationDate | string |
Date de création, au format date-heure. |
|
Date de début effective
|
items.effectiveStartDate | string |
Date de début effective de cet abonnement, au format date-heure. |
|
Date de fin de l’engagement
|
items.commitmentEndDate | string |
Date de fin de l’engagement pour cet abonnement, au format date-heure. |
|
Annulation autorisée jusqu’à la date
|
items.cancellationAllowedUntilDate | string |
Date de la dernière annulation. |
|
Date de fin du cycle de facturation
|
items.billingCycleEndDate | string |
Date de fin du cycle de facturation de cet abonnement, au format date-heure. |
|
Statut
|
items.status | string |
Indique l’état d’approvisionnement : « success », « pending » ou « failed ». |
|
Renouvellement automatique activé
|
items.autoRenewEnabled | boolean |
autoRenewEnabled |
|
Version d’évaluation
|
items.isTrial | boolean |
Valeur indiquant si l’abonnement est un essai. |
|
Type de facturation
|
items.billingType | string |
Spécifie la façon dont l’abonnement est facturé : « aucun », « utilisation » ou « licence ». |
|
Cycle de facturation
|
items.billingCycle | string |
Indique la fréquence avec laquelle le partenaire est facturé pour cette commande. |
|
Durée du terme
|
items.termDuration | string |
Représentation ISO 8601 de la durée du terme. |
|
Durée du renouvellement
|
items.renewalTermDuration | string |
Représentation ISO 8601 de la durée du terme. |
|
Produit Microsoft
|
items.isMicrosoftProduct | boolean |
Valeur indiquant si l’abonnement est un produit Microsoft. |
|
Partner ID
|
items.partnerId | string |
ID MPN du revendeur d’enregistrement, utilisé dans le modèle partenaire indirect. |
|
Attention nécessaire
|
items.attentionNeeded | boolean |
Attention nécessaire. |
|
Type de contrat
|
items.contractType | string |
Type de contrat : « subscription », « productKey » ou « redemptionCode ». |
|
Nom de l’éditeur
|
items.publisherName | string |
Nom de l’éditeur. |
|
Promotion ID
|
items.promotionId | string |
Identificateur de promotion s’il est appliqué à l’abonnement. |
|
ID de commande
|
items.orderId | string |
ID de la commande qui a été passée pour commencer l’abonnement. |
Obtenir des commandes client (déconseillées) [DÉCONSEILLÉE]
Obtient une collection de toutes les commandes d’un client spécifié (déconseillé).
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de locataire du client
|
CustomerTenantID | True | string |
ID de locataire du client. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Nombre total
|
totalCount | integer |
Nombre total de commandes client. |
|
items
|
items | array of object |
items |
|
ID
|
items.id | string |
Identificateur de commande. |
|
AUTRE ID
|
items.alternateId | string |
Identificateur convivial de l’ordre. |
|
ID de client
|
items.referenceCustomerId | string |
Identificateur du client. |
|
Cycle de facturation
|
items.billingCycle | string |
Indique la fréquence avec laquelle le partenaire est facturé pour cette commande. |
|
Code monétaire
|
items.currencyCode | string |
Devise utilisée lors du placement de la commande. |
|
Symbole monétaire
|
items.currencySymbol | string |
Symbole monétaire associé au code monétaire. |
|
lineItems
|
items.lineItems | array of object |
lineItems |
|
lineItemNumber
|
items.lineItems.lineItemNumber | integer |
Numéro d’élément de ligne. |
|
ID de l’offre
|
items.lineItems.offerId | string |
ID de l’offre. |
|
Identifiant d’abonnement
|
items.lineItems.subscriptionId | string |
ID de l’abonnement. |
|
Durée du terme
|
items.lineItems.termDuration | string |
Représentation ISO 8601 de la durée du terme. |
|
Promotion ID
|
items.lineItems.promotionId | string |
ID de promotion. |
|
Date de fin de terme personnalisée
|
items.lineItems.customTermEndDate | string |
Date de fin de la première période de facturation du nouvel abonnement. |
|
Type de transaction
|
items.lineItems.transactionType | string |
Type de transaction de l’élément de ligne. |
|
Nom convivial
|
items.lineItems.friendlyName | string |
Nom convivial de l’abonnement défini par le partenaire pour aider à désambiguer. |
|
quantité
|
items.lineItems.quantity | integer |
Quantité |
|
Date de création
|
items.creationDate | string |
Date de création de l’ordre, au format date-heure. |
|
Statut
|
items.status | string |
État de l’ordre. |
|
Type de transaction
|
items.transactionType | string |
Type de transaction de l’ordre. Les valeurs prises en charge sont « UserPurchase », « SystemPurchase » ou « SystemBilling » |
Obtenir des factures (déconseillées) [DÉCONSEILLÉE]
Obtenir une collection de factures (déconseillée).
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Taille
|
Size | integer |
Le nombre de ressources de facturation à renvoyer dans la réponse. Ce paramètre est facultatif. |
|
|
Contrepartie
|
Offset | string |
L’indice base zéro de la première facture à retourner. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Nombre total
|
totalCount | integer |
Nombre total d’éléments dans la collection. |
|
items
|
items | array of object |
items |
|
ID
|
items.id | string |
Identificateur de facture. |
|
Date de facturation
|
items.invoiceDate | string |
Date de génération de la facture. |
|
Date de début de la période de facturation
|
items.billingPeriodStartDate | string |
Date de début de la période de facturation au format UTC. |
|
Date de fin de la période de facturation
|
items.billingPeriodEndDate | string |
Date de fin de la période de facturation au format UTC. |
|
Total des frais
|
items.totalCharges | float |
Frais totaux. Inclut les frais pour les transactions et les ajustements. |
|
Montant payé
|
items.paidAmount | float |
Montant payé par le partenaire. Négatif si un paiement a été reçu. |
|
Code monétaire
|
items.currencyCode | string |
Code qui indique la devise utilisée pour tous les montants et totaux des éléments de facture. |
|
Symbole monétaire
|
items.currencySymbol | string |
Symbole monétaire utilisé pour tous les montants et totaux des éléments de facture. |
|
Lien de téléchargement PDF
|
items.pdfDownloadLink | string |
Lien pour télécharger la facture au format PDF. Ce lien n’est pas retourné dans le cadre des résultats de la recherche et n’est renseigné que si la facture est accessible par ID. Ce lien expire automatiquement en 30 minutes. |
|
invoiceDetails
|
items.invoiceDetails | array of object |
Détails de la facture. |
|
Type d’élément de ligne de facture
|
items.invoiceDetails.invoiceLineItemType | string |
Type de détail de facture : « none », « usage_line_items », « billing_line_items ». |
|
Fournisseur de facturation
|
items.invoiceDetails.billingProvider | string |
Le fournisseur de facturation : « none », « office », « azure » ou « azure_data_market ». |
|
Type du document
|
items.documentType | string |
Type de document de la facture : « Note de crédit », « Facture ». |
|
Type de facture
|
items.invoiceType | string |
Type de facture : « périodique », « one_time ». |
Obtenir les détails du client (déconseillé) [DÉPRÉCIÉ]
Obtient une ressource client qui correspond à un ID client (déconseillé).
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de locataire du client
|
CustomerTenantID | True | string |
ID de locataire client |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID
|
id | string |
ID du client. |
|
ID de commerce.
|
commerceId | string |
ID de commerce. |
|
ID du locataire
|
companyProfile.tenantId | string |
Identificateur de locataire du client pour l’ID Microsoft Entra. Il s’agit également d’un MicrosoftID. |
|
Nom de la société (profil de la société).
|
companyProfile.companyName | string |
Nom de l’entreprise ou de l’organisation. |
|
Domain
|
companyProfile.domain | string |
Nom du client, tel que contoso.onmicrosoft.com. |
|
Pays (profil d’entreprise)
|
companyProfile.address.country | string |
Le pays. |
|
Région (profil d’entreprise).
|
companyProfile.address.region | string |
Région |
|
Ville (profil de l’entreprise)
|
companyProfile.address.city | string |
Ville. |
|
État (profil d’entreprise)
|
companyProfile.address.state | string |
État. |
|
Address Line1 (profil d’entreprise)
|
companyProfile.address.addressLine1 | string |
Première ligne de l’adresse. |
|
Code postal (profil d’entreprise)
|
companyProfile.address.postalCode | string |
Code postal ou code postal. |
|
Numéro de téléphone (profil de l’entreprise)
|
companyProfile.address.phoneNumber | string |
Numéro de téléphone d’un contact au niveau de l’entreprise/de l’organisation du client. |
|
E-mail (profil de l’entreprise)
|
companyProfile.email | string |
Messagerie électronique. |
|
ID de profil
|
billingProfile.id | string |
Identificateur de profil. |
|
Prénom (profil de facturation)
|
billingProfile.firstName | string |
Prénom du contact de facturation à l’entreprise du client. |
|
Nom (profil de facturation)
|
billingProfile.lastName | string |
Nom du contact de facturation. |
|
E-mail (profil de facturation)
|
billingProfile.email | string |
Adresse e-mail du contact de facturation |
|
Culture (profil de facturation)
|
billingProfile.culture | string |
Leur culture préférée pour la communication et la devise, comme «en-us». |
|
Langue (profil de facturation)
|
billingProfile.language | string |
Leur langue préférée pour la communication. |
|
Nom de la société (profil de facturation)
|
billingProfile.companyName | string |
Nom de l’entreprise ou de l’organisation. |
|
Pays (profil de facturation)
|
billingProfile.defaultAddress.country | string |
Pays/région au format de code de pays ISO. |
|
Région (profil de facturation)
|
billingProfile.defaultAddress.region | string |
Région |
|
Ville (profil de facturation)
|
billingProfile.defaultAddress.city | string |
Ville. |
|
État (profil de facturation)
|
billingProfile.defaultAddress.state | string |
État. |
|
AddressLine1 (profil de facturation)
|
billingProfile.defaultAddress.addressLine1 | string |
Première ligne de l’adresse. |
|
Code postal (profil de facturation)
|
billingProfile.defaultAddress.postalCode | string |
Code postal ou code postal. |
|
Prénom (profil de facturation)
|
billingProfile.defaultAddress.firstName | string |
Prénom d’un contact au niveau de l’entreprise/de l’organisation du client. |
|
Nom (profil de facturation)
|
billingProfile.defaultAddress.lastName | string |
Nom d’un contact au niveau de l’entreprise/de l’organisation du client. |
|
Numéro de téléphone (profil de facturation)
|
billingProfile.defaultAddress.phoneNumber | string |
Numéro de téléphone d’un contact au niveau de l’entreprise/de l’organisation du client. |
|
Relation avec le partenaire
|
relationshipToPartner | string |
Définit le programme de licences que le partenaire utilise pour ce client : « none », « reseller », « advisor », « syndication » ou « microsoft_support ». |
|
Autoriser l’accès délégué
|
allowDelegatedAccess | boolean |
Indique si le partenaire a reçu des privilèges d’administrateur délégués par ce client. |
|
Domaines personnalisés
|
customDomains | array of string |
Liste des domaines personnalisés d’un client. |
Obtenir tous les clients (déconseillés) [DÉCONSEILLÉ]
Obtenir la liste des clients (déconseillés).
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Taille
|
Size | string |
Nombre de résultats à afficher à la fois. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Nombre total
|
totalCount | integer |
Nombre total d’éléments dans la collection |
|
items
|
items | array of object |
items |
|
ID
|
items.id | string |
ID du client. |
|
ID du locataire
|
items.companyProfile.tenantId | string |
Identificateur de locataire du client pour l’ID Microsoft Entra. Il s’agit également d’un MicrosoftID. |
|
Domain
|
items.companyProfile.domain | string |
Nom du client, tel que contoso.onmicrosoft.com. |
|
Nom de l’entreprise
|
items.companyProfile.companyName | string |
Nom de l’entreprise ou de l’organisation. |
|
Relation avec le partenaire
|
items.relationshipToPartner | string |
Définit le programme de licences que le partenaire utilise pour ce client : « none », « reseller », « advisor », « syndication » ou « microsoft_support ». |