Skip to main content

​
Autenticación

FUEL utiliza su propio sistema de cuentas, independiente de la plataforma FIRE. Navega a la página de inicio de sesión de FUEL e ingresa con las credenciales que te proporcionó el administrador de tu equipo.
Las cuentas de FUEL son gestionadas por un superadmin. Si no tienes credenciales, pídele a tu administrador que cree una cuenta para ti desde el panel de Administración.

​
El contexto operativo

Antes de usar cualquier pestaña de FUEL, debes establecer un contexto operativo mediante la barra lateral. El contexto le indica a FUEL qué entorno de FIRE y qué tienda debe utilizar como destino en todas las operaciones. La barra lateral contiene cuatro selectores secuenciales y un selector de tienda:
1

Selecciona un entorno

Elige el entorno de FIRE al que deseas apuntar (por ejemplo, staging, producción o un sandbox específico para un cliente). Los entornos son configurados por un superadmin y cada uno apunta a una URL base de FIRE con sus propias credenciales de API.
2

Selecciona una cuenta

Elige la cuenta dentro de ese entorno. Las cuentas agrupan a los vendors bajo una misma entidad operadora.
3

Selecciona un país

Elige el país de operación. La selección del país afecta los formatos de documentos fiscales, el manejo de moneda y la disponibilidad de canales.
4

Selecciona un vendor

Elige el vendor (marca o concepto) que estás probando. Cada vendor tiene su propia API key vinculada al entorno seleccionado.
5

Selecciona una tienda

Usa el selector de tienda para elegir la ubicación específica. El selector muestra únicamente las tiendas que pertenecen al vendor seleccionado en el paso anterior.
Una vez realizadas las cinco selecciones, el contexto operativo estará activo y cada pestaña apuntará a esa combinación de entorno + tienda.
Pestañas como Orden individual, Batch y Cancelar orden permanecen deshabilitadas hasta que se establezca un contexto operativo completo. Asegúrate de que los cinco selectores muestren un valor antes de continuar.

​
Entornos

Los entornos son el puente entre FUEL y un despliegue de FIRE. Cada registro de entorno almacena:
  • Una URL base de FIRE (por ejemplo, https://api.staging.firepos.io)
  • Una API key por vendor, vinculada a ese entorno
Solo un superadmin puede crear o editar entornos. Si necesitas un nuevo entorno (por ejemplo, un sandbox para un nuevo cliente o un entorno de UAT), contacta a tu superadmin.

​
Panel de administración (solo superadmin)

El panel de Administración es accesible desde la barra lateral para los usuarios con privilegios de superadmin. Contiene cuatro secciones:

Entornos

Agrega, edita o desactiva entornos. Por cada entorno puedes configurar la URL base de FIRE y establecer las API keys por vendor.

Gestión de usuarios

Crea cuentas de FUEL, asigna roles (usuario / superadmin) y desactiva cuentas cuando los miembros del equipo se van.

Menús de prueba

Crea y gestiona menús de prueba — catálogos de productos utilizados por Orden individual y Batch para construir los payloads de órdenes.

Tiendas

Visualiza y sincroniza la lista de tiendas para cada combinación de vendor y entorno.

​
Menús de prueba

Un menú de prueba es un catálogo de productos administrado por el superadmin que define qué productos, canales y procesadores de pago están disponibles al construir una orden en FUEL. Cada menú de prueba está vinculado a un entorno y vendor específicos, y contiene:
  • Productos — ítems con nombre, precio (en la unidad mínima de la moneda: centavos para BRL, dólares para USD) y grupos de modificadores opcionales (salsas, tamaños, extras)
  • Canales — los canales de orden disponibles para ese vendor: POS, KIOSK, APP, AGGREGATOR
  • Procesadores — los métodos de pago que acepta el vendor
Orden individual y Batch requieren al menos un menú de prueba asignado al vendor y entorno activos. Sin un menú de prueba, FUEL no puede construir los payloads de órdenes y los controles de inyección estarán deshabilitados. Pídele a tu superadmin que cree un menú de prueba si no aparece ninguno en el selector.
Los menús de prueba pueden modelar múltiples líneas de productos y niveles de precios. Crea menús separados para distintos escenarios de prueba (por ejemplo, un menú de “happy path” con ítems simples y un menú de “modificadores” para poner a prueba los grupos de modificadores).
Una vez que tu contexto operativo esté establecido y haya un menú de prueba disponible, estarás listo para comenzar a inyectar órdenes. Consulta Orden individual para un recorrido paso a paso.