Saltar al contenido principal

Catálogos y Fuentes de Consulta

Los catálogos representan las fuentes de información habilitadas para consulta dentro de la plataforma. Desde este módulo puedes:

  • Ver qué catálogos están habilitados.
  • Habilitar nuevas fuentes.
  • Consultar información desde la plataforma web.
  • Acceder a la documentación para integrar consultas vía API.
  • Exportar resultados a PDF o CSV.

Acceso al módulo de Catálogos​

Para ingresar:

  1. En el menú lateral, ve a Consultas.
  2. Haz clic en Listar.

Vista de catálogos y fuentes disponibles​

Al entrar encontrarás dos secciones:

Catálogos habilitados (parte superior)​

Aquí aparecen todos los catálogos ya activos y listos para consulta.

Catálogos habilitados

Fuentes disponibles para habilitar (parte inferior)​

Aquí aparecen las fuentes que aún no están activas pero pueden ser habilitadas.

Fuentes disponibles

Para habilitar una fuente nueva:

  1. Ubica la fuente en la sección inferior.
  2. Haz clic en Habilitar fuente.

Aparecerá un detalle con:

  • Información que devuelve el catálogo
  • Precio por consulta
  • Precio por obtener información actualizada

Botón habilitar fuente

Si necesitas solicitar un precio actualizado, debes escribir al correo:

info@inmutable.app

  1. Haz clic en Confirmar.

Con esto, el catálogo quedará habilitado y aparecerán las opciones de consulta y de integración.

Asignar permisos al rol​

Después de habilitar un catálogo, el primer paso obligatorio es asignar permisos a los roles.

  1. Ve al menú Usuarios.
  2. Entra a Roles.
  3. Selecciona el rol que tendrá permiso para consultar el catálogo.
  4. En el listado inferior de catálogos habilitados, asigna:
    • Permiso de lectura
    • Permiso de escritura (si aplica)

Permisos en rol

⚠️ Si el usuario ya estaba autenticado, debe cerrar sesión y volver a iniciar sesión para refrescar permisos.

Consultar un catálogo desde la plataforma web​

Para hacer una consulta:

  1. En el catálogo habilitado, haz clic en Consultar.

Botón consultar

  1. Se abrirá un formulario donde debes ingresar:
    • Identificador o parámetros necesarios de búsqueda

Formulario consulta

  1. Opcionalmente puedes activar el checkbox: Obtener información actualizada

Esto forzará consultar nuevamente la fuente externa.

  1. Haz clic en Consultar.

Validación de fecha de consulta​

Cuando obtienes información actualizada, la respuesta incluirá un campo como:

  • Fecha de consulta

Esto indica cuándo se consultó la fuente, y te permite decidir si necesitas ejecutar nuevamente para obtener datos más recientes.

Fecha de consulta

Integración vía API​

Para consultar el catálogo desde otros sistemas:

  1. Haz clic en Integrar por API.

Botón integrar por API

Se abrirá la documentación con:

  • Cómo autenticarse
  • Cómo consultar esta fuente desde sistemas externos
  • Seguridad y manejo de tokens
  • Precios por consulta
  • Ejemplos de request/response

Documentación API del catálogo

Para usar los catálogos vía API es necesario contar con un usuario tipo API, como se explicó en secciones anteriores.

Exportar resultados​

Después de realizar una consulta, puedes exportar la información a:

  • PDF
  • CSV

Exportar PDF CSV

En las siguientes secciones se explica cómo configurar plantillas personalizadas para estas exportaciones.

Notas importantes​

  • Habilitar catálogo no da acceso automático: siempre debes asignar permisos al rol.
  • Los permisos nuevos solo se reflejan tras reautenticación del usuario.
  • La opción de información actualizada tiene un costo distinto si la fuente lo define.
  • Las integraciones API requieren usuario API y rol con permisos habilitados.