Tipos de cambio
Obtener tasas de cambio
Consulta la tasa de cambio diaria oficial de Yuno, la misma referencia que Yuno usa en sus propios reportes, para que tus precios y tu conciliación coincidan con los nuestros.
GET
Obtener tipos de cambio
Los comercios que venden a través de fronteras necesitan una única tasa de referencia para fijar precios en una moneda y conciliar en otra. Este endpoint devuelve la tasa de cambio diaria oficial de Yuno, la misma referencia que Yuno usa en sus propios reportes, expresada como unidades de la moneda por 1 USD.
Se publican alrededor de 161 monedas por día.
Tres reglas se cumplen en toda respuesta:
USD se publica con una tasa de 1.
Habilitado por organizaciónEsta API requiere activación para tu organización. Contacta a tu Key Account Manager (KAM) para habilitarla.
Qué es y qué no es
Esta es una tasa de referencia, publicada una vez por día para un día cerrado. Yuno no se compromete a procesar ni liquidar a esta tasa.- Es de solo lectura: sin cotizaciones, sin bloqueo de tasa, sin conversión aplicada a un pago.
- No es una tasa en vivo ni intradía. El valor de un día es final una vez que se cierra la carga diaria.
- Para convertir una transacción real en el checkout, usa Conversion Rate. Es un producto distinto: una cotización de un proveedor para una transacción.
Elegir qué solicitas
Todos los parámetros son opcionales, y la forma de la respuesta depende de lo que envíes:end_date es el único parámetro con un complemento: no se puede usar sin start_date. Todo lo demás funciona por sí solo.
Límites del rango: hasta 31 días cuando se omite currency, y hasta 366 días cuando solicitas una sola moneda.
El último día disponible
Sin fechas, obtienes el día publicado más reciente en lugar de una fecha que tengas que calcular. El día actual nunca se entrega, porque su valor no es final hasta que se cierra la carga diaria, así que el día más nuevo que puedes recibir es ayer (UTC). Si una carga diaria se retrasa, esta también es la forma segura de consultar: recibes el día más nuevo que realmente existe en lugar de una respuesta vacía para un día que nunca se publicó.Cómo leer la respuesta
- Ordenada por
fx_datey luego porcurrency. - Un valor por moneda por día. Cuando existe más de una fuente para un día, el desempate ocurre dentro de Yuno y no forma parte de este contrato.
- Lo que no existe simplemente está ausente. Un día o una moneda sin tasa publicada no aparece en
rates, y un rango sin nada publicado devuelve200con un arreglo vacío, no un error. Trata unratesvacío como “no hay nada publicado para lo que pediste”, nunca como una falla.
Códigos de moneda
Los códigos son en su mayoría ISO 4217, pero el conjunto publicado también incluye códigos que no son monedas fiduciarias, comoBTC, XAU (oro) y XAG (plata). Un código bien formado que Yuno no publica no es un error: se devuelve como un arreglo rates vacío.
Almacenamiento en caché
Un día publicado nunca cambia, por lo que una respuesta de un día pasado se puede almacenar en caché indefinidamente. Consultar sin fechas es la única solicitud cuya respuesta cambia, una vez por día.Errores
Los errores devuelven uncode y un arreglo messages. El mensaje nombra el parámetro con el problema.