Dela via

Microsoft Partner Center (Preview)

  • Reference

This connector allows you to connect to MPC API and collect some information including customer details, orders and subscriptions.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Standard All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Standard All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name Microsoft
URL https://support.microsoft.com
Connector Metadata
Publisher Microsoft
Website https://docs.microsoft.com/en-us/partner-center/develop/
Privacy policy https://privacy.microsoft.com/en-us/privacystatement
Categories IT Operations;Business Management

Creating a connection

The connector supports the following authentication types:
Default Parameters for creating connection. All regions Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Get All Customers

Get a list of customers.
Get customer details

Gets a Customer resource that corresponds to a customer ID.
Get customer orders

Gets a collection of all the orders for a specified customer.
Get customer subscriptions

Gets a collection of all the subscriptions for a specified customer.
Get invoices

Get a collection of invoices.

Get All Customers

Operation ID:
GetAllCustomers

Get a list of customers.

Parameters

Name Key Required Type Description
Size
 Size string

The number of results to be displayed at one time.

Returns

Name Path Type Description
Total Count
 totalCount integer

Total count of elements in collection
items
 items array of object

items
ID
 items.id string

The customer ID.
Tenant ID
 items.companyProfile.tenantId string

The customer's tenant identifier for Microsoft Entra ID. This is also called a MicrosoftID.
Domain
 items.companyProfile.domain string

The customer's name, such as contoso.onmicrosoft.com.
Company Name
 items.companyProfile.companyName string

The name of the company or organization.
Relationship To Partner
 items.relationshipToPartner string

Defines the licensing program that the partner uses for this customer: "none", "reseller", "advisor", "syndication" or "microsoft_support".

Get customer details

Operation ID:
GetCustomerDetails

Gets a Customer resource that corresponds to a customer ID.

Parameters

Name Key Required Type Description
Customer tenant ID
 CustomerTenantID True string

A customer tenant ID

Returns

Name Path Type Description
ID
 id string

The customer ID.
The commerce ID.
 commerceId string

The commerce ID.
Tenant ID
 companyProfile.tenantId string

The customer's tenant identifier for Microsoft Entra ID. This is also called a MicrosoftID.
Company Name (Company Profile).
 companyProfile.companyName string

The name of the company or organization.
Domain
 companyProfile.domain string

The customer's name, such as contoso.onmicrosoft.com.
Country (Company Profile)
 companyProfile.address.country string

The country.
Region (Company Profile).
 companyProfile.address.region string

The region.
City (Company Profile)
 companyProfile.address.city string

The city.
State (Company Profile)
 companyProfile.address.state string

The state.
Address Line1 (Company Profile)
 companyProfile.address.addressLine1 string

The first line of the address.
Postal Code (Company Profile)
 companyProfile.address.postalCode string

The ZIP code or postal code.
Phone Number (Company Profile)
 companyProfile.address.phoneNumber string

The phone number of a contact at the customer's company/organization.
Email (Company Profile)
 companyProfile.email string

Email.
Profile ID
 billingProfile.id string

The profile identifier.
First Name (Billing Profile)
 billingProfile.firstName string

The first name of the billing contact at the customer's company.
Last Name (Billing Profile)
 billingProfile.lastName string

The last name of the billing contact.
Email (Billing Profile)
 billingProfile.email string

The billing contact's email address
Culture (Billing Profile)
 billingProfile.culture string

Their preferred culture for communication and currency, such as "en-us".
Language (Billing Profile)
 billingProfile.language string

Their preferred language for communication.
Company Name (Billing Profile)
 billingProfile.companyName string

The name of the company or organization.
Country (Billing Profile)
 billingProfile.defaultAddress.country string

The country/region in ISO country code format.
Region (Billing Profile)
 billingProfile.defaultAddress.region string

The region.
City (Billing Profile)
 billingProfile.defaultAddress.city string

The city.
State (Billing Profile)
 billingProfile.defaultAddress.state string

The state.
AddressLine1 (Billing Profile)
 billingProfile.defaultAddress.addressLine1 string

The first line of the address.
Postal Code (Billing Profile)
 billingProfile.defaultAddress.postalCode string

The ZIP code or postal code.
First Name (Billing Profile)
 billingProfile.defaultAddress.firstName string

The first name of a contact at the customer's company/organization.
Last Name (Billing Profile)
 billingProfile.defaultAddress.lastName string

The last name of a contact at the customer's company/organization.
Phone Number (Billing Profile)
 billingProfile.defaultAddress.phoneNumber string

The phone number of a contact at the customer's company/organization.
Relationship To Partner
 relationshipToPartner string

Defines the licensing program that the partner uses for this customer: "none", "reseller", "advisor", "syndication" or "microsoft_support".
Allow Delegated Access
 allowDelegatedAccess boolean

Indicates whether the partner has been granted delegated admin privileges by this customer.
Custom Domains
 customDomains array of string

List of custom domains of a customer.

Get customer orders

Operation ID:
GetCustomerOrders

Gets a collection of all the orders for a specified customer.

Parameters

Name Key Required Type Description
Customer tenant ID
 CustomerTenantID True string

A customer tenant ID.

Returns

Name Path Type Description
Total Count
 totalCount integer

Total count of customer orders.
items
 items array of object

items
ID
 items.id string

An order identifier.
Alternate ID
 items.alternateId string

A friendly identifier for the order.
Customer ID
 items.referenceCustomerId string

The customer identifier.
Billing Cycle
 items.billingCycle string

Indicates the frequency with which the partner is billed for this order.
Currency Code
 items.currencyCode string

The currency used when placing the order.
Currency Symbol
 items.currencySymbol string

The currency symbol associated with the currency code.
lineItems
 items.lineItems array of object

lineItems
lineItemNumber
 items.lineItems.lineItemNumber integer

Line item number.
Offer ID
 items.lineItems.offerId string

The ID of the offer.
Subscription ID
 items.lineItems.subscriptionId string

The ID of the subscription.
Term Duration
 items.lineItems.termDuration string

An ISO 8601 representation of the term's duration.
Promotion ID
 items.lineItems.promotionId string

Promotion ID.
Custom Term End Date
 items.lineItems.customTermEndDate string

The end date of the first billing term of the new subscription.
Transaction Type
 items.lineItems.transactionType string

The transaction type of the line item.
Friendly Name
 items.lineItems.friendlyName string

The friendly name for the subscription defined by the partner to help disambiguate.
quantity
 items.lineItems.quantity integer

Quantity
Creation Date
 items.creationDate string

The date the order was created, in date-time format.
Status
 items.status string

The status of the order.
Transaction Type
 items.transactionType string

The transaction type of the order. Supported values are 'UserPurchase', 'SystemPurchase', or 'SystemBilling'

Get customer subscriptions

Operation ID:
GetCustomerSubscription

Gets a collection of all the subscriptions for a specified customer.

Parameters

Name Key Required Type Description
Customer tenant ID
 CustomerTenantID True string

A customer's tenant ID.

Returns

Name Path Type Description
Total Count
 totalCount integer

Total count of subscriptions for customer.
items
 items array of object

items
ID
 items.id string

The subscription identifier.
Offer ID
 items.offerId string

The offer identifier.
Offer Name
 items.offerName string

The offer name.
Friendly Name
 items.friendlyName string

The friendly name for the subscription defined by the partner to help disambiguate.
ID
 items.productType.id string

The subscription identifier.
Display Name
 items.productType.displayName string

Display Name.
Quantity
 items.quantity integer

Provides the subscription quantity after provisioning.
Unit Type
 items.unitType string

The units defining quantity for the subscription.
Has Purchasable Addons
 items.hasPurchasableAddons boolean

A value indicating whether the subscription has purchasable add-ons.
Creation Date
 items.creationDate string

The creation date, in date-time format.
Effective Start Date
 items.effectiveStartDate string

The effective start date for this subscription, in date-time format.
Commitment End Date
 items.commitmentEndDate string

The commitment end date for this subscription, in date-time format.
Cancellation Allowed Until Date
 items.cancellationAllowedUntilDate string

The last date for cancellation.
Billing Cycle End Date
 items.billingCycleEndDate string

The billing cycle end date for this subscription, in date-time format.
Status
 items.status string

Indicates the provisioning status: "success", "pending" or "failed".
Auto Renew Enabled
 items.autoRenewEnabled boolean

autoRenewEnabled
Is Trial
 items.isTrial boolean

A value indicating whether the subscription is a trial.
Billing Type
 items.billingType string

Specifies how the subscription is billed: "none", "usage", or "license".
Billing Cycle
 items.billingCycle string

Indicates the frequency with which the partner is billed for this order.
Term Duration
 items.termDuration string

An ISO 8601 representation of the term's duration.
Renewal Term Duration
 items.renewalTermDuration string

An ISO 8601 representation of the term's duration.
Is Microsoft Product
 items.isMicrosoftProduct boolean

A value indicating whether the subscription is a Microsoft product.
Partner ID
 items.partnerId string

The MPN ID of the reseller of record, used in the indirect partner model.
Attention Needed
 items.attentionNeeded boolean

Is Attention Needed.
Contract Type
 items.contractType string

The type of contract: "subscription", "productKey", or "redemptionCode".
Publisher Name
 items.publisherName string

The publisher name.
Promotion ID
 items.promotionId string

The promotion identifier if applied to the subscription.
Order ID
 items.orderId string

The ID of the order that was placed to begin the subscription.

Get invoices

Operation ID:
GetInvoices

Get a collection of invoices.

Parameters

Name Key Required Type Description
Size
 Size integer

The number of invoice resources to return in the response. This parameter is optional.
Offset
 Offset string

The zero-based index of the first invoice to return.

Returns

Name Path Type Description
Total Count
 totalCount integer

Total count of elements in the collection.
items
 items array of object

items
ID
 items.id string

The invoice identifier.
Invoice Date
 items.invoiceDate string

The date the invoice was generated.
Billing Period Start Date
 items.billingPeriodStartDate string

Billing period start date in UTC.
Billing Period End Date
 items.billingPeriodEndDate string

Billing period end date in UTC.
Total Charges
 items.totalCharges float

The total charges. Includes charges for transactions and any adjustments.
Paid Amount
 items.paidAmount float

The amount paid by the partner. Negative if a payment was received.
Currency Code
 items.currencyCode string

A code that indicates the currency used for all invoice item amounts and totals.
Currency Symbol
 items.currencySymbol string

The currency symbol used for all invoice item amounts and totals.
PDF Download Link
 items.pdfDownloadLink string

A link to download the invoice in PDF format. This link isn't returned as part of the search results, and is populated only if the invoice is accessed by ID. This link auto-expires in 30 minutes.
invoiceDetails
 items.invoiceDetails array of object

The invoice details.
Invoice Line Item Type
 items.invoiceDetails.invoiceLineItemType string

The type of invoice detail: "none", "usage_line_items", "billing_line_items".
Billing Provider
 items.invoiceDetails.billingProvider string

The billing provider: "none", "office", "azure" or "azure_data_market".
Document Type
 items.documentType string

The document type of the invoice: "Credit Note", "Invoice".
Invoice Type
 items.invoiceType string

The type of invoice: "recurring", "one_time".