Compartir a través de

Obtención de una matriz de ofertas

  • Artículo

En este artículo se explica cómo obtener una matriz de ofertas durante un mes determinado. La matriz de ofertas incluye propiedades y reglas de compra para los productos y sku. Este método admite filtros para obtener el historial por mes.

Requisitos previos

  • Credenciales tal como se describe en el artículo Autenticación de la API de partners. Este escenario solo es compatible con la autenticación de usuario y aplicación. Todavía no se admite la autenticación solo de aplicación. Los asociados que experimentan un error http:400 deben consultar la documentación de autenticación de la API de partners.
  • Actualmente, esta API solo admite el acceso de usuario en el que los asociados deben estar en uno de los roles siguientes: Agente de administración o Agente de ventas.

Detalles

  • Current devuelve datos solo para los nuevos productos basados en licencias comerciales actualizados.
  • Los precios actuales incluyen productos disponibles durante el mes actual hasta la fecha en que se llama a la API. Los meses anteriores incluyen la fecha a partir del último día del mes seleccionado.
  • Este método devuelve datos como una secuencia de archivos. La secuencia de archivos es un archivo .csv o una versión comprimida zip del .csv. A continuación se muestran los detalles sobre cómo solicitar archivos comprimidos.

Solicitud REST

Sintaxis de la solicitud

Método URI de solicitud
GET https://api.partner.microsoft.com/v1.0/sales/offermatrix(Month='{date}')/$value

Parámetros de filtro de URI

Use los siguientes parámetros de filtro.

Nombre Type Obligatorio Descripción
Mes string No Debe cumplir con YYYYYMM para la hoja de precios que se solicita.

Encabezados de solicitud

Además de estos encabezados, los archivos de precios se pueden recuperar como comprimidos reduciendo el ancho de banda y los tiempos de descarga. De forma predeterminada, los archivos no están comprimidos. Para obtener versiones comprimidas de los archivos, puede incluir el siguiente valor de encabezado. Tenga en cuenta que las hojas comprimidas solo están disponibles a partir de abril de 2020, todas las hojas anteriores a abril de 2020 solo están disponibles como no comprimidas.

Encabezado Tipo de valor Valor Descripción
Accept-Encoding string deflate Opcional. Si se omite, la secuencia de archivos no se comprime.

Ejemplo de solicitud

GET https://api.partner.microsoft.com/v1.0/sales/offermatrix(Month='202101')/$value HTTP/1.1
Authorization: Bearer
Accept-Encoding: deflate
Host: api.partner.microsoft.com

Respuesta REST

Si se ejecuta correctamente, este método devuelve una matriz de ofertas como una secuencia de archivos. La secuencia de archivos es un archivo .csv o una versión comprimida zip del .csv.

Códigos de error y de respuesta correctos

Cada respuesta incluye un código de estado HTTP que indica si la operación se ha realizado correctamente o con errores y proporciona información de depuración adicional. Use una herramienta de seguimiento de red para leer este código, el tipo de error y los parámetros adicionales. Para obtener la lista completa, consulte Códigos de error.

Ejemplo de respuesta

HTTP/1.1 200 OK
Cache-Control: private
Content-Length: 42180180
Content-Type: application/octet-stream
Content-Disposition: attachment; filename=updatedoffice.csv
Request-ID: 9f8bed52-e4df-4d0c-9ca6-929a187b0731
Date: Wed, 02 Feb 2021 03:41:20 GMT

"ProductTitle","ProductId","SkuId","SkuTitle","ProvisioningId","ProvisioningString","MinLicenses","MaxLicenses","AssetOwnershipLimit","AssetOwnershipLimitType","ProductSkuPreRequisites","ProductSkuConversion","Description","AllowedCountries" 
"Microsoft 365 Business Basic","CFQ7TTC0LH18","0001","Microsoft 365 Business Basic","3b555118-da6a-4418-894f-7df1e2096870","O365_BUSINESS_ESSENTIALS","1","300","2","ConcurrentCount","","CFQ7TTC0LDPB/0001,CFQ7TTC0LF8Q/0001","Best for businesses that need professional...","AD;AE;AF;AG;AI;AL;AM;AO..."
======= Truncated ==============

Contenido relacionado