Microsoft Partner Center [PRETERIDO]
Esse conector permite que você se conecte à API MPC e colete algumas informações, incluindo detalhes do cliente, pedidos e assinaturas.
Este conector está disponível nos seguintes produtos e regiões:
| Serviço | Class | Regiões |
|---|---|---|
| Estúdio Copiloto | Standard | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicações Lógicas | Standard | Todas as regiões do Logic Apps , exceto as seguintes: - Regiões do Azure Government - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Aplicações Power | Standard | Todas as regiões do Power Apps , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Automatize o poder | Standard | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - 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 | |
|---|---|
| Editora | Microsoft |
| Sítio Web | 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 Empresarial |
A criar uma ligação
O conector suporta os seguintes tipos de autenticação:
| Predefinição | 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.
Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
Limites de Limitação
| Name | Chamadas | Período de Renovação |
|---|---|---|
| Chamadas de API por conexão | 100 | 60 segundos |
Ações
| Obter detalhes do cliente (preterido) [PRETERIDO] |
Obtém um recurso do Cliente que corresponde a um ID do cliente (preterido). |
| Obter faturas (preteridas) [PRETERIDO] |
Obter uma coleção de faturas (preterido). |
| Obter pedidos de clientes (preterido) [PRETERIDO] |
Obtém uma coleção de todos os pedidos de um cliente especificado (preterido). |
| Obter subscrições de clientes (preteridas) [PRETERIDO] |
Obtém uma coleção de todas as assinaturas de um cliente especificado (preterido). |
| Obter todos os clientes (preterido) [PRETERIDO] |
Obtenha uma lista de clientes (preterida). |
Obter detalhes do cliente (preterido) [PRETERIDO]
Obtém um recurso do Cliente que corresponde a um ID do cliente (preterido).
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do locatário do cliente
|
CustomerTenantID | True | string |
Um ID de locatário do cliente |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
id | string |
O ID do cliente. |
|
O ID de comércio.
|
commerceId | string |
O ID de comércio. |
|
ID do inquilino
|
companyProfile.tenantId | string |
O identificador de locatário do cliente para o Microsoft Entra ID. 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. |
|
Endereço Line1 (Perfil da Empresa)
|
companyProfile.address.addressLine1 | string |
A primeira linha do endereço. |
|
Código Postal (Perfil da Empresa)
|
companyProfile.address.postalCode | string |
O código postal 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 próprio (Perfil de Faturação)
|
billingProfile.firstName | string |
O primeiro nome do contato de faturamento na empresa do cliente. |
|
Apelido (Perfil de Faturação)
|
billingProfile.lastName | string |
O sobrenome do contato de cobrança. |
|
Email (Perfil de Faturação)
|
billingProfile.email | string |
O endereço de e-mail do contacto de faturação |
|
Cultura (Perfil de Faturação)
|
billingProfile.culture | string |
Sua cultura preferida para comunicação e moeda, como "en-us". |
|
Idioma (Perfil de Faturação)
|
billingProfile.language | string |
A sua língua preferida para a comunicação. |
|
Nome da Empresa (Perfil de Faturação)
|
billingProfile.companyName | string |
O nome da empresa ou organização. |
|
País (Perfil de Faturação)
|
billingProfile.defaultAddress.country | string |
O país/região no formato de código de país ISO. |
|
Região (Perfil de Faturação)
|
billingProfile.defaultAddress.region | string |
A região. |
|
Cidade (Perfil de Faturação)
|
billingProfile.defaultAddress.city | string |
A cidade. |
|
Estado (Perfil de Faturação)
|
billingProfile.defaultAddress.state | string |
O Estado. |
|
AddressLine1 (Perfil de Faturação)
|
billingProfile.defaultAddress.addressLine1 | string |
A primeira linha do endereço. |
|
Código Postal (Perfil de Faturação)
|
billingProfile.defaultAddress.postalCode | string |
O código postal ou código postal. |
|
Nome próprio (Perfil de Faturação)
|
billingProfile.defaultAddress.firstName | string |
O primeiro nome de um contato na empresa/organização do cliente. |
|
Apelido (Perfil de Faturação)
|
billingProfile.defaultAddress.lastName | string |
O sobrenome de um contato na empresa/organização do cliente. |
|
Número de telefone (perfil de faturação)
|
billingProfile.defaultAddress.phoneNumber | string |
O número de telefone de um contato na empresa/organização do cliente. |
|
Relação com o parceiro
|
relationshipToPartner | string |
Define o programa de licenciamento que o parceiro usa para este cliente: "nenhum", "revendedor", "consultor", "distribuição" ou "microsoft_support". |
|
Permitir acesso delegado
|
allowDelegatedAccess | boolean |
Indica se o parceiro recebeu privilégios de administrador delegado desse cliente. |
|
Domínios personalizados
|
customDomains | array of string |
Lista de domínios personalizados de um cliente. |
Obter faturas (preteridas) [PRETERIDO]
Obter uma coleção de faturas (preterido).
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Tamanho
|
Size | integer |
O número de recursos de fatura a serem retornados na resposta. Este parâmetro é opcional. |
|
|
Compensação
|
Offset | string |
O índice baseado em zero da primeira fatura a ser devolvida. |
Devoluções
| Name | 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 Faturação
|
items.billingPeriodStartDate | string |
Data de início do período de faturação em UTC. |
|
Data de Fim do Período de Faturação
|
items.billingPeriodEndDate | string |
Data de término do período de faturamento em UTC. |
|
Total de Encargos
|
items.totalCharges | float |
Os encargos totais. Inclui encargos para transações e quaisquer ajustes. |
|
Valor pago
|
items.paidAmount | float |
O valor pago pelo sócio. 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 da moeda
|
items.currencySymbol | string |
O símbolo de moeda usado para todos os valores e totais de itens da fatura. |
|
PDF Download Link
|
items.pdfDownloadLink | string |
Um link para descarregar a fatura em formato PDF. Esse link não é retornado como parte dos resultados da pesquisa e é preenchido somente se a fatura for acessada por ID. Este link expira automaticamente em 30 minutos. |
|
detalhes da fatura
|
items.invoiceDetails | array of object |
Os detalhes da fatura. |
|
Tipo de item de linha da fatura
|
items.invoiceDetails.invoiceLineItemType | string |
O tipo de detalhe da fatura: "nenhum", "usage_line_items", "billing_line_items". |
|
Fornecedor de Faturação
|
items.invoiceDetails.billingProvider | string |
O fornecedor de faturação: "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 (preterido) [PRETERIDO]
Obtém uma coleção de todos os pedidos de um cliente especificado (preterido).
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do locatário do cliente
|
CustomerTenantID | True | string |
Um ID de locatário do cliente. |
Devoluções
| Name | 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 ordem. |
|
ID alternativo
|
items.alternateId | string |
Um identificador amigável para o pedido. |
|
ID do Cliente
|
items.referenceCustomerId | string |
O identificador do cliente. |
|
Ciclo de Faturação
|
items.billingCycle | string |
Indica a frequência com que o parceiro é cobrado por este pedido. |
|
Código de Moeda
|
items.currencyCode | string |
A moeda usada ao fazer o pedido. |
|
Símbolo da moeda
|
items.currencySymbol | string |
O símbolo de moeda associado ao código da 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 Identificador da oferta. |
|
ID da subscrição
|
items.lineItems.subscriptionId | string |
O ID da assinatura. |
|
Duração do Prazo
|
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 Fim do Termo Personalizado
|
items.lineItems.customTermEndDate | string |
A data final do primeiro período de cobrança da nova assinatura. |
|
Tipo de Operaçã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 para a assinatura definido pelo parceiro para ajudar a desambiguar. |
|
quantidade
|
items.lineItems.quantity | integer |
Quantidade |
|
Data de criação
|
items.creationDate | string |
A data em que a ordem foi criada, no formato data-hora. |
|
Situação
|
items.status | string |
O estado do pedido. |
|
Tipo de Operação
|
items.transactionType | string |
O tipo de transação da ordem. Os valores suportados são 'UserPurchase', 'SystemPurchase' ou 'SystemBilling' |
Obter subscrições de clientes (preteridas) [PRETERIDO]
Obtém uma coleção de todas as assinaturas de um cliente especificado (preterido).
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do locatário do cliente
|
CustomerTenantID | True | string |
Um ID de locatário do cliente. |
Devoluções
| Name | 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 de 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 para a assinatura definido pelo parceiro para ajudar a desambiguar. |
|
ID
|
items.productType.id | string |
O identificador de assinatura. |
|
Nome de exibição
|
items.productType.displayName | string |
Nome para 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 Addons Comprecíveis
|
items.hasPurchasableAddons | boolean |
Um valor que indica se a assinatura tem complementos que podem ser comprados. |
|
Data de criação
|
items.creationDate | string |
A data de criação, no formato data-hora. |
|
Data de início efetiva
|
items.effectiveStartDate | string |
A data de início efetiva desta assinatura, no formato data-hora. |
|
Data de Fim do Compromisso
|
items.commitmentEndDate | string |
A data de término do compromisso para esta assinatura, no formato de data-hora. |
|
Cancelamento permitido até a data
|
items.cancellationAllowedUntilDate | string |
A última data para cancelamento. |
|
Data de Fim do Ciclo de Faturação
|
items.billingCycleEndDate | string |
A data de término do ciclo de faturamento para esta assinatura, no formato data-hora. |
|
Situação
|
items.status | string |
Indica o status do provisionamento: "sucesso", "pendente" ou "falha". |
|
Renovação automática ativada
|
items.autoRenewEnabled | boolean |
autoRenewEnabled |
|
É julgamento
|
items.isTrial | boolean |
Um valor que indica se a assinatura é uma versão de avaliação. |
|
Tipo de Faturação
|
items.billingType | string |
Especifica como a assinatura é cobrada: "nenhuma", "uso" ou "licença". |
|
Ciclo de Faturação
|
items.billingCycle | string |
Indica a frequência com que o parceiro é cobrado por este pedido. |
|
Duração do Prazo
|
items.termDuration | string |
Uma representação ISO 8601 da duração do termo. |
|
Duração do Prazo de Renovação
|
items.renewalTermDuration | string |
Uma representação ISO 8601 da duração do termo. |
|
É um produto da Microsoft
|
items.isMicrosoftProduct | boolean |
Um valor que indica se a assinatura é um produto da Microsoft. |
|
ID de Parceiro
|
items.partnerId | string |
O ID MPN do revendedor de registro, usado no modelo de parceiro indireto. |
|
Atenção necessária
|
items.attentionNeeded | boolean |
é preciso atenção. |
|
Tipo de Contrato
|
items.contractType | string |
O tipo de contrato: "assinatura", "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 da encomenda
|
items.orderId | string |
A ID do pedido que foi feito para iniciar a assinatura. |
Obter todos os clientes (preterido) [PRETERIDO]
Obtenha uma lista de clientes (preterida).
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Tamanho
|
Size | string |
O número de resultados a serem exibidos ao mesmo tempo. |
Devoluções
| Name | 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 ID do cliente. |
|
ID do inquilino
|
items.companyProfile.tenantId | string |
O identificador de locatário do cliente para o Microsoft Entra ID. 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 o parceiro
|
items.relationshipToPartner | string |
Define o programa de licenciamento que o parceiro usa para este cliente: "nenhum", "revendedor", "consultor", "distribuição" ou "microsoft_support". |