Crear cotizaciones de divisas

POST /api/common/divisas Alta de cotizaciones de divisa V4

Descripción

Da de alta una o varias cotizaciones de divisa. La moneda base se fija automáticamente a EUR. En cada cotización es obligatorio indicar la divisa, la fecha y el importe de cambio. Las cotizaciones que ya existan para su misma divisa y fecha no se crean y se informa de ellas en la respuesta.

Campos del cuerpo

Campo	Tipo	Requerido	Descripción
codigoDivisa	string	✅	Código de divisa de 3 caracteres (p. ej. USD)
fechaDivisa	string	✅	Fecha de la cotización (YYYY-MM-DD)
importeCambio	decimal	✅	Importe de cambio frente a la moneda base
codigoMonedaBase	string	❌	No enviar: lo fija el servidor siempre a EUR

Note

El cuerpo es un array: se pueden enviar varias cotizaciones en una sola petición.

Ejemplo

curl -X POST "https://api.tandem.com/api/common/divisas" \
  -H "Authorization: Bearer tu_access_token" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "codigoDivisa": "USD",
      "fechaDivisa": "2026-06-20",
      "importeCambio": 1.0854
    }
  ]'

Respuesta exitosa (201)

{
  "success": true,
  "message": "Cotizaciones insertadas correctamente.",
  "result": {
    "totalRecibidas": 1,
    "totalInsertadas": 1,
    "totalOmitidas": 0,
    "insertadas": [
      {
        "codigoMonedaBase": "EUR",
        "codigoDivisa": "USD",
        "fechaDivisa": "2026-06-20T00:00:00",
        "importeCambio": 1.0854
      }
    ],
    "omitidas": []
  }
}

Respuesta con cotizaciones duplicadas (409)

{
  "success": false,
  "message": "Alguna cotización ya existía y no se ha insertado.",
  "result": {
    "totalRecibidas": 1,
    "totalInsertadas": 0,
    "totalOmitidas": 1,
    "insertadas": [],
    "omitidas": ["USD - 2026-06-20"]
  }
}