Pular para conteúdo

WS610 - Exportar relatório de Horário médio de Saída/Chegada por rota

Esta integração tem por objetivo exportar o relatório de Horário médio de Saída/Chegada por rota do Comprovei

Autenticação

  • As chamadas terão autenticação a nível de transporte (Basic Authentication);
  • Solicite o user / password ao administrador da conta.

Características

  • URL

    https://api.comprovei.com.br/api/1.1/util/export/routeInOutAvg

  • Método:

    POST

  • Parâmetro URL:

    Sem parâmetros

  • Exemplo:

    {
        "headers": {
            "username": "usuario",
            "password": "senha"
        },
        "body": {
            "formato_exportacao" : "xml",
            "filtros": {
                "data_inicial": "2020-01-01",
                "data_final": "2020-01-01",
                "codigo_transportador": ["String"],
                "regioes": ["String", "String2"],
            },
            "campos": [
                "Região/CD",
                "Rota/Roteiro",
                "Motorista",
                "Transportadora",
                "Meta Saída",
                "Média em Trânsito",
                "Fim Planejado",
                "Média de Chegada na Base",
                "Média de Clientes",
                "Última Ocorrência",
                "Tipo de Rota",
                "No. Embarcadores"
            ],
            "campos_inclusos": [
                "Tipo de Rota",
                "Meta Saída",
                "Fim Planejado",
                "Motorista"
            ]
        }
    }
    

    Importante

    • "campos" é usado para definir os nomes dos campos que devem ser utilizados na exportação. Nenhum campo deve ser adicionado ou retirado, apenas alterados.
    • O campo "campos" não deve ter sua ordem alterada, porém o nome dos campos pode ser alterado para a exportação.
    • Em "campos_inclusos" é possível selecionar quais campos e em que ordem eles serão exportados, os nomes dos campos devem ser iguais ao do campo "campos". Caso queira exportar todos os campos, não acrescentar "campos_inclusos".
    • Em "formato_exportação" é possível selecionar qual modelo da exportação, são aceitos: xml, xls, json e csv;

    Exemplo de Response

    • Sucesso:
      {
          "statusCode": 200,
          "headers": {
              "Content-Type": "application/json",
              "Access-Control-Allow-Origin": "*",
              "Access-Control-Allow-Credentials": true
          },
          "body": {
              "user_message": "https://comprovei.s3.amazonaws.com/producao/report_requests/export/21/routeExport-20200525192526.csv.zip?  X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAJELIIV2RATTMVK7A%2F20200525%2Fus-east-1%2Fs3%2Faws4_request&    X-Amz-Date=20200525T192538Z&X-Amz-Expires=259200&   X-Amz-Signature=19d54276cff1a3f1e074bac3e5f7737d670030f5bfb8267fbfebeb335a2dfca4&X-Amz-SignedHeaders=host",
              "code": 0,
              "internal_message": "Exportação gerada com sucesso!",
              "response_data": ""
          }
      }
      
    • Erro:

      {
          "statusCode": 400,
          "headers": {
              "Content-Type": "application/json",
              "Access-Control-Allow-Origin": "*",
              "Access-Control-Allow-Credentials": true
          },
          "body": {
              "message": "Não foram encontrados resultados para os filtros selecionados!"
          }
      }
      

    • Erro:

      {
          "statusCode": 400,
          "headers": {
              "Content-Type": "application/json",
              "Access-Control-Allow-Origin": "*",
              "Access-Control-Allow-Credentials": true
          },
          "body": {
              "message": "Algum campo de data está no formato errado. Tente (aaaa-mm-dd)"
          }
      }
      
      • Erro:
        {
            "statusCode": 400,
            "headers": {
                "Content-Type": "application/json",
                "Access-Control-Allow-Origin": "*",
                "Access-Control-Allow-Credentials": true
            },
            "body": {
                "message": "O intervalo de datas não pode ter mais de 31 dias"
            }
        }