> For the complete documentation index, see [llms.txt](https://docs.api.persat.com.ar/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.api.persat.com.ar/entidades-basicas/objetos-en-cliente/historial-de-actividad-de-un-objeto.md).

# Historial de actividad de un objeto

Permite saber en qué formularios y órdenes de trabajo (OTs) fue mencionado un objeto en cliente. Por ejemplo, para una heladera, podemos ver todos los formularios de mantenimiento y las OTs en las que se la incluyó, ordenados de lo más nuevo a lo más viejo.

El objeto se identifica igual que en [Obtener objeto](https://docs.api.persat.com.ar/entidades-basicas/objetos-en-cliente/obtener-objeto.md): con el cliente en el que se encuentra **actualmente**, el obj\_id y el field\_1.

<mark style="color:blue;">`GET`</mark> `https://api.persat.com.ar/v1/clientobjvalue/uid_client/obj_id/field_1/activity`

#### Path Parameters

| Name                                          | Type   | Description                                                            |
| --------------------------------------------- | ------ | ---------------------------------------------------------------------- |
| uid\_client<mark style="color:red;">\*</mark> | String | Identificador del cliente en el que se encuentra actualmente el objeto |
| obj\_id<mark style="color:red;">\*</mark>     | Number | Identificador del tipo de objeto. Heladeras por ej.                    |
| field\_1<mark style="color:red;">\*</mark>    | String | Identificador del objeto                                               |

#### Query Parameters

| Name                  | Type    | Description                                                                                                                                                              |
| --------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| offset                | number  | Mismo concepto de SQL para la paginación. En caso de no enviarse el valor será 0 (cero)                                                                                  |
| limit                 | number  | Mismo concepto de SQL para la paginación. Max: 100. En caso de no enviarse el valor será 20                                                                              |
| only\_current\_client | boolean | `true`: solo devuelve la actividad en el cliente actual del objeto. `false`: devuelve la actividad en todos los clientes por los que pasó el objeto. Por defecto `false` |

#### Headers

| Name                                            | Type   | Description     |
| ----------------------------------------------- | ------ | --------------- |
| Authorization<mark style="color:red;">\*</mark> | String | Bearer API\_KEY |

{% tabs %}
{% tab title="200: OK La consulta se ejecutó con éxito" %}

```json
{
    "success": true,
    "data": {
        "client_obj_value": {
            "uid_client": "AABC9098",
            "obj_id": 2,
            "field_1": "AABCSA090AA"
        },
        "activity": [
            {
                "type": "WORK_ORDER",
                "date": "2026-10-28T18:04:00.000Z",
                "client": {
                    "uid_client": "AABC9098",
                    "name": "Supermercado Norte",
                    "is_current_client": true
                },
                "user": {
                    "user_id": 15,
                    "name": "jperez",
                    "real_name": "Juan Pérez",
                    "exists": true
                },
                "work_order": {
                    "wo_id": "45872",
                    "schema_id": 3,
                    "name": "Mantenimiento preventivo",
                    "state": "CERRADA_OK"
                }
            }
        ]
    },
    "paging": {
        "offset": 0,
        "limit": 20,
        "result": 1,
        "total": 1
    }
}
```

{% endtab %}

{% tab title="404: Not Found El cliente o el objeto no existe" %}

```json
{
    "success": false,
    "error": {
        "status": 404,
        "type": "NOT_FOUND",
        "userMessage": "No se encontro el obj value"
    }
}
```

{% endtab %}

{% tab title="400: Bad Request Error en alguno de los campos enviados. userMessage contiene informacipon adicional." %}

```javascript
{
    "success": false,
    "error": {
        "status": 400,
        "type": "BAD_REQUEST",
        "userMessage": "'limit' debe ser un number >= 1 y <= 100"
    }
}
```

{% endtab %}
{% endtabs %}

### Ejemplo de consulta

En este ejemplo queremos ver la actividad de una heladera particular, en todos los clientes por los que pasó

* **uid\_client**: <mark style="color:green;">AABC9098</mark> - Cliente en el que se encuentra actualmente la heladera
* **obj\_id**: <mark style="color:blue;">2</mark> - Tipo de Objeto Heladera
* **field\_1**: <mark style="color:orange;">AABCSA090AA</mark> - Identificador de la heladera

La url de la consulta queda asi:

**<https://api.persat.com.ar/v1/clientobjvalue/>**<mark style="color:green;">AABC9098</mark>/<mark style="color:blue;">2</mark>/<mark style="color:orange;">AABCSA090AA</mark>**/activity**?offset=0\&limit=3

### Analizando la Respuesta

```json
{
    "success": true,
    "data": {
        "client_obj_value": {
            "uid_client": "AABC9098",
            "obj_id": 2,
            "field_1": "AABCSA090AA"
        },
        "activity": [
            {
                "type": "WORK_ORDER",
                "date": "2026-10-28T18:04:00.000Z",
                "client": {
                    "uid_client": "AABC9098",
                    "name": "Supermercado Norte",
                    "is_current_client": true
                },
                "user": {
                    "user_id": 15,
                    "name": "jperez",
                    "real_name": "Juan Pérez",
                    "exists": true
                },
                "work_order": {
                    "wo_id": "45872",
                    "schema_id": 3,
                    "name": "Mantenimiento preventivo",
                    "state": "CERRADA_OK"
                }
            },
            {
                "type": "DIGITAL_FORM",
                "date": "2026-09-12T10:30:00.000Z",
                "client": {
                    "uid_client": "AABC9098",
                    "name": "Supermercado Norte",
                    "is_current_client": true
                },
                "user": null,
                "digital_form": {
                    "form_id": "981245",
                    "schema_id": 12,
                    "title": "Instalación de equipo"
                }
            },
            {
                "type": "DIGITAL_FORM",
                "date": "2026-03-02T15:12:00.000Z",
                "client": {
                    "uid_client": "ZZK1020",
                    "name": "Kiosco Central",
                    "is_current_client": false
                },
                "user": {
                    "user_id": 8,
                    "name": "El usuario ya no existe en Persat",
                    "real_name": "María Gómez",
                    "exists": false
                },
                "digital_form": {
                    "form_id": "870331",
                    "schema_id": 12,
                    "title": "Retiro de equipo"
                }
            }
        ]
    },
    "paging": {
        "offset": 0,
        "limit": 3,
        "result": 3,
        "total": 14
    }
}
```

**client\_obj\_value:** Es el objeto consultado: cliente actual, tipo de objeto y su identificador (field\_1).

**activity:** Es un array con la actividad del objeto, ordenada de la más nueva a la más vieja. Cada item tiene:

* **type:** Dónde fue mencionado el objeto. Puede ser `DIGITAL_FORM` (formulario) o `WORK_ORDER` (orden de trabajo).
* **date:** Fecha y hora local en la que ocurrió la actividad.
* **client:** Cliente del formulario u OT en el que se mencionó al objeto. Un objeto puede haber pasado por varios clientes, por eso **is\_current\_client** indica si ese cliente es en el que se encuentra actualmente el objeto.
* **digital\_form:** Solo viene cuando **type** es `DIGITAL_FORM`. Contiene el **form\_id** del formulario (se puede usar en [Obtener formulario](https://docs.api.persat.com.ar/modulos/formularios-digitales/obtener-formulario.md)), el **schema\_id** y el **title** de su esquema.
* **work\_order:** Solo viene cuando **type** es `WORK_ORDER`. Contiene el **wo\_id** de la OT (se puede usar en [Obtener OT](https://docs.api.persat.com.ar/modulos/ordenes-de-trabajo/obtener-ot.md)), el **schema\_id** y el **name** del tipo de OT, y su **state** (estado actual).
* **user:** Usuario que realizó la actividad. Es `null` cuando no hay un usuario asociado, por ejemplo si el formulario o la OT fueron creados desde la API. Si el usuario fue eliminado de Persat, **exists** es `false` y **name** es "El usuario ya no existe en Persat" (cuando es posible, **real\_name** conserva el nombre original).

**paging:** Es un objeto JSON que contiene los datos de la consulta offset y limit tal cual se recibieron, la cantidad de items devueltos en esta consulta (**result**) y el total de actividad del objeto (**total**). De esta forma podemos ir trayendo de forma paginada todo el historial.

{% hint style="info" %}
Si solo nos interesa la actividad del objeto en el cliente en el que está ahora, agregamos `only_current_client=true` a la consulta. En el ejemplo anterior, el último item (del cliente ZZK1020) no vendría.
{% endhint %}
