Web Service Cadastro Bearer Token
Considerações Iniciais
O objetivo deste documento é fornecer orientações aos desenvolvedores e partes interessadas sobre a integração com o Web Service do sistema CADASTRO da TECNORISK.
Regras
A fim de atender com exatidão os procedimentos adotados no setor de análise cadastral da TECNORISK, o integrador emprega algumas regras que devem ser respeitadas.
| Serviço | Descrição | ||
|---|---|---|---|
| FICHA | Se tipo do motorista for agregado então é necessário no mínimo 12 embarques para envio de ficha. | ||
| * | Se tipo do motorista for terceiro, é obrigatório referência comercial. | ||
| * | Para o sistema aceitar referências pessoais e/ou comerciais, é necessário não possuir liberação nos últimos 6 meses. | ||
| * | Se tipo do motorista for veículo-frota, o CPF do motorista obrigatoriamente deve ser '222.222.222-22'. | ||
| * | Se tipo do motorista for terceiro, é obrigatório veículo e mercadoria. | ||
| * | Se tipo do motorista for veículo-frota, é obrigatório veículo. | ||
(*) FICHA
Endereços Web Service
URL {Homologação}
https://ws.tecnorisk.com.br/homologacao/cadastro
URL {Produção}
https://ws.tecnorisk.com.br/cadastro
As credenciais para utilizar esses ambientes devem ser solicitadas diretamente à equipe de T.I. da TECNORISK por meio do email: sistemas@tecnorisk.com.br.
Autenticação
POST /auth
Nossa autenticação utiliza o Token para acessar o restante dos nossos serviços.
O token tem uma duração de 10 minutos sendo o contador renovado a cada interação em qualquer dos endpoints.
É preciso passar no Header a key : "Authorization" com o valor : "O token gerado" para avançar nos demais endpoints. Conforme exemplo abaixo:
CURL
CURLOPT_HTTPHEADER => [
"Authorization: 401925901dc0c90d4f7c09e07919c844",
"Content-Type: application/json"
]No exemplo acima foi passado via Curl, mas pode ser adaptado para linguagens de programação.
Parâmetros Disponíveis
| # | Parâmetro | Tipo | Descrição | Exemplo |
|---|---|---|---|---|
| 1 | username {obrigatório} | String | Usuário de acesso | teste |
| 2 | password {obrigatório} | String | Senha de acesso | 123456 |
URL autenticação POST
https://ws-cadastro.tecnorisk.com.br/auth
JSON Request
{
"username" : "seu_usuario",
"password" : "sua_senha"
}JSON Response
{
"Token": "3bfc2216ac331b50477561278c75f2f4"
}Dependências
| Nome | Descrição | URL | Parâmetros |
|---|---|---|---|
| transportadora_id | Recupera ID da transportadora utilizando como base o CNPJ desta. | /transportadora/ | cnpj={1} |
| unidade_transporte_id | Recupera ID da unidade de transporte utilizando como base o CNPJ desta. | /unidade_transporte/ | cnpj={1} |
| tipo_motorista | Lista dos tipos de motoristas disponibilizados pelo sistema. | /tipo_motorista | - |
| parentesco_referencia_pessoal | Lista dos parentescos para referência pessoal do motorista. | /parentesco_referencia_pessoal | - |
| tipo_contato_referencia_comercial | Lista dos tipos de contato para referência comercial do motorista. | /tipo_referencia_comercial | - |
| rastreador | Lista dos rastreadores para o veículo cavalo disponibilizados pelo sistema. | /rastreador | - |
| mercadoria | Lista das mercadorias disponibilizadas pelo sistema. | /mercadoria | - |
| tipo_nacionalidade, nacionalidade | Lista de nacionalidades para motoristas e veículos. | /tipo_nacionalidade | - |
| pais_motorista, pais_residencia, pais | Lista de países disponíveis no sistema. | /paises | - |
| estado_emissor_rg, estado, estado_emissor | Lista de estados disponíveis no sistema, de acordo com a nacionalidade do motorista. | /estados, /estados_estrangeiros | - |
| cidade | Lista de cidades disponíveis no sistema, de acordo com a nacionalidade do motorista. | /cidades, /cidades_estrangeiras | - |
| categoria | Lista de categorias da CNH disponíveis no sistema. | /categoria_cnh | - |
| tipo | Lista de tipos de veículos disponíveis no sistema. | /tipo_veiculo | - |
| marca | Lista de marcas disponíveis no sistema, tanto brasileiras quanto estrangeiras. | /marcas | - |
| modelo | Lista de modelos disponíveis no sistema, tanto brasileiras quanto estrangeiras. | /modelos/ | marca={1} |
| cor | Lista de cores disponíveis no sistema. | /cor | - |
| tipo_arquivo | Lista de tipos de arquivos para envio em anexo | /tipo_arquivo | - |
Lista de Parâmetros
| Parâmetro | Descrição |
|---|---|
| cnpj={1} | Número do CNPJ da transportadora ou unidade de transporte. |
| marca={1} |
Código de uma marca válida. GET /marcas para lista disponível. |
Envio de Ficha
POST /ficha
Conjunto de informações que agrupa dados do motorista, referências pessoais, referências comerciais, veículos e mercadoria.
Parâmetros Disponíveis
-
Para o envio dos documentos via base64 deve conter URI || BASE64.
(Ex: data:image/png;base64,iVBORw0KGgoAAAA...) - Caso seja declarado a placa dos veículos do tipo reboque, os campos DDD e Fone do proprietário devem ser preenchidos.
| TAG | Descrição | Tipo | Tamanho |
|---|---|---|---|
| Nó 'Ficha' | |||
| transportadora_id {obrigatório} |
ID referêncial da transportadora. GET /transportadora/cnpj={CNPJ}. |
Integer | 5 |
| unidade_transporte_id {obrigatório} |
ID referêncial da unidade de transporte. GET /unidade_transportadora/cnpj={CNPJ}. |
Integer | 5 |
| observacao | Informações adicionais sobre a ficha. | Text | 2048 |
| Nó 'Motorista' | |||
| cpf_motorista {obrigatório} | CPF do motorista. Cadastro prévio do motorista necessário na TECNORISK. | String | 11 |
| vencimento_cnh_motorista {obrigatório} | Data de vencimento da CNH do motorista. Sintaxe 'YYYY-MM-DD'. | Date | 10 |
| tipo_motorista {obrigatório} |
Tipo de motorista. GET /tipo_motorista. |
Integer | 2 |
| ddd_fixo_motorista {obrigatório} | DDD do telefone de contato do motorista. | String | 3 |
| fone_fixo_motorista {obrigatório} | Número do telefone de contato do motorista. | String | 3 |
| ddd_celular_motorista {obrigatório} | DDD do celular de contato do motorista. | String | 3 |
| fone_celular_motorista {obrigatório} | Número do celular de contato do motorista. | String | 3 |
| tempo_empregado_motorista {obrigatório} | Tempo de serviço do motorista para com a empresa. | Integer | 3 |
| tipo_tempo_empregado_motorista {obrigatório} |
Tipo do tempo de serviço do motorista para com a empresa. GET /tipo_tempo_empregado. |
Char | 1 |
| Nó 'Veiculo' :: obrigatório para motorista terceiro. | |||
| placa_veiculo {obrigatório} |
Placa do veículo cavalo. Necessário prévio cadastro do veículo na TECNORISK. |
String | 8 |
| ddd_prop_veiculo {obrigatório} | DDD do telefone do proprietário do veículo cavalo. | String | 2 |
| fone_prop_veiculo {obrigatório} | Número do telefone do proprietário do veículo cavalo. | String | 9 |
| rastreador |
Tipo de rastreador do veículo. GET /rastreador. |
Integer | 3 |
| placa_reboque |
Placa do veículo reboque 1. Necessário prévio cadastro do veículo na TECNORISK. |
String | 8 |
| ddd_prop_reboque {obrigatório} | DDD do telefone do proprietário do veículo reboque 1. | String | 2 |
| fone_prop_reboque {obrigatório} | Número do telefone do proprietário do veículo reboque 1. | String | 9 |
| placa_bitrem |
Placa do veículo reboque 2. prévio cadastro do veículo na TECNORISK. |
String | 8 |
| ddd_prop_bitrem {obrigatório} | DDD do telefone do proprietário do veículo reboque 2. | String | 2 |
| fone_prop_bitrem {obrigatório} | Número do telefone do proprietário do veículo reboque 2. | String | 9 |
| placa_reboque3 |
Placa do veículo reboque 3. Necessário prévio cadastro do veículo na TECNORISK. |
String | 8 |
| ddd_prop_reboque3 {obrigatório} | DDD do telefone do proprietário do veículo reboque 3. | String | 2 |
| fone_prop_reboque3 {obrigatório} | Número do telefone do proprietário do veículo reboque 3. | String | 9 |
| Nó 'Mercadoria :: obrigatório para motorista' | |||
| mercadoria {obrigatório} |
Tipo da mercadoria. GET /mercadoria. |
Integer | 4 |
| mercadoria_origem {obrigatório} | Origem do percurso da mercadoria. | String | 100 |
| mercadoria_destino {obrigatório} | Destino do percurso da mercadoria. | String | 100 |
| mercadoria_valor {obrigatório} | Valor da mercadoria. Valor mínimo R$ 10.000,00. | String | 10 |
| Nó 'Documentacao' | |||
| cnh | Documentação CNH do motorista. | Base64 | |
| veiculo | Documentação do Veículo | Base64 | |
| reboque_1 | Documentação do Reboque I | Base64 | |
| reboque_2 | Documentação do Reboque II | Base64 | |
| reboque_3 | Documentação do Reboque III | Base64 | |
URL Envio de ficha
POST
https://ws-cadastro.tecnorisk.com.br/ficha
JSON Request
{
"Ficha":{
"transportadora_id":"1962",
"unidade_transporte_id":"4471",
"observacao":"teste of ficha on Tecnorisk"
},
"Motorista":{
"cpf_motorista":"136.707.479.74",
"vencimento_cnh_motorista":"2050-08-30",
"tipo_motorista":"2",
"ddd_fixo_motorista":"41",
"fone_fixo_motorista":"90*9012",
"ddd_celular_motorista":"41",
"fone_celular_motorista":"9994-0678",
"tempo_empregado_motorista":"1",
"tipo_tempo_empregado_motorista":"A"
},
"ReferenciaPessoal":{
"0":{
"contato_referencia_pessoal":"JOAO DA SILVA",
"parentesco_referencia_pessoal":"45",
"ddd_contato_referencia_pessoal":"47",
"fone_contato_referencia_pessoal":"3664-2152"
},
"1":{
"contato_referencia_pessoal":"MARIA APARECIDA",
"parentesco_referencia_pessoal":"4",
"ddd_contato_referencia_pessoal":"11",
"fone_contato_referencia_pessoal":"98795-2112"
},
"2":{
"contato_referencia_pessoal":"CARLA ANDRADE",
"parentesco_referencia_pessoal":"1",
"ddd_contato_referencia_pessoal":"41",
"fone_contato_referencia_pessoal":"8745-0233"
}
},
"ReferenciaComercial":{
"0":{
"empresa_referencia_comercial":"TECNORISK",
"contato_referencia_comercial":"GIULIANO SOARES",
"tipo_contato_referencia_comercial":"26",
"ddd_contato_referencia_comercial":"41",
"fone_contato_referencia_comercial":"3065-1127"
},
"1":{
"empresa_referencia_comercial":"TRANSPORTADORA",
"contato_referencia_comercial":"THIAGO TABORDA",
"tipo_contato_referencia_comercial":"15",
"ddd_contato_referencia_comercial":"11",
"fone_contato_referencia_comercial":"45*8245Y"
}
},
"Veiculo":{
"placa_veiculo":"ACQ-9320",
"ddd_prop_veiculo":"41",
"fone_prop_veiculo":"8755-5412",
"rastreador":"3",
"placa_reboque":"AAA-4040",
"ddd_prop_reboque":"11",
"fone_prop_reboque":"45*1992",
"placa_bitrem":"TTT-4321",
"ddd_prop_bitrem":"47",
"fone_prop_bitrem":"88224566",
}
"Mercadoria":
"mercadoria":"21",
"mercadoria_origem":"COLOMBO-PR",
"mercadoria_destino":"TRANSPORTADORA KRRETA-SAO PAULO-SP",
"mercadoria_valor":"10.000,00"
}JSON Response
{
"SUCESSO":
"CODE": "200",
"MSG": "Ficha 2685283 enviada com sucesso.",
"FICHA": "2685283"
}
Cadastrar Motorista
POST /motorista
Para a modalidade de cadastro de motorista, a estrutura é a seguinte:
| Tipo | Descrição | Tipo | Tamanho |
|---|---|---|---|
| Nó Motorista | |||
| nome_completo {obrigatório} | Nome do motorista. Sem acentuação e cedilha. | String | 100 |
| tipo_nacionalidade {obrigatório} |
Tipo de nacionalidade do motorista. GET /tipo_nacionalidade. |
Integer | 3 |
| tipo_motorista {obrigatório} |
Tipo de motorista. GET /tipo_motorista. |
Integer | 2 |
| cpf_dni {obrigatório} | CPF para motorista brasileiro. DNI para motorista estrangeiro. | String | 11 |
| rg {obrigatório} | RG do motorista. | String | 10 |
| estado_emissor_rg {obrigatório} |
Código do estado emissor do RG do motorista. GET /estados ou /estados_estrangeiros. |
Integer | 3 |
| pais_motorista {obrigatório} |
Código do país do motorista. GET /paises. |
Integer | 2 |
| estado {obrigatório} |
Código do estado do motorista. GET /estados ou /estados_estrangeiros. |
Integer | 3 |
| cidade {obrigatório} |
Código do estado do motorista. GET /cidades ou /cidades_estrangeiros. |
Integer | 5 |
| data_nascimento {obrigatório} | Data de nascimento do motorista. Sintaxe YYYY-MM-DD. | Date | 10 |
| Nó Filiacao | |||
| nome_pai {obrigatório} | Nome do pai do motorista. Sem acentuação e cedilha. | String | 100 |
| nome_mae {obrigatório} | Nome da mãe do motorista. Sem acentuação e cedilha. | String | 100 |
| Nó CarteiraHabilitacao :: obrigatório para Terceiros, Agregados e Motorista/Funcionário. | |||
| prontuario_cnh {obrigatório} | Número do prontuário da CNH. | String | 11 |
| data_primeira_cnh {obrigatório} | Data de emissão da primeira CNH válida. Sintaxe YYYY-MM-DD. | Date | 10 |
| estado_emissor {obrigatório} |
Código do estado emissor da CNH. GET /estados ou /estados_estrangeiros. |
Integer | 3 |
| registro {obrigatório} | Número do registro da CNH. | String | 11 |
| data_vencimento {obrigatório} | Data de vencimento da CNH. Sintaxe YYYY-MM-DD. | Date | 10 |
| categoria {obrigatório} |
Código da categoria da CNH. GET /categoria_cnh. |
Integer | 2 |
| renach {obrigatório} | Número do renach da CNH. | String | 15 |
| Nó Endereco | |||
| rua_av_trav {obrigatório} | Rua, avenida ou travessa da residência do motorista. | String | 100 |
| numero {obrigatório} | Número da residência do motorista. | Integer | 10 |
| complemento {obrigatório} | Complemento da residência do motorista. | String | 100 |
| cep {obrigatório} | Código de endereçamento postal da residência do motorista. | String | 11 |
| bairro {obrigatório} | Nome do bairro da residência do motorista. | String | 100 |
| estado {obrigatório} |
Código do estado da residência do motorista. GET /estados ou /estados_estrangeiros. |
Integer | 3 |
| cidade {obrigatório} |
Código da cidade da residência do motorista. GET /cidades ou /cidades_estrangeiras. |
Integer | 5 |
| pais_residencia {obrigatório} |
Código do país da residência do motorista. GET /paises. |
Integer | 2 |
| Nó Contato | |||
| fone_ddd {obrigatório} | DDD do telefone do motorista. | String | 2 |
| fone_numero {obrigatório} | Número do telefone do motorista. | String | 9 |
| cel_ddd {obrigatório} | DDD do celular do motorista. | String | 2 |
| cel_numero {obrigatório} | Número do celular do motorista. | String | 9 |
| email {obrigatório} | Endereço de email do motorista. | String | 150 |
URL Cadastro de Motorista
POST https://ws-cadastro.tecnorisk.com.br/motorista
JSON Request
{
"Motorista":{
"nome_completo":"JOAQUIM BARBOSA RAMOS",
"tipo_nacionalidade":"1",
"tipo_motorista":"2",
"cpf_dni":"036.626.780-51",
"rg":"8.211.652-1",
"estado_emissor_rg":"16",
"pais_motorista":"3",
"estado":"16",
"cidade":"4567",
"data_nascimento":"1968-12-11"
},
"Filiacao":{
"nome_pai":"JOAQUIM RAMOS",
"nome_mae":"MARIA ANTONIETA SILVA"
},
"CarteiraHabilitacao":{
"prontuario_cnh":"1234567890",
"data_primeira_cnh":"2011-04-12",
"estado_emissor":"5",
"registro":"12345678901",
"data_vencimento":"2027-04-12",
"categoria":"1",
"renach":"PR908389946"
},
"Endereco":{
"rua_av_trav":"av salgado filho",
"numero":"0",
"complemento":"quadra 3 lote 5",
"cep":"80250090",
"bairro":"rio verde",
"pais_residencia":"3",
"estado":"13",
"cidade":"2964"
},
"Contato":{
"fone_ddd":"41",
"fone_numero":"84973385",
"cel_ddd":"41",
"cel_numero":"83344332",
"email":"contato@transportadora.com.br"
}
}JSON Response
{
"SUCESSO": {
"CODE": "200",
"MSG": "Motorista JOAQUIM BARBOSA RAMOS inserido com sucesso.",
"MOTORISTA_CODE": "876772"
}
}Cadastrar Veículo
POST /veiculo
Já para o cadastro de veículo, os dados estão estruturados do seguinte modo:
| TAG | Descrição | Tipo | Tamanho |
|---|---|---|---|
| Nó Veiculo | |||
| placa {obrigatório} | Placa do veículo. Sintaxe XXX-NNNN ou XXXNNNN. | String | 8 |
| nacionalidade {obrigatório} |
Tipo de nacionalidade do veículo. GET /tipo_nacionalidade. |
Integer | 3 |
| tipo {obrigatório} |
Tipo de veículo. GET /tipo_veiculo. |
Char | 1 |
| documento | Documento do veículo. | String | 12 |
| chassi {obrigatório} | Chassi do veículo. | String | 17 |
| renavam {obrigatório} | Renavam do veículo. | String | 11 |
| marca {obrigatório} |
Código do país do motorista. GET /marcas. |
Integer | 3 |
| modelo {obrigatório} |
Código do modelo do veículo. GET /modelos/marca={MARCA}. |
Integer | 4 |
| ano_fabricacao {obrigatório} | Ano de fabricação do veículo. Sintaxe YYYY. | Integer | 4 |
| cor {obrigatório} |
Código da cor do veículo. GET /cor. |
Integer | 2 |
| antt_rntrc {obrigatório} | Número RNTRC da ANTT do veículo. | String | 12 |
| antt_data_validade {obrigatório} | Data de validade da ANTT do veículo. Sintaxe YYYY-MM-DD. | Date | 10 |
| pais {obrigatório} |
Código do país do veículo. GET /paises. |
Integer | 2 |
| estado |
Código do estado do veículo. GET /estados ou /estados_estrangeiros. |
Integer | 3 |
| cidade {obrigatório} |
Código da cidade do veículo. GET /cidades ou /cidades_estrangeiras. |
Integer | 5 |
| Nó Proprietario :: pessoa física, jurídica ou estrangeira | |||
| nacionalidade {obrigatório} |
Tipo de nacionalidade do proprietário. GET /tipo_nacionalidade. |
Integer | 3 |
| cpf_cnpj_dni {obrigatório} | CPF ou CNPJ para proprietário brasileiro. DNI para proprietário estrangeiro. | String | 14 |
| nome_completo {obrigatório} | Nome do proprietário. Sem acentuação e cedilha. | String | 100 |
| Nó ProprietarioEndereco | |||
| rua_av_trav | Rua, avenida ou travessa da residência do proprietário. | String | 100 |
| numero | Número da residência do proprietário. | Integer | 10 |
| complemento | Complemento da residência do proprietário. | String | 100 |
| cep | Código de endereçamento postal da residência do proprietário. | String | 11 |
| bairro | Nome do bairro da residência do proprietário. | String | 100 |
| pais_residencia |
Código do país da residência do proprietário. GET /paises. |
Integer | 2 |
| estado |
Código do estado da residência do proprietário. GET /estados ou /estados_estrangeiros. |
Integer | 3 |
| cidade |
Código da cidade da residência do proprietário. GET /cidades ou /cidades_estrangeiras. |
Integer | 5 |
| Nó ProprietarioContato | |||
| fone_ddd {obrigatório} | DDD do telefone do proprietário. | String | 2 |
| fone_numero {obrigatório} | Número do telefone do proprietário. | String | 9 |
| Endereço de email do proprietário. | String | 150 | |
| Nó Arrendatario :: obrigatório para veículos em alienação, aos demais deve-se ignorar os nós abaixo | |||
| cpf_cnpj {obrigatório} | CPF ou CNPJ do arrendatário. | String | 14 |
| nome_completo {obrigatório} | Nome do arrendatário. Sem acentuação e cedilha. | String | 100 |
| Nó ArrendatarioEndereco | |||
| rua_av_trav | Rua, avenida ou travessa da residência do arrendatário. | String | 100 |
| numero | Número da residência do arrendatário. | Integer | 10 |
| complemento | Complemento da residência do arrendatário. | String | 100 |
| cep | Código de endereçamento postal da residência do arrendatário. | String | 11 |
| bairro | Nome do bairro da residência do arrendatário. | String | 100 |
| estado {obrigatório} |
Código do estado da residência do arrendatário. GET /estados. |
Integer | 5 |
| cidade {obrigatório} |
Código da cidade da residência do arrendatário. GET /cidades. |
Integer | 2 |
| Nó ArrendatarioContato | |||
| fone_ddd {obrigatório} | DDD do telefone do arrendatário. | String | 2 |
| fone_numero {obrigatório} | Número do telefone do arrendatário. | String | 9 |
| email {obrigatório} | Endereço de email do arrendatário. | String | 150 |
URL Cadastro de Veículo
POST https://ws-cadastro.tecnorisk.com.br/veiculo
JSON Request
{
"Veiculo":{
"placa":"AAA-1155",
"nacionalidade":"1",
"tipo":"V",
"documento":"8475741554",
"chassi":"26595xx959b",
"renavam":"878786",
"marca":"3",
"modelo":"16",
"ano_fabricacao":"2007",
"cor":"12",
"antt_rntrc":"4548541",
"antt_data_validade":"2050-09-12",
"pais":"3",
"estado":"16",
"cidade":"4567"
},
"Proprietario":{
"nacionalidade":"1",
"cpf_cnpj_dni":"774.441.887-50",
"nome_completo":"JOAQUIM BARBOSA"
},
"ProprietarioEndereco":{
"rua_av_trav":"av salgado filho",
"numero":"0",
"complemento":"quadra 3 lote 5",
"cep":"80250090",
"bairro":"rio verde",
"pais_residencia":"3",
"estado":"13",
"cidade":"2964"
},
"ProprietarioContato":{
"fone_ddd":"41",
"fone_numero":"84973385",
"email":"contato@transportadora.com.br"
},
"Arrendatario":{
"cpf_cnpj":"772.995.169-00",
"nome_completo":"LILS Palestras"
},
"ArrendatarioEndereco":{
"rua_av_trav":"av salgado filho",
"numero":"0",
"complemento":"quadra 3 lote 5",
"cep":"80250090",
"bairro":"rio verde",
"estado":"13",
"cidade":"2964"
},
"ArrendatarioContato":{
"fone_ddd":"41",
"fone_numero":"84973385",
"email":"contato@transportadora.com.br"
}
}JSON Response
{
"SUCESSO": {
"CODE": "200",
"MSG": "Veículo AAA-1155 inserido com sucesso.",
"VEICULO_CODE": "609147"
}
}
Cadastrar Marcas de Veículos
POST /marcas
Para a modalidade de cadastro de marcas, a estrutura é a seguinte:
| Tag | Descrição | Tipo | Tamanho |
|---|---|---|---|
| marca_nome {obrigatório} | Descrição da marca do veículo/reboque | String | 255 |
URL Cadastro de Marca
POST https://ws-cadastro.tecnorisk.com.br/marcas
JSON Request
{
"marca_nome": "Descrição da marca do veículo/reboque"
}
JSON Response
{
"SUCESSO": {
"CODE": "200",
"MSG": "Marca [Descrição da marca do veículo\/reboque] inserida com sucesso",
"ID": "2069"
}
}
Cadastrar Modelos de Veículos
POST /marcas
Para a modalidade de cadastro de modelos, a estrutura é a seguinte:
| Tag | Descrição | Tipo | Tamanho |
|---|---|---|---|
| modelo_nome {obrigatório} | Descrição do modelo do veículo/reboque | String | 255 |
| marca_id {obrigatório} |
ID da marca cadastrada previamente. GET /marcas. |
Integer | - |
URL Cadastro de Modelos
POST https://ws-cadastro.tecnorisk.com.br/marcas
JSON Request
{
"modelo_nome": "Descrição do modelo do veículo/reboque",
"marca_id": "0000"
}
JSON Response
{
"SUCESSO": {
"CODE": "200",
"MSG": "Modelo [Descrição do modelo do veículo\/reboque] inserido com sucesso",
"ID": "10091"
}
}
Consultar Liberação por ID da Ficha
-
Para verificação do status deve-se verificar a tag situacao_cadastro,
onde está pode retornar 4 estados.
* L - Finalizado Completo = Recomendado
* N - Finalizado Incompleto = Não Recomendado
* D ou A - Em análise
* O retorno é referente a última ficha cadastrada. Se a ficha estiver com o status “N - Finalizado Incompleto”, pode-se obter o motivo na tag “observacao”.
URL Liberação por ID da Ficha
GET https://ws-cadastro.tecnorisk.com.br/liberacao/{TRANSPORTADORA_ID}/{FICHA_ID}
JSON Response
{
"Ficha":{
"transportadora_id":"1410",
"unidade_transporte_id":"3658",
"observacao":"teste ficha Tecnorisk"
},
"Motorista":{
"cpf_motorista":"136.707.479-74",
"ddd_fixo_motorista":"41",
"fone_fixo_motorista":"90*9012",
"ddd_celular_motorista":"41",
"fone_celular_motorista":"9994-0678"
},
"ReferenciaPessoal":{
"0":{
"contato_referencia_pessoal":"JOAO DA SILVA",
"parentesco_referencia_pessoal":"45",
"ddd_contato_referencia_pessoal":"47",
"fone_contato_referencia_pessoal":"3664-2152"
},
"1":{
"contato_referencia_pessoal":"MARIA APARECIDA",
"parentesco_referencia_pessoal":"4",
"ddd_contato_referencia_pessoal":"11",
"fone_contato_referencia_pessoal":"98795-2112"
}
}
}Consultar Liberação de Motorista
- Para fazer a consulta da liberação de motorista é preciso estar com a ficha da transportadora liberada.
-
Para verificação do status observe a tag situacao_cadastro, onde está
pode retornar 4 estados :
- L - Finalizado Completo
- N - Finalizado Incompleto
- D ou A - Em análise
- O retorno é referente a última ficha cadastrada. Se a ficha estiver com o status “N - Finalizado Incompleto”, pode-se obter o motivo na tag “observacao”.
URL Consultar Motorista
GET https://ws-cadastro.tecnorisk.com.br/liberacao_motorista/{TRANSPORTADORA_ID}/{FICHA_ID}
JSON Response
{
"Liberacao": {
"ficha": "2685290",
"data_ficha_termino": "23\/06\/2023",
"termino": "2023-06-23 09:43:48.373276",
"situacao_cadastro": "L",
"situacao_cadastro_descricao": "FINALIZADO COMPLETO",
"codigo_aprovacao": "",
"Empresa": {
"transportadora": "1 - AVALIACAO DE RISCO TECNORISK - TESTE",
"unidade_transporte": "2 - AVALIACAO DE RISCO TECNORISK - TESTE2"
},
"Motorista": {
"nome": "TESTE TECNORISK",
"cpf_dni": "00000000000",
"rg": "00.000.000-0"
},
"VeiculoCavalo": {
"placa": "ACQ-9320",
"marca": "MERCEDES BENZ",
"modelo": "LK-1313",
"proprietario": "ANDREIA HERMINIA DE SIQUEIRA TESTE",
"cpf_cnpj": "21836071817"
},
"VeiculoReboque": {
"placa": "AAA-4040",
"marca": "MERCEDES BENZ",
"modelo": "AXOR 2540 S",
"proprietario": "BRUNO TESTE",
"cpf_cnpj": "85116853594"
},
"VeiculoBitrem": {
"placa": "TTT-4321",
"marca": "MERCEDES BENZ",
"modelo": "AXOR 2540 S",
"proprietario": "CLAUDETE TESTE",
"cpf_cnpj": "88162377590"
},
"Vencimento": {
"data_vencimento": "25\/06\/2023"
},
"Responsabilidade": {
"empresa": "A impressão ou divulgação desta consultaserá de inteira responsabilidade de 1 - AVALIACAO DE RISCO TECNORISK - TESTE.",
"servico": "A utilização do serviço de informações cadastrais oferecido pela TECNORISK CADASTRO, implica na aceitação plena de todas as cláusulas de nosso contrato de prestação de serviços."
}
}
}Consultar Liberação de Veículo
URL Consultar Veículo
GET https://ws-cadastro.tecnorisk.com.br/liberacao_veiculo/{TRANSPORTADORA_ID}/{VEICULO_PLACA}
JSON Response
{
"Liberacao": {
"ficha": "2685285",
"data_ficha_termino": "",
"termino": "",
"situacao_cadastro": "D",
"situacao_cadastro_descricao": "EM ANÁLISE",
"codigo_aprovacao": "",
"Empresa": {
"transportadora": "1 - AVALIACAO DE RISCO TECNORISK - TESTE",
"unidade_transporte": "2 - AVALIACAO DE RISCO TECNORISK - TESTE2"
},
"Motorista": {
"nome": "LUCAS EDUARDO DA SILVA",
"cpf_dni": "13670747974",
"rg": "14.644.677-9"
},
"VeiculoCavalo": {
"placa": "ACQ-9320",
"marca": "MERCEDES BENZ",
"modelo": "LK-1313",
"proprietario": "ANDREIA HERMINIA DE SIQUEIRA TESTE",
"cpf_cnpj": "21836071817"
},
"VeiculoReboque": {
"placa": "AAA-4040",
"marca": "MERCEDES BENZ",
"modelo": "AXOR 2540 S",
"proprietario": "BRUNO TESTE",
"cpf_cnpj": "85116853594"
},
"VeiculoBitrem": {
"placa": "TTT-4321",
"marca": "MERCEDES BENZ",
"modelo": "AXOR 2540 S",
"proprietario": "CLAUDETE TESTE",
"cpf_cnpj": "88162377590"
},
"Vencimento": {
"data_vencimento": ""
},
"Responsabilidade": {
"empresa": "A impressão ou divulgação desta consultaserá de inteira responsabilidade de 1 - AVALIACAO DE RISCO TECNORISK - TESTE.",
"servico": "A utilização do serviço de informações cadastrais oferecido pela TECNORISK CADASTRO, implica na aceitação plena de todas as cláusulas de nosso contrato de prestação de serviços."
}
}
}