Cómo ver qué usuario ha creado un envío a través de la API

Finalidad: descubre cómo saber qué usuario de tu cuenta de Sendcloud ha creado un envío concreto, y cómo usar esta información para rastrear errores hasta la persona que prepara los pedidos o para medir su productividad.

Si gestionas un equipo de empleados que preparan, embalan y anuncian envíos en Sendcloud, ahora puedes obtener el ID del usuario que ha creado cada envío. Esto resulta especialmente útil para los comercios con varios preparadores de pedidos que quieren:

• Rastrear errores de envío hasta la persona que lo creó. Si un envío se ha embalado de forma incorrecta o se ha usado la etiqueta equivocada, puedes averiguar quién lo creó.
• Medir la productividad de los preparadores de pedidos. Puedes ver cuántos envíos ha creado cada uno y crear tus propios informes con esta información.

Averiguar quién ha creado un envío

Puedes obtener esta información a través de la Events API, que devuelve una lista de eventos de tu organización. Cada evento incluye el user_id del usuario que realizó la acción, el envío afectado, la operation (create, update o delete) y el momento en que ocurrió.

Un envío puede tener más de un evento a lo largo del tiempo, por ejemplo uno para su creación y otro para una actualización posterior. Para averiguar quién lo creó, filtra por operation=create.

Para consultar la lista completa de parámetros y campos de respuesta, lee la referencia de la Events API.

Averiguar quién ha creado un envío concreto

Utiliza esto si quieres rastrear un envío que se ha embalado incorrectamente o que tenía la etiqueta equivocada, hasta el usuario que lo creó.

1. Llama al endpoint Consultar envíos y pasa el número de seguimiento del envío como parámetro tracking_number.
   Por ejemplo, si pasas el número de seguimiento 3SYZXG2094203, obtendrás un envío con el ID 6b67970c-d288-4966-859d-c2b653ad7922.
2. Llama al endpoint Consultar una lista de eventos. Establece el parámetro resource_id con el ID de envío obtenido en el paso 1 y define operation como create.

3. La respuesta incluye el user_id del usuario que creó el envío:

   {
     "data": [
       {
         "user_id": 97965,
         "actor_id": null,
         "organization_id": 97965,
         "resource_type": "shipment",
         "operation": "create",
         "resource_id": "6b67970c-d288-4966-859d-c2b653ad7922",
         "timestamp": "2026-07-14T08:50:14.477458Z"
       }
     ]
   }

4. En tu panel de Sendcloud, ve a Configuración > Usuarios y roles > Usuarios activos para asociar el user_id con la dirección de correo electrónico correspondiente.

Medir la productividad de los preparadores de pedidos

Utiliza esto si quieres crear tu propio panel de control para hacer un seguimiento de cuántos envíos crea cada preparador de pedidos.

1. Llama al endpoint Consultar una lista de eventos con operation definido como create para ver quién ha creado cada envío.
2. En tu panel de Sendcloud, ve a Configuración > Usuarios y roles > Usuarios activos para asociar esos ID de usuario con tus preparadores de pedidos.
3. Utiliza estos datos para crear tus propios paneles de control y hacer un seguimiento de las métricas que necesites.

Artículos relacionados

→ Documentación de la API y Guía de inicio rápido
→ ¿Qué son los webhooks y cómo configurarlos en Sendcloud?