# Integrar Dispositivos de Rastreo a Persat

Si lo que necesita es integrar su flota actual de vehículos a Persat, y ya cuenta con dispositivos de rastreo propios o brindados por un tercero, entonces este es el lugar indicado. 

Mediante el siguiente endpoint podrá enviar datos GPS para cada uno de sus dispositivos y luego visualizar los mismos en los mapas de Persat.

{% hint style="success" %}
Persat cuenta con una variedad de Partners de Rastreo autorizados. Consulte previamente los partners de Rastreo actuales para evitar tener que realizar esta integración por su cuenta.
{% endhint %}

{% hint style="danger" %} <mark style="color:red;">IMPORTANTE</mark>

Si la integración la realiza un tercero, es imperativo <mark style="color:red;">**no compartir**</mark> la API key con acceso TOTAL, sino que se debe compartir la Api Key con <mark style="color:green;">"Acceso restringido a insertar datos de Rastreo únicamente".</mark> [Ver Niveles de Acceso y Consideraciones Importantes](/como-usar-la-api/introduccion-1.md)
{% endhint %}

## Endpoint para enviar datos GPS

Para enviar un dato GPS para un dispositivo en Persat, se debe enviar una consulta POST como la que se especifica a continuación.

<mark style="color:blue;">`POST`</mark> `https://api.persat.com.ar/v1/devices-geoposition/device_id`

#### Path Parameters

| Name                                         | Type   | Description                                                                                                                                        |
| -------------------------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| device\_id<mark style="color:red;">\*</mark> | Number | Identificador del device. Se puede obtener la lista de Devices desde [Listar Dispositivos](/entidades-basicas/dispositivos/listar-dispositivos.md) |

#### Headers

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

#### Request Body

Objeto Json con los siguientes fields

<table><thead><tr><th width="203">Name</th><th width="128">Type</th><th>Description</th></tr></thead><tbody><tr><td>date<mark style="color:red;">*</mark></td><td>String</td><td>Fecha y hora, en formato <strong>yyyy-MM-ddTHH:mm:ss.SSSZ</strong>, indicando el momento en que se obtiene la posición GPS del vehículo.</td></tr><tr><td>lat<mark style="color:red;">*</mark></td><td>number</td><td>Número entre -90 y +90, representando la latitud</td></tr><tr><td>lng<mark style="color:red;">*</mark></td><td>number</td><td>Número entre -180 y + 180, representando la longitud</td></tr><tr><td>relative_odometer</td><td>number</td><td>Número [Opcional] representando el odómetro del vehiculo. En realidad no es el valor real del odometro, si no un valor de referencia que va aumentando con cada movimiento del vehiculo. Está representado en metros. La ventaja de utilizar este valor es que se puede hacer uso del módulo de <strong>Mantenimiento Preventivo</strong></td></tr></tbody></table>

### Ejemplo de body request

```json
{
    "date": "2024-06-06T13:35:21.000Z",
    "lat": -25.23123,
    "lng": 120.000023,
    "relative_odometer": 0
}
```

### Posbibles Respuestas

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

```json
{
    "success": true,
    "data": {}
}
```

{% endtab %}

{% tab title="400: Bad Request schema\_id no es un número" %}

```json
{
    "success": false,
    "error": {
        "status": 400,
        "type": "BAD_REQUEST",
        "userMessage": "'lng' invalido. Debe ser un number"
    }
}

```

{% endtab %}

{% tab title="404: Not Found No existe este tipo de formulario" %}

```json
{
    "success": false,
    "error": {
        "status": 404,
        "type": "NOT_FOUND",
        "userMessage": "No existe un device con este id"
    }
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %} <mark style="color:orange;">**IMPORTANTE:**</mark>

Persat realiza procesamiento digital de los datos GPS recibidos para evitar fluctuaciones rápidas o fallas de intermitencia. Es decir que es posible que, sobre todo para el caso en que se esten realizando pruebas, algunos de los valores enviados no aparezcan en el mapa.&#x20;

Se debe simular un recorrido "real" de un vehículo. Por ejemplo: no se debería enviar dos puntos GPS con 1 segundo de diferencia a 1 km de distancia, dado que no hay vehículo que cumpla con esos parámetros de velocidad.&#x20;
{% endhint %}


---

# 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.api.persat.com.ar/modulos/rastreo-satelital/integrar-dispositivos-de-rastreo-a-persat.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.