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:

event.status	Descripción	detail.status
blocked	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.	BLOCKED Bloqueado
active	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á created.	active Activo
created	Cuando se crea un nuevo cobrador.	Depende del estado inicial del cobrador.
edit	Cuando se editan los datos de un cobrador. Este evento no corresponde a un estado del cobrador, por lo que detail.status puede llegar con cualquier valor.	-

Encabezado

Nombre	Contenido
Authorization	Bearer {integration_key}
X-Trazo-Signature	timestamp={timestamp},signature={firma}
X-Trazo-Event-Id	Identificador único del evento
X-Trazo-Event-Attempt	Número de intento: 1, 2 o 3
Content-Type	application/json

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.

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.

Payload

{
    "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"
    }
}

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

current_collect no lo calcula Trazo: lo informa quien dispara el evento, con el cálculo ya hecho de su lado.

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.

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ó.

{
    "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"
    }
}

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.

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.

Encabezado

Nombre	Contenido
Authorization	Bearer base64(client_id:client_secret_key)
Content-Type	application/json

Payload

{
    "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"
    }
}