Microsoft Partner Center [PRETERIDO]
Esse conector permite que você se conecte à API do MPC e colete algumas informações, incluindo detalhes do cliente, pedidos e assinaturas.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Standard | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Standard | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Standard | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Microsoft |
| URL | https://support.microsoft.com |
| Metadados do conector | |
|---|---|
| Publicador | Microsoft |
| Website | https://docs.microsoft.com/en-us/partner-center/develop/ |
| Política de privacidade | https://privacy.microsoft.com/en-us/privacystatement |
| Categorias | Operações de TI; Gestão de empresas |
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Obter assinaturas do cliente (preteridas) [PRETERIDAS] |
Obtém uma coleção de todas as assinaturas para um cliente especificado (preterido). |
| Obter detalhes do cliente (preterido) [PRETERIDO] |
Obtém um recurso cliente que corresponde a uma ID do cliente (preterida). |
| Obter faturas (preteridas) [PRETERIDAS] |
Obter uma coleção de faturas (preterida). |
| Obter pedidos de clientes (preteridos) [PRETERIDO] |
Obtém uma coleção de todos os pedidos de um cliente especificado (preterido). |
| Obter todos os clientes (preterido) [PRETERIDO] |
Obter uma lista de clientes (preterido). |
Obter assinaturas do cliente (preteridas) [PRETERIDAS]
Obtém uma coleção de todas as assinaturas para um cliente especificado (preterido).
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do locatário do cliente
|
CustomerTenantID | True | string |
ID do locatário de um cliente. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Contagem total
|
totalCount | integer |
Contagem total de assinaturas para o cliente. |
|
items
|
items | array of object |
items |
|
ID
|
items.id | string |
O identificador da assinatura. |
|
ID da oferta
|
items.offerId | string |
O identificador da oferta. |
|
Nome da Oferta
|
items.offerName | string |
O nome da oferta. |
|
Nome amigável
|
items.friendlyName | string |
O nome amigável da assinatura definida pelo parceiro para ajudar a desambiguar. |
|
ID
|
items.productType.id | string |
O identificador da assinatura. |
|
Nome de Exibição
|
items.productType.displayName | string |
Nome de Exibição. |
|
Quantidade
|
items.quantity | integer |
Fornece a quantidade de assinatura após o provisionamento. |
|
Tipo de unidade
|
items.unitType | string |
As unidades que definem a quantidade para a assinatura. |
|
Tem complementos adquiríveis
|
items.hasPurchasableAddons | boolean |
Um valor que indica se a assinatura tem complementos adquiríveis. |
|
Data de Criação
|
items.creationDate | string |
A data de criação, no formato de data e hora. |
|
Data de início efetiva
|
items.effectiveStartDate | string |
A data de início efetiva dessa assinatura, no formato de data e hora. |
|
Data de término do compromisso
|
items.commitmentEndDate | string |
A data de término do compromisso desta assinatura, em formato de data e hora. |
|
Cancelamento permitido até a data
|
items.cancellationAllowedUntilDate | string |
A última data para cancelamento. |
|
Data de término do ciclo de cobrança
|
items.billingCycleEndDate | string |
A data de término do ciclo de cobrança dessa assinatura, em formato de data e hora. |
|
Situação
|
items.status | string |
Indica o status de provisionamento: "êxito", "pendente" ou "com falha". |
|
Renovação Automática Habilitada
|
items.autoRenewEnabled | boolean |
autoRenewEnabled |
|
É avaliação
|
items.isTrial | boolean |
Um valor que indica se a assinatura é uma avaliação. |
|
Tipo de Cobrança
|
items.billingType | string |
Especifica como a assinatura é cobrada: "none", "usage" ou "license". |
|
Ciclo de cobrança
|
items.billingCycle | string |
Indica a frequência com que o parceiro é cobrado por essa ordem. |
|
Duração do termo
|
items.termDuration | string |
Uma representação ISO 8601 da duração do termo. |
|
Duração do termo de renovação
|
items.renewalTermDuration | string |
Uma representação ISO 8601 da duração do termo. |
|
É o produto da Microsoft
|
items.isMicrosoftProduct | boolean |
Um valor que indica se a assinatura é um produto da Microsoft. |
|
ID de Parceiro
|
items.partnerId | string |
A ID do MPN do revendedor de registro, usada no modelo de parceiro indireto. |
|
Atenção necessária
|
items.attentionNeeded | boolean |
É necessário atenção. |
|
Tipo de contrato
|
items.contractType | string |
O tipo de contrato: "subscription", "productKey" ou "redemptionCode". |
|
Nome do Editor
|
items.publisherName | string |
O nome do editor. |
|
ID da promoção
|
items.promotionId | string |
O identificador de promoção se aplicado à assinatura. |
|
ID do pedido
|
items.orderId | string |
A ID do pedido que foi feito para iniciar a assinatura. |
Obter detalhes do cliente (preterido) [PRETERIDO]
Obtém um recurso cliente que corresponde a uma ID do cliente (preterida).
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do locatário do cliente
|
CustomerTenantID | True | string |
Uma ID de locatário do cliente |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
id | string |
A ID do cliente. |
|
A ID do comércio.
|
commerceId | string |
A ID do comércio. |
|
ID do locatário
|
companyProfile.tenantId | string |
O identificador de locatário do cliente para a ID do Microsoft Entra. Isso também é chamado de MicrosoftID. |
|
Nome da Empresa (Perfil da Empresa).
|
companyProfile.companyName | string |
O nome da empresa ou organização. |
|
Domínio
|
companyProfile.domain | string |
O nome do cliente, como contoso.onmicrosoft.com. |
|
País (Perfil da Empresa)
|
companyProfile.address.country | string |
O país. |
|
Região (Perfil da Empresa).
|
companyProfile.address.region | string |
A região. |
|
Cidade (Perfil da Empresa)
|
companyProfile.address.city | string |
A cidade. |
|
Estado (Perfil da Empresa)
|
companyProfile.address.state | string |
O estado. |
|
Linha de Endereço1 (Perfil da Empresa)
|
companyProfile.address.addressLine1 | string |
A primeira linha do endereço. |
|
Cep (Perfil da Empresa)
|
companyProfile.address.postalCode | string |
O CEP ou código postal. |
|
Número de Telefone (Perfil da Empresa)
|
companyProfile.address.phoneNumber | string |
O número de telefone de um contato na empresa/organização do cliente. |
|
Email (Perfil da Empresa)
|
companyProfile.email | string |
Email. |
|
ID do perfil
|
billingProfile.id | string |
O identificador de perfil. |
|
Nome (Perfil de Cobrança)
|
billingProfile.firstName | string |
O primeiro nome do contato de cobrança na empresa do cliente. |
|
Sobrenome (Perfil de Cobrança)
|
billingProfile.lastName | string |
O sobrenome do contato de cobrança. |
|
Email (Perfil de Cobrança)
|
billingProfile.email | string |
O endereço de email do contato de cobrança |
|
Cultura (Perfil de Cobrança)
|
billingProfile.culture | string |
Sua cultura preferida para comunicação e moeda, como "en-us". |
|
Idioma (Perfil de Cobrança)
|
billingProfile.language | string |
Seu idioma preferido para comunicação. |
|
Nome da empresa (perfil de cobrança)
|
billingProfile.companyName | string |
O nome da empresa ou organização. |
|
País (Perfil de Cobrança)
|
billingProfile.defaultAddress.country | string |
O país/região no formato de código de país ISO. |
|
Região (Perfil de Cobrança)
|
billingProfile.defaultAddress.region | string |
A região. |
|
Cidade (Perfil de Cobrança)
|
billingProfile.defaultAddress.city | string |
A cidade. |
|
Estado (Perfil de Cobrança)
|
billingProfile.defaultAddress.state | string |
O estado. |
|
AddressLine1 (Perfil de Cobrança)
|
billingProfile.defaultAddress.addressLine1 | string |
A primeira linha do endereço. |
|
Cep (perfil de cobrança)
|
billingProfile.defaultAddress.postalCode | string |
O CEP ou código postal. |
|
Nome (Perfil de Cobrança)
|
billingProfile.defaultAddress.firstName | string |
O nome de um contato na empresa/organização do cliente. |
|
Sobrenome (Perfil de Cobrança)
|
billingProfile.defaultAddress.lastName | string |
O sobrenome de um contato na empresa/organização do cliente. |
|
Número de Telefone (Perfil de Cobrança)
|
billingProfile.defaultAddress.phoneNumber | string |
O número de telefone de um contato na empresa/organização do cliente. |
|
Relação com parceiro
|
relationshipToPartner | string |
Define o programa de licenciamento que o parceiro usa para esse cliente: "none", "reseller", "advisor", "syndication" ou "microsoft_support". |
|
Permitir acesso delegado
|
allowDelegatedAccess | boolean |
Indica se o parceiro recebeu privilégios de administrador delegado por esse cliente. |
|
Domínios personalizados
|
customDomains | array of string |
Lista de domínios personalizados de um cliente. |
Obter faturas (preteridas) [PRETERIDAS]
Obter uma coleção de faturas (preterida).
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Tamanho
|
Size | integer |
O número de recursos de fatura a serem retornados na resposta. Esse parâmetro é opcional. |
|
|
Deslocamento
|
Offset | string |
O índice baseado em zero da primeira fatura a ser retornada. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Contagem total
|
totalCount | integer |
Contagem total de elementos na coleção. |
|
items
|
items | array of object |
items |
|
ID
|
items.id | string |
O identificador da fatura. |
|
Data da fatura
|
items.invoiceDate | string |
A data em que a fatura foi gerada. |
|
Data de início do período de cobrança
|
items.billingPeriodStartDate | string |
Data de início do período de cobrança em UTC. |
|
Data de término do período de cobrança
|
items.billingPeriodEndDate | string |
Data de término do período de cobrança em UTC. |
|
Total de encargos
|
items.totalCharges | float |
O total de encargos. Inclui encargos para transações e quaisquer ajustes. |
|
Valor pago
|
items.paidAmount | float |
O valor pago pelo parceiro. Negativo se um pagamento foi recebido. |
|
Código de moeda
|
items.currencyCode | string |
Um código que indica a moeda usada para todos os valores e totais de itens da fatura. |
|
Símbolo de moeda
|
items.currencySymbol | string |
O símbolo de moeda usado para todos os valores e totais do item da fatura. |
|
PDF Download Link
|
items.pdfDownloadLink | string |
Um link para baixar a fatura no formato PDF. Esse link não é retornado como parte dos resultados da pesquisa e é preenchido somente se a fatura for acessada pela ID. Esse link expira automaticamente em 30 minutos. |
|
invoiceDetails
|
items.invoiceDetails | array of object |
Os detalhes da fatura. |
|
Tipo de item de linha de fatura
|
items.invoiceDetails.invoiceLineItemType | string |
O tipo de detalhe da fatura: "none", "usage_line_items", "billing_line_items". |
|
Provedor de cobrança
|
items.invoiceDetails.billingProvider | string |
O provedor de cobrança: "none", "office", "azure" ou "azure_data_market". |
|
Tipo de documento
|
items.documentType | string |
O tipo de documento da fatura: "Nota de Crédito", "Fatura". |
|
Tipo de fatura
|
items.invoiceType | string |
O tipo de fatura: "recorrente", "one_time". |
Obter pedidos de clientes (preteridos) [PRETERIDO]
Obtém uma coleção de todos os pedidos de um cliente especificado (preterido).
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do locatário do cliente
|
CustomerTenantID | True | string |
Uma ID de locatário do cliente. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Contagem total
|
totalCount | integer |
Contagem total de pedidos de clientes. |
|
items
|
items | array of object |
items |
|
ID
|
items.id | string |
Um identificador de pedido. |
|
ID alternativa
|
items.alternateId | string |
Um identificador amigável para a ordem. |
|
ID do cliente
|
items.referenceCustomerId | string |
O identificador do cliente. |
|
Ciclo de cobrança
|
items.billingCycle | string |
Indica a frequência com que o parceiro é cobrado por essa ordem. |
|
Código de moeda
|
items.currencyCode | string |
A moeda usada ao fazer o pedido. |
|
Símbolo de moeda
|
items.currencySymbol | string |
O símbolo de moeda associado ao código de moeda. |
|
lineItems
|
items.lineItems | array of object |
lineItems |
|
lineItemNumber
|
items.lineItems.lineItemNumber | integer |
Número do item de linha. |
|
ID da oferta
|
items.lineItems.offerId | string |
O ID da oferta. |
|
ID da assinatura
|
items.lineItems.subscriptionId | string |
A ID da assinatura. |
|
Duração do termo
|
items.lineItems.termDuration | string |
Uma representação ISO 8601 da duração do termo. |
|
ID da promoção
|
items.lineItems.promotionId | string |
ID da promoção. |
|
Data de término do termo personalizado
|
items.lineItems.customTermEndDate | string |
A data de término do primeiro período de cobrança da nova assinatura. |
|
Tipo de Transação
|
items.lineItems.transactionType | string |
O tipo de transação do item de linha. |
|
Nome amigável
|
items.lineItems.friendlyName | string |
O nome amigável da assinatura definida pelo parceiro para ajudar a desambiguar. |
|
quantidade
|
items.lineItems.quantity | integer |
Quantidade |
|
Data de Criação
|
items.creationDate | string |
A data em que o pedido foi criado, no formato de data e hora. |
|
Situação
|
items.status | string |
O status da ordem. |
|
Tipo de Transação
|
items.transactionType | string |
O tipo de transação da ordem. Os valores com suporte são 'UserPurchase', 'SystemPurchase' ou 'SystemBilling' |
Obter todos os clientes (preterido) [PRETERIDO]
Obter uma lista de clientes (preterido).
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Tamanho
|
Size | string |
O número de resultados a serem exibidos ao mesmo tempo. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Contagem total
|
totalCount | integer |
Contagem total de elementos na coleção |
|
items
|
items | array of object |
items |
|
ID
|
items.id | string |
A ID do cliente. |
|
ID do locatário
|
items.companyProfile.tenantId | string |
O identificador de locatário do cliente para a ID do Microsoft Entra. Isso também é chamado de MicrosoftID. |
|
Domínio
|
items.companyProfile.domain | string |
O nome do cliente, como contoso.onmicrosoft.com. |
|
Nome da Empresa
|
items.companyProfile.companyName | string |
O nome da empresa ou organização. |
|
Relação com parceiro
|
items.relationshipToPartner | string |
Define o programa de licenciamento que o parceiro usa para esse cliente: "none", "reseller", "advisor", "syndication" ou "microsoft_support". |