Obtención de una hoja de precios

  • Artículo

En este artículo se explica cómo obtener una hoja de precios para un mercado y una vista concretos. 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 admite la autenticación de usuario de la aplicación. Todavía no se admite la 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 donde los asociados deben estar en uno de los siguientes roles: Global Administración, agente de Administración o Agente de ventas.

Detalles

  • Current devuelve datos solo para el consumo y las reservas del plan de Azure, los productos basados en licencias (nueva experiencia comercial) y Marketplace.
  • Los precios actuales incluyen todos los medidores y productos disponibles durante el mes actual hasta la fecha en que se llama a la API. Los meses anteriores incluyen todos los medidores y productos disponibles para el mes determinado.
  • Los precios de los medidores de consumo solo están en USD, los partners deben usar la API de tipos de cambio de divisas para calcular los costos de moneda local.
  • Los precios del medidor de consumo son precios de venta al por menor estimados. Los descuentos del partner están disponibles a través del crédito obtenido por el partner.
  • Los precios del medidor de reservas incluyen los descuentos del asociado de CSP. Los precios de venta al por menor estimados para las reservas se pueden encontrar en los servicios compartidos de reservas descargables desde la página "Precios y ofertas" del Centro de partners.
  • Puede encontrar más información sobre los precios del plan de Azure en la documentación de precios del plan de Azure.
  • Los precios de los partners y las API de tipo de cambio de divisas no forman parte del SDK del Centro de partners.
  • Este método devuelve la lista de precios como un flujo de archivos. La secuencia de archivos es un archivo .csv o una versión comprimida zip del .csv. A continuación se incluyen 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/pricesheets(Market='{market}',PricesheetView='{view}')/$value

Parámetros necesarios de URI

Use los siguientes parámetros de ruta de acceso para solicitar el mercado y el tipo de hoja de precios que desee.

Nombre Type Obligatorio Descripción
Mercado string Sí Código de país o región de dos letras para el mercado que se solicita
PricesheetView string Sí Tipo de hoja de precios que se solicita, que puede ser azure_consumption, azure_reservations, updatedlicensebased, marketplace o software.

Nota:

updatedlicensebased PriceSheetView solo está disponible actualmente para los partners que forman parte de la nueva experiencia comercial de Microsoft 365/Microsoft Dynamics 365 technical preview.

Nota:

La lista de precios de software estará disponible a través de la API a partir del 1 de abril de 2022.

Parámetros de filtro de URI

Use los siguientes parámetros de filtro.

Nombre Type Obligatorio Descripción
Escala de tiempo string No El valor predeterminado es actual si no se pasa. Los valores posibles son historial, actual y futuro.
Mes string No Solo es necesario si se solicita el historial, debe cumplir con AAAAMM para la hoja de precios que se solicita.

Nota:

Los precios futuros no son compatibles con Marketplace. Desde el 1 de abril de 2022, los partners podrán ver el historial de listas de precios de software a través de la API, a partir del historial de marzo de 2022.

Encabezados de solicitud

  • Para obtener más información, consulte Encabezados REST de asociados.

Además de los encabezados anteriores, 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 valor de encabezado siguiente. 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 no se omite la secuencia de archivos no está comprimida.

Ejemplo de solicitud

GET https://api.partner.microsoft.com/v1.0/sales/pricesheets(Market='ad',PricesheetView='azure_consumption')/$value?timeline=history&month=201909 HTTP/1.1
Authorization: Bearer
Host: api.partner.microsoft.com

Ejemplo de solicitud para el nuevo comercio

Nota:

updatedlicensebased PriceSheetView solo está disponible actualmente para los partners que forman parte de la nueva experiencia comercial de Microsoft 365/Microsoft Dynamics 365 technical preview.

GET https://api.partner.microsoft.com/v1.0/sales/pricesheets(Market='US',PricesheetView='updatedlicensebased')/$value?timeline=history&month=202101 HTTP/1.1
Authorization: Bearer
Accept-Encoding: deflate
Host: api.partner.microsoft.com

Respuesta REST

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

Ejemplo de respuesta para el nuevo comercio

Nota:

updatedlicensebased PriceSheetView solo está disponible actualmente para los partners que forman parte de la nueva experiencia comercial de Microsoft 365/Microsoft Dynamics 365 technical preview.

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

"ProductTitle","ProductId","SkuId","SkuTitle","Publisher","SkuDescription","UnitOfMeasure","TermDuration","BillingPlan","Market","Currency","UnitPrice","PricingTierRangeMin","PricingTierRangeMax","EffectiveStartDate","EffectiveEndDate","Tags","ERP Price"
"Advanced Communications","CFQ7TTC0HDK0","0001","Advanced Communications","Microsoft Corporation","Advanced meetings, calling, workflow integration, and management tools for IT.","","P1Y","Annual","US","USD","115.2","","","2/1/2019 12:00:00 AM","2/4/2021 8:35:31 PM","License","144"
======= Truncated ==============

Códigos de error y de respuesta correctos

Cada respuesta incluye un código de estado HTTP que indica éxito o error y otra información de depuración. Use una herramienta de seguimiento de red para leer este código, tipo de error y otros parámetros. Para obtener la lista completa, consulte Códigos de error.

Si no hay ningún cambio esperado para la nueva lista de precios futuro basada en licencias comerciales, no se devolverá ninguna lista de precios futura. Al pasar el futuro a la escala de tiempo solicitada para el objeto PriceSheetView actualizado, los asociados verán el siguiente código de respuesta de LA API: 404 No encontrado.

Pasos siguientes