Saltar al contenido
logo

Ingeniería

Precios en colones y dólares sin sorpresas

Cómo Porta muestra precios en colones o dólares al tipo de cambio del BCCR: conversión en el servidor, filtros entre monedas y un primer render sin adivinar.

26 de octubre de 2026 · 5 min de lectura

En Costa Rica una casa puede estar publicada en dólares y la de al lado en colones, y quien busca quiere compararlas en la moneda con la que piensa. Parece un problema de multiplicar por el tipo de cambio. En la práctica, la parte difícil es que el mismo precio no cambie de valor según la pantalla, el momento o quién lo mire.

Una sola fuente para el tipo de cambio

El tipo de cambio sale del Banco Central de Costa Rica, que publica cada día los tipos de referencia de compra y de venta como indicadores económicos. Todos los días a las 2:00 a. m., hora de Costa Rica, una función programada en AWS Lambda le pide al backend que consulte esos dos indicadores en la API pública del BCCR, y el backend guarda un registro por día con la compra y la venta. Nadie en el frontend llama al BCCR.

Si la consulta falla un día, el backend sigue usando el último tipo de cambio válido y registra una advertencia cuando el dato tiene más de dos días. Preferimos un precio convertido con el tipo de cambio de ayer a una página de resultados que no carga.

El servidor convierte y el cliente nunca

La regla más importante es que el navegador nunca convierte precios. Cada consulta de precios a la API GraphQL incluye la moneda en la que la persona quiere verlos, y el backend responde con dos valores: el precio original de la publicación y el precio convertido. El frontend muestra el convertido y conserva el original para saber en qué moneda lo publicó el vendedor.

Convertir en un solo lugar evita una clase entera de errores. Si el cliente multiplicara por su propia copia del tipo de cambio, la tarjeta de resultados, el detalle de la propiedad y el correo de una alerta podrían mostrar tres números distintos para la misma casa, cada uno con un tipo de cambio de un momento diferente.

Filtrar por precio entre monedas

Los filtros tienen el mismo problema en sentido inverso. Si alguien busca casas de menos de 200.000 dólares, las publicaciones en colones también tienen que entrar en la comparación. El servicio de búsqueda del backend normaliza los precios al momento de consultar, con el mismo servicio de tipos de cambio, de modo que un filtro en dólares y otro en colones devuelven el mismo conjunto de propiedades.

En el frontend, el control de rango de precios marca siempre la moneda en la que están sus números. Cuando la persona cambia de moneda, los límites que había escrito se borran en lugar de reinterpretarse: 200.000 en dólares no significa nada útil en colones, y es mejor pedirlo de nuevo que adivinar.

Dos capas para el primer render

Las páginas públicas se generan en el servidor para que lleguen completas a buscadores y a quien comparte un enlace. El servidor no sabe qué moneda prefiere quien visita, porque esa preferencia vive en su navegador o en su perfil. Adivinarla, o guardar en caché la preferencia de una persona y mostrársela a otra, sería peor que no hacerlo.

Por eso el primer render siempre muestra colones, la moneda base de Porta. Después de la hidratación, si la persona eligió dólares, la página vuelve a pedir los precios en esa moneda. Quien ya prefiere colones no hace ninguna petición extra. Los datos estructurados y las tarjetas para redes sociales publican el precio en la moneda propia de la publicación, que es la que el vendedor escribió.

Carreras entre peticiones

Una persona puede cambiar de colones a dólares y de vuelta en un segundo. Si la primera respuesta llega después de la segunda, la página mostraría precios de la moneda equivocada. Cada recarga de precios lleva un número de petición y solo se aplica la respuesta más reciente; las anteriores se descartan al llegar.

Hay un detalle más fino. El proveedor de moneda de React arranca con el valor por defecto y adopta la preferencia guardada en un efecto, pero los efectos de los componentes hijos corren antes que los del padre. Un componente que en su primer render preguntara al contexto leería colones y no recargaría nada. Al montar, los componentes leen la preferencia directamente del almacenamiento local, que es síncrono y ya tiene el valor correcto; después el contexto manda.

Lo que aprendimos

  • Un precio convertido es un dato del servidor, no un cálculo de presentación.
  • Toda superficie nueva que muestre precios renderizados en el servidor necesita la recarga de la segunda capa, o se queda congelada en colones. Lo dejamos escrito como regla para el equipo.
  • La consistencia vale más que la precisión al minuto: el tipo de cambio de referencia cambia una vez al día y eso alcanza para comparar propiedades.

Si querés ver el resultado del lado de quien busca, el selector de moneda está en la barra superior de Porta y la guía del centro de ayuda explica cómo usarlo.

Elaborado por el equipo de Porta con apoyo de herramientas de inteligencia artificial y contrastado con las fuentes citadas en el texto. Si encontrás un dato desactualizado, escribinos desde el Centro de ayuda.

Ingeniería

Cómo construimos el blog de Porta

Por qué el blog de Porta usa MDX en el repositorio, un registro tipado y páginas estáticas, y qué cuidamos en SEO: hreflang, lastmod, RSS y datos estructurados.

26 de octubre de 2026 · 5 min de lectura