Manual de Integração SISTEC - Rastreamento

Manual SISTEC
PDF

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.

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

Autenticação

A autenticação para uso do integrador é feita utilizando BASIC AUTH, nativo do HTML.

Ambientes

A API de Rastreamento do SISTEC oferece os seguintes endpoints principais:

HOMOLOGAÇÃO http://ws.tecnorisk.com.br/homologacao/sistec/api/v2
PRODUÇÃO http://ws.tecnorisk.com.br/sistec/api/v2

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

POST /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 Nó 'veiculos' array de registros
  • 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)
Nó 'acompanhantes' array de registros - aceita somente 2 (dois) nós de registro
  • obrigatório acompanhante_cpf - CPF Acompanhante. text
Nó 'lacres' array de registros
  • obrigatório lacre_atual - Lacre Atual. text
  • lacre_anterior - Lacre Anterior. text
Nó 'gerenciadora_riscos_externa' array de registros
  • 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
Nó 'viagem_locais_pernoite' array de registros
  • 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
Nó 'iscas' array de registros
  • obrigatório isca_numero - Número da Isca. text
obrigatório Nó cargas array de registros
  • 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_empresa ou carga_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

Exemplo de envio:

JSON Monitoramento

Exemplo 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."
    ]
  }
}

                            

Cadastro de Motorista

POST /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 Motorista

Exemplo de resposta para uma requisição correta:


{
  "erro": 0,
  "mensagem": "Motorista cadastrado com sucesso.",
  "resultado": {
    "motorista_id": "123456",
    "mensagens": []
  }
}

                            

Cadastro de Veículo

POST /veiculo

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ículo

Exemplo de resposta para uma requisição correta:


{
  "erro": 0,
  "mensagem": "Veículo inserido com sucesso.",
  "resultado": {
    "veiculo_id": "123456",
    "mensagens": []
  }
}

                        

Cadastro de Iscas

POST /transportadora/isca

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

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

POST /transportadora/pontos_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

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

POST /monitoramento/cancelar

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
}

Suporte

Se você encontrar problemas ou tiver dúvidas sobre a API de Rastreamento do SISTEC, entre em contato com nossa equipe de suporte.

E-mail

Para dúvidas técnicas: sistemas@tecnorisk.com.br

Última atualização: 20 de Maio de 2025 | Versão da API: 1.0.0