Manual de Consulta e Laudo de Motoristas Autônomos - VX Consult

VERSÃO 12/02/2026


Status de Pesquisa:


URL base:

https://api-hml.vxconsult.com.br/


🔎 Busca de Pesquisas do Motorista por CPF:

[POST] /api/users-permissions/consultar


ID Descrição
1 AUTÔNOMO - R$ 0,01 a R$60.000,00
3 AUTÔNOMO - R$ 0,01 a R$100.000,00
4 AUTÔNOMO - R$ 0,01 a R$300.000,00
5 AUTÔNOMO - R$ 0,01 a R$600.000,00 / APÓLICE

Campo (JSON):

cpf


Exemplo 1️⃣:


                {
                    "cpf": "378.304.448-03"
                }
                

Exemplo de resposta 1️⃣:


                {
                "data": {
                "pesquisas": [
                    {
                        "id": "189371",
                        "cpf": "378.304.448-03",
                        "data_pesquisa": "2025-05-22T15:38:12-03:00",
                        "autorizacao_s3":
                        "https://s3.sa-east-1.amazonaws.com/vx-consult-bucket-plataforma/pesquisas/autorizacao-189371.pdf",
                        "status": "Concluído",
                        "cavalo_placa": "AAA0000",
                        "carreta1_placa": null,
                        "carreta2_placa": null,
                        "carreta3_placa": null,
                        "perfil": "Autônomo",
                        "validade": "2025-08-21T15:38:12-03:00",
                        "dentro_validade": true,
                        "dias_expirar": 7862400000,
                        "pagina_renova": "https://plataforma.vxconsult.com.br/cliente/pesquisa-view.php?p=189371"
                    },
                    {
                        "id": "189371",
                        "cpf": "378.304.448-03",
                        "data_pesquisa": "2025-05-22T15:38:12-03:00",
                        "autorizacao_s3":
                        "https://s3.sa-east-1.amazonaws.com/vx-consult-bucket-plataforma/pesquisas/autorizacao-189371.pdf",
                        "status": "Concluído",
                        "cavalo_placa": "AAA0000",
                        "carreta1_placa": "",
                        "carreta2_placa": null,
                        "carreta3_placa": null,
                        "perfil": "Autônomo",
                        "validade": "2025-08-21T15:38:12-03:00",
                        "dentro_validade": true,
                        "dias_expirar": 7862400000,
                        "pagina_renova": "https://plataforma.vxconsult.com.br/cliente/pesquisa-view.php?p=189371"
                    },
                    {
                        "id": "189371",
                        "cpf": "378.304.448-03",
                        "data_pesquisa": "2025-05-22T15:38:12-03:00",
                        "autorizacao_s3":
                        "https://s3.sa-east-1.amazonaws.com/vx-consult-bucket-plataforma/pesquisas/autorizacao-189371.pdf",
                        "status": "Concluído",
                        "cavalo_placa": "AAA0000",
                        "carreta1_placa": "",
                        "carreta2_placa": "",
                        "carreta3_placa": null,
                        "perfil": "Autônomo",
                        "validade": "2025-08-21T15:38:12-03:00",
                        "dentro_validade": true,
                        "dias_expirar": 7862400000,
                        "pagina_renova": "https://plataforma.vxconsult.com.br/cliente/pesquisa-view.php?p=189371"
                    },
                    {
                        "id": "189371",
                        "cpf": "378.304.448-03",
                        "data_pesquisa": "2025-05-22T15:38:12-03:00",
                        "autorizacao_s3":
                        "https://s3.sa-east-1.amazonaws.com/vx-consult-bucket-plataforma/pesquisas/autorizacao-189371.pdf",
                        "status": "Concluído",
                        "cavalo_placa": "AAA0000",
                        "carreta1_placa": "",
                        "carreta2_placa": "",
                        "carreta3_placa": "",
                        "perfil": "Autônomo",
                        "validade": "2025-08-21T15:38:12-03:00",
                        "dentro_validade": true,
                        "dias_expirar": 7862400000,
                        "pagina_renova": "https://plataforma.vxconsult.com.br/cliente/pesquisa-view.php?p=189371"
                    },
                    {
                        "id": "188473",
                        "cpf": "378.304.448-03",
                        "data_pesquisa": "2024-08-08T15:53:37-03:00",
                        "autorizacao_s3":
                        "https://s3.sa-east-1.amazonaws.com/vx-consult-bucket-plataforma/pesquisas/autorizacao-188473.pdf",
                        "status": "Concluído",
                        "cavalo_placa": null,
                        "carreta1_placa": null,
                        "carreta2_placa": null,
                        "carreta3_placa": null,
                        "perfil": "Autônomo",
                        "validade": "2024-11-07T15:53:37-03:00",
                        "dentro_validade": false,
                        "dias_expirar": 7862400000,
                        "pagina_renova": "https://plataforma.vxconsult.com.br/cliente/pesquisa-view.php?p=188473"
                    },
                    {
                        "id": "188325",
                        "cpf": "378.304.448-03",
                        "data_pesquisa": "2024-07-31T16:01:46-03:00",
                        "autorizacao_s3":
                        "https://s3.sa-east-1.amazonaws.com/vx-consult-bucket-plataforma/pesquisas/autorizacao-188325.pdf",
                        "status": "Concluído",
                        "cavalo_placa": null,
                        "carreta1_placa": "GFY1G86",
                        "carreta2_placa": "GFY1G86",
                        "carreta3_placa": null,
                        "perfil": "Autônomo",
                        "validade": "2024-10-30T16:01:46-03:00",
                        "dentro_validade": false,
                        "dias_expirar": 7862400000,
                        "pagina_renova": "https://plataforma.vxconsult.com.br/cliente/pesquisa-view.php?p=188325"
                    }
                ]
                    },
                        "message": "Pesquisa encontrada"
                    }
                

🔎 É possível filtrar as pesquisas com esse CPF incluindo as placas a serem buscadas:

Exemplo 2️⃣:


                {
                    "cpf": "378.304.448-03",
                    "placas": ["AAA0000"]
                }
                

Exemplo de resposta 2️⃣:


                {
            "data": {
            "pesquisas": [
                    {
                    "id": "189371",
                    "cpf": "378.304.448-03",
                    "data_pesquisa": "2025-05-22T15:38:12-03:00",
                    "autorizacao_s3":
                    "https://s3.sa-east-1.amazonaws.com/vx-consult-bucket-plataforma/pesquisas/autorizacao-189371.pdf",
                    "status": "Concluído",
                    "cavalo_placa": "AAA0000",
                    "carreta1_placa": "",
                    "carreta2_placa": "",
                    "carreta3_placa": "",
                    "perfil": "Autônomo",
                    "validade": "2025-08-21T15:38:12-03:00",
                    "dentro_validade": true,
                    "temporario": false,
                    "pagina_renova": "https://plataforma.vxconsult.com.br/cliente/pesquisa-view.php?p=189371"
                    }
                    ]
                },
                    "message": "Pesquisa encontrada"
                }
            


🖥️ Gerar Nova Consulta e Retornar o Laudo:

[POST] /api/users-permissions/gerarLaudoConsulta


Corpo (JSON) pesquisa: ID da pesquisa:


                {
                    "pesquisa": "188473"
                        "origem_cidade_carga": "Piracicaba",
                        "origem_estado_carga": "SP",
                        "destino_cidade_carga": "Uberaba",
                        "destino_estado_carga": "MG",
                        "tipo_mercadoria": 12,
                        "valor": 4
                }
            

Exemplo de resposta (sucesso):


                {
                    "consulta": "181962",
                    "laudo":
                    "https://s3.sa-east-1.amazonaws.com/vx-consult-bucket-plataforma/consulta/autorizacao-consulta-181962.pdf",
                    "validade": "2025-11-15T15:44:12-03:00"
                }
            

Exemplo de resposta (erro - pesquisa invalida ou pesquisa fora da data):


                {
                    "data": null,
                    "error": 
                        {
                            "status": 400,
                            "name": "BadRequestError",
                            "message": "Nenhuma pesquisa válida encontrada para pesquisa 1893711",
                            "details": {}
                        }
                }
            


♻️ Renovar pesquisa:

[POST] /api/users-permissions/renovarPesquisa


Corpo de requisição (pesquisa precisa ser um ID válido, retornado depois de consultar o CPF)


                {
                    "pesquisa": "189371"
                }
            

Exemplo de requisição (sucesso):


                {
                    "pesquisa": "207573",
                    "pesquisaURL": "url",
                    "message": "Pesquisa renovada com sucesso!"
                }
                

Exemplo de requisição (ID de pesquisa não encontrada):


                {
                    "data": null,
                    "error": {
                    "status": 400,
                    "name": "BadRequestError",
                    "message": "Pesquisa não encontrada",
                    "details": {}
                    }
                }
                

🔎 Buscar padrão de pesquisa:

[POST] /api/users-permissions/buscaPadraoPesquisa


Exemplo de resposta:


                {
                            "padrao": [
                        {
                            "id": "522",
                            "titulo": "Básica"
                        },
                        {
                            "id": "523",
                            "titulo": "Completa"
                        },
                        {
                            "id": "524",
                            "titulo": "Completa RDO"
                        }
                    ]
                }
                


🚚 Criar pesquisa (até 3 carretas para cada pesquisa):

[POST] /api/users-permissions/criarPesquisa


Enviar:

Padrão => ID de um padrão válido retornado em


                    buscaPadraoPesquisa
                

Tipo_motorista:


                1: Autonomo
                2: RH
                3: Frota
                4: Agregado
                


Exemplo de requisição:


                {
                "padrao": "524",
                "tipo_motorista": "1",
                "motorista": {
                    "nome_completo": "TESTE CELSO",
                    "cpf": "37830444803",
                    "rg": "1234250123",
                    "cnh": "02513123254",
                    "cep": "99240000",
                    "logradouro": "Distrito d Santa Barbara ",
                    "numero": "1",
                    "complemento": "",
                    "bairro": "Interior ",
                    "cidade": "São Valentim do Sul",
                    "estado": "RS",
                    "telefone_residencial": "Vagner trentin ",
                    "telefone_residencial_contato": "54999138845",
                    "telefone_comercial": "",
                    "telefone_comercial_contato": "",
                    "telefone_referencia": "",
                    "telefone_referencia_contato": "(54) 99658-1956"
                },
                "cavalo": {
                    "nome_proprietario": "TRANS ETC LTDA",
                    "rntc_proprietario": "0310204500",
                    "cpf_cnpj_proprietario": "31.701.111/0001-02",
                    "telefone_residencial_proprietario": "Etc ",
                    "telefone_residencial_contato_proprietario": "(54) 98125-7772",
                    "telefone_comercial_proprietario": "Abc ",
                    "telefone_comercial_contato_proprietario": "(54) 98125-7772",
                    "placa": "AAA0A00"
                },
                "carretas": [
                    {
                    "nome_proprietario": "TRANS ETC LTDA",
                    "rntc_proprietario": "0310204500",
                    "cpf_cnpj_proprietario": "31.701.111/0001-02",
                    "telefone_residencial_proprietario": "Etc ",
                    "telefone_residencial_contato_proprietario": "(54) 98125-7772",
                    "telefone_comercial_proprietario": "Abc ",
                    "telefone_comercial_contato_proprietario": "(54) 98125-7772",
                    "placa": "AAA0A00"
                    }
                ],
                "arquivos": [
                    {
                    "title": "Comprovante de Endereco",
                    "path": "URL_PUBLIC"
                    },
                    {
                    "title": "CNH",
                    "path": "URL_PUBLIC"
                    },
                    {
                    "title": "Veículo",
                    "path": "URL_PUBLIC"
                    },
                    {
                    "title": "Documento Cavalo",
                    "path": "URL_PUBLIC"
                    },
                    {
                    "title": "Documento Carreta",
                    "path": "URL_PUBLIC"
                    }
                ]
                }
                


Exemplo de sucesso:


                {
                    "pesquisa": "901444",
                    "message": "Pesquisa criada com sucesso"
                }
                


Exemplo de falha:


                {
                    "pesquisa": false,
                    "message": "Erro: motorista já com pesquisa ativa"
                }
                


💻 Acompanhamento de pesquisa ativa:

[POST] api/users-permissions/pesquisaAtiva


Exemplo de requisição:


                {
	                "pesquisa": "207735"
                }
                


Exemplo de resposta:


                {
                    "pesquisa": {
                        "id": "207735",
                        "cpf": "378.304.448-03",
                        "data_pesquisa": "1751054896",
                        "autorizacao_s3": null,
                        "status": "Em Análise",
                        "tipo": "1",
                        "cavalo_placa": "AAA0A00",
                        "carreta1_placa": "AAA0A00",
                        "carreta2_placa": "AAA0A00",
                        "carreta3_placa": "AAA0A00",
                        "perfil": "Autônomo"
                    }
                }

                


Exemplo de resposta (erro):


                {
                    "pesquisa": false,
                    "message": "Pesquisa inexistente"
                }
                

📦 Busca por Tipo de Carga

[GET] api/users-permissions/buscaTiposCarga


Exemplo de resposta:


            {
                "padrao": [
                    {
                        "id": "1",
                        "titulo": "Perecíveis"
                    },
                    {
                        "id": "2",
                        "titulo": "Congelados"
                    },
                    {
                        "id": "3",
                        "titulo": "Granel Líquido"
                    },
                    {
                        "id": "4",
                        "titulo": "Granel Sólido"
                    },
                    {
                        "id": "6",
                        "titulo": "Máquinas Agrícolas"
                    },
                    {
                        "id": "7",
                        "titulo": "Encanamentos"
                    },
                    {
                        "id": "8",
                        "titulo": "Madeiras"
                    },
                    {
                        "id": "9",
                        "titulo": "Explosivos"
                    },
                    {
                        "id": "10",
                        "titulo": "Gases Inflamáveis"
                    },
                    {
                        "id": "12",
                        "titulo": "ALGODÃO"
                    },
                    {
                        "id": "13",
                        "titulo": "Soja"
                    },
                    {
                        "id": "14",
                        "titulo": "Milho"
                    },
                    {
                        "id": "15",
                        "titulo": "AÇÚCAR"
                    },
                    {
                        "id": "16",
                        "titulo": "Etanol"
                    },
                    {
                        "id": "17",
                        "titulo": "Gasolina"
                    },
                    {
                        "id": "18",
                        "titulo": "Óleo Diesel"
                    },
                    {
                        "id": "19",
                        "titulo": "AÇO"
                    },
                    {
                        "id": "20",
                        "titulo": "Ferro"
                    },
                    {
                        "id": "21",
                        "titulo": "ALUMÍNIO"
                    },
                    {
                        "id": "22",
                        "titulo": "Medicamentos"
                    },
                    {
                        "id": "23",
                        "titulo": "CELULARES"
                    },
                    {
                        "id": "24",
                        "titulo": "COBRE"
                    },
                    {
                        "id": "26",
                        "titulo": "Estanho"
                    },
                    {
                        "id": "27",
                        "titulo": "Níquel"
                    },
                    {
                        "id": "28",
                        "titulo": "CHUMBO"
                    },
                    {
                        "id": "30",
                        "titulo": "Shampoo"
                    },
                    {
                        "id": "31",
                        "titulo": "Teste"
                    },
                    {
                        "id": "32",
                        "titulo": "Sementes"
                    },
                    {
                        "id": "33",
                        "titulo": "Grãos"
                    },
                    {
                        "id": "35",
                        "titulo": "Diversos"
                    },
                    {
                        "id": "36",
                        "titulo": "Sementes de Soja"
                    },
                    {
                        "id": "37",
                        "titulo": "Milheto"
                    },
                    {
                        "id": "38",
                        "titulo": "CAROÇO DE ALGODÃO"
                    },
                    {
                        "id": "39",
                        "titulo": "Zirgônio"
                    },
                    {
                        "id": "40",
                        "titulo": "BEBIDAS"
                    },
                    {
                        "id": "41",
                        "titulo": "Tarugo de ferro"
                    },
                    {
                        "id": "42",
                        "titulo": "Sucata Ferrosa"
                    },
                    {
                        "id": "43",
                        "titulo": "Papel"
                    },
                    {
                        "id": "44",
                        "titulo": "BORRACHA"
                    },
                    {
                        "id": "45",
                        "titulo": "ADUBO"
                    },
                    {
                        "id": "46",
                        "titulo": "Fertilizantes"
                    },
                    {
                        "id": "47",
                        "titulo": "Óxido de Ferro"
                    },
                    {
                        "id": "48",
                        "titulo": "Peças automotivas"
                    },
                    {
                        "id": "49",
                        "titulo": "Outros"
                    },
                    {
                        "id": "50",
                        "titulo": "Porco"
                    },
                    {
                        "id": "51",
                        "titulo": "Ração"
                    },
                    {
                        "id": "52",
                        "titulo": "Descartáveis Hospitalares"
                    },
                    {
                        "id": "53",
                        "titulo": "CAMA - MESA - BANHO"
                    },
                    {
                        "id": "54",
                        "titulo": "Leite"
                    },
                    {
                        "id": "56",
                        "titulo": "ÁGUA"
                    },
                    {
                        "id": "57",
                        "titulo": "Polietileno"
                    },
                    {
                        "id": "58",
                        "titulo": "ARROZ"
                    },
                    {
                        "id": "59",
                        "titulo": "CAFÉ"
                    },
                    {
                        "id": "60",
                        "titulo": "Feijão "
                    },
                    {
                        "id": "61",
                        "titulo": "Vergalhão de ferro"
                    },
                    {
                        "id": "62",
                        "titulo": "Eletrodomésticos "
                    },
                    {
                        "id": "63",
                        "titulo": "Reciclagem "
                    },
                    {
                        "id": "64",
                        "titulo": "Suco"
                    },
                    {
                        "id": "65",
                        "titulo": "Farelo de Soja"
                    },
                    {
                        "id": "66",
                        "titulo": "Gado Bovino"
                    },
                    {
                        "id": "67",
                        "titulo": "Sorgo em Grãos"
                    },
                    {
                        "id": "68",
                        "titulo": "BOBINAS DE PAPEL"
                    },
                    {
                        "id": "70",
                        "titulo": "Vidro"
                    },
                    {
                        "id": "71",
                        "titulo": "CHAPAS DE MDF"
                    },
                    {
                        "id": "72",
                        "titulo": "AÇÚCAR ENSACADO"
                    },
                    {
                        "id": "73",
                        "titulo": "Tubo de Aço"
                    },
                    {
                        "id": "74",
                        "titulo": "Sucata ferrosa"
                    },
                    {
                        "id": "75",
                        "titulo": "Pallets de Madeira"
                    },
                    {
                        "id": "76",
                        "titulo": "Postes de Concreto"
                    },
                    {
                        "id": "77",
                        "titulo": "CALCÁRIO"
                    },
                    {
                        "id": "78",
                        "titulo": "Emabalagens"
                    },
                    {
                        "id": "79",
                        "titulo": "Embalagens"
                    },
                    {
                        "id": "80",
                        "titulo": "Estrutura Metálica"
                    },
                    {
                        "id": "81",
                        "titulo": "Trélica"
                    },
                    {
                        "id": "82",
                        "titulo": "Soja em grãos"
                    },
                    {
                        "id": "84",
                        "titulo": "ALIMENTOS"
                    },
                    {
                        "id": "85",
                        "titulo": "Tecidos"
                    },
                    {
                        "id": "86",
                        "titulo": "Colagem"
                    },
                    {
                        "id": "87",
                        "titulo": "Dry Mont"
                    },
                    {
                        "id": "88",
                        "titulo": "Transformador"
                    },
                    {
                        "id": "89",
                        "titulo": "CLORETO DE POTÁSSIO"
                    },
                    {
                        "id": "90",
                        "titulo": "Refrigerante"
                    },
                    {
                        "id": "91",
                        "titulo": "Sofá"
                    },
                    {
                        "id": "92",
                        "titulo": "Pisos para amostra"
                    },
                    {
                        "id": "94",
                        "titulo": "Haste de bombeio"
                    },
                    {
                        "id": "95",
                        "titulo": "Leite em pó"
                    },
                    {
                        "id": "96",
                        "titulo": "Creme de leite "
                    },
                    {
                        "id": "97",
                        "titulo": "ÁGUA DE CÔCO"
                    },
                    {
                        "id": "98",
                        "titulo": "Tecido "
                    },
                    {
                        "id": "99",
                        "titulo": "Sucata de papelão"
                    },
                    {
                        "id": "102",
                        "titulo": "Refrigerante"
                    },
                    {
                        "id": "103",
                        "titulo": "Garrafa de vidro "
                    },
                    {
                        "id": "104",
                        "titulo": "BOBINAS DE ALUMÍNIO "
                    },
                    {
                        "id": "105",
                        "titulo": "Sucata de alumínio"
                    },
                    {
                        "id": "106",
                        "titulo": "Soja em grãos"
                    },
                    {
                        "id": "107",
                        "titulo": "ALGODÃO EM PLUMA"
                    },
                    {
                        "id": "108",
                        "titulo": "Coco Ralado"
                    },
                    {
                        "id": "110",
                        "titulo": "URÉIA FERTILIZANTE"
                    },
                    {
                        "id": "111",
                        "titulo": "Sandálias"
                    },
                    {
                        "id": "112",
                        "titulo": "Gesso"
                    },
                    {
                        "id": "113",
                        "titulo": "Gergelim"
                    },
                    {
                        "id": "114",
                        "titulo": "Fraldas"
                    },
                    {
                        "id": "115",
                        "titulo": "Preforma"
                    },
                    {
                        "id": "116",
                        "titulo": "ENERGÉTICO "
                    },
                    {
                        "id": "117",
                        "titulo": "RED BULL"
                    },
                    {
                        "id": "118",
                        "titulo": "DESTILADOS"
                    },
                    {
                        "id": "119",
                        "titulo": "VINHO"
                    },
                    {
                        "id": "120",
                        "titulo": "WHISKY"
                    },
                    {
                        "id": "121",
                        "titulo": "GIN"
                    },
                    {
                        "id": "122",
                        "titulo": "PANETONE"
                    },
                    {
                        "id": "123",
                        "titulo": "BOBINAS DE AÇO"
                    },
                    {
                        "id": "124",
                        "titulo": "TARUGO"
                    },
                    {
                        "id": "125",
                        "titulo": "AMACIANTE"
                    },
                    {
                        "id": "126",
                        "titulo": "DETERGENTE"
                    },
                    {
                        "id": "127",
                        "titulo": "CERVEJA"
                    },
                    {
                        "id": "129",
                        "titulo": "CHAPAS DE AÇO"
                    },
                    {
                        "id": "130",
                        "titulo": "POLIETILENO "
                    },
                    {
                        "id": "131",
                        "titulo": "VENTILADORES"
                    },
                    {
                        "id": "132",
                        "titulo": "MICROONDAS"
                    },
                    {
                        "id": "133",
                        "titulo": "ÓLEO DE SOJA"
                    },
                    {
                        "id": "134",
                        "titulo": "AZEITE"
                    },
                    {
                        "id": "135",
                        "titulo": "PRODUTOS NESTLÉ"
                    },
                    {
                        "id": "136",
                        "titulo": "SEMENTE DE CHIA"
                    },
                    {
                        "id": "137",
                        "titulo": "EMPILHADEIRA / MÁQUINA"
                    },
                    {
                        "id": "138",
                        "titulo": "AMIDO DE MILHO"
                    },
                    {
                        "id": "139",
                        "titulo": "AÇÚCAR ENSACADO EM BAG"
                    },
                    {
                        "id": "140",
                        "titulo": "ARROZ ENSACADO"
                    },
                    {
                        "id": "141",
                        "titulo": "PALLET DE CERVEJA"
                    },
                    {
                        "id": "142",
                        "titulo": "ARGAMASSA"
                    },
                    {
                        "id": "143",
                        "titulo": "CAIXA PLASTICA VAZIA PARA CERVEJA"
                    },
                    {
                        "id": "144",
                        "titulo": "PALETE DE CERVEJA VAZIO "
                    },
                    {
                        "id": "145",
                        "titulo": "VASILHAMES "
                    }
                ]
            }