Catálogo de Eventos

ALTUM ERP puede notificar a sus sistemas externos mediante webhooks cuando ocurren los siguientes eventos. Todos los payloads se envían como JSON y los campos de fecha usan formato ISO 8601 (UTC).

Cómo usar este catálogo

Navegue a Integraciones → Catálogo de Eventos para consultar los eventos disponibles directamente desde la interfaz, incluyendo ejemplos de payload interactivos.

Eventos por módulo

Ventas

sale.created

Se emite cuando se crea y finaliza una venta exitosamente.

Campo	Tipo	Requerido	Descripción
id	string (UUID)	Sí	Identificador único de la venta.
folio	string	Sí	Folio consecutivo de la venta.
total	number	Sí	Monto total incluyendo IVA (MXN).
subtotal	number	Sí	Subtotal antes de impuestos (MXN).
iva	number	Sí	Monto de IVA aplicado (MXN).
clienteId	string (UUID)	No	Identificador del cliente.
clienteNombre	string	No	Nombre del cliente.
sucursalId	string (UUID)	Sí	Identificador de la sucursal.
items	array	Sí	Líneas de detalle de la venta.
formaPago	string	Sí	Clave SAT de forma de pago (ej. 01 = Efectivo, 04 = Tarjeta).
metodoPago	string	Sí	Método de pago SAT (PUE = Una sola exhibición, PPD = Parcialidades).
createdAt	ISO 8601	Sí	Fecha y hora de creación.

sale.cancelled

Se emite cuando una venta es cancelada.

Campo	Tipo	Requerido	Descripción
id	string (UUID)	Sí	Identificador único de la venta cancelada.
folio	string	Sí	Folio de la venta.
total	number	Sí	Monto total (MXN).
motivoCancelacion	string	No	Razón de la cancelación.
canceladoPor	string (UUID)	Sí	Identificador del usuario que canceló.
canceladoEn	ISO 8601	Sí	Fecha y hora de la cancelación.

payment.received

Se emite cuando se registra un pago de cliente (abono o liquidación).

Campo	Tipo	Requerido	Descripción
id	string (UUID)	Sí	Identificador único del pago.
monto	number	Sí	Monto del pago (MXN).
formaPago	string	Sí	Clave SAT de forma de pago.
referencia	string	No	Referencia del pago.
clienteId	string (UUID)	Sí	Identificador del cliente.
clienteNombre	string	Sí	Nombre del cliente.
ventaId	string (UUID)	No	Venta a la que se aplica el pago.
sucursalId	string (UUID)	Sí	Identificador de la sucursal.
creadoEn	ISO 8601	Sí	Fecha y hora del pago.

return.created

Se emite cuando se registra una devolución o cambio de mercancía.

Campo	Tipo	Requerido	Descripción
id	string (UUID)	Sí	Identificador único de la devolución.
folio	string	Sí	Folio de la devolución.
ventaOriginalId	string (UUID)	Sí	Identificador de la venta original.
ventaOriginalFolio	string	Sí	Folio de la venta original.
clienteId	string (UUID)	No	Identificador del cliente.
tipoDevolucion	string	Sí	REEMBOLSO, CAMBIO o NOTA_CREDITO.
montoReembolso	number	No	Monto total reembolsado (MXN).
items	array	Sí	Artículos devueltos.
motivo	string	No	Motivo de la devolución.
creadoEn	ISO 8601	Sí	Fecha y hora de la devolución.

---

Facturación

invoice.stamped

Se emite cuando un CFDI es timbrado exitosamente por el PAC (Finkok).

Campo	Tipo	Requerido	Descripción
id	string (UUID)	Sí	Identificador interno del CFDI.
uuid	string (UUID)	Sí	UUID fiscal asignado por el SAT.
folio	string	No	Folio del comprobante.
serie	string	No	Serie del comprobante.
rfcEmisor	string	Sí	RFC del emisor.
rfcReceptor	string	Sí	RFC del receptor.
nombreReceptor	string	Sí	Nombre o razón social del receptor.
subtotal	number	Sí	Subtotal antes de impuestos (MXN).
iva	number	Sí	Monto de IVA (MXN).
total	number	Sí	Total del comprobante (MXN).
moneda	string	Sí	Clave ISO 4217 de la moneda.
tipoCambio	number	No	Tipo de cambio respecto a MXN.
tipoComprobante	string	Sí	I=Ingreso, E=Egreso, P=Pago, T=Traslado.
metodoPago	string	No	Método de pago SAT.
formaPago	string	No	Clave SAT de forma de pago.
timbradoEn	ISO 8601	Sí	Fecha y hora del timbrado.

invoice.cancelled

Se emite cuando un CFDI es cancelado ante el SAT.

Campo	Tipo	Requerido	Descripción
id	string (UUID)	Sí	Identificador interno del CFDI cancelado.
uuid	string (UUID)	Sí	UUID fiscal del CFDI cancelado.
folio	string	No	Folio del comprobante.
rfcEmisor	string	Sí	RFC del emisor.
rfcReceptor	string	Sí	RFC del receptor.
total	number	Sí	Total del comprobante cancelado (MXN).
motivoCancelacion	string	Sí	Clave SAT de motivo de cancelación (01–04).
uuidSustitucion	string (UUID) o null	No	UUID del CFDI que sustituye al cancelado (aplica para motivo 01).
canceladoEn	ISO 8601	Sí	Fecha y hora de la cancelación.

---

Inventarios

stock.low

Se emite cuando el stock de un producto cae por debajo del mínimo configurado.

Campo	Tipo	Requerido	Descripción
productoId	string (UUID)	Sí	Identificador del producto.
productoNombre	string	Sí	Nombre del producto.
sku	string	No	SKU del producto.
almacenId	string (UUID)	Sí	Almacén donde se detectó el stock bajo.
almacenNombre	string	Sí	Nombre del almacén.
stockActual	number	Sí	Cantidad actual en existencia.
stockMinimo	number	Sí	Cantidad mínima configurada.
unidadMedida	string	Sí	Clave SAT de unidad de medida.
detectadoEn	ISO 8601	Sí	Fecha y hora de detección.

stock.movement

Se emite cuando ocurre cualquier movimiento de inventario.

Campo	Tipo	Requerido	Descripción
id	string (UUID)	Sí	Identificador único del movimiento.
productoId	string (UUID)	Sí	Identificador del producto.
productoNombre	string	Sí	Nombre del producto.
sku	string	No	SKU del producto.
tipoMovimiento	string	Sí	ENTRADA, SALIDA, AJUSTE o TRANSFERENCIA.
cantidad	number	Sí	Cantidad del movimiento (siempre positiva).
stockAnterior	number	Sí	Stock antes del movimiento.
stockNuevo	number	Sí	Stock después del movimiento.
almacenId	string (UUID)	Sí	Almacén afectado.
almacenNombre	string	Sí	Nombre del almacén.
referencia	string	No	Tipo de documento origen.
referenciaId	string (UUID)	No	Identificador del documento origen.
realizadoEn	ISO 8601	Sí	Fecha y hora del movimiento.

product.created

Se emite cuando se crea un nuevo producto en el catálogo.

product.updated

Se emite cuando se actualiza la información de un producto existente. Incluye el campo camposModificados (array de strings) con los nombres de los campos que cambiaron.

---

Clientes

customer.created

Se emite cuando se crea un nuevo cliente. Incluye datos fiscales básicos (RFC, tipo de persona, régimen fiscal, uso CFDI).

customer.updated

Se emite cuando se actualiza la información de un cliente. Incluye el campo camposModificados con los nombres de los campos que cambiaron.

---

Compras

purchase_order.created

Se emite cuando se crea una nueva orden de compra. Incluye proveedor, almacén destino, totales y líneas de detalle.

purchase_order.received

Se emite cuando se registra la recepción total o parcial de una orden de compra. Incluye el campo esRecepcionCompleta para indicar si la recepción cierra la orden.

---

Referencia rápida de tipos de evento

Evento	Módulo
sale.created	Ventas
sale.cancelled	Ventas
payment.received	Ventas
return.created	Ventas
invoice.stamped	Facturación
invoice.cancelled	Facturación
stock.low	Inventarios
stock.movement	Inventarios
product.created	Inventarios
product.updated	Inventarios
customer.created	Clientes
customer.updated	Clientes
purchase_order.created	Compras
purchase_order.received	Compras