---
id: KB-IN-009
url: https://app.codecontract.io/ayuda/integraciones/que-eventos-puede-avisarte-la-plataforma
idioma: es
categoria: integraciones
audiencia: desarrollador
nivel: avanzado
actualizado: 2026-08-13
tambienEn: [en]
relacionados: [KB-IN-005, KB-IN-008, KB-IN-014]
citadoPor: [KB-IN-013]
---

# Los veinte avisos que puede mandar a tu sistema

_El catálogo completo de qué puede disparar algo en vuestro lado._

**Responde a:** qué eventos emite la plataforma · lista de webhooks disponibles · avisar a mi erp cuando pasa algo · eventos de expediente y solicitud

Vuestro sistema puede enterarse en el momento de lo que pasa aquí, sin preguntar cada rato. Esto es todo lo que puede avisar, agrupado por lo que le pasa a cada cosa.

## Lo que le pasa a un expediente

| Evento | Cuándo se dispara |
| --- | --- |
| Se completa | Todo lo obligatorio está entregado y aprobado |
| Se cancela | Alguien lo cierra sin completar |
| Se duplica | Se crea uno nuevo a partir de este |
| Se añade una fase | El expediente crece con el proceso en marcha |
| Se importa un bloque | Entra documentación en lote |
| Se elimina | Deja de existir |

## Lo que le pasa a una solicitud

| Evento | Para qué suele usarse |
| --- | --- |
| Se envía | Registrar en vuestro sistema que se pidió |
| Se abre | Saber que llegó de verdad |
| Se responde | Disparar el siguiente paso vuestro |
| Se recibe | Marcar el documento como entrado |
| Se rechaza | Abrir una tarea a quien la pidió |
| Se recuerda | Contabilizar la insistencia |
| Se reenvía | Detectar contactos problemáticos |

## Lo que le pasa a un documento

| Evento | Para qué suele usarse |
| --- | --- |
| Se sube | Reflejarlo en vuestro gestor documental |
| Se le extraen datos | Volcar esos datos a vuestro sistema |
| Se certifica | Guardar la referencia de la prueba |
| Se genera desde plantilla | Trazar documentos creados automáticamente |
| Se rellena a mano | Distinguir lo manual de lo automático |

## Aprobaciones

Se aprueba o se rechaza. Son los dos que más disparan trabajo en el otro lado: aprobar suele desbloquear algo vuestro, y rechazar suele abrir una tarea.

> [!IMPORTANT]
> Suscribíos solo a lo que vais a usar. Escuchar los veinte llena vuestro registro de eventos que nadie procesa, y cuando falle uno importante estará enterrado entre ellos.

> [!WARNING]
> Cada entrega de webhook consume. Veinte eventos por expediente en un volumen alto suma deprisa; escuchar tres bien elegidos consume una fracción y resuelve lo mismo.

> [!NOTE]
> Los tres que cubren la mayoría de las integraciones reales: expediente completado, solicitud respondida y aprobación decidida. Con esos tres se automatiza casi todo lo que la gente quiere automatizar.

**¿Puedo elegir cuáles recibir?**

Sí, y conviene.

**¿Qué pasa si mi sistema está caído?**

Se reintenta; revisad la cola de fallidos.

**¿Se puede probar sin producción?**

Sí, contra el entorno de pruebas.

## Ejemplos

**Un equipo se suscribe a los veinte eventos y a las dos semanas nadie mira el registro.**

- Deja tres: expediente completado, solicitud respondida y aprobación decidida

→ El registro vuelve a ser legible y el consumo baja, sin perder nada de lo que automatizaban.

**Se suscriben los veinte avisos y el sistema receptor recibe ruido continuo.**

- Suscribe solo los eventos que se van a procesar
- Añade los demás cuando haya algo que hacer con ellos

→ El sistema recibe lo que sabe usar y el registro sigue siendo legible.

**Se quiere reaccionar a que un documento caduque y no se sabe qué avisa eso.**

- Consulta la lista de eventos disponibles

→ La integración se monta sobre lo que existe.

**Un aviso llega dos veces por un reintento.**

- Trata el aviso como idempotente por su identificador

→ El mismo evento no genera dos acciones.

**El aviso llega y el sistema receptor no sabe de qué expediente habla.**

- Incluye el identificador del expediente en el tratamiento

→ La acción se aplica donde corresponde.

**Se cambia un flujo y los avisos dejan de encajar.**

- Revisa las suscripciones al cambiar el proceso

→ La integración acompaña al cambio.