Configuración del agente Uful

Guía de configuración inicial (onboarding)

Aquí se describe el proceso de configuración inicial (onboarding) del agente Uful. Sigue el mismo orden que el asistente en pantalla o en terminal.

¿Cuándo aparece el asistente?

La primera vez que ejecutas el agente y aún no existe un archivo de configuración válido, el programa te ofrecerá completar el asistente.

Formas de configurar (resumen)

  • Asistente en el navegador (recomendado para mejor experiencia): se abre una página local en tu equipo; sigues los pasos en pantalla.
  • Asistente por terminal (línea de comandos): el programa te hace preguntas una tras otra; es útil en servidores sin interfaz gráfica.
  • Configuración manual: copiar el archivo de ejemplo y completar los datos en un editor de texto. Útil para equipos sin terminal interactiva o cuando la configuración se prepara en otro ordenador y se copia después.

Antes de empezar: datos que conviene tener a mano

  • La dirección web (URL) de la API de Uful que te haya indicado tu proveedor o administrador.
  • Tu API Key: es como una contraseña que identifica al agente ante el servicio. Debe tratarse con cuidado y no compartirse públicamente.
  • Datos de la base de datos donde el agente escribirá la información sincronizada: tipo de motor (por ejemplo SQL Server, MySQL o PostgreSQL), dirección del servidor, puerto, usuario, contraseña y nombre de la base.
  • Si usarás reglas personalizadas de escritura (modo avanzado), la ruta o una copia del archivo de reglas en formato JSON, según lo que acuerdes con soporte técnico.

Pantalla de bienvenida

La primera interacción con el agente es por consola. Ahí se te ofrecerán dos métodos para la configuración: por CLI (línea de comandos) o por GUI (interfaz gráfica en el navegador). Elige el que prefieras y continúa con el asistente correspondiente.

Pantalla de bienvenida del asistente en consola

Consola: bienvenida

Opción para abrir la configuración por interfaz gráfica

Opción de abrir la GUI

Paso 1 de 4

API Key (credenciales de la API)

En esta sección se valida la API Key que creaste desde el panel de gasolinero. El asistente comprobará que esa clave sea correcta y te permitirá continuar cuando la validación sea exitosa.

Paso API Key en terminal

Terminal (CLI)

Paso API Key en el navegador

Navegador (GUI)

Paso 2 de 4

Zona horaria

Debes seleccionar la zona horaria con la que operará el agente.

Esa elección solo afecta cómo se muestran las fechas: se verán en la zona horaria que elijas. Luego continúa al siguiente paso.

Selección de zona horaria en terminal

Terminal (CLI)

Selección de zona horaria en el navegador

Navegador (GUI)

Paso 3 de 4

Base de datos

En esta sección se configura la conexión a la base de datos con la que trabajará el agente.

Nota de seguridad: se recomienda encarecidamente crear un usuario de base de datos dedicado, exclusivo para el agente, con los permisos mínimos necesarios para que el agente pueda operar. Así se reduce el riesgo de que el agente pueda actuar sobre tablas no autorizadas o llevar a cabo acciones no permitidas en la base de datos.

  1. Indica el tipo de motor de base de datos (SQL Server, MySQL o PostgreSQL, según lo que uses).
  2. Escribe la dirección del servidor (o «host») y el puerto. Cada tipo de motor usa un puerto habitual; el asistente puede sugerirte uno por defecto.
  3. Indica usuario y contraseña con los que el agente se conectará.
  4. Escribe el nombre exacto de la base de datos destino.
  5. Realiza la prueba de conexión. Por CLI será automática al completar los datos solicitados.

Si la prueba falla: verifica servidor, puerto, usuario, contraseña y nombre de la base. Comprueba también firewalls o reglas de red que permitan la conexión desde el equipo donde corre el agente.

Configuración de base de datos en terminal

Terminal (CLI)

Configuración de base de datos en el navegador

Navegador (GUI)

Paso de base de datos completado en terminal

Flujo completado en terminal (CLI)

Paso 4 de 4

Perfil

Crear un «perfil». Este agrupa la configuración de cómo el agente escribe datos en la base: qué estaciones de la plataforma están asociadas y qué modo de mapeo se utiliza (reglas ERP avanzadas).

Qué debes hacer:

  • Identificador del perfil: asigna un nombre o código al perfil (por ejemplo un nombre que reconozcas en tu organización). Sirve para distinguir esta configuración si más adelante hubiera varios perfiles.
  • Estaciones: el asistente obtiene de Uful la lista de estaciones vinculadas a tu API Key. Debes revisar que aparezcan las estaciones esperadas. En la interfaz web, suelen incluirse todas las devueltas por el sistema; en el asistente por terminal puedes elegir cuáles marcar. Si no ves estaciones, confirma en la plataforma Uful que tu API Key tenga estaciones asignadas o intenta más tarde.
  • Modo de mapeo — ERP Rules: modo para reglas personalizadas de escritura al ERP. Debes indicar un archivo de reglas en formato JSON; el asistente lo guardará donde corresponda en la configuración del agente.
Configuración de perfil en terminal

Terminal (CLI)

Configuración de perfil en el navegador

Navegador (GUI)

Al terminar

Qué ocurre: se crea el archivo de configuración del agente. El programa se reiniciará solo para aplicar los cambios. En los siguientes arranques ya no debería aparecer el asistente mientras exista una configuración válida.

Recordatorio: guarda copias de respaldo de la configuración solo en lugares seguros y según las políticas de tu organización. Las API Keys y contraseñas son datos sensibles.