Resumo de viagem

Baixar o registro resumido das viagens finalizadas em um período e cadastradas na Plataforma Milks.

Este método retorna os registros de viagens com a associação entre os registros das tabelas envolvidas e o resumo geral de totalização de volume, distância percorrida, distância rastreada, dados da descarga entre outros. Exemplo: No lugar do identificador do agente de coleta que realizou a viagem, retorna o código e o nome deste agente, relacionado com o registro no ERP.

Método POST

http://app.milksrota.com.br/api/retaguardasync/readResumoViagem

Requisição

Dados da requisição

{
    "conta_id": "DDDD",
    "token": "xxxx-xxxx-xxxx-xxxx",
    "doc": "99.999.999/9999-99 ,
    "dt_inicio": "2020-08-09 00:00:01",
    "dt_fim": "2020-08-09 23:59:59"
}

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.

Resposta

200: Registros localizados

{
    "success": true,
    "message": "OK",
    "data": [
        {
            "id": "218663", // Identificador da vaigem
            "dt_abertura": "2020-08-09 07:31:08", // Inicio viagem
            "dt_fechamento": "2020-08-09 10:30:46", // Fim viagem
            "dt_liberacao": null, // Data liberação
            "km_inicial": "291800", 
            "km_final": "291884",
            "km_distancia": "84",
            "programacao": "0",
            "codigo_programacao": "0",
            "dt_sincronizacao": "2020-08-18 11:58:00",
            "descarregada": 0,
            "rastreada": "0",
            "km_rastreado": 0,
            "veiculo_placa": "KXM5I42",
            "veiculo_codigo": "V-001",
            "linha_codigo": "28",
            "linha_nome": "BARREIRO",
            "linha_id": "7008",
            "km_adicional": null,
            "rota_codigo": "5",
            "rota_nome": "USINA QUELUZ",
            "tipo_descarga": "TP",
            "coletor_codigo": "004",
            "coletor_nome": "CLEBER SOARES DOS SANTOS",
            "tecnico_codigo": null,
            "tecnico_nome": null,
            "coletas_realizadas": "2",
            "coletas_canceladas": "22",
            "coletas_pendentes": 20,
            "volume_coletado": "4926",
            "volume_descartado": 0,
            "volume_aferido": null,
            "atesto": -4926,
            "completa": "0"
        },
        {
            "id": "218666",
            "dt_abertura": "2020-08-09 04:43:58",
            "dt_fechamento": "2020-08-09 10:38:44",
            "dt_liberacao": null,
            "km_inicial": "410240",
            "km_final": "410345",
            "km_distancia": "105",
            "programacao": "0",
            "codigo_programacao": "0",
            "dt_sincronizacao": "2020-08-18 11:58:00",
            "descarregada": 0,
            "rastreada": "0",
            "km_rastreado": 0,
            "veiculo_placa": "LQS5J40",
            "veiculo_codigo": "V-011",
            "linha_codigo": "27",
            "linha_nome": "SERTAO VELHO/LORENA",
            "linha_id": "5762",
            "km_adicional": null,
            "rota_codigo": "5",
            "rota_nome": "USINA QUELUZ",
            "tipo_descarga": "TP",
            "coletor_codigo": "012",
            "coletor_nome": "JOSE LUIZ DE ANDRADE CARDOSO",
            "tecnico_codigo": null,
            "tecnico_nome": null,
            "coletas_realizadas": "0",
            "coletas_canceladas": "58",
            "coletas_pendentes": 52,
            "volume_coletado": null,
            "volume_descartado": 0,
            "volume_aferido": null,
            "atesto": 0,
            "completa": "0"
        }
    ],
    "monitor.time": 0.10523581504822
}

Os registros de viagens cadastradas na plataforma Milk's foram retornados com sucesso.

404: Conta não localizada

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

O que isso significa? Significa que o ID da conta não foi localizado na Plataforma Milk's.

403: Token inválido

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

O que isso significa? Significa que o token informado na requisição não corresponde ao token cadastrado para a conta.

Last updated