Centrum partnerskie firmy Microsoft [PRZESTARZAŁE]
Ten łącznik umożliwia łączenie się z interfejsem API MPC i zbieranie niektórych informacji, w tym szczegółów klienta, zamówień i subskrypcji.
Ten łącznik jest dostępny w następujących produktach i regionach:
| Usługa | Class | Regions |
|---|---|---|
| Copilot Studio | Standard | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Logic Apps | Standard | Wszystkie regiony usługi Logic Apps z wyjątkiem następujących: — Regiony platformy Azure Government — Regiony platformy Azure (Chiny) - Departament Obrony USA (DoD) |
| Power Apps | Standard | Wszystkie regiony usługi Power Apps z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Power Automate | Standard | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Kontakt | |
|---|---|
| Name | Microsoft |
| adres URL | https://support.microsoft.com |
| Metadane łącznika | |
|---|---|
| Publisher | Microsoft |
| Witryna internetowa | https://docs.microsoft.com/en-us/partner-center/develop/ |
| Zasady ochrony prywatności | https://privacy.microsoft.com/en-us/privacystatement |
| Kategorie | Operacje IT; Zarządzanie biznesem |
Tworzenie połączenia
Łącznik obsługuje następujące typy uwierzytelniania:
| Wartość domyślna | Parametry tworzenia połączenia. | Wszystkie regiony | Nie można udostępniać |
Domyślny
Dotyczy: wszystkie regiony
Parametry tworzenia połączenia.
Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.
Limity ograniczania
| Nazwa | Wywołania | Okres odnowienia |
|---|---|---|
| Wywołania interfejsu API na połączenie | 100 | 60 sekund |
Akcje
| Pobieranie faktur (przestarzałych) [PRZESTARZAŁE] |
Pobierz kolekcję faktur (przestarzałe). |
| Pobieranie subskrypcji klienta (przestarzałe) [PRZESTARZAŁE] |
Pobiera kolekcję wszystkich subskrypcji dla określonego klienta (przestarzałe). |
| Pobieranie szczegółów klienta (przestarzałe) [PRZESTARZAŁE] |
Pobiera zasób klienta odpowiadający identyfikatorowi klienta (przestarzałe). |
| Pobieranie zamówień klientów (przestarzałe) [PRZESTARZAŁE] |
Pobiera kolekcję wszystkich zamówień dla określonego klienta (przestarzałe). |
| Pobierz wszystkich klientów (przestarzałych) [PRZESTARZAŁE] |
Pobierz listę klientów (przestarzałych). |
Pobieranie faktur (przestarzałych) [PRZESTARZAŁE]
Pobierz kolekcję faktur (przestarzałe).
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Rozmiar
|
Size | integer |
Liczba zasobów faktury, które mają zostać zwrócone w odpowiedzi. Ten parametr jest opcjonalny. |
|
|
Przesunięcie
|
Offset | string |
Indeks zerowy pierwszej faktury do zwrócenia. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Łączna liczba
|
totalCount | integer |
Łączna liczba elementów w kolekcji. |
|
items
|
items | array of object |
items |
|
identyfikator
|
items.id | string |
Identyfikator faktury. |
|
Data faktury
|
items.invoiceDate | string |
Data wygenerowania faktury. |
|
Data rozpoczęcia okresu rozliczeniowego
|
items.billingPeriodStartDate | string |
Data rozpoczęcia okresu rozliczeniowego w formacie UTC. |
|
Data zakończenia okresu rozliczeniowego
|
items.billingPeriodEndDate | string |
Data zakończenia okresu rozliczeniowego w formacie UTC. |
|
Łączne opłaty
|
items.totalCharges | float |
Łączne opłaty. Obejmuje opłaty za transakcje i wszelkie korekty. |
|
Kwota płatna
|
items.paidAmount | float |
Kwota zapłacona przez partnera. Ujemny, jeśli otrzymano płatność. |
|
Kod waluty
|
items.currencyCode | string |
Kod wskazujący walutę używaną dla wszystkich kwot i sum elementów faktury. |
|
Symbol waluty
|
items.currencySymbol | string |
Symbol waluty używany dla wszystkich kwot i sum elementów faktury. |
|
Link do pobierania plików PDF
|
items.pdfDownloadLink | string |
Link umożliwiający pobranie faktury w formacie PDF. Ten link nie jest zwracany jako część wyników wyszukiwania i jest wypełniany tylko wtedy, gdy faktura jest uzyskiwana za pomocą identyfikatora. To łącze automatycznie wygasa w ciągu 30 minut. |
|
invoiceDetails
|
items.invoiceDetails | array of object |
Szczegóły faktury. |
|
Typ elementu wiersza faktury
|
items.invoiceDetails.invoiceLineItemType | string |
Typ szczegółów faktury: "none", "usage_line_items", "billing_line_items". |
|
Dostawca rozliczeń
|
items.invoiceDetails.billingProvider | string |
Dostawca rozliczeń: "none", "office", "azure" lub "azure_data_market". |
|
Typ dokumentu
|
items.documentType | string |
Typ dokumentu faktury: "Credit Note", "Invoice". |
|
Typ faktury
|
items.invoiceType | string |
Typ faktury: "cykliczne", "one_time". |
Pobieranie subskrypcji klienta (przestarzałe) [PRZESTARZAŁE]
Pobiera kolekcję wszystkich subskrypcji dla określonego klienta (przestarzałe).
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator dzierżawy klienta
|
CustomerTenantID | True | string |
Identyfikator dzierżawy klienta. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Łączna liczba
|
totalCount | integer |
Łączna liczba subskrypcji dla klienta. |
|
items
|
items | array of object |
items |
|
identyfikator
|
items.id | string |
Identyfikator subskrypcji. |
|
Identyfikator oferty
|
items.offerId | string |
Identyfikator oferty. |
|
Nazwa oferty
|
items.offerName | string |
Nazwa oferty. |
|
Przyjazna nazwa
|
items.friendlyName | string |
Przyjazna nazwa subskrypcji zdefiniowanej przez partnera w celu ułatwienia rozróżnienia. |
|
identyfikator
|
items.productType.id | string |
Identyfikator subskrypcji. |
|
Wyświetlana nazwa
|
items.productType.displayName | string |
Nazwa wyświetlana. |
|
Ilość
|
items.quantity | integer |
Udostępnia ilość subskrypcji po aprowizacji. |
|
Typ jednostki
|
items.unitType | string |
Jednostki definiujące ilość dla subskrypcji. |
|
Ma możliwe do przeczyszczania dodatki
|
items.hasPurchasableAddons | boolean |
Wartość wskazująca, czy subskrypcja ma możliwe do przekupu dodatki. |
|
Data utworzenia
|
items.creationDate | string |
Data utworzenia w formacie daty i godziny. |
|
Data rozpoczęcia obowiązywania
|
items.effectiveStartDate | string |
Data rozpoczęcia obowiązująca dla tej subskrypcji w formacie daty i godziny. |
|
Data zakończenia zobowiązania
|
items.commitmentEndDate | string |
Data zakończenia zobowiązania dla tej subskrypcji w formacie daty i godziny. |
|
Anulowanie dozwolone do daty
|
items.cancellationAllowedUntilDate | string |
Data ostatniego anulowania. |
|
Data zakończenia cyklu rozliczeniowego
|
items.billingCycleEndDate | string |
Data zakończenia cyklu rozliczeniowego dla tej subskrypcji w formacie daty i godziny. |
|
Status
|
items.status | string |
Wskazuje stan aprowizacji: "success", "pending" lub "failed". |
|
Automatyczne odnawianie włączone
|
items.autoRenewEnabled | boolean |
autoRenewEnabled |
|
Jest w wersji próbnej
|
items.isTrial | boolean |
Wartość wskazująca, czy subskrypcja jest wersją próbną. |
|
Typ rozliczeń
|
items.billingType | string |
Określa sposób naliczania opłat za subskrypcję: "none", "usage" lub "license". |
|
Cykl rozliczeniowy
|
items.billingCycle | string |
Wskazuje częstotliwość, z jaką partner jest rozliczany za to zamówienie. |
|
Czas trwania terminu
|
items.termDuration | string |
Reprezentacja iso 8601 czasu trwania terminu. |
|
Czas trwania okresu odnowienia
|
items.renewalTermDuration | string |
Reprezentacja iso 8601 czasu trwania terminu. |
|
Jest produktem firmy Microsoft
|
items.isMicrosoftProduct | boolean |
Wartość wskazująca, czy subskrypcja jest produktem firmy Microsoft. |
|
identyfikator partnera
|
items.partnerId | string |
Identyfikator MPN odsprzedawcy rekordu używany w modelu partnera pośredniego. |
|
Wymagana uwaga
|
items.attentionNeeded | boolean |
Potrzebna jest uwaga. |
|
Typ kontraktu
|
items.contractType | string |
Typ kontraktu: "subskrypcja", "productKey" lub "redemptionCode". |
|
Nazwa wydawcy
|
items.publisherName | string |
Nazwa wydawcy. |
|
Identyfikator promocji
|
items.promotionId | string |
Identyfikator podwyższania poziomu, jeśli zostanie zastosowany do subskrypcji. |
|
Identyfikator zamówienia
|
items.orderId | string |
Identyfikator zamówienia, który został złożony w celu rozpoczęcia subskrypcji. |
Pobieranie szczegółów klienta (przestarzałe) [PRZESTARZAŁE]
Pobiera zasób klienta odpowiadający identyfikatorowi klienta (przestarzałe).
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator dzierżawy klienta
|
CustomerTenantID | True | string |
Identyfikator dzierżawy klienta |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
identyfikator
|
id | string |
Identyfikator klienta. |
|
Identyfikator handlu.
|
commerceId | string |
Identyfikator handlu. |
|
Identyfikator dzierżawy
|
companyProfile.tenantId | string |
Identyfikator dzierżawy klienta dla identyfikatora entra firmy Microsoft. Jest to również nazywane identyfikatorem MicrosoftID. |
|
Nazwa firmy (profil firmy).
|
companyProfile.companyName | string |
Nazwa firmy lub organizacji. |
|
Domena
|
companyProfile.domain | string |
Nazwa klienta, taka jak contoso.onmicrosoft.com. |
|
Kraj (profil firmy)
|
companyProfile.address.country | string |
Kraj. |
|
Region (profil firmy).
|
companyProfile.address.region | string |
Region. |
|
Miasto (profil firmy)
|
companyProfile.address.city | string |
Miejscowość. |
|
Stan (profil firmy)
|
companyProfile.address.state | string |
Stan. |
|
Wiersz adresu1 (profil firmy)
|
companyProfile.address.addressLine1 | string |
Pierwszy wiersz adresu. |
|
Kod pocztowy (profil firmy)
|
companyProfile.address.postalCode | string |
Kod pocztowy lub kod pocztowy. |
|
Numer telefonu (profil firmy)
|
companyProfile.address.phoneNumber | string |
Numer telefonu kontaktu w firmie/organizacji klienta. |
|
Poczta e-mail (profil firmy)
|
companyProfile.email | string |
E-mail. |
|
Identyfikator profilu
|
billingProfile.id | string |
Identyfikator profilu. |
|
Imię (profil rozliczeniowy)
|
billingProfile.firstName | string |
Imię kontaktu rozliczeniowego w firmie klienta. |
|
Nazwisko (profil rozliczeniowy)
|
billingProfile.lastName | string |
Nazwisko kontaktu rozliczeniowego. |
|
Poczta e-mail (profil rozliczeniowy)
|
billingProfile.email | string |
Adres e-mail kontaktu rozliczeniowego |
|
Kultura (profil rozliczeniowy)
|
billingProfile.culture | string |
Preferowana kultura komunikacji i waluty, na przykład "en-us". |
|
Język (profil rozliczeniowy)
|
billingProfile.language | string |
Preferowany język komunikacji. |
|
Nazwa firmy (profil rozliczeniowy)
|
billingProfile.companyName | string |
Nazwa firmy lub organizacji. |
|
Kraj (profil rozliczeniowy)
|
billingProfile.defaultAddress.country | string |
Kraj/region w formacie kodu kraju ISO. |
|
Region (profil rozliczeniowy)
|
billingProfile.defaultAddress.region | string |
Region. |
|
Miasto (profil rozliczeniowy)
|
billingProfile.defaultAddress.city | string |
Miejscowość. |
|
Stan (profil rozliczeniowy)
|
billingProfile.defaultAddress.state | string |
Stan. |
|
AddressLine1 (profil rozliczeniowy)
|
billingProfile.defaultAddress.addressLine1 | string |
Pierwszy wiersz adresu. |
|
Kod pocztowy (profil rozliczeniowy)
|
billingProfile.defaultAddress.postalCode | string |
Kod pocztowy lub kod pocztowy. |
|
Imię (profil rozliczeniowy)
|
billingProfile.defaultAddress.firstName | string |
Imię kontaktu w firmie/organizacji klienta. |
|
Nazwisko (profil rozliczeniowy)
|
billingProfile.defaultAddress.lastName | string |
Nazwisko osoby kontaktowej w firmie/organizacji klienta. |
|
Numer telefonu (profil rozliczeniowy)
|
billingProfile.defaultAddress.phoneNumber | string |
Numer telefonu kontaktu w firmie/organizacji klienta. |
|
Relacja z partnerem
|
relationshipToPartner | string |
Definiuje program licencjonowania używany przez partnera dla tego klienta: "none", "reseller", "advisor", "syndication" lub "microsoft_support". |
|
Zezwalaj na dostęp delegowany
|
allowDelegatedAccess | boolean |
Wskazuje, czy partner otrzymał delegowane uprawnienia administratora przez tego klienta. |
|
Domeny niestandardowe
|
customDomains | array of string |
Lista domen niestandardowych klienta. |
Pobieranie zamówień klientów (przestarzałe) [PRZESTARZAŁE]
Pobiera kolekcję wszystkich zamówień dla określonego klienta (przestarzałe).
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator dzierżawy klienta
|
CustomerTenantID | True | string |
Identyfikator dzierżawy klienta. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Łączna liczba
|
totalCount | integer |
Łączna liczba zamówień klientów. |
|
items
|
items | array of object |
items |
|
identyfikator
|
items.id | string |
Identyfikator zamówienia. |
|
Identyfikator alternatywny
|
items.alternateId | string |
Przyjazny identyfikator zamówienia. |
|
Identyfikator klienta
|
items.referenceCustomerId | string |
Identyfikator klienta. |
|
Cykl rozliczeniowy
|
items.billingCycle | string |
Wskazuje częstotliwość, z jaką partner jest rozliczany za to zamówienie. |
|
Kod waluty
|
items.currencyCode | string |
Waluta używana podczas składania zamówienia. |
|
Symbol waluty
|
items.currencySymbol | string |
Symbol waluty skojarzony z kodem waluty. |
|
lineItems
|
items.lineItems | array of object |
lineItems |
|
numerPozycji
|
items.lineItems.lineItemNumber | integer |
Numer elementu wiersza. |
|
Identyfikator oferty
|
items.lineItems.offerId | string |
Identyfikator oferty. |
|
Identyfikator subskrypcji
|
items.lineItems.subscriptionId | string |
Identyfikator subskrypcji. |
|
Czas trwania terminu
|
items.lineItems.termDuration | string |
Reprezentacja iso 8601 czasu trwania terminu. |
|
Identyfikator promocji
|
items.lineItems.promotionId | string |
Identyfikator promocji. |
|
Data zakończenia terminu niestandardowego
|
items.lineItems.customTermEndDate | string |
Data zakończenia pierwszego okresu rozliczeniowego nowej subskrypcji. |
|
Typ transakcji
|
items.lineItems.transactionType | string |
Typ transakcji elementu wiersza. |
|
Przyjazna nazwa
|
items.lineItems.friendlyName | string |
Przyjazna nazwa subskrypcji zdefiniowanej przez partnera w celu ułatwienia rozróżnienia. |
|
ilość
|
items.lineItems.quantity | integer |
Ilość |
|
Data utworzenia
|
items.creationDate | string |
Data utworzenia zamówienia w formacie daty i godziny. |
|
Status
|
items.status | string |
Stan zamówienia. |
|
Typ transakcji
|
items.transactionType | string |
Typ transakcji zamówienia. Obsługiwane wartości to "UserPurchase", "SystemPurchase" lub "SystemBilling" |
Pobierz wszystkich klientów (przestarzałych) [PRZESTARZAŁE]
Pobierz listę klientów (przestarzałych).
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Rozmiar
|
Size | string |
Liczba wyników, które mają być wyświetlane jednocześnie. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Łączna liczba
|
totalCount | integer |
Łączna liczba elementów w kolekcji |
|
items
|
items | array of object |
items |
|
identyfikator
|
items.id | string |
Identyfikator klienta. |
|
Identyfikator dzierżawy
|
items.companyProfile.tenantId | string |
Identyfikator dzierżawy klienta dla identyfikatora entra firmy Microsoft. Jest to również nazywane identyfikatorem MicrosoftID. |
|
Domena
|
items.companyProfile.domain | string |
Nazwa klienta, taka jak contoso.onmicrosoft.com. |
|
Nazwa firmy
|
items.companyProfile.companyName | string |
Nazwa firmy lub organizacji. |
|
Relacja z partnerem
|
items.relationshipToPartner | string |
Definiuje program licencjonowania używany przez partnera dla tego klienta: "none", "reseller", "advisor", "syndication" lub "microsoft_support". |