# Leer excursiones

> ## Método POST
>
> <http://app.milksrota.com.br/api/retaguardasync/readViagem>

## Requisição

### Dados da requisição

```javascript
{
    "conta_id": "DDDD",
    "token": "xxxx-xxxx-xxxx-xxxx",
    "doc": "99.999.999/9999-99 ,
    "dt_inicio": "2020-08-19",
    "dt_fim": "2020-08-21"
}
```

{% hint style="info" %}
**conta\_id**: Deve ser informado o ID da conta que você encontra na tela ***"Sua conta"*** no menu principal no painel do Milk's Rota.

**token**: Deve ser informado o Token da conta, que você encontra na tela ***"Sua conta"*** no menu principal no painel do Milk's Rota.

**doc:** Deve ser informado o CNPJ da conta cadastra. Pode ser encontrado na tela *"sua conta"* no menu principal do painel Milk's Rota.

**dt\_inicio:** Data inicial do período que se deseja consultar as viagens finalizadas.

**dt\_fim:** Data final do período que se deseja consultar as viagens finalizadas.
{% endhint %}

## Resposta

### 200: Registros localizados

```javascript
{
    "success": true,
    "message": "OK",
    "data": [
        {
            "id": "213858", // Chave Primária e identificador da viagem
            "veiculo_id": "1334", 
            "coletor_id": "1933",
            "linha_id": "2679",
            "rota_id": "211",
            "conta_id": "40001", // Identificador da conta
            "dt_fechamento": "2020-07-20 09:18:21", // Fim viagem
            "dt_push": null,
            "dt_abertura": "2020-07-20 09:08:59", // Inicio viagem
            "km_inicial": "1",  // Km inicio da viagem
            "km_final": "2",    // Km final da viagem
            "km_distancia": "1", // Distância percorrida
            "km_justificativa": null,// Justificativa km na viagem
            "descarregada": null, // Viagem descarregada = 1
            "dt_descarga": null, // Data da descarga
            "liberada": "0", // Viagem liberada pelo operarod
            "dt_liberacao": null, // Data da liberação da viagem
            "tecnico_id": null,
            "coletado": null,  // Volume total coletado
            "descarregado": null, // Volume total descarregado
            "diferenca": null,  // Diferença (atesto)
            "removida": "0",  // viagem removida 
            "token": "40001.2788.200720-0908", 
            "app_version": "0.91.0", // Versão do app coletor
            "dispositivo_id": null, 
            "foto_km_inicial": null,
            "foto_km_final": null,
            "programacao": null, // Numero da programação (ERP) 
            "distancia_mt": "0", // distância rastreada
            "velocidade_media_mt": "0", 
            "velocidade_maxima_mt": "0", 
            "tracker_unique_id": null, // não utilizado
            "km_valor": null, // não utilizado
            "dt_criacao": null,
            "dt_atualizacao": "2020-07-20 14:46:11",
            "dt_exclusao": null,
            "rastreada": "1",  // Viagem rastreada 1 = sim 
            "dt_data": "2020-07-18 18:41:06", // Data base dados app coletor
            "codigo_programacao": "undefined",
            "dt_sincronizacao": null, // Data sincronização com ERP
            "android_boots": "0", // Vezes em que o celular foi reiniciado na viagem
            "rota": "001",  // Rota no ERP
            "veiculo": "00005", // Veiculo no ERP
            "linha": "0033", // Linha no ERP
            "coletor": "000386", // Motorista no ERP
            "comunitario_pendente": false, // Pendencia de distribuicao de tanque coletivo
            "bocas": 0, // Compartimento onde o leite foi armazenado
            "tanques": 0 // Numero de tanque coletados
        },
    ],
    "monitor.time": 0.10523581504822
}
```

{% hint style="success" %}
Os registros de viagens cadastradas na plataforma Milk's foram retornados com sucesso.
{% endhint %}

### 404: Conta não localizada

```javascript
{    
    "success": false,
    "message": "Conta não localizada",
    "data": [],
    "monitor.time": 2.14737200737 // Tempo de execução
}
```

{% hint style="danger" %}
**O que isso significa?** Significa que o ID da conta não foi localizado na Plataforma Milk's.
{% endhint %}

### 403: Token inválido

```javascript
{
    "success": false,
    "message": "Token inválido",
    "data": [],
    "monitor.time": 2.14737200737 // Tempo de execução
}
```

{% hint style="danger" %}
**O que isso significa?** Significa que o token informado na requisição não corresponde ao token cadastrado para a conta.
{% endhint %}