# Fuentes de tipos de cambio

Esta página está destinada a sistematizar todas las tarifas (cotizaciones) por categorías lógicas. Se necesitan grupos para que el administrador pueda navegar rápidamente entre docenas o cientos de tarifas, filtrarlas y encontrar la exacta que necesita editar. Es una especie de "carpetas" o "etiquetas" para las cotizaciones.

Descripción detallada de los elementos de la interfaz:

1. Título de la página "Grupos":
   * Indica claramente que estamos en la sección de gestión de grupos, que es una subsección del menú "Tipos de cambio".
2. El botón "+ Añadir" en la esquina superior derecha:
   * Botón principal de llamada a la acción. Al hacer clic se inicia la creación de un nuevo grupo abriendo una ventana modal con un formulario para completar.
3. Tabla de grupos existentes:
   * Muestra la lista completa de todos los grupos creados en el sistema. Cada fila es un grupo separado. Las columnas proporcionan la siguiente información:
   * ID: Un identificador numérico único del grupo en la base de datos. Utilizado por el sistema para referencias internas. Ordenado por defecto en orden ascendente (de más antiguo a más nuevo).
   * Nombre: El campo más importante. Muestra el nombre asignado al grupo. Este nombre aparecerá en el desplegable "Grupo" al crear y editar cotizaciones (como en el tema anterior “Cotización”). El nombre debe ser claro e informativo (por ejemplo, "Direcciones USDT", "Direcciones BTC", "Fiat UAH").
   * Acciones (columna "Operaciones"):
     * Icono de lápiz (Editar): Al hacer clic en este icono se abre una ventana modal para editar el grupo seleccionado, donde se puede cambiar su nombre y estado.
     * Icono de papelera (Eliminar): Elimina el grupo seleccionado del sistema. Advertencia importante: Un grupo solo puede eliminarse si no hay cotizaciones vinculadas a él. El sistema no permitirá eliminar un grupo que esté en uso para evitar romper la integridad de los datos. Si intentas hacerlo, aparecerá un mensaje de error.

Uso práctico: El administrador visita esta página cuando necesita crear una nueva categoría para futuras cotizaciones (por ejemplo, se lanza un nuevo activo — DOGE, y se necesita un grupo "Direcciones DOGE"), o cuando necesita ajustar el nombre de un grupo existente para una mejor legibilidad.

Ejemplo práctico de creación de un grupo:

1. El administrador planea añadir una serie de nuevas direcciones para la stablecoin USDC.
2. Se dirige a la sección *Tarifas → Grupos*.
3. Hace clic en el botón "+ Añadir".
4. En el campo "Nombre" introduce "Direcciones USDC" y añade una breve descripción.
5. Hace clic en el botón "Guardar ✅".

Ahora, al crear una nueva cotización (por ejemplo, para la dirección USDC->UAH), podrá seleccionar el grupo recién creado "Direcciones USDC" en el campo "Grupo", lo que permitirá filtrar y encontrar cómodamente todas las tarifas relacionadas con USDC en la página principal de cotizaciones.<br>

* Fuentes de tarifas

#### Gestión de fuentes de tarifas <a href="#ulvcprj6tbm0" id="ulvcprj6tbm0"></a>

Propósito de la sección: La sección "Fuentes de Tarifas" está diseñada para integrar tu exchanger con plataformas y exchanges externos para recibir automáticamente tarifas de divisas actualizadas. En lugar de actualizar manualmente cada cotización, puedes conectar una fuente de datos externa (por ejemplo, un archivo XML en formato BestChange desde otro servicio o exchange), y el sistema descargará regularmente (con cierta frecuencia) las tarifas desde allí y actualizará tus direcciones de intercambio. Esto asegura la competitividad y relevancia de tus ofertas.

La página contiene una tabla con todas las fuentes configuradas y un botón para añadir nuevas.

Descripción de los elementos:

1. Botón "+ Añadir" en la esquina superior derecha:
   * Este botón abre un formulario para añadir una nueva fuente de tarifas. Es tu herramienta principal para conectar nuevos proveedores de datos externos.
2. Tabla de fuentes existentes:
   * Esta tabla lista todas las fuentes que ya has añadido al sistema. Cada fila contiene información sobre una fuente. Las columnas de la tabla:
   * ID: Un identificador numérico único del registro en el sistema. Se asigna automáticamente y ayuda al soporte técnico a identificar la fuente al resolver problemas.
   * Nombre: El nombre de la fuente que estableciste al crearla. El nombre debe ser claro y descriptivo para que puedas identificar fácilmente la fuente (por ejemplo, "BestChange\_Listing\_USD", "Tarifas NBU").
   * Enlace a la fuente: Este es el campo más importante. Muestra la dirección URL donde el sistema encuentra el archivo XML en el formato requerido (normalmente BestChange). Es en esta dirección donde se leen los datos.
   * Habilitado: Indicador de estado de la fuente. Tiene dos valores:
     * Habilitado (ON): La fuente está activa. El sistema la comprueba y descarga datos regularmente, actualizando las cotizaciones correspondientes.
     * Deshabilitado (OFF): La fuente está suspendida. El sistema la ignora y los datos no se actualizan. Esto es útil para desactivar temporalmente una fuente sin eliminarla.
   * Acciones (última columna):
     * Icono de lápiz (Editar): Permite realizar cambios en la configuración de la fuente seleccionada (cambiar nombre, enlace o estado).
     * Icono de papelera (Eliminar): Elimina la fuente del sistema.

**Cómo añadir una nueva fuente de tarifas: Explicación del formulario**

1. Haz clic en el botón "+ Añadir".
2. Se abrirá un formulario. Tiene tres campos principales:
   * Campo "Nombre":
     * ¿Qué es? Este es el nombre de tu fuente dentro del panel de administración.
     * ¿Cómo rellenarlo? Piensa un nombre claro y descriptivo. Por ejemplo, BestChange: USDT a UAH o Tarifas Binance (BTC/USDT). Esto te ayudará a encontrar rápidamente la fuente necesaria en una lista larga.
   * Campo "Enlace a la fuente":
     * ¿Qué es? La dirección URL de un archivo XML público que contiene datos de tarifas en el formato que requiere el sistema (la mayoría de las veces imita el formato BestChange).
     * ¿Cómo rellenarlo? Necesitas obtener este enlace de tu socio, exchange, o encontrar una fuente de datos pública que proporcione información en un formato compatible. Ejemplo: <https://partner.service.com/export.xml>
     * ¡Importante! Asegúrate de que la fuente sea fiable y accesible. La estabilidad de tus actualizaciones de tarifas depende de ello.
   * Interruptor "Habilitado":
     * ¿Qué es? Una opción que determina si la fuente estará activa inmediatamente después de la creación.
     * ¿Cómo elegir?
       * Sí (ON): Elige esto si confías en la corrección del enlace y quieres que el sistema comience a actualizar tarifas desde esta fuente de inmediato.
       * No (OFF): Elige esto si solo estás probando o quieres añadir la fuente "como respaldo" pero activarla más tarde.
3. Haz clic en el botón "Guardar ✅" para añadir la fuente al sistema.

**¿Cómo funciona en la práctica?**

1. Añades una fuente (por ejemplo, un enlace a un XML con tarifas de un socio).
2. El sistema (habitualmente a intervalos, por ejemplo cada 30 segundos) solicita automáticamente la URL especificada, descarga el archivo y lo analiza.
3. Al encontrar una coincidencia entre las monedas en tu sistema y las monedas en el archivo fuente, el sistema actualiza los valores de la fórmula en tus cotizaciones.
4. Cuando el usuario final abre el sitio del exchanger, ve tarifas actualizadas que fueron obtenidas automáticamente desde la fuente externa.

Advertencias críticamente importantes para un nuevo administrador:

* Fiabilidad de la fuente: La calidad y disponibilidad de la fuente externa es tu prioridad. Si esta "cae", tus tarifas dejarán de actualizarse.
* Formato de datos: El sistema espera datos en un formato estrictamente definido. Antes de añadir, asegúrate de que tu enlace proporcione datos en la forma requerida (normalmente XML compatible con BestChange).
* Pruebas: Siempre primero prueba una nueva fuente creando una cotización de prueba y asegurándote de que los datos se actualizan correctamente y sin errores.