Saltar al contenido principal
Bold publica eventos de negocio cuando cambian entidades relevantes. Los nombres exactos y sus versiones se exponen desde la API de eventos del entorno. 
GET /v1/notifications/events
GET /v1/notifications/events/versions
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.

​
Familias de eventos

Catálogo

Cambios en productos, artículos, propiedades y variantes.

Almacén

Recepciones, envíos, lotes, ubicaciones, inventarios y movimientos de stock.

Planificación

Pedidos de venta, pedidos de compra, demanda, suministro y previsiones.

Producción

Peticiones, órdenes, operaciones, recetas, progreso, pausas y finalización.

Mantenimiento

Activos, partes de trabajo, consumos, tiempos y cierres.

Costes y personal

Cambios de coste, empleados y tareas relacionadas.

​
Ejemplos de nombres

Los nombres siguen el patrón Dominio.Entidad.Accion.
EventoCuándo usarlo
Items.Sku.CreatedSincronizar artículos nuevos con otro sistema.
Planning.SalesOrder.LineConfirmedReaccionar cuando una línea de venta empieza a generar demanda.
Planning.PurchaseOrder.LineConfirmedRegistrar suministro esperado en una integración externa.
Warehouse.Receipt.ReceivedAvisar de una entrada real de material.
Warehouse.Shipment.ShippedActualizar un sistema logístico tras una salida.
Production.Order.FinishedReaccionar al cierre de una orden de fabricación.
Maintenance.WorkOrder.CompletedEnviar cierre de mantenimiento a una herramienta de análisis o a un sistema de gestión.
No construyas nombres de eventos a mano. Usa /v1/notifications/events/versions para leer eventName y eventVersion del entorno.

​
Elegir un evento

1

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

Consulta nombre y versión

Usa la ruta de eventos disponibles para obtener el contrato vigente.
3

Suscribe solo lo necesario

Evita suscripciones genéricas si tu integración solo necesita una familia de eventos.
4

Versiona tu consumidor

Trata eventVersion como parte del contrato. No mezcles versiones sin probar los datos enviados.

​
Ejemplo de suscripción

{
  "endpoint": "https://integraciones.example.com/bold/sales-orders",
  "eventName": "Planning.SalesOrder.LineConfirmed",
  "eventVersion": 1
}
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.