> ## 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

> Aprende cómo integrarte con Fire, el OS de gestión de restaurantes.

Fire es un OS de gestión de restaurantes que administra tiendas, menús, productos y canales de venta — incluyendo web, app, kioscos y agregadores de delivery (iFood, Keeta, 99, Rappi y otros).

<img className="block dark:hidden rounded-xl mx-auto" style={{maxWidth: '480px'}} src="https://mintcdn.com/firepos/gddYq9ZzZKtuBajb/images/fire-logo-02.png?fit=max&auto=format&n=gddYq9ZzZKtuBajb&q=85&s=4dcd1d885561ff909ba4301879a12c2e" alt="Fire" width="1120" height="550" data-path="images/fire-logo-02.png" />

<img className="hidden dark:block rounded-xl mx-auto" style={{maxWidth: '480px'}} src="https://mintcdn.com/firepos/gddYq9ZzZKtuBajb/images/fire-logo-01.png?fit=max&auto=format&n=gddYq9ZzZKtuBajb&q=85&s=6eabe9256c84aec547f20bec8b1df90e" alt="Fire" width="1120" height="550" data-path="images/fire-logo-01.png" />

## Modelo de integración

Fire es el **sistema maestro**. Emite eventos cada vez que algo relevante cambia y recibe órdenes inyectadas desde sistemas externos. Cualquier sistema que necesite reaccionar a esos eventos — o enviar órdenes hacia Fire — se integra a través de la misma interfaz:

* **Fire emite eventos** cada vez que cambian tiendas, menús o productos, y cuando se actualiza el estado de una orden. Los eventos se entregan a tu sistema mediante llamadas webhook por HTTPS.
* **Fire recibe órdenes** inyectadas por tu sistema vía la API REST.

Tu sistema se suscribe a los eventos que le interesan y actúa sobre ellos como necesite.

<Note>
  Un caso de uso común es un orquestador de agregadores — un sistema que conecta Fire con varios agregadores de delivery (iFood, Keeta, 99, Rappi, etc.) y maneja la publicación y el flujo de órdenes entre ellos. La integración funciona igual para cualquier otro tipo de cliente.
</Note>

## Flujos de datos

**Flujo de publicación** — Fire emite eventos que tu sistema debe propagar a sistemas downstream (agregadores, plataformas de facturación, ERPs o cualquier sistema que deba mantenerse sincronizado):

<img className="rounded-xl" src="https://mintcdn.com/firepos/GUvsAqdwhl0SaxAR/images/publication-flow.png?fit=max&auto=format&n=GUvsAqdwhl0SaxAR&q=85&s=1f9af400e5943624c9af0d4f11b66f42" alt="Diagrama del flujo de publicación" width="1808" height="978" data-path="images/publication-flow.png" />

**Flujo de órdenes** — tu sistema envía órdenes a Fire y recibe actualizaciones de estado de vuelta:

<img className="rounded-xl" src="https://mintcdn.com/firepos/GUvsAqdwhl0SaxAR/images/order-flow.png?fit=max&auto=format&n=GUvsAqdwhl0SaxAR&q=85&s=921023e20fa1d8c45c320a2ef14f565d" alt="Diagrama del flujo de órdenes" width="1800" height="964" data-path="images/order-flow.png" />

## Qué construyes

Tu integración necesita:

| Responsabilidad                                             | Dirección         |
| ----------------------------------------------------------- | ----------------- |
| Exponer un endpoint HTTPS para recibir eventos              | Fire → Tu sistema |
| Validar las firmas de los eventos entrantes                 | Fire → Tu sistema |
| Procesar eventos de publicación (tienda, menú, producto)    | Fire → Tu sistema |
| Inyectar órdenes en Fire usando tu API key                  | Tu sistema → Fire |
| Manejar las actualizaciones de estado de órdenes desde Fire | Fire → Tu sistema |

Tanto la recepción de eventos como las llamadas a la API requieren autenticación. Consulta [Autenticación](/es/authentication) para saber cómo se emiten las credenciales y cómo usarlas en cada lado.

## Próximos pasos

<CardGroup cols={2}>
  <Card title="Conceptos clave" icon="book" href="/es/key-concepts">
    Entiende los componentes fundamentales de la integración con Fire.
  </Card>

  <Card title="Autenticación" icon="lock" href="/es/authentication">
    Configura tus credenciales de API y la validación de firmas de webhook.
  </Card>

  <Card title="Inicio rápido" icon="rocket" href="/es/quickstart">
    Pon a funcionar tu integración de extremo a extremo.
  </Card>

  <Card title="Integraciones de agregadores" icon="webhook" href="/es/configuration/backoffice-integrations">
    Configura integraciones, endpoints de webhook y eventos de prueba desde el panel.
  </Card>
</CardGroup>