Compartir a través de


Obtención de tasas de cambio extranjeras

En este artículo se explica cómo obtener tipos de cambio de divisas durante un mes determinado.

Requisitos previos

  • Credenciales como se describe en Autenticación de API. 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.
  • 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 se usa con get price sheet API para calcular los cargos esperados para las monedas locales de CSP del plan de Azure.
  • Los tipos de cambio de divisas son verdaderos durante todo el mes que se publican.
  • Puede encontrar más información sobre los precios del plan de Azure en la documentación de precios del plan de Azure.
  • Este método devuelve resultados 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 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/fxrates(Month='{month}')/$value

Parámetros necesarios de URI

Use los siguientes parámetros de ruta de acceso para solicitar el mes de los tipos de cambio de divisas que desee.

Nombre Type Obligatorio Descripción
Mes string Debe estar en formato AAAAMM. Si se omite, el valor predeterminado es el mes actual.

Encabezados de solicitud

Además de los encabezados anteriores, los archivos 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 solicitudes 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/fxrates(Month='201909')/$value HTTP/1.1
Authorization: Bearer
Accept-Encoding: deflate
Host: api.partner.microsoft.com

Respuesta REST

Si se ejecuta correctamente, este método devuelve tipos de cambio de divisas 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: 18548
Content-Type: application/octet-stream
Content-Disposition: attachment; filename=fxrates
Request-ID: 65fb6e59-051b-42f7-8771-c8c139b3c901
Date: Wed, 02 Oct 2019 03:42:54 GMT

"CurrencyCode","USDPerUnit","Month"
"AED","0.27224589249009701","2019”
======= Truncated ==============