Microsoft Partner Center [VERALTET]
Mit diesem Connector können Sie eine Verbindung mit der MPC-API herstellen und einige Informationen einschließlich Kundendetails, Bestellungen und Abonnements sammeln.
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Dienstleistung | Class | Regions |
|---|---|---|
| Copilot Studio | Norm | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Logik-Apps | Norm | Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche: – Azure Government-Regionen - Azure China-Regionen - US Department of Defense (DoD) |
| Power Apps | Norm | Alle Power Apps-Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Power Automate | Norm | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | Microsoft |
| URL | https://support.microsoft.com |
| Connectormetadaten | |
|---|---|
| Herausgeber | Microsoft |
| Webseite | https://docs.microsoft.com/en-us/partner-center/develop/ |
| Datenschutzrichtlinie | https://privacy.microsoft.com/en-us/privacystatement |
| Kategorien | IT-Vorgänge; Unternehmensführung |
Eine Verbindung wird erstellt
Der Connector unterstützt die folgenden Authentifizierungstypen:
| Vorgabe | Parameter zum Erstellen einer Verbindung. | Alle Regionen | Nicht teilbar |
Vorgabe
Anwendbar: Alle Regionen
Parameter zum Erstellen einer Verbindung.
Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.
Drosselungsgrenzwerte
| Name | Aufrufe | Verlängerungszeitraum |
|---|---|---|
| API-Aufrufe pro Verbindung | 100 | 60 Sekunden |
Aktionen
| Abrufen von Kundenabonnements (veraltet) [VERALTET] |
Ruft eine Auflistung aller Abonnements für einen angegebenen Kunden ab (veraltet). |
| Abrufen von Kundenbestellungen (veraltet) [VERALTET] |
Ruft eine Auflistung aller Bestellungen für einen angegebenen Kunden ab (veraltet). |
| Abrufen von Kundendetails (veraltet) [VERALTET] |
Ruft eine Kundenressource ab, die einer Kunden-ID entspricht (veraltet). |
| Alle Kunden abrufen (veraltet) [VERALTET] |
Abrufen einer Liste von Kunden (veraltet). |
| Rechnungen abrufen (veraltet) [VERALTET] |
Abrufen einer Sammlung von Rechnungen (veraltet). |
Abrufen von Kundenabonnements (veraltet) [VERALTET]
Ruft eine Auflistung aller Abonnements für einen angegebenen Kunden ab (veraltet).
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Kundenmandanten-ID
|
CustomerTenantID | True | string |
Mandanten-ID eines Kunden. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Gesamtanzahl
|
totalCount | integer |
Gesamtzahl der Abonnements für Kunden. |
|
items
|
items | array of object |
items |
|
ID
|
items.id | string |
Der Abonnementbezeichner. |
|
Angebots-ID
|
items.offerId | string |
Der Angebotsbezeichner. |
|
Angebotsname
|
items.offerName | string |
Der Angebotsname. |
|
Freundlicher Name
|
items.friendlyName | string |
Der Anzeigename für das vom Partner definierte Abonnement, um mehrdeutig zu sein. |
|
ID
|
items.productType.id | string |
Der Abonnementbezeichner. |
|
Anzeigename
|
items.productType.displayName | string |
Anzeigename. |
|
Menge
|
items.quantity | integer |
Stellt die Abonnementmenge nach der Bereitstellung bereit. |
|
Einheitentyp
|
items.unitType | string |
Die Einheiten, die die Menge für das Abonnement definieren. |
|
Hat bearbeitbare Addons
|
items.hasPurchasableAddons | boolean |
Ein Wert, der angibt, ob das Abonnement über bearbeitbare Add-Ons verfügt. |
|
Erstellungsdatum
|
items.creationDate | string |
Das Erstellungsdatum im Datums-/Uhrzeitformat. |
|
Effektives Startdatum
|
items.effectiveStartDate | string |
Das effektive Startdatum für dieses Abonnement im Datums-/Uhrzeitformat. |
|
Enddatum der Verpflichtung
|
items.commitmentEndDate | string |
Das Enddatum der Verpflichtung für dieses Abonnement im Datums-/Uhrzeitformat. |
|
Stornierung bis Datum zulässig
|
items.cancellationAllowedUntilDate | string |
Das letzte Datum für die Stornierung. |
|
Enddatum des Abrechnungszyklus
|
items.billingCycleEndDate | string |
Das Enddatum des Abrechnungszyklus für dieses Abonnement im Datums-/Uhrzeitformat. |
|
Der Status
|
items.status | string |
Gibt den Bereitstellungsstatus an: "success", "pending" oder "failed". |
|
Automatische Verlängerung aktiviert
|
items.autoRenewEnabled | boolean |
autoRenewEnabled |
|
Ist Testversion
|
items.isTrial | boolean |
Ein Wert, der angibt, ob das Abonnement eine Testversion ist. |
|
Abrechnungstyp
|
items.billingType | string |
Gibt an, wie das Abonnement abgerechnet wird: "none", "usage" oder "license". |
|
Abrechnungszyklus
|
items.billingCycle | string |
Gibt die Häufigkeit an, mit der der Partner für diese Bestellung in Rechnung gestellt wird. |
|
Laufzeitdauer
|
items.termDuration | string |
Eine ISO 8601-Darstellung der Dauer des Begriffs. |
|
Verlängerungsdauer
|
items.renewalTermDuration | string |
Eine ISO 8601-Darstellung der Dauer des Begriffs. |
|
Ist Microsoft-Produkt
|
items.isMicrosoftProduct | boolean |
Ein Wert, der angibt, ob das Abonnement ein Microsoft-Produkt ist. |
|
Partner ID
|
items.partnerId | string |
Die MPN-ID des Datensatzhändlers, der im indirekten Partnermodell verwendet wird. |
|
Aufmerksamkeit erforderlich
|
items.attentionNeeded | boolean |
Ist Aufmerksamkeit erforderlich. |
|
Vertragstyp
|
items.contractType | string |
Der Vertragstyp: "subscription", "productKey" oder "redemptionCode". |
|
Herausgebername
|
items.publisherName | string |
Der Herausgebername. |
|
Heraufsufungs-ID
|
items.promotionId | string |
Die Heraufsufungs-ID, wenn sie auf das Abonnement angewendet wird. |
|
Auftrags-ID
|
items.orderId | string |
Die ID der Bestellung, die zum Starten des Abonnements aufgegeben wurde. |
Abrufen von Kundenbestellungen (veraltet) [VERALTET]
Ruft eine Auflistung aller Bestellungen für einen angegebenen Kunden ab (veraltet).
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Kundenmandanten-ID
|
CustomerTenantID | True | string |
Eine Kundenmandanten-ID. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Gesamtanzahl
|
totalCount | integer |
Gesamtzahl der Kundenbestellungen. |
|
items
|
items | array of object |
items |
|
ID
|
items.id | string |
Ein Auftragsbezeichner. |
|
Alternative ID
|
items.alternateId | string |
Ein benutzerfreundlicher Bezeichner für die Bestellung. |
|
Kunden-ID
|
items.referenceCustomerId | string |
Die Kundenkennung. |
|
Abrechnungszyklus
|
items.billingCycle | string |
Gibt die Häufigkeit an, mit der der Partner für diese Bestellung in Rechnung gestellt wird. |
|
Währungscode
|
items.currencyCode | string |
Die Währung, die beim Aufgeben der Bestellung verwendet wird. |
|
Währungssymbol
|
items.currencySymbol | string |
Das Währungssymbol, das dem Währungscode zugeordnet ist. |
|
lineItems
|
items.lineItems | array of object |
lineItems |
|
lineItemNumber
|
items.lineItems.lineItemNumber | integer |
Zeilenelementnummer. |
|
Angebots-ID
|
items.lineItems.offerId | string |
Die ID des Angebots. |
|
Abonnement-ID
|
items.lineItems.subscriptionId | string |
Die ID des Abonnements. |
|
Laufzeitdauer
|
items.lineItems.termDuration | string |
Eine ISO 8601-Darstellung der Dauer des Begriffs. |
|
Heraufsufungs-ID
|
items.lineItems.promotionId | string |
Heraufsufungs-ID. |
|
Enddatum des benutzerdefinierten Ausdrucks
|
items.lineItems.customTermEndDate | string |
Das Enddatum der ersten Abrechnungsdauer des neuen Abonnements. |
|
Transaktionstyp
|
items.lineItems.transactionType | string |
Der Transaktionstyp der Position. |
|
Freundlicher Name
|
items.lineItems.friendlyName | string |
Der Anzeigename für das vom Partner definierte Abonnement, um mehrdeutig zu sein. |
|
Menge
|
items.lineItems.quantity | integer |
Menge |
|
Erstellungsdatum
|
items.creationDate | string |
Das Datum, an dem die Reihenfolge erstellt wurde, im Datums-/Uhrzeitformat. |
|
Der Status
|
items.status | string |
Der Status der Bestellung. |
|
Transaktionstyp
|
items.transactionType | string |
Der Transaktionstyp der Bestellung. Unterstützte Werte sind "UserPurchase", "SystemPurchase" oder "SystemBilling" |
Abrufen von Kundendetails (veraltet) [VERALTET]
Ruft eine Kundenressource ab, die einer Kunden-ID entspricht (veraltet).
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Kundenmandanten-ID
|
CustomerTenantID | True | string |
Eine Kundenmandanten-ID |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
ID
|
id | string |
Die Kunden-ID. |
|
Die Commerce-ID.
|
commerceId | string |
Die Commerce-ID. |
|
Mieter-ID
|
companyProfile.tenantId | string |
Der Mandantenbezeichner des Kunden für die Microsoft Entra-ID. Dies wird auch als MicrosoftID bezeichnet. |
|
Firmenname (Firmenprofil).
|
companyProfile.companyName | string |
Der Name des Unternehmens oder der Organisation. |
|
Domäne
|
companyProfile.domain | string |
Der Name des Kunden, z. B. contoso.onmicrosoft.com. |
|
Land (Unternehmensprofil)
|
companyProfile.address.country | string |
Das Land. |
|
Region (Unternehmensprofil).
|
companyProfile.address.region | string |
Die Region. |
|
Stadt (Firmenprofil)
|
companyProfile.address.city | string |
Die Stadt. |
|
Bundesland (Unternehmensprofil)
|
companyProfile.address.state | string |
Das Land/die Region. |
|
Adresszeile1 (Firmenprofil)
|
companyProfile.address.addressLine1 | string |
Die erste Zeile der Adresse. |
|
Postleitzahl (Firmenprofil)
|
companyProfile.address.postalCode | string |
Plz. |
|
Telefonnummer (Unternehmensprofil)
|
companyProfile.address.phoneNumber | string |
Die Telefonnummer eines Kontakts im Unternehmen/der Organisation des Kunden. |
|
E-Mail (Unternehmensprofil)
|
companyProfile.email | string |
E-Mail. |
|
Profil-ID
|
billingProfile.id | string |
Der Profilbezeichner. |
|
Vorname (Abrechnungsprofil)
|
billingProfile.firstName | string |
Der Vorname des Abrechnungskontakts im Unternehmen des Kunden. |
|
Nachname (Abrechnungsprofil)
|
billingProfile.lastName | string |
Der Nachname des Abrechnungskontakts. |
|
E-Mail (Abrechnungsprofil)
|
billingProfile.email | string |
Die E-Mail-Adresse des Abrechnungskontakts |
|
Kultur (Abrechnungsprofil)
|
billingProfile.culture | string |
Ihre bevorzugte Kultur für Kommunikation und Währung, z. B. "en-us". |
|
Sprache (Abrechnungsprofil)
|
billingProfile.language | string |
Ihre bevorzugte Sprache für die Kommunikation. |
|
Firmenname (Abrechnungsprofil)
|
billingProfile.companyName | string |
Der Name des Unternehmens oder der Organisation. |
|
Land (Abrechnungsprofil)
|
billingProfile.defaultAddress.country | string |
Das Land/die Region im ISO-Ländercodeformat. |
|
Region (Abrechnungsprofil)
|
billingProfile.defaultAddress.region | string |
Die Region. |
|
Ort (Abrechnungsprofil)
|
billingProfile.defaultAddress.city | string |
Die Stadt. |
|
Status (Abrechnungsprofil)
|
billingProfile.defaultAddress.state | string |
Das Land/die Region. |
|
AddressLine1 (Abrechnungsprofil)
|
billingProfile.defaultAddress.addressLine1 | string |
Die erste Zeile der Adresse. |
|
Postleitzahl (Abrechnungsprofil)
|
billingProfile.defaultAddress.postalCode | string |
Plz. |
|
Vorname (Abrechnungsprofil)
|
billingProfile.defaultAddress.firstName | string |
Der Vorname eines Kontakts im Unternehmen/der Organisation des Kunden. |
|
Nachname (Abrechnungsprofil)
|
billingProfile.defaultAddress.lastName | string |
Der Nachname eines Kontakts im Unternehmen/der Organisation des Kunden. |
|
Telefonnummer (Abrechnungsprofil)
|
billingProfile.defaultAddress.phoneNumber | string |
Die Telefonnummer eines Kontakts im Unternehmen/der Organisation des Kunden. |
|
Beziehung zu Partner
|
relationshipToPartner | string |
Definiert das Lizenzierungsprogramm, das der Partner für diesen Kunden verwendet: "none", "reseller", "advisor", "syndication" oder "microsoft_support". |
|
Delegierten Zugriff zulassen
|
allowDelegatedAccess | boolean |
Gibt an, ob dem Partner delegierte Administratorrechte von diesem Kunden gewährt wurden. |
|
Benutzerdefinierte Domains
|
customDomains | array of string |
Liste der benutzerdefinierten Domänen eines Kunden. |
Alle Kunden abrufen (veraltet) [VERALTET]
Abrufen einer Liste von Kunden (veraltet).
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Größe
|
Size | string |
Die Anzahl der Ergebnisse, die gleichzeitig angezeigt werden sollen. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Gesamtanzahl
|
totalCount | integer |
Gesamtanzahl der Elemente in der Auflistung |
|
items
|
items | array of object |
items |
|
ID
|
items.id | string |
Die Kunden-ID. |
|
Mieter-ID
|
items.companyProfile.tenantId | string |
Der Mandantenbezeichner des Kunden für die Microsoft Entra-ID. Dies wird auch als MicrosoftID bezeichnet. |
|
Domäne
|
items.companyProfile.domain | string |
Der Name des Kunden, z. B. contoso.onmicrosoft.com. |
|
Name des Unternehmens
|
items.companyProfile.companyName | string |
Der Name des Unternehmens oder der Organisation. |
|
Beziehung zu Partner
|
items.relationshipToPartner | string |
Definiert das Lizenzierungsprogramm, das der Partner für diesen Kunden verwendet: "none", "reseller", "advisor", "syndication" oder "microsoft_support". |
Rechnungen abrufen (veraltet) [VERALTET]
Abrufen einer Sammlung von Rechnungen (veraltet).
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Größe
|
Size | integer |
Die Anzahl der Rechnungsressourcen, die in der Antwort zurückgegeben werden sollen. Dieser Parameter ist optional. |
|
|
Offset
|
Offset | string |
Der nullbasierte Index der ersten Rechnung, die zurückgegeben werden soll. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Gesamtanzahl
|
totalCount | integer |
Die Gesamtanzahl der Elemente in der Auflistung. |
|
items
|
items | array of object |
items |
|
ID
|
items.id | string |
Der Rechnungsbezeichner. |
|
Rechnungsdatum
|
items.invoiceDate | string |
Das Datum, an dem die Rechnung generiert wurde. |
|
Startdatum des Abrechnungszeitraums
|
items.billingPeriodStartDate | string |
Startdatum des Abrechnungszeitraums in UTC. |
|
Enddatum des Abrechnungszeitraums
|
items.billingPeriodEndDate | string |
Enddatum des Abrechnungszeitraums in UTC. |
|
Gesamtgebühren
|
items.totalCharges | float |
Die Gesamtgebühren. Umfasst Gebühren für Transaktionen und alle Anpassungen. |
|
Bezahlter Betrag
|
items.paidAmount | float |
Der vom Partner gezahlte Betrag. Negativ, wenn eine Zahlung empfangen wurde. |
|
Währungscode
|
items.currencyCode | string |
Ein Code, der die Währung angibt, die für alle Rechnungsartikelbeträge und Summen verwendet wird. |
|
Währungssymbol
|
items.currencySymbol | string |
Das Währungssymbol, das für alle Rechnungsartikelbeträge und Summen verwendet wird. |
|
PDF-Downloadlink
|
items.pdfDownloadLink | string |
Ein Link zum Herunterladen der Rechnung im PDF-Format. Dieser Link wird nicht als Teil der Suchergebnisse zurückgegeben und wird nur ausgefüllt, wenn auf die Rechnung über die ID zugegriffen wird. Dieser Link läuft in 30 Minuten automatisch ab. |
|
invoiceDetails
|
items.invoiceDetails | array of object |
Die Rechnungsdetails. |
|
Rechnungspositionstyp
|
items.invoiceDetails.invoiceLineItemType | string |
Die Art der Rechnungsdetails: "none", "usage_line_items", "billing_line_items". |
|
Abrechnungsanbieter
|
items.invoiceDetails.billingProvider | string |
Der Abrechnungsanbieter: "none", "office", "azure" oder "azure_data_market". |
|
Dokumenttyp
|
items.documentType | string |
Der Dokumenttyp der Rechnung: "Gutschrift", "Rechnung". |
|
Rechnungstyp
|
items.invoiceType | string |
Die Art der Rechnung: "recurring", "one_time". |