Dela via


Microsoft Partner Center [INAKTUELL]

Med den här anslutningsappen kan du ansluta till MPC API och samla in viss information, till exempel kundinformation, beställningar och prenumerationer.

Den här anslutningsappen är tillgänglig i följande produkter och regioner:

Tjänster Class Regioner
Copilot Studio Norm Alla Power Automate-regioner utom följande:
     - Amerikanska myndigheter (GCC)
     - Amerikanska myndigheter (GCC High)
     – China Cloud drivs av 21Vianet
     - US Department of Defense (DoD)
Logiska appar Norm Alla Logic Apps-regioner utom följande:
     – Azure Government-regioner
     – Regioner i Azure Kina
     - US Department of Defense (DoD)
Power Apps Norm Alla Power Apps-regioner utom följande:
     - Amerikanska myndigheter (GCC)
     - Amerikanska myndigheter (GCC High)
     – China Cloud drivs av 21Vianet
     - US Department of Defense (DoD)
Power Automate Norm Alla Power Automate-regioner utom följande:
     - Amerikanska myndigheter (GCC)
     - Amerikanska myndigheter (GCC High)
     – China Cloud drivs av 21Vianet
     - US Department of Defense (DoD)
Kontakt
Namn Microsoft
URL https://support.microsoft.com
Metadata för anslutningsprogram
Utgivare Microsoft
Webbplats https://docs.microsoft.com/en-us/partner-center/develop/
Sekretesspolicy https://privacy.microsoft.com/en-us/privacystatement
Kategorier IT-åtgärder; Företagsledning

Skapa en anslutning

Anslutningsappen stöder följande autentiseringstyper:

Standardinställning Parametrar för att skapa anslutning. Alla regioner Går inte att dela

Standard

Tillämpligt: Alla regioner

Parametrar för att skapa anslutning.

Det här är inte delningsbar anslutning. Om power-appen delas med en annan användare uppmanas en annan användare att skapa en ny anslutning explicit.

Begränsningsgränser

Name Anrop Förnyelseperiod
API-anrop per anslutning 100 60 sekunder

Åtgärder

Hämta alla kunder (inaktuell) [INAKTUELL]

Hämta en lista över kunder (inaktuella).

Hämta fakturor (inaktuella) [INAKTUELLA]

Hämta en samling fakturor (inaktuella).

Hämta kundbeställningar (inaktuella) [INAKTUELLA]

Hämtar en samling av alla beställningar för en angiven kund (inaktuell).

Hämta kundinformation (inaktuell) [INAKTUELL]

Hämtar en kundresurs som motsvarar ett kund-ID (inaktuellt).

Hämta kundprenumerationer (inaktuella) [INAKTUELLA]

Hämtar en samling med alla prenumerationer för en angiven kund (inaktuell).

Hämta alla kunder (inaktuell) [INAKTUELL]

Hämta en lista över kunder (inaktuella).

Parametrar

Name Nyckel Obligatorisk Typ Description
Storlek
Size string

Antalet resultat som ska visas samtidigt.

Returer

Name Sökväg Typ Description
Totalt antal
totalCount integer

Totalt antal element i samlingen

items
items array of object

items

ID-nummer
items.id string

Kund-ID:t.

Hyresgäst-ID
items.companyProfile.tenantId string

Kundens klient-ID för Microsoft Entra-ID. Detta kallas även för ett MicrosoftID.

Domän
items.companyProfile.domain string

Kundens namn, till exempel contoso.onmicrosoft.com.

Företagsnamn
items.companyProfile.companyName string

Namnet på företaget eller organisationen.

Relation till partner
items.relationshipToPartner string

Definierar det licensieringsprogram som partnern använder för den här kunden: "none", "reseller", "advisor", "syndication" eller "microsoft_support".

Hämta fakturor (inaktuella) [INAKTUELLA]

Hämta en samling fakturor (inaktuella).

Parametrar

Name Nyckel Obligatorisk Typ Description
Storlek
Size integer

Antalet fakturaresurser som ska returneras i svaret. Den här parametern är valfri.

Avräkning
Offset string

Det nollbaserade indexet för den första fakturan som ska returneras.

Returer

Name Sökväg Typ Description
Totalt antal
totalCount integer

Totalt antal element i samlingen.

items
items array of object

items

ID-nummer
items.id string

Fakturaidentifieraren.

Fakturadatum
items.invoiceDate string

Det datum då fakturan genererades.

Startdatum för faktureringsperiod
items.billingPeriodStartDate string

Startdatum för faktureringsperiod i UTC.

Slutdatum för faktureringsperiod
items.billingPeriodEndDate string

Slutdatum för faktureringsperiod i UTC.

Totalt antal avgifter
items.totalCharges float

De totala avgifterna. Inkluderar avgifter för transaktioner och eventuella justeringar.

Betalt belopp
items.paidAmount float

Det belopp som partnern betalar. Negativt om en betalning togs emot.

Valutakod
items.currencyCode string

En kod som anger den valuta som används för alla fakturaartikelbelopp och summor.

Valutasymbol
items.currencySymbol string

Valutasymbolen som används för alla fakturaobjektsbelopp och summor.

PDF-nedladdningslänk
items.pdfDownloadLink string

En länk för att ladda ned fakturan i PDF-format. Den här länken returneras inte som en del av sökresultaten och fylls bara i om fakturan nås med ID. Den här länken upphör att gälla automatiskt om 30 minuter.

invoiceDetails
items.invoiceDetails array of object

Fakturainformationen.

Typ av fakturaradsobjekt
items.invoiceDetails.invoiceLineItemType string

Typ av fakturainformation: "none", "usage_line_items", "billing_line_items".

Faktureringsprovider
items.invoiceDetails.billingProvider string

Faktureringsprovidern: "none", "office", "azure" eller "azure_data_market".

Dokumenttyp
items.documentType string

Dokumenttypen för fakturan: "Kreditnota", "Faktura".

Fakturatyp
items.invoiceType string

Typ av faktura: "återkommande", "one_time".

Hämta kundbeställningar (inaktuella) [INAKTUELLA]

Hämtar en samling av alla beställningar för en angiven kund (inaktuell).

Parametrar

Name Nyckel Obligatorisk Typ Description
Kundens klientorganisations-ID
CustomerTenantID True string

Ett kundklient-ID.

Returer

Name Sökväg Typ Description
Totalt antal
totalCount integer

Totalt antal kundorder.

items
items array of object

items

ID-nummer
items.id string

En orderidentifierare.

Alternativt ID
items.alternateId string

En egen identifierare för ordern.

Kund-ID
items.referenceCustomerId string

Kundidentifieraren.

Faktureringscykel
items.billingCycle string

Anger hur ofta partnern faktureras för den här ordern.

Valutakod
items.currencyCode string

Den valuta som används vid beställningen.

Valutasymbol
items.currencySymbol string

Valutasymbolen som är associerad med valutakoden.

lineItems
items.lineItems array of object

lineItems

lineItemNumber
items.lineItems.lineItemNumber integer

Radartikelnummer.

Erbjudande-ID-nummer
items.lineItems.offerId string

ID:t för erbjudandet.

Prenumerations-ID
items.lineItems.subscriptionId string

ID:t för prenumerationen.

Termvaraktighet
items.lineItems.termDuration string

En ISO 8601-representation av termens varaktighet.

Kampanj-ID
items.lineItems.promotionId string

Kampanj-ID.

Slutdatum för anpassad term
items.lineItems.customTermEndDate string

Slutdatumet för den första faktureringsperioden för den nya prenumerationen.

Transaktionstyp
items.lineItems.transactionType string

Transaktionstypen för radobjektet.

Vänligt namn
items.lineItems.friendlyName string

Det egna namnet på prenumerationen som definierats av partnern för att underlätta tvetydigheten.

kvantitet
items.lineItems.quantity integer

Kvantitet

Skapandedatum
items.creationDate string

Det datum då ordern skapades, i datum-tid-format.

Läge
items.status string

Status för ordern.

Transaktionstyp
items.transactionType string

Transaktionstypen för ordern. Värden som stöds är "UserPurchase", "SystemPurchase" eller "SystemBilling"

Hämta kundinformation (inaktuell) [INAKTUELL]

Hämtar en kundresurs som motsvarar ett kund-ID (inaktuellt).

Parametrar

Name Nyckel Obligatorisk Typ Description
Kundens klientorganisations-ID
CustomerTenantID True string

Ett kundklient-ID

Returer

Name Sökväg Typ Description
ID-nummer
id string

Kund-ID:t.

Handels-ID:t.
commerceId string

Handels-ID:t.

Hyresgäst-ID
companyProfile.tenantId string

Kundens klient-ID för Microsoft Entra-ID. Detta kallas även för ett MicrosoftID.

Företagsnamn (företagsprofil).
companyProfile.companyName string

Namnet på företaget eller organisationen.

Domän
companyProfile.domain string

Kundens namn, till exempel contoso.onmicrosoft.com.

Land (företagsprofil)
companyProfile.address.country string

Landet.

Region (företagsprofil).
companyProfile.address.region string

Regionen.

Stad (företagsprofil)
companyProfile.address.city string

Staden.

Tillstånd (företagsprofil)
companyProfile.address.state string

Staten.

Adressrad1 (företagsprofil)
companyProfile.address.addressLine1 string

Den första raden i adressen.

Postnummer (företagsprofil)
companyProfile.address.postalCode string

Postnummer eller postnummer.

Telefonnummer (företagsprofil)
companyProfile.address.phoneNumber string

Telefonnumret till en kontakt på kundens företag/organisation.

E-post (företagsprofil)
companyProfile.email string

E-post.

Profil-ID
billingProfile.id string

Profilidentifieraren.

Förnamn (faktureringsprofil)
billingProfile.firstName string

Förnamnet på faktureringskontakten på kundens företag.

Efternamn (faktureringsprofil)
billingProfile.lastName string

Efternamnet på faktureringskontakten.

E-post (faktureringsprofil)
billingProfile.email string

Faktureringskontaktens e-postadress

Kultur (faktureringsprofil)
billingProfile.culture string

Deras föredragna kultur för kommunikation och valuta, till exempel "en-us".

Språk (faktureringsprofil)
billingProfile.language string

Deras föredragna språk för kommunikation.

Företagsnamn (faktureringsprofil)
billingProfile.companyName string

Namnet på företaget eller organisationen.

Land (faktureringsprofil)
billingProfile.defaultAddress.country string

Landet/regionen i ISO-landskodformat.

Region (faktureringsprofil)
billingProfile.defaultAddress.region string

Regionen.

Stad (faktureringsprofil)
billingProfile.defaultAddress.city string

Staden.

Tillstånd (faktureringsprofil)
billingProfile.defaultAddress.state string

Staten.

AddressLine1 (faktureringsprofil)
billingProfile.defaultAddress.addressLine1 string

Den första raden i adressen.

Postnummer (faktureringsprofil)
billingProfile.defaultAddress.postalCode string

Postnummer eller postnummer.

Förnamn (faktureringsprofil)
billingProfile.defaultAddress.firstName string

Förnamnet på en kontakt på kundens företag/organisation.

Efternamn (faktureringsprofil)
billingProfile.defaultAddress.lastName string

Efternamnet på en kontakt på kundens företag/organisation.

Telefonnummer (faktureringsprofil)
billingProfile.defaultAddress.phoneNumber string

Telefonnumret till en kontakt på kundens företag/organisation.

Relation till partner
relationshipToPartner string

Definierar det licensieringsprogram som partnern använder för den här kunden: "none", "reseller", "advisor", "syndication" eller "microsoft_support".

Tillåt delegerad åtkomst
allowDelegatedAccess boolean

Anger om partnern har beviljats delegerade administratörsbehörigheter av den här kunden.

Anpassade domäner
customDomains array of string

Lista över anpassade domäner för en kund.

Hämta kundprenumerationer (inaktuella) [INAKTUELLA]

Hämtar en samling med alla prenumerationer för en angiven kund (inaktuell).

Parametrar

Name Nyckel Obligatorisk Typ Description
Kundens klientorganisations-ID
CustomerTenantID True string

Kundens klientorganisations-ID.

Returer

Name Sökväg Typ Description
Totalt antal
totalCount integer

Totalt antal prenumerationer för kunden.

items
items array of object

items

ID-nummer
items.id string

Prenumerationsidentifieraren.

Erbjudande-ID-nummer
items.offerId string

Erbjudandeidentifieraren.

Erbjudandets namn
items.offerName string

Erbjudandets namn.

Vänligt namn
items.friendlyName string

Det egna namnet på prenumerationen som definierats av partnern för att underlätta tvetydigheten.

ID-nummer
items.productType.id string

Prenumerationsidentifieraren.

Visningsnamn
items.productType.displayName string

Visningsnamn.

Kvantitet
items.quantity integer

Tillhandahåller prenumerationskvantiteten efter etableringen.

Enhetstyp
items.unitType string

Enheter som definierar kvantitet för prenumerationen.

Har köpbara tillägg
items.hasPurchasableAddons boolean

Ett värde som anger om prenumerationen har köpbara tillägg.

Skapandedatum
items.creationDate string

Skapandedatum i datum-tid-format.

Gällande startdatum
items.effectiveStartDate string

Det effektiva startdatumet för den här prenumerationen, i datum-tid-format.

Slutdatum för åtagande
items.commitmentEndDate string

Slutdatum för åtagandet för den här prenumerationen i datum-tid-format.

Annullering tillåts till och med datum
items.cancellationAllowedUntilDate string

Det sista datumet för annullering.

Slutdatum för faktureringscykel
items.billingCycleEndDate string

Slutdatum för faktureringscykeln för den här prenumerationen i datum-tid-format.

Läge
items.status string

Anger etableringsstatus: "lyckades", "väntar" eller "misslyckades".

Automatisk förnyelse aktiverad
items.autoRenewEnabled boolean

autoRenewEnabled

Är en utvärderingsversion
items.isTrial boolean

Ett värde som anger om prenumerationen är en utvärderingsversion.

Faktureringstyp
items.billingType string

Anger hur prenumerationen faktureras: "none", "usage" eller "license".

Faktureringscykel
items.billingCycle string

Anger hur ofta partnern faktureras för den här ordern.

Termvaraktighet
items.termDuration string

En ISO 8601-representation av termens varaktighet.

Varaktighet för förnyelseperiod
items.renewalTermDuration string

En ISO 8601-representation av termens varaktighet.

Är Microsoft Product
items.isMicrosoftProduct boolean

Ett värde som anger om prenumerationen är en Microsoft-produkt.

Partner ID
items.partnerId string

MPN-ID för återförsäljaren av posten, som används i den indirekta partnermodellen.

Uppmärksamhet krävs
items.attentionNeeded boolean

Är uppmärksamhet krävs.

Kontraktstyp
items.contractType string

Typ av kontrakt: "subscription", "productKey" eller "redemptionCode".

Utgivarens namn
items.publisherName string

Utgivarens namn.

Kampanj-ID
items.promotionId string

Kampanjidentifieraren om den tillämpas på prenumerationen.

Order-ID
items.orderId string

ID:t för den beställning som gjordes för att påbörja prenumerationen.