> For the complete documentation index, see [llms.txt](https://docs.qentaz.com/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.qentaz.com/documentation/webhooks/eventos-de-equipo.md).

# Eventos de equipo

En estos eventos te notificaremos sobre cambios en tus cobradores: bloqueo por exceso de recaudo en efectivo, activación, alta de un nuevo cobrador y edición de sus datos. Los estados que se notifican son los siguientes:

<table><thead><tr><th width="153.03515625">event.status</th><th>Descripción</th><th width="215.95703125">detail.status</th></tr></thead><tbody><tr><td><code>blocked</code></td><td>Cuando uno de tus cobradores supera el valor máximo permitido de cobros efectuados en efectivo. Se reactiva automáticamente al conciliarse el valor en efectivo.</td><td>BLOCKED<br><code>Bloqueado</code></td></tr><tr><td><code>active</code></td><td>Cuando uno de tus cobradores se activa o desbloquea. No se dispara por la activación implícita al crear o actualizar un cobrador vía API — para eso está <code>created</code>.</td><td>active<br><code>Activo</code></td></tr><tr><td><code>created</code></td><td>Cuando se crea un nuevo cobrador.</td><td>Depende del estado inicial del cobrador.</td></tr><tr><td><code>edit</code></td><td>Cuando se editan los datos de un cobrador. Este evento no corresponde a un estado del cobrador, por lo que <code>detail.status</code> puede llegar con cualquier valor.</td><td>-</td></tr></tbody></table>

## Encabezado

<table><thead><tr><th width="231.90625">Nombre</th><th>Contenido</th></tr></thead><tbody><tr><td><code>Authorization</code></td><td>Bearer {integration_key}</td></tr><tr><td><code>X-Trazo-Signature</code></td><td>timestamp={timestamp},signature={firma}</td></tr><tr><td><code>X-Trazo-Event-Id</code></td><td>Identificador único del evento</td></tr><tr><td><code>X-Trazo-Event-Attempt</code></td><td>Número de intento: 1, 2 o 3</td></tr><tr><td><code>Content-Type</code></td><td>application/json</td></tr></tbody></table>

Si configuraste un encabezado personalizado para tu comercio, este se envía además de los anteriores con el nombre y el valor que hayas definido.

{% hint style="info" %}
Cómo validar la firma, la política de reintentos y el uso del `event_id` para identificar reintentos son iguales para todos los eventos de Trazo: encontrarás el detalle en la [Introducción](/documentation/webhooks/introduccion.md).
{% endhint %}

## Payload

{% code overflow="wrap" %}

```json
{
    "event_id": "5a6b7c8d-9e0f-1a2b-3c4d-5e6f7a8b9c0d",
    "event": {
        "type": "team",
        "status": "blocked"
    },
    "created_at": "2025-03-15 16:49:02.891",
    "external_user_id": "col-00123",
    "detail": {
        "external_user_id": "col-00123",
        "nickname": "Carlos",
        "first_name": "Juan Carlos",
        "last_name": "Ramirez Rios",
        "phone": "573998887777",
        "email": "",
        "user_id_type": "CC",
        "user_id_number": "12345678",
        "role": "collector",
        "collect_limit": "3000000",
        "current_collect": "3105200",
        "status": "BLOCKED"
    }
}
```

{% endcode %}

`blocked`, `active` y `created` comparten esta misma forma de `detail` — solo cambia `status` según el estado del cobrador en cada caso.

{% hint style="warning" %}
`current_collect` no lo calcula Trazo: lo informa quien dispara el evento, con el cálculo ya hecho de su lado.
{% endhint %}

### Detalle del evento de modificación

A diferencia de los demás eventos, en `edit` el objeto `detail` **no** trae la foto completa del cobrador. Trae únicamente los campos que cambiaron, con su valor nuevo.

{% hint style="info" %}
Este evento se dispara después de que el cambio ya se aplicó, así que no hay forma de incluir el valor anterior del campo — solo reportamos lo que cambió y a qué quedó.
{% endhint %}

{% code overflow="wrap" %}

```json
{
    "event_id": "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
    "event": {
        "type": "team",
        "status": "edit"
    },
    "created_at": "2025-03-15 16:49:02.891",
    "external_user_id": "col-00123",
    "detail": {
        "collect_limit": "4000000"
    }
}
```

{% endcode %}

## Evento: Límite de efectivo

En este evento recibirás una notificación sobre el estado de recolección de efectivo de los conductores que completen alguno de los siguientes casos:

* Cuando supere el 50% del monto límite de recaudo en efectivo.
* Cuando supere el 75% del monto límite de recaudo en efectivo.
* Cuando supere el 100% del monto límite de recaudo en efectivo.

{% hint style="danger" %}
Este evento se ejecuta cada 60 minutos en la franja horaria de 8:00 am a 6:00 pm, de lunes a sábado. En caso de no recibir una respuesta positiva del webhook, se harán dos reintentos con un espaciado de 5 segundos.
{% endhint %}

### Encabezado

<table><thead><tr><th width="256.5999755859375">Nombre</th><th>Contenido</th></tr></thead><tbody><tr><td><code>Authorization</code></td><td>Bearer base64(client_id:client_secret_key)</td></tr><tr><td><code>Content-Type</code></td><td>application/json</td></tr></tbody></table>

### Payload

```json
{
    "event": {
        "type": "team",
        "status": "limit"
    },
    "created_at": "2025-03-15 16:49:02.891",
    "detail": {
        "status": "active",
        "phone": "573998887777",
        "email": "",
        "collect_limit": "3000000",
        "current_collect": "1500000",
        "collection_rate": "0.50"
    }
}
```