Obtención de una hoja de precios

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 describen en Autenticación de la API para partners. Este escenario solo admite la autenticación de usuario de la aplicación. La opción de solo aplicación aún no es compatible. 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

• Actualmente solo se devuelven datos del consumo y las reservas del plan de Azure, de los productos basados en licencias (nueva experiencia de comercio) y de los productos de Microsoft 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 para partners están disponibles a través del crédito obtenido por socios.
• 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 para asociados y las API de tipos de cambio no forman parte del Partner Center SDK.
• 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

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.

Parámetros de filtro de URI

Use los siguientes parámetros de filtro.

Obtener los precios de la versión preliminar de los productos basados en licencias

Utilice el parámetro de filtro timeline=future para obtener la lista de precios basada en licencias correspondiente al próximo mes antes de que entre en vigor. Esto permite a los partners obtener una vista previa de los cambios de precios con antelación y planear en consecuencia.

En el ejemplo siguiente se recupera la hoja de precios futura para el mercado estadounidense:

GET https://api.partner.microsoft.com/v1.0/sales/pricesheets(Market='US',PricesheetView='updatedlicensebased')/$value?timeline=future HTTP/1.1
Authorization: Bearer
Host: api.partner.microsoft.com

Si no se espera ningún cambio de precios para el próximo mes, la API devuelve una respuesta 404 No encontrada. Esto indica que no hay ninguna hoja de precios futura disponible porque no se prevé ningún cambio.

Encabezados de solicitud

• Para obtener más información, consulte cabeceras 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.

Ejemplo de solicitud

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

Ejemplo de solicitud para el nuevo comercio

GET https://api.partner.microsoft.com/v1.0/sales/pricesheets(Market='US',PricesheetView='updatedlicensebased')/$value?timeline=history&month=202505 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

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 respuesta de éxito y de error

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.

Contenido relacionado

• Obtención de una matriz de ofertas