> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fire.rest/llms.txt
> Use this file to discover all available pages before exploring further.

# Introducción

> FUEL es el banco de pruebas y simulación interno del ecosistema de restaurantes FIRE.

FUEL (FIRE Unified Event Loader) es una herramienta interna utilizada por los equipos de QA, desarrollo y operaciones para validar la plataforma FIRE completa sin depender de clientes, tiendas ni proveedores reales. Opera en dos direcciones: cargando eventos de prueba en FIRE y simulando los sistemas externos que lo rodean.

## Dos direcciones de operación

| Dirección                           | Qué hace                                                                | Ejemplos                                                                          |
| ----------------------------------- | ----------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
| **Carga hacia FIRE**                | Envía eventos a los endpoints de FIRE como si vinieran de un canal real | Inyectar órdenes via `POST /v1/orders`, cancelar via `POST /v1/orders/:id/cancel` |
| **Simulación de sistemas externos** | Actúa como los servicios externos con los que FIRE se comunica          | Webhooks de KDS, callbacks fiscales (PlugNotas, por país), endpoints HTTP mock    |

Esto te permite ejercitar flujos de extremo a extremo —en 7 países y múltiples entornos— sin tocar integraciones de producción.

## Las 7 pestañas operacionales

* **Orden individual** — Construye e inyecta una orden con control total sobre cada campo.
* **Batch** — Genera y envía múltiples órdenes a la vez con distribuciones configurables por canal, estado y procesador.
* **Load sim** — Reproduce un patrón de tráfico realista basado en datos históricos de producción, comprimido en una duración objetivo.
* **Raw replay** — Busca órdenes de producción en FIRE (o tómalas de las muestras almacenadas en FUEL) y vuelve a inyectarlas, opcionalmente regenerando los IDs.
* **Comparison** — Envía el mismo conjunto de órdenes a múltiples escenarios en paralelo y compara los resultados.
* **Cancelar orden** — Cancela una orden existente por ID de orden externo o código de orden.
* **Webhooks** — Envía eventos de KDS (`order.preparing`, `order.ready`, `order.dispatched`, `order.cancelled`), callbacks fiscales y eventos de PlugNotas; administra endpoints HTTP mock; e inspecciona el log de eventos entrantes.

## Contexto de operación

Antes de usar cualquier pestaña, debes seleccionar tu **contexto de operación** en el panel lateral. El contexto tiene cinco niveles:

<Steps>
  <Step title="Entorno">
    El entorno de FIRE (por ejemplo, staging, producción). Cada entorno es configurado por un superadmin con una URL base y una clave de API.
  </Step>

  <Step title="Cuenta">
    La cuenta (marca o grupo operador) dentro de ese entorno.
  </Step>

  <Step title="País">
    El país que rige las reglas fiscales, los formatos de facturación y la moneda.
  </Step>

  <Step title="Vendor">
    El vendor (concepto de restaurante) bajo la cuenta.
  </Step>

  <Step title="Tienda">
    La ubicación específica de la tienda que se va a usar como destino.
  </Step>
</Steps>

<Warning>
  Los cinco niveles deben estar seleccionados antes de que FUEL pueda enviar cualquier solicitud. Las pestañas que requieren un menú de prueba también necesitan uno configurado para el vendor seleccionado.
</Warning>

## A dónde ir ahora

<CardGroup cols={2}>
  <Card title="Configuración" icon="gear" href="/es/fuel/setup">
    Configura entornos, cuentas y menús de prueba.
  </Card>

  <Card title="Orden individual" icon="cart-shopping" href="/es/fuel/single-order">
    Inyecta una sola orden con control total de los campos.
  </Card>

  <Card title="Batch" icon="layer-group" href="/es/fuel/batch">
    Envía múltiples órdenes con distribuciones configurables.
  </Card>

  <Card title="Load sim" icon="chart-line" href="/es/fuel/load-sim">
    Simula tráfico pico a partir de patrones históricos.
  </Card>

  <Card title="Raw replay" icon="rotate-left" href="/es/fuel/raw-replay">
    Busca y vuelve a inyectar órdenes de producción.
  </Card>

  <Card title="Cancelar orden" icon="ban" href="/es/fuel/cancel-order">
    Cancela una orden por ID o código.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/es/fuel/webhooks">
    Envía eventos webhook y administra endpoints mock.
  </Card>

  <Card title="Comparison" icon="code-compare" href="/es/fuel/comparison">
    Compara resultados de inyección entre entornos.
  </Card>
</CardGroup>
