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

# Visión general de eventos

> Todos los eventos webhook que Fire emite, organizados por entidad.

Fire notifica a tu sistema los cambios en tiempo real vía webhooks — peticiones HTTP `POST` enviadas a tu endpoint registrado siempre que ocurre algo relevante. Te suscribes a los eventos que te interesan y actúas sobre ellos como tu integración requiera.

## Eventos de canal

Los eventos de canal notifican a tu sistema cuando cambia el catálogo de canales de venta. Úsalos para mantener tu mapeo local de canales sincronizado — los IDs de canal son obligatorios al inyectar órdenes y al procesar eventos de publicación.

<CardGroup cols={3}>
  <Card title="channel.updated" icon="plug" href="/es/webhook-reference/channel-updated">
    Un canal fue creado o su configuración cambió.
  </Card>

  <Card title="channel.deleted" icon="plug-circle-xmark" href="/es/webhook-reference/channel-deleted">
    Un canal fue removido de Fire.
  </Card>

  <Card title="channels.sync" icon="arrows-rotate" href="/es/webhook-reference/channels-sync">
    Sync masivo — catálogo completo de canales en lotes de hasta 50.
  </Card>
</CardGroup>

## Eventos de tienda

Los eventos de tienda notifican a tu sistema cuando cambian las configuraciones de tienda. Fire soporta actualizaciones de tienda individuales, eliminaciones explícitas y syncs masivos para onboarding o cambios masivos.

<CardGroup cols={3}>
  <Card title="store.updated" icon="store" href="/es/webhook-reference/store-updated">
    Una tienda fue creada o su configuración cambió.
  </Card>

  <Card title="store.deleted" icon="trash" href="/es/webhook-reference/store-deleted">
    Una tienda fue removida de Fire.
  </Card>

  <Card title="stores.sync" icon="arrows-rotate" href="/es/webhook-reference/stores-sync">
    Sync masivo — hasta 50 tiendas por lote.
  </Card>
</CardGroup>

## Eventos de menú

Los eventos de menú llevan la definición completa del catálogo para una tienda y canal específicos — categorías, productos, grupos de modificadores y horarios. El payload está listo para reenviarse a sistemas downstream.

<CardGroup cols={2}>
  <Card title="menu.updated" icon="book-open" href="/es/webhook-reference/menu-updated">
    Un menú fue creado o actualizado. También se usa para indicar la eliminación del menú (payload vacío).
  </Card>

  <Card title="menus.sync" icon="arrows-rotate" href="/es/webhook-reference/menus-sync">
    Sync masivo — menús de varias tiendas en lotes de hasta 50.
  </Card>
</CardGroup>

## Eventos de producto

<CardGroup cols={2}>
  <Card title="product.updated" icon="tag" href="/es/webhook-reference/product-updated">
    Uno o más productos fueron actualizados en todas las tiendas donde aparecen.
  </Card>

  <Card title="product.availability_changed" icon="circle-dot" href="/es/webhook-reference/product-availability-changed">
    Un producto fue activado o desactivado en una o más tiendas.
  </Card>
</CardGroup>

## Eventos de orden

<CardGroup cols={1}>
  <Card title="order.status_changed" icon="receipt" href="/es/webhook-reference/order-status-changed">
    El estado de una orden cambió dentro de Fire.
  </Card>
</CardGroup>

***

## Envelope del evento

Todos los eventos comparten la misma estructura de nivel superior:

```json theme={null}
{
  "event": "event.type",
  "id": "evt_abc123",
  "createdAt": "2025-01-15T14:30:00Z",
  "data": { }
}
```

| Campo       | Tipo   | Descripción                                    |
| ----------- | ------ | ---------------------------------------------- |
| `event`     | string | Identificador del tipo de evento               |
| `id`        | string | ID único del evento — úsalo para deduplicación |
| `createdAt` | string | Timestamp ISO 8601                             |
| `data`      | object | Payload específico del evento                  |

## Headers de la petición

| Header             | Descripción                                                      |
| ------------------ | ---------------------------------------------------------------- |
| `Content-Type`     | `application/json`                                               |
| `X-Fire-Event`     | Tipo de evento (p. ej. `menu.updated`)                           |
| `X-Fire-Signature` | Firma HMAC-SHA256 — consulta [Autenticación](/es/authentication) |
| `X-Fire-Delivery`  | ID único del intento de entrega                                  |

## Deduplicación

Usa el campo `id` para detectar y descartar entregas duplicadas. Fire puede entregar el mismo evento más de una vez en caso de reintentos.

## Cómo responder

Devuelve cualquier `2xx` en menos de 10 segundos para confirmar la recepción. Procesa de forma asíncrona para evitar timeouts.