Manual de Integração SISTEC - Rastreamento
Manual SISTEC
Introdução
Bem-vindo ao Manual de Integração do SISTEC para Rastreamento. Esta documentação fornece instruções detalhadas para integrar sistemas com a plataforma de rastreamento da Tecnorisk.
Visão Geral
A API de Rastreamento do SISTEC permite que você gere uma solicitação de monitoramento, acesse dados de rastreamento de veículos em tempo real, histórico de posições, eventos e alertas através de endpoints RESTful.
Esta API foi projetada para oferecer:
Resposta Rápida
Obtenha dados de localização com latência mínima para aplicações em tempo real.
Segurança
Proteção dos dados através de usuário e senha Basic Auth.
Dados Completos
Acesso a informações detalhadas de monitoramento, posição, status e eventos.
Fácil Integração
Endpoints RESTful compatíveis com qualquer linguagem de programação.
Requisitos
Para utilizar a API de Rastreamento do SISTEC, você precisará de:
- Ser cliente Tecnorisk com serviço de rastreamento ativo
- Possuir credenciais de acesso (usuário e senha ou token API)
- Processamento de dados no formato JSON
Importante
A requisição por POST, deve conter em seu cabeçalho, a declaração explícita do tipo de conteúdo no formato application/json;charset=utf-8, afim de garantir que os dados sejam tratados e validados de forma uniforme pelo Web Service.
Autenticação
A autenticação para uso do integrador é feita utilizando BASIC AUTH, nativo do HTML.
Credenciais
As credenciais para utilização devem ser requeridas diretamente com a equipe de T.I da TECNORISK, através do email: sistemas@tecnorisk.com.br.
Ambientes
A API de Rastreamento do SISTEC oferece os seguintes endpoints principais:
Obtenção
Endpoints para obtenção de dados:
| Método | Endpoint | Descrição | Retorno |
|---|---|---|---|
| GET | /monitoramento/prioridades |
Prioridades do Monitoramento | |
| GET | /unidades_transporte |
Unidades de Transporte | |
| GET | /pgrs |
PGRs | |
| GET | /pgrs/{idPgr}/mercadorias |
Mercadorias | |
| GET | /transportadora/pontos_controle |
Pontos de Controle | |
| GET | /transportadora/rotas |
Rotas | |
| GET | /transportadora/rotas/pontos_parada/{idRota} |
Pontos de Parada Referente a Rota | |
| GET | /estados |
Estados | |
| GET | /estados/{idEstado}/municipios |
Cidades | |
| GET | /tipos_rastreadores |
Tipos de Rastreadores |
Requisições
Exemplos e informações para os envios de requisições ao webservice Tecnorisk.
Solicitação de Monitoramento
Parâmetros
obrigatório Nó 'Principal'-
obrigatório
data_hora_atual- Data e hora do sistema de envio da SM. datetime - YYYY-MM-DD HH:II -
email_com_copia- E-mails para onde serão enviadas cópias da SM. text - Separador ";" -
obrigatório
pgr_id- ID do PGR. Utilize para a busca do PGR "/pgrs". integer -
obrigatório
unidade_transporte_id- ID da Unidade de Transporte. Utilize para a busca do PGR "/unidades_transporte". integer -
obrigatório
motorista_cpf- CPF do Motorista text -
obrigatório
motorista_telefone- Telefone de Contato do Motorista varchar(11) -
motorista_celular1- Celular 1 de Contato do Motorista varchar(15) -
motorista_celular2- Celular 2 de Contato do Motorista varchar(15) -
obrigatório
monitoramento_prioridade- ID da Prioridade do Monitoramento. Utilize para a busca da Prioridade ‘/monitoramento/prioridades’. integer -
obrigatório
monitoramento_placa_container- Placa do Container do Monitoramento. text -
obrigatório
carga_mercadoria- ID da Carga do Monitoramento. Utilize para a busca da Mercadoria ‘/pgrs/{id_pgr}/mercadorias’. integer -
obrigatório
viagem_origem_data_saida- Data da Saída do Veículo. date - YYYY-MM-DD -
obrigatório
viagem_origem_hora_saida- Hora da Saída do Veículo. time - HH:II -
obrigatório (3)
viagem_origem_estado- Estado de Origem da Viagem. Enviar nome ou sigla. text -
obrigatório (3)
viagem_origem_cidade- Cidade de Origem da Viagem. Enviar nome. text -
obrigatório (4)
viagem_destino_estado- Estado de Destino da Viagem. Enviar nome ou sigla. text -
obrigatório (4)
viagem_destino_cidade- Cidade de Destino da Viagem. Enviar nome. text -
obrigatório
viagem_destino_data_chegada- Data Prevista da Chegada no Destino. date - YYYY-MM-DD -
obrigatório
viagem_destino_hora_chegada- Hora Prevista da Chegada no Destino. time - HH:II -
viagem_origem_id_endereco OU viagem_origem_cnpj- ID ou CNPJ do Endereço do Ponto de Origem. Utilize para a busca do ponto '/transportadora/pontos_controle'. integer -
viagem_destino_id_endereco OU viagem_destino_cnpj- ID ou CNPJ do Endereço do Ponto de Destino. Utilize para a busca do ponto '/transportadora/pontos_controle'. integer -
obrigatório
viagem_rota- ID da Rota que o Veículo deverá fazer. Utilize para a busca da rota ‘/transportadora/rotas’. integer -
viagem_pontos_parada- IDs dos Pontos de Parada dentro da Rota. Utilize para a busca dos pontos de parada ‘/transportadora/rotas/pontos_parada/{id_rota}’. array of integer -
viagem_observacoes- Observações Sobre o Veículo ou a Viagem. text -
viagem_senha_cliente- Senha de Viagem Normal. text -
viagem_senha_coacao- Senha Para Coação da Tecnorisk. text -
solicitacao_anterior- Número de solicitação anterior. Integer
-
obrigatório
veiculo_placa- Placa do Veículo. text -
veiculo_odometro- Odômetro do Veículo. numeric -
obrigatório
veiculo_tipo- Tipo do Veículo. Utilize "V" para o cavalo, "R1" para o reboque 1 e "R2" para o reboque 2. varchar(2)
-
obrigatório
acompanhante_cpf- CPF Acompanhante. text
-
obrigatório
lacre_atual- Lacre Atual. text -
lacre_anterior- Lacre Anterior. text
-
obrigatório
gerenciadora_riscos_externa_nome- Nome da Gerenciadora de Riscos Externa. text -
obrigatório
gerenciadora_riscos_externa_numero- Número de Identificação da Gerenciadora de Riscos Externa. text -
obrigatório
gerenciadora_riscos_externa_tipo- Utilize 1 - AJUDANTE | 2 - CARRETA | 3 - CAVALO | 4 - MOTORISTA. integer
-
obrigatório
viagem_local_pernoite_estado- Estado do Pernoite. Enviar nome ou sigla. text -
obrigatório
viagem_local_pernoite_cidade- Cidade do Pernoite. Enviar nome. text -
obrigatório
viagem_local_pernoite_local- Local do Pernoite. text
-
obrigatório
isca_numero- Número da Isca. text
-
carga_manifesto- Número do Manifesto. integer -
carga_nota_fiscal **- Número da Nota Fiscal. integer -
carga_nota_fiscal_serie **- Série da Nota Fiscal. varchar(10) -
carga_cliente **- Nome do Cliente Referente à Nota Fiscal. text -
carga_cliente_cnpj **- CNPJ do Cliente Referente à Nota Fiscal. text -
carga_cliente_telefone- Telefone do Cliente Referente à Nota Fiscal. integer -
carga_local_entrega **- Endereço do Cliente Referente à Nota Fiscal. text -
carga_peso- Peso da Mercadoria Referente à Nota Fiscal. integer -
obrigatório
carga_valor **- Valor da Carga Referente à Nota Fiscal. numeric(12,2) - ponto flutuante -
carga_previsao_data_chegada **- Data da Previsão de Chegada no Cliente Referente à Nota Fiscal. date - YYYY-MM-DD -
carga_previsao_hora_chegada **- Hora da Previsão de Chegada no Cliente Referente à Nota Fiscal. time - HH:II -
carga_previsao_data_saida **- Data da Previsão de Saída do Cliente Referente à Nota Fiscal. date - YYYY-MM-DD -
carga_previsao_hora_saida **- Hora da Previsão de Saída do Cliente Referente à Nota Fiscal. time - HH:II -
carga_ponto_empresaoucarga_cliente_cnpj **- ID do Endereço da Empresa de Destino. Utilize para a busca do ponto/transportadora/pontos_controle. integer -
carga_mercadoria- ID da Carga referente à NF. Utilize para a busca da Mercadoria/pgrs/{id_pgr}/mercadorias. integer
Pontos de Origem e Destino
- (3) Campos não obrigatórios se campo
viagem_origem_id_enderecoouviagem_origem_cnpjenviado. - (4) Campos não obrigatórios se campo
viagem_destino_id_enderecoouviagem_destino_cnpjenviado. - É imprescindível que o ponto esteja cadastrado – Verificar Cadastro de Pontos de Controles.
Para considerar a cidade/estado de origem e a cidade/estado de destino da ROTA, não enviar os campos
viagem_origem_cidade, viagem_origem_estado, viagem_destino_cidade,
viagem_destino_estado, viagem_origem_cnpj, viagem_destino_cnpj. Dessa forma,
o sistema considerará a origem e destino da ROTA informada.
Informações Adicionais
- Campo
motorista_telefoneé obrigatório, se for a primeira viagem do motorista. - Isca deve ser cadastrada antes do envio – Verificar Cadastro de Iscas.
Exemplo de envio:
JSON MonitoramentoExemplo de resposta para uma requisição correta:
{
"erro": 0,
"mensagem": "Solicitação de Monitoramento criada com sucesso.",
"resultado": {
"monitoramento_id": "00000000",
"mensagens": [
"Valor total de mercadoria(s), fora do que é permitido pelo PGR.",
"Nenhuma liberação de cadastro/ficha encontrada para o CPF 00000000, na Tecnorisk Cadastros."
]
}
}
Informações Adicionais
Quando a solicitação for criada sem erros, será retornado no elemento erro o valor 0 (zero).
O campo monitoramento_id dentro do objeto resultado retornará o número da solicitação criada.
No campo mensagens, dentro do objeto resultado, serão retornadas as informações adicionais a respeito da criação do monitoramento.
Cadastro de Motorista
Parâmetros
-
obrigatório
motorista_nome- Nome do Motorista. text -
obrigatório
motorista_rg- RG do Motorista. text -
obrigatório
motorista_estado_rg- Estado do RG do Motorista. text -
obrigatório
motorista_data_nascimento- Data de Nascimento do Motorista. date - YYYY-MM-DD -
obrigatório
motorista_cidade- Cidade do Motorista. text -
obrigatório
motorista_estado- Estado do Motorista. text -
obrigatório
motorista_nome_pai- Nome do Pai do Motorista. text -
obrigatório
motorista_nome_mae- Nome da Mãe do Motorista. text -
obrigatório
motorista_endereco_cep- CEP do Endereço do Motorista. integer -
obrigatório
motorista_endereco_rua- Rua do Endereço do Motorista. text -
obrigatório
motorista_endereco_numero- Número do Endereço do Motorista. integer -
obrigatório
motorista_endereco_bairro- Bairro do Endereço do Motorista. text -
obrigatório
motorista_endereco_estado- Estado do Endereço do Motorista. text -
obrigatório
motorista_endereco_cidade- Cidade do Endereço do Motorista. text -
obrigatório
motorista_endereco_ddd- DDD do Telefone do Endereço do Motorista. integer -
obrigatório
motorista_endereco_telefone- Telefone do Endereço do Motorista. integer
Exemplo de envio:
JSON MotoristaExemplo de resposta para uma requisição correta:
{
"erro": 0,
"mensagem": "Motorista cadastrado com sucesso.",
"resultado": {
"motorista_id": "123456",
"mensagens": []
}
}
Cadastro de Veículo
Parâmetros
-
obrigatório
veiculo_tipo- Utilize "V" para o cavalo, "R1" para o reboque 1 e "R2" para o reboque 2. text -
obrigatório
veiculo_placa- Placa. text -
obrigatório
veiculo_estado- Estado do veículo. text -
obrigatório
veiculo_cidade- Cidade do veículo. text -
obrigatório
veiculo_renavam- Renavam. text -
obrigatório
veiculo_chassi- Chassi. text -
obrigatório
veiculo_marca- Marca. text -
obrigatório
veiculo_cor- Cor. text -
obrigatório
veiculo_modelo- Modelo do veículo. text -
obrigatório
veiculo_proprietario_endereco_cep- CEP do proprietário do veículo. text -
obrigatório
veiculo_proprietario_endereco_rua- Rua do proprietário do veículo. text -
obrigatório
veiculo_proprietario_endereco_numero- Número do proprietário do veículo. integer -
obrigatório
veiculo_proprietario_endereco_bairro- Bairro do proprietário do veículo. text -
obrigatório
veiculo_proprietario_endereco_estado- Estado do proprietário do veículo. text -
obrigatório
veiculo_proprietario_endereco_cidade- Cidade do proprietário do veículo. text -
obrigatório
veiculo_proprietario_endereco_ddd- DDD do proprietário do veículo. integer -
obrigatório
veiculo_proprietario_endereco_telefone- Telefone do proprietário do veículo. integer -
obrigatório
veiculo_proprietario_cnpj_cpf- CPF/CNPJ do proprietário do veículo. text -
obrigatório
veiculo_proprietario_nome- Nome do proprietário do veículo. text
Exemplo de envio:
JSON VeículoExemplo de resposta para uma requisição correta:
{
"erro": 0,
"mensagem": "Veículo inserido com sucesso.",
"resultado": {
"veiculo_id": "123456",
"mensagens": []
}
}
Cadastro de Iscas
Parâmetros
-
obrigatório
isca_numero- Número da Isca. text -
isca_nota_fiscal- NF Refente a Isca. text -
isca_responsavel- Responsável pela Isca. text -
isca_tecnologia- Tecnologia. text
Informações Adicionais
Para utilizá-la, basta no campo isca_numero da solicitação de monitoramento, colocar o mesmo número da isca cadastrada nesta etapa.
Exemplo de envio:
{
"isca_numero": 123456,
"isca_nota_fiscal": 78910,
"isca_responsavel": "Fulano",
"isca_tecnologia": "Sascar"
}
Exemplo de resposta para uma requisição correta:
{
"erro": 0,
"mensagem": "Registro inserido com sucesso."
}
Cadastro de Pontos de Controle
Parâmetros
-
obrigatório
endereco- Endereço do Ponto de Controle. text -
obrigatório
local- Descrição/Nome do Ponto de Controle. text -
obrigatório
cnpj_local- CNPJ do Ponto de Controle. text -
obrigatório
estado- Estado do Ponto de Controle. text -
obrigatório
cidade- Cidade do Ponto de Controle. text -
latitude- Latitude do Ponto de Controle. text -
longitude- Longitude do Ponto de Controle. text -
raio- Raio de abrangência do ponto (em metros). integer
Informações Adicionais
Se nosso serviço não conseguir buscar as coordenadas (latitude, longitude) automaticamente, um erro será gerado informando que deve-se informar estes dados.
Exemplo de envio:
{
"endereco": "Rua XXX",
"local": "Casa XXX",
"cnpj_local": "18436248000165",
"estado": "PR",
"cidade": "Colombo",
"latitude": "-25.000",
"longitude": "-42.00",
"raio": 300
}
Exemplo de resposta para uma requisição correta:
{
"erro": 0,
"mensagem": "Registro inserido com sucesso",
"resultado": {
"ponto_entrega_id": 00000,
"documentacao_url": "sistema.tecnorisk.com.br/tecnorisk/documentacao/view.php?s=manual-integracao-sistec--rastreamento",
"data_criacao": "10/115/13/2020",
"titulo": "Manual Integração Sistec - Rastreamento"
}
}
Cancelar Solicitação de Monitoramento
Parâmetros
-
obrigatório
monitoramento_id- Número da solicitação que será cancelada. integer -
obrigatório
cancelamento_motivo- Motivo do cancelamento da solicitação. text -
cancelamento_email_copia- E-mail para quem será enviado a cópia do e-mail. text
Exemplo de resposta para uma requisição correta:
{
"erro": 0,
"mensagem": "Registro cancelado com sucesso.",
"resultado": {
"monitoramento_id": 00000
}
}
Códigos de Erro
A API retorna códigos de erro padronizados em caso de falha. Todos os erros seguem o formato:
{
"erro": -5,
"mensagem": "Campo data_hora_atual deve ser enviado.",
"resultado": null
}
Informações Adicionais
- Prevenção de Erros: Procurando evitar falhas no envio da solicitação de monitoramento, o sistema de integração disponibiliza códigos de erros que podem ocorrer no envio da solicitação. Esses erros devem ser tratados para o perfeito funcionamento da integração.
- Códigos de Erros: Códigos de erros menores que zero (0) são considerados problemas (validação incorreta, problema ao inserir o registro, tipo do campo incorreto, etc).
- Notificação: Como prevenção, um e-mail com o erro ocorrido será enviado para o e-mail do solicitante da requisição.
Suporte
Se você encontrar problemas ou tiver dúvidas sobre a API de Rastreamento do SISTEC, entre em contato com nossa equipe de suporte.
Para dúvidas técnicas: sistemas@tecnorisk.com.br
Última atualização: 20 de Maio de 2025 | Versão da API: 1.0.0