Cotizaciones contables
Cotización de una moneda respecto de la moneda de la tienda en una fecha, la del libro de dinero; para revaluar cuentas y conciliar.
Cotizaciones contables
Objetos
ExchangeRate
currencystringobligatorioMoneda de la cotización — código ISO 4217 o de activo (USDT): 1 unidad de esta moneda = rate unidades de la moneda de la tienda.
store_currencystringobligatorioMoneda de la tienda, código ISO 4217.
datestringobligatorioFecha contable pedida, AAAA-MM-DD en la zona horaria de la tienda.
ratestring o nullobligatorioCotización contable del día como cadena decimal: 1 currency = rate de la moneda de la tienda — con ella el libro de dinero convierte los movimientos de una cuenta en esta moneda en esta fecha. null — la cotización del día todavía no se fijó (la fija la primera operación en moneda extranjera del día) o ninguna fuente cotiza el par. "1" para la moneda de la tienda.
rate_datestring o nullobligatorioDía en que se fijó la cotización: para una fecha sin cotización propia el libro toma la anterior más cercana; para una fecha previa a la primera fijación, la primera. null — no hay cotización.
sourcestring o nullobligatorioFuente de cotización de mercado de la regla de la tienda: coingecko, criptoya_p2p, ar_oficial, ar_blue, ar_mep, ar_ccl, ar_mayorista, cbr. null — ninguna fuente cotiza el par (la tienda lo acepta solo con cotización manual) o es la moneda de la tienda.
- Valores:
coingeckocriptoya_p2par_oficialar_bluear_mepar_cclar_mayoristacbrnull
Endpoints
Obtener la cotización contable del día de una moneda en una fecha: con ella el libro de dinero convierte los movimientos de las cuentas en moneda extranjera
get/exchange-rates/{currency}
Scope: finance:read
Parámetros
Ruta
currencystringobligatorioCódigo de moneda ISO 4217 o de activo (USDT, USDC) del conjunto de monedas de las cuentas de dinero.
Query
datestring (date)Fecha contable AAAA-MM-DD en la zona horaria de la tienda; por defecto, hoy.
Respuestas
200Éxito
application/json
Devuelve ExchangeRate
401Falta el token, es inválido, venció o fue revocado
Encabezados
WWW-AuthenticatestringobligatorioEsquema de autenticación (RFC 6750).
- Ejemplo:
Bearer
application/problem+json
Devuelve Problem
403El plan, la dirección IP o los scopes del token no permiten la solicitud
Encabezados
WWW-AuthenticatestringEsquema de autenticación (RFC 6750).
- Ejemplo:
Bearer error="insufficient_scope", scope="locations:read"
application/problem+json
Devuelve ForbiddenProblem
404El objeto no existe o no está disponible para la aplicación
application/problem+json
Devuelve Problem
422Un parámetro es inválido o desconocido
application/problem+json
Devuelve ValidationProblem
429Se agotó el límite de solicitudes
Encabezados
Retry-AfterintegerobligatorioSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve RateLimitProblem
503La tienda no está disponible por ahora
Encabezados
Retry-AfterintegerSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve Problem
Los errores comunes, como token, acceso, validación de la entrada y límite de solicitudes, pueden venir de cualquier endpoint; están en el catálogo: Errores
curl "https://api.saleya.app/v1/exchange-rates/{currency}" \
-H "Authorization: Bearer $SALEYA_API_TOKEN"{
"currency": "string",
"store_currency": "string",
"date": "string",
"rate": "string",
"rate_date": "string",
"source": "coingecko"
}