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.

Cargando el índice de búsqueda…

Cotizaciones contables

Objetos

ExchangeRate

  • currencystringobligatorio

    Moneda 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_currencystringobligatorio

    Moneda de la tienda, código ISO 4217.

  • datestringobligatorio

    Fecha contable pedida, AAAA-MM-DD en la zona horaria de la tienda.

  • ratestring o nullobligatorio

    Cotizació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 nullobligatorio

    Dí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 nullobligatorio

    Fuente 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

  • currencystringobligatorio

    Có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-Authenticatestringobligatorio

    Esquema 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-Authenticatestring

    Esquema 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-Afterintegerobligatorio

    Segundos de espera antes de reintentar.

    Mínimo:
    0

application/problem+json

Devuelve RateLimitProblem

503La tienda no está disponible por ahora

Encabezados

  • Retry-Afterinteger

    Segundos 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

Ejemplo de solicitud
curl "https://api.saleya.app/v1/exchange-rates/{currency}" \
  -H "Authorization: Bearer $SALEYA_API_TOKEN"
Ejemplo de respuesta · 200
{
  "currency": "string",
  "store_currency": "string",
  "date": "string",
  "rate": "string",
  "rate_date": "string",
  "source": "coingecko"
}