# Crear seguimientos

Para crear un seguimiento se debe realizar un POST como el que se muestra a continuación.

<mark style="color:green;">`POST`</mark> `https://api.persat.com.ar/v1/follow_ups`

#### Headers

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

#### Request Body

<table><thead><tr><th width="254">Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>uid_client<mark style="color:red;">*</mark></td><td>string</td><td>El número/identificador de cliente (es un valor alfanumérico).</td></tr><tr><td>title<mark style="color:red;">*</mark></td><td>string</td><td>Título del seguimiento.</td></tr><tr><td>responsible_user_ids<mark style="color:red;">*</mark></td><td>number[]</td><td>Listado de ids de usuarios responsables del seguimiento. Mínimo 1 responsable.</td></tr><tr><td>color<mark style="color:red;">*</mark></td><td>string</td><td>Color identificador del seguimiento. Ver colores disponibles en la siguiente sección.</td></tr><tr><td>date<mark style="color:red;">*</mark></td><td>string</td><td>Fecha del seguimiento en formato ISO, debe ser una fecha futura. Ejemplo: 2021-09-09T14:30:00.000Z.</td></tr><tr><td>description</td><td>string</td><td>Descripción del seguimiento.</td></tr><tr><td>send_email_minutes_before</td><td>number</td><td>Minutos previos a la fecha en los que se envía un email a los responsables. Ver minutos disponibles en la siguiente sección. Si no está presente no se envía mail.</td></tr></tbody></table>

### Aclaraciones sobre el request

**Listado de colores disponibles.**

<figure><img src="https://3878285185-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZX85SzYcp8wvaPjODD%2Fuploads%2FwR9T0iu6utz48dpETF2g%2Fcolor.png?alt=media&#x26;token=38a4ee40-4abb-47ab-9c34-1896679f5d0a" alt=""><figcaption><p>Listado en la app web</p></figcaption></figure>

* RED
* ORANGE
* YELLOW
* GREEN
* BLUE
* PINK
* BLACK

**Listado de minutos disponibles.**

<div align="center" data-full-width="false"><figure><img src="https://3878285185-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZX85SzYcp8wvaPjODD%2Fuploads%2F7PGn9y10VidgTkSglKEI%2Fhora.png?alt=media&#x26;token=c35da28d-86be-450c-a203-8d9af692c3f0" alt="" width="296"><figcaption><p>Listado en la app web</p></figcaption></figure></div>

* 0 (en el momento del seguimiento)
* 10
* 20
* 30
* 45
* 60 (1 hora)
* 120 (2 horas)
* 180 (3 horas)
* 240 (4 horas)
* 300 (5 horas)
* 1440 (1 día)
* 2880 (2 días)
* 4320 (3 días)
* 5760 (4 días)
* 10080 (1 semana)

{% hint style="danger" %}
IMPORTANTE: los usuarios responsables deben tener habilitado el grupo de cliente correspondiente al cliente que se le asigna el seguimiento. Ver "**group\_id**" en [Obtener un Cliente](https://docs.api.persat.com.ar/entidades-basicas/clientes/obtener-un-cliente).
{% endhint %}

{% tabs %}
{% tab title="200 El seguimiento fue creado" %}

```javascript
{
    "success": true,
    "data": {
        "id": 33,
        "uid_client": "CL-0044",
        "title": "Llamar",
        "description": "",
        "color": "RED",
        "responsible_user_ids": [
            1,
            2,
            3
        ],
        "send_email": false,
        "date": "2026-01-01T00:00:00.000Z"
    }
}

```

{% endtab %}

{% tab title="400 campos obligatorios" %}

```javascript
{
    "success": false,
    "error": {
        "status": 400,
        "type": "BAD_REQUEST",
        "userMessage": "'uid_client' debe ser un string"
    }
}
```

{% endtab %}

{% tab title="404 Cliente no encontrado" %}

```javascript
{
    "success": false,
    "error": {
        "status": 409,
        "type": "CONFLICT",
        "userMessage": "No existe el cliente con uid: 'CL-0044'"
    }
}
```

{% endtab %}

{% tab title="409: Conflict los responsables no tienen permitido ver el grupo de cliente" %}

```javascript
{
    "success": false,
    "error": {
        "status": 409,
        "type": "CONFLICT",
        "userMessage": "Los usuarios con id 1,2. No tienen permitido ver el cliente"
    }
}
```

{% endtab %}
{% endtabs %}

### Ejemplo de request

En este ejemplo insertamos un seguimiento, que incluye envío de email 2 horas antes de la fecha del seguimiento.

### body

```json
{
    "title": "Llamar",
    "description": "Realizar nota de pedido",
    "uid_client": "CL-0044",
    "color": "ORANGE",
    "date": "2030-02-01T20:00:00.000Z",
    "responsible_user_ids": [1,2,52],
    "send_email_minutes_before": 120 
}
```

{% hint style="info" %}
**date:** Si bien la fecha esta representada en UTC, hay que considerarla en <mark style="color:blue;">**horario local**</mark>. Entonces para el caso del ejemplo, y sin importar si soy un cliente de Argentina, Ecuardor o Mexico, la fecha del evento representa el día 1 de Febrero de 2023 hora de mi país

```
"date": "2030-02-01T20:00:00.000Z",
```

{% endhint %}

### Analizando la Respuesta

En caso que no haya ningun error, obtenemos

```json
{
    "success": true,
    "data": {
        "id": 35,
        "uid_client": "CL-0044",
        "title": "Llamar",
        "description": "Realizar nota de pedido",
        "color": "ORANGE",
        "responsible_user_ids": [
            1,
            2,
            52
        ],
        "date": "2030-02-01T20:00:00.000Z",
        "send_email_minutes_before": 120,
        "send_email": true
    }
}
```

**id:** Identificador del seguimiento.

**uid\_client:** identificador alfanumérico del cliente.

&#x20;**title:** título del seguimiento.

**description:** descripción del seguimiento.

**color:** color del seguimiento.

**responsible\_user\_ids:** ids de los usuarios responsables del seguimiento.

**date:** fecha del seguimiento.

{% hint style="info" %}
Si bien la fecha esta representada en UTC, hay que considerarla en <mark style="color:blue;">**horario local**</mark>. Entonces para el caso del ejemplo, y sin importar si soy un cliente de Argentina, Ecuardor o Mexico, la fecha mostrada representa el día 1 de Febrero de 2023 hora de mi país

```
"date": "2030-02-01T20:00:00.000Z",
```

{% endhint %}

**send\_email:** booleano que indica si se enviará email

**send\_email\_minutes\_before:** los minutos previos a la fecha en los que se va a enviar un mail a los responsables en forma de aviso del seguimiento. En este ejemplo se enviaría el 2030-02-01T18:00:00.000Z.

{% hint style="danger" %}
**send\_email\_minutes\_before** solo estará presente cuando send\_email sea 'true'
{% endhint %}