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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.qentaz.com/documentation/webhooks/eventos-de-equipo.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
