Centro de partners de Microsoft [EN DESUSO]
Este conector le permite conectarse a la API de MPC y recopilar información, incluidos los detalles del cliente, los pedidos y las suscripciones.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Estándar | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Estándar | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Estándar | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Microsoft |
| URL | https://support.microsoft.com |
| Metadatos del conector | |
|---|---|
| Publicador | Microsoft |
| Website | https://docs.microsoft.com/en-us/partner-center/develop/ |
| Directiva de privacidad | https://privacy.microsoft.com/en-us/privacystatement |
| Categorías | Operaciones de TI; Gestión empresarial |
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Predeterminado | Parámetros para crear una conexión. | Todas las regiones | No se puede compartir |
Predeterminado
Aplicable: Todas las regiones
Parámetros para crear una conexión.
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Obtener detalles del cliente (en desuso) [EN DESUSO] |
Obtiene un recurso customer que corresponde a un identificador de cliente (en desuso). |
| Obtener facturas (en desuso) [EN DESUSO] |
Obtener una colección de facturas (en desuso). |
| Obtener pedidos de clientes (en desuso) [EN DESUSO] |
Obtiene una colección de todos los pedidos de un cliente especificado (en desuso). |
| Obtener suscripciones de cliente (en desuso) [EN DESUSO] |
Obtiene una colección de todas las suscripciones de un cliente especificado (en desuso). |
| Obtener todos los clientes (en desuso) [EN DESUSO] |
Obtenga una lista de clientes (en desuso). |
Obtener detalles del cliente (en desuso) [EN DESUSO]
Obtiene un recurso customer que corresponde a un identificador de cliente (en desuso).
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de inquilino del cliente
|
CustomerTenantID | True | string |
Un identificador de inquilino de cliente |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
identificación
|
id | string |
Identificador del cliente. |
|
Identificador de comercio.
|
commerceId | string |
Identificador de comercio. |
|
Id. de inquilino
|
companyProfile.tenantId | string |
Identificador de inquilino del cliente para el identificador de Microsoft Entra. Esto también se denomina MicrosoftID. |
|
Nombre de la compañía (perfil de empresa).
|
companyProfile.companyName | string |
Nombre de la empresa u organización. |
|
Dominio
|
companyProfile.domain | string |
Nombre del cliente, como contoso.onmicrosoft.com. |
|
País (perfil de empresa)
|
companyProfile.address.country | string |
El país. |
|
Región (perfil de empresa).
|
companyProfile.address.region | string |
La región. |
|
Ciudad (perfil de empresa)
|
companyProfile.address.city | string |
La ciudad. |
|
Estado (perfil de empresa)
|
companyProfile.address.state | string |
El estado. |
|
Línea de dirección1 (perfil de empresa)
|
companyProfile.address.addressLine1 | string |
Primera línea de la dirección. |
|
Código postal (perfil de empresa)
|
companyProfile.address.postalCode | string |
El código postal o el código postal. |
|
Número de teléfono (perfil de empresa)
|
companyProfile.address.phoneNumber | string |
Número de teléfono de un contacto en la empresa o organización del cliente. |
|
Correo electrónico (perfil de empresa)
|
companyProfile.email | string |
Correo electrónico. |
|
Id. de perfil
|
billingProfile.id | string |
Identificador del perfil. |
|
Nombre (perfil de facturación)
|
billingProfile.firstName | string |
Nombre del contacto de facturación en la empresa del cliente. |
|
Apellidos (perfil de facturación)
|
billingProfile.lastName | string |
Apellido del contacto de facturación. |
|
Correo electrónico (perfil de facturación)
|
billingProfile.email | string |
Dirección de correo electrónico del contacto de facturación |
|
Referencia cultural (perfil de facturación)
|
billingProfile.culture | string |
Su cultura preferida para la comunicación y moneda, como "en-us". |
|
Idioma (perfil de facturación)
|
billingProfile.language | string |
Su idioma preferido para la comunicación. |
|
Nombre de la empresa (perfil de facturación)
|
billingProfile.companyName | string |
Nombre de la empresa u organización. |
|
País (perfil de facturación)
|
billingProfile.defaultAddress.country | string |
País o región en formato de código de país ISO. |
|
Región (perfil de facturación)
|
billingProfile.defaultAddress.region | string |
La región. |
|
Ciudad (perfil de facturación)
|
billingProfile.defaultAddress.city | string |
La ciudad. |
|
Estado (perfil de facturación)
|
billingProfile.defaultAddress.state | string |
El estado. |
|
AddressLine1 (perfil de facturación)
|
billingProfile.defaultAddress.addressLine1 | string |
Primera línea de la dirección. |
|
Código postal (perfil de facturación)
|
billingProfile.defaultAddress.postalCode | string |
El código postal o el código postal. |
|
Nombre (perfil de facturación)
|
billingProfile.defaultAddress.firstName | string |
Nombre de un contacto en la empresa o organización del cliente. |
|
Apellidos (perfil de facturación)
|
billingProfile.defaultAddress.lastName | string |
Apellido de un contacto en la empresa o organización del cliente. |
|
Número de teléfono (perfil de facturación)
|
billingProfile.defaultAddress.phoneNumber | string |
Número de teléfono de un contacto en la empresa o organización del cliente. |
|
Relación con el asociado
|
relationshipToPartner | string |
Define el programa de licencias que el asociado usa para este cliente: "none", "reseller", "advisor", "syndication" o "microsoft_support". |
|
Permitir el acceso delegado
|
allowDelegatedAccess | boolean |
Indica si este cliente ha concedido privilegios de administrador delegado al asociado. |
|
Dominios personalizados
|
customDomains | array of string |
Lista de dominios personalizados de un cliente. |
Obtener facturas (en desuso) [EN DESUSO]
Obtener una colección de facturas (en desuso).
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Tamaño
|
Size | integer |
El número de recursos de factura que se van a devolver en la respuesta. Este parámetro es opcional. |
|
|
Desplazar
|
Offset | string |
El índice de base cero de la primera factura que se devuelve. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Recuento total
|
totalCount | integer |
Recuento total de elementos de la colección. |
|
items
|
items | array of object |
items |
|
identificación
|
items.id | string |
Identificador de factura. |
|
Fecha de factura
|
items.invoiceDate | string |
Fecha en que se generó la factura. |
|
Fecha inicial del periodo de facturación
|
items.billingPeriodStartDate | string |
Fecha de inicio del período de facturación en UTC. |
|
Fecha final del periodo de facturación
|
items.billingPeriodEndDate | string |
Fecha de finalización del período de facturación en UTC. |
|
Total de cargos
|
items.totalCharges | float |
El total de cargos. Incluye cargos por transacciones y cualquier ajuste. |
|
Importe pagado
|
items.paidAmount | float |
Importe pagado por el socio. Negativo si se recibió un pago. |
|
Código de moneda
|
items.currencyCode | string |
Código que indica la moneda utilizada para todos los importes y totales de los artículos de factura. |
|
Símbolo de la moneda
|
items.currencySymbol | string |
Símbolo de moneda utilizado para todos los importes y totales de los artículos de factura. |
|
Vínculo de descarga de PDF
|
items.pdfDownloadLink | string |
Vínculo para descargar la factura en formato PDF. Este vínculo no se devuelve como parte de los resultados de la búsqueda y solo se rellena si el identificador accede a la factura. Este vínculo expira automáticamente en 30 minutos. |
|
invoiceDetails
|
items.invoiceDetails | array of object |
Detalles de la factura. |
|
Tipo de elemento de línea de factura
|
items.invoiceDetails.invoiceLineItemType | string |
Tipo de detalle de factura: "none", "usage_line_items", "billing_line_items". |
|
Proveedor de facturación
|
items.invoiceDetails.billingProvider | string |
El proveedor de facturación: "none", "office", "azure" o "azure_data_market". |
|
Tipo de documento
|
items.documentType | string |
Tipo de documento de la factura: "Nota de crédito", "Factura". |
|
Tipo de factura
|
items.invoiceType | string |
Tipo de factura: "periódica", "one_time". |
Obtener pedidos de clientes (en desuso) [EN DESUSO]
Obtiene una colección de todos los pedidos de un cliente especificado (en desuso).
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de inquilino del cliente
|
CustomerTenantID | True | string |
Identificador de inquilino del cliente. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Recuento total
|
totalCount | integer |
Recuento total de pedidos de clientes. |
|
items
|
items | array of object |
items |
|
identificación
|
items.id | string |
Identificador de pedido. |
|
Identificador alternativo
|
items.alternateId | string |
Identificador descriptivo para el pedido. |
|
Id. de cliente
|
items.referenceCustomerId | string |
Identificador del cliente. |
|
Ciclo de facturación
|
items.billingCycle | string |
Indica la frecuencia con la que se factura al asociado para este pedido. |
|
Código de moneda
|
items.currencyCode | string |
Moneda utilizada al realizar el pedido. |
|
Símbolo de la moneda
|
items.currencySymbol | string |
Símbolo de moneda asociado al código de moneda. |
|
lineItems
|
items.lineItems | array of object |
lineItems |
|
lineItemNumber
|
items.lineItems.lineItemNumber | integer |
Número de elemento de línea. |
|
Id. de oferta
|
items.lineItems.offerId | string |
Identificador de la oferta. |
|
Id. de suscripción
|
items.lineItems.subscriptionId | string |
Identificador de la suscripción. |
|
Duración del término
|
items.lineItems.termDuration | string |
Representación ISO 8601 de la duración del término. |
|
Id. de promoción
|
items.lineItems.promotionId | string |
Id. de promoción. |
|
Fecha de finalización del término personalizado
|
items.lineItems.customTermEndDate | string |
Fecha de finalización del primer período de facturación de la nueva suscripción. |
|
Tipo de transacción
|
items.lineItems.transactionType | string |
Tipo de transacción del elemento de línea. |
|
Nombre amigable
|
items.lineItems.friendlyName | string |
Nombre descriptivo de la suscripción definida por el asociado para ayudar a desambiguar. |
|
quantity
|
items.lineItems.quantity | integer |
Cantidad |
|
Fecha de creación
|
items.creationDate | string |
Fecha en que se creó el pedido, en formato de fecha y hora. |
|
Estado
|
items.status | string |
Estado del pedido. |
|
Tipo de transacción
|
items.transactionType | string |
Tipo de transacción del pedido. Los valores admitidos son "UserPurchase", "SystemPurchase" o "SystemBilling". |
Obtener suscripciones de cliente (en desuso) [EN DESUSO]
Obtiene una colección de todas las suscripciones de un cliente especificado (en desuso).
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de inquilino del cliente
|
CustomerTenantID | True | string |
Identificador de inquilino de un cliente. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Recuento total
|
totalCount | integer |
Recuento total de suscripciones para el cliente. |
|
items
|
items | array of object |
items |
|
identificación
|
items.id | string |
Identificador de la suscripción. |
|
Id. de oferta
|
items.offerId | string |
Identificador de la oferta. |
|
Nombre de la oferta
|
items.offerName | string |
Nombre de la oferta. |
|
Nombre amigable
|
items.friendlyName | string |
Nombre descriptivo de la suscripción definida por el asociado para ayudar a desambiguar. |
|
identificación
|
items.productType.id | string |
Identificador de la suscripción. |
|
Nombre de pantalla
|
items.productType.displayName | string |
Nombre para mostrar. |
|
Cantidad
|
items.quantity | integer |
Proporciona la cantidad de suscripción después del aprovisionamiento. |
|
Tipo de unidad
|
items.unitType | string |
Unidades que definen la cantidad de la suscripción. |
|
Tiene complementos purchasables
|
items.hasPurchasableAddons | boolean |
Valor que indica si la suscripción tiene complementos que se pueden purgar. |
|
Fecha de creación
|
items.creationDate | string |
Fecha de creación, en formato de fecha y hora. |
|
Fecha de inicio efectiva
|
items.effectiveStartDate | string |
Fecha de inicio efectiva para esta suscripción, en formato de fecha y hora. |
|
Fecha de finalización del compromiso
|
items.commitmentEndDate | string |
Fecha de finalización del compromiso para esta suscripción, en formato de fecha y hora. |
|
Cancelación permitida hasta la fecha
|
items.cancellationAllowedUntilDate | string |
La última fecha de cancelación. |
|
Fecha de finalización del ciclo de facturación
|
items.billingCycleEndDate | string |
Fecha de finalización del ciclo de facturación para esta suscripción, en formato de fecha y hora. |
|
Estado
|
items.status | string |
Indica el estado de aprovisionamiento: "correcto", "pendiente" o "error". |
|
Renovación automática habilitada
|
items.autoRenewEnabled | boolean |
autoRenewEnabled |
|
Is Trial
|
items.isTrial | boolean |
Valor que indica si la suscripción es una prueba. |
|
Tipo de facturación
|
items.billingType | string |
Especifica cómo se factura la suscripción: "none", "usage" o "license". |
|
Ciclo de facturación
|
items.billingCycle | string |
Indica la frecuencia con la que se factura al asociado para este pedido. |
|
Duración del término
|
items.termDuration | string |
Representación ISO 8601 de la duración del término. |
|
Duración del período de renovación
|
items.renewalTermDuration | string |
Representación ISO 8601 de la duración del término. |
|
¿Es el producto de Microsoft?
|
items.isMicrosoftProduct | boolean |
Valor que indica si la suscripción es un producto de Microsoft. |
|
Partner ID
|
items.partnerId | string |
Identificador de MPN del revendedor de registro, que se usa en el modelo de asociado indirecto. |
|
Atención necesaria
|
items.attentionNeeded | boolean |
Es necesario prestar atención. |
|
Tipo de contrato
|
items.contractType | string |
Tipo de contrato: "subscription", "productKey" o "redemptionCode". |
|
Nombre del publicador
|
items.publisherName | string |
Nombre del publicador. |
|
Id. de promoción
|
items.promotionId | string |
Identificador de promoción si se aplica a la suscripción. |
|
Id. de pedido
|
items.orderId | string |
Identificador del pedido que se realizó para iniciar la suscripción. |
Obtener todos los clientes (en desuso) [EN DESUSO]
Obtenga una lista de clientes (en desuso).
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Tamaño
|
Size | string |
Número de resultados que se van a mostrar al mismo tiempo. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Recuento total
|
totalCount | integer |
Recuento total de elementos de la colección |
|
items
|
items | array of object |
items |
|
identificación
|
items.id | string |
Identificador del cliente. |
|
Id. de inquilino
|
items.companyProfile.tenantId | string |
Identificador de inquilino del cliente para el identificador de Microsoft Entra. Esto también se denomina MicrosoftID. |
|
Dominio
|
items.companyProfile.domain | string |
Nombre del cliente, como contoso.onmicrosoft.com. |
|
Nombre de la compañía
|
items.companyProfile.companyName | string |
Nombre de la empresa u organización. |
|
Relación con el asociado
|
items.relationshipToPartner | string |
Define el programa de licencias que el asociado usa para este cliente: "none", "reseller", "advisor", "syndication" o "microsoft_support". |