> 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

## Evento: Cobrador bloqueado

En este evento te avisaremos cuando uno de tus cobradores supere el valor máximo permitido de cobros efectuados en efectivo. En el momento que se concilie el valor en efectivo, se reactivará nuevamente el cobrador.<br>

### 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": "blocked"
    },
    "created_at": "2025-03-15 16:49:02.891",
    "detail": {
        "phone": "573998887777",
        "email": "",
        "nickname": "Carlos",
        "first_name": "Juan Carlos",
        "last_name": "Ramirez Rios",
        "user_id_type": "CC",
        "user_id_number": "12345678",
        "user_id_number_dv": "",
        "role": "collector",
        "collect_limit": "3000000",
        "current_collect": "3105200",
        "user_country": "Colombia",
        "user_state": "Bogota",
        "user_city": "Bogota"
    }
}
```

## Evento: Cobrador activado

En este evento te avisaremos cuando uno de tus cobradores se active o desbloquee. Es importante tener en cuenta que la activación en la creación o actualización vía API no se tiene en cuenta para este evento.

### 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": "active"
    },
    "created_at": "2025-03-15 16:49:02.891",
    "detail": {
        "phone": "573998887777",
        "email": "",
        "nickname": "Carlos",
        "first_name": "Juan Carlos",
        "last_name": "Ramirez Rios",
        "user_id_type": "CC",
        "user_id_number": "12345678",
        "user_id_number_dv": "",
        "role": "collector",
        "collect_limit": "3000000",
        "current_collect": "0",
        "user_country": "Colombia",
        "user_state": "Bogota",
        "user_city": "Bogota"
    }
}
```

## 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:<br>

* 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",
    }
}
```
