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

# Eventos disponibles

> Consulta los tipos de eventos que puedes usar en suscripciones webhook.

Bold publica eventos de negocio cuando cambian entidades relevantes. Los nombres exactos y sus versiones se exponen desde la API de eventos del entorno.

```http theme={null}
GET /v1/notifications/events
GET /v1/notifications/events/versions
```

<Info>
  Usa siempre el listado del entorno donde vas a integrar. Los eventos disponibles pueden crecer con nuevas funcionalidades. Estas rutas requieren acceso a la aplicación.
</Info>

## Familias de eventos

<Columns cols={2}>
  <Card title="Catálogo" icon="boxes">
    Cambios en productos, artículos, propiedades y variantes.
  </Card>

  <Card title="Almacén" icon="warehouse">
    Recepciones, envíos, lotes, ubicaciones, inventarios y movimientos de stock.
  </Card>

  <Card title="Planificación" icon="calendar-range">
    Pedidos de venta, pedidos de compra, demanda, suministro y previsiones.
  </Card>

  <Card title="Producción" icon="factory">
    Peticiones, órdenes, operaciones, recetas, progreso, pausas y finalización.
  </Card>

  <Card title="Mantenimiento" icon="wrench">
    Activos, partes de trabajo, consumos, tiempos y cierres.
  </Card>

  <Card title="Costes y personal" icon="circle-dollar-sign">
    Cambios de coste, empleados y tareas relacionadas.
  </Card>
</Columns>

## Ejemplos de nombres

Los nombres siguen el patrón `Dominio.Entidad.Accion`.

| Evento                                 | Cuándo usarlo                                                                           |
| -------------------------------------- | --------------------------------------------------------------------------------------- |
| `Items.Sku.Created`                    | Sincronizar artículos nuevos con otro sistema.                                          |
| `Planning.SalesOrder.LineConfirmed`    | Reaccionar cuando una línea de venta empieza a generar demanda.                         |
| `Planning.PurchaseOrder.LineConfirmed` | Registrar suministro esperado en una integración externa.                               |
| `Warehouse.Receipt.Received`           | Avisar de una entrada real de material.                                                 |
| `Warehouse.Shipment.Shipped`           | Actualizar un sistema logístico tras una salida.                                        |
| `Production.Order.Finished`            | Reaccionar al cierre de una orden de fabricación.                                       |
| `Maintenance.WorkOrder.Completed`      | Enviar cierre de mantenimiento a una herramienta de análisis o a un sistema de gestión. |

<Warning>
  No construyas nombres de eventos a mano. Usa `/v1/notifications/events/versions` para leer `eventName` y `eventVersion` del entorno.
</Warning>

## Elegir un evento

<Steps>
  <Step title="Identifica el cambio de negocio">
    Decide si necesitas saber que una línea se confirmó, una recepción se completó o una orden cambió de estado.
  </Step>

  <Step title="Consulta nombre y versión">
    Usa la ruta de eventos disponibles para obtener el contrato vigente.
  </Step>

  <Step title="Suscribe solo lo necesario">
    Evita suscripciones genéricas si tu integración solo necesita una familia de eventos.
  </Step>

  <Step title="Versiona tu consumidor">
    Trata `eventVersion` como parte del contrato. No mezcles versiones sin probar los datos enviados.
  </Step>
</Steps>

## Ejemplo de suscripción

```json theme={null}
{
  "endpoint": "https://integraciones.example.com/bold/sales-orders",
  "eventName": "Planning.SalesOrder.LineConfirmed",
  "eventVersion": 1
}
```

<Tip>
  Cuando el evento solo indica que algo cambió, llama a la API con el identificador recibido para obtener el estado actual antes de actualizar tu sistema.
</Tip>