Documentacao Web Service SIGhRA v01.07.03

Data 03/02/2023
Versão 1.7.3
Cópia
Integração Revisão 03/02/2023
Páginas 1 de 77
Código
Integração SIGhRA
Web Service SOAP
Versão 1.7.3
Data 03/02/2023
Documento Documentacao_Web_Service_SIGhRA_v01.07.03.pdf
Autores Carlos Henrique da Cunha Pereira

cpereira@sighra.com.br
Projeto e propriedade intelectual – SIGHRA SISTEMAS INOVADORES

DOCUMENTO CONTROLADO – REPRODUÇÃO PROIBIDA
Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 2 de 77
Código
Índice
1 Controle de Revisões ............................................................................................................. 4
1.1 Histórico de Versões ......................................................................................................... 4
2 Introdução ............................................................................................................................... 5
3 Métodos disponíveis............................................................................................................... 6
3.1 obterUltimaPosicao ........................................................................................................... 7
3.2 obterPosicoes ................................................................................................................. 10
3.3 obterPosicoesPeriodo ..................................................................................................... 13
3.4 obterPosicoesCriterio ...................................................................................................... 14
3.5 obterMacros .................................................................................................................... 16
3.6 obterMacrosPeriodo ........................................................................................................ 19
3.7 obterMacrosCriterio ......................................................................................................... 20
3.8 obterMensagens.............................................................................................................. 22
3.9 obterMensagensPeriodo ................................................................................................. 24
3.10 obterMensagensCriterio .................................................................................................. 26
3.11 enviarMensagem ............................................................................................................. 28
3.12 obterInfracoes ................................................................................................................. 29
3.13 obterInfracoesPeriodo ..................................................................................................... 36
3.14 obterInfracoesCriterio ...................................................................................................... 37
3.15 obterTelemetria ............................................................................................................... 39
3.16 obterTelemetriaPeriodo ................................................................................................... 44
3.17 obterTelemetriaCriterio .................................................................................................... 45
3.18 enviarMotoristas .............................................................................................................. 47
3.19 desativarMotoristas ......................................................................................................... 50
3.20 ativarMotoristas ............................................................................................................... 52
3.21 enviarConfiguracoesArea ................................................................................................ 55

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 3 de 77
Código
3.22 enviarConfiguracoesMacro .............................................................................................. 58
3.23 enviarConfiguracoesMensagemPre................................................................................. 61
3.24 enviarConfiguracoesSensor ............................................................................................ 64
3.25 enviarComandoTelefonico ............................................................................................... 67
3.26 enviarComando ............................................................................................................... 70
3.27 obterVersao..................................................................................................................... 72
4 Tabelas .................................................................................................................................. 73
4.1 Sensores/Atuadores ........................................................................................................ 73
4.2 Tipos de Macro................................................................................................................ 74
4.3 Eventos ........................................................................................................................... 75
4.4 Comandos ....................................................................................................................... 75
5 Tipos Comuns ....................................................................................................................... 76
5.1 Status dos Sensores/Atuadores (SensorAtuador) ........................................................... 76
5.2 Motorista ......................................................................................................................... 76
5.3 Veiculo ............................................................................................................................ 76
5.4 GrupoArea....................................................................................................................... 76
5.5 GrupoMacro .................................................................................................................... 77
5.6 GrupoMensagemPre ....................................................................................................... 77
5.7 ConfiguracaoSensor ........................................................................................................ 77

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 4 de 77
Código
1 Controle de Revisões
1.1 Histórico de Versões

Data Versão Descrição
03/02/2023 1.7.3 Adição do hodômetro nos métodos de macro e mensagem.
22/12/2022 1.7.2 Ajustes ponteiro de infrações.
09/12/2022 1.7.1 Ajustes pesquisa por data de recepção (infração / mensagem / macro /
posição).
11/07/2022 1.7.0 Adição de métodos de obtenção de relatórios de telemetria.
24/03/2022 1.6.4 Adição de campos de origem e ID de evento no retorno do WS de
Mensagens.
11/03/2022 1.6.3 Desativação/Reativação de Motoristas.
03/03/2022 1.6.2 Criação de parâmetros ENVIA_SENSOR_AUSENTE e
ENVIA_ATUADOR_AUSENTE para controlar o retorno de informações
de sensores e atualizadores que não possuam status ou não estejam
configurados no veículo.
08/08/2021 1.6.0 Novos métodos:
- Envio de Grupo de Macro
- Envio de Grupo de Área
- Envio de Grupo de Mensagens Pré-Formatadas
- Solicitação de Comando Telefônico
- Envio de Comando
- Controle de Sensores
23/07/2021 1.5.2 Adição de infrações de guinada brusca e aceleração/desaceleração
longitudinal.
07/07/2021 1.5.1 Caso não seja adicionada informação de grupo no arquivo de
configuração, os grupos passam a ser obtidos por usuário.
Adição de método para verificação da versão.

26/10/2020 1.5.0 Adição de campo ponto de referência na posição, infração, macro e
mensagem.
Adição de informação de número de satélites e dop na infração, macro

e mensagem.
Adição de métodos obterPosicoesCriterio, obterMacrosCriterio,

obterInfracoesCriterio, obterMensagensCriterio para buscas com
parâmetros adicionais de entrada.
Adição de infrações de jornada.
Adição de código de evento no retorno de posições.
Adição de método para embarque de motoristas (enviarMotoristas).

15/09/2020 1.4.0 Adição de informações de motorista na posição e na macro.

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 5 de 77
Código
Adição de métodos de obtenção de infrações.

16/03/2020 1.3.1 Adição de campos de informação de número de satélite, dop, bateria,
horímetro e posição online/memória na posição.
04/03/2020 1.3.0 Adição de método de última posição.
26/02/2020 1.2.0 Adição de informação de hodômetro.
16/08/2019 1.1.0 Adição de Informação de Sensores e Atuadores
02/07/2019 1.0.0 Versão Inicial do Documento
2 Introdução
Este documento tem como objetivo o detalhamento técnico das interações com o WebService
SIGhRA para integração de sistemas. Trata-se de web service desenvolvido utilizando-se de
protocolo SOAP e XML para troca de informações.

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 6 de 77
Código
3 Métodos disponíveis
Campo Descrição
obterUltimaPosicao Obtém a última posição de todos os veículos da base.
obterPosicoes Histórico de posições utilizando posição inicial (id) como critério.
obterPosicoesPeriodo Histórico de posições informando período como critério.
obterPosicoesCriterio Histórico de posições informando uma combinação de critérios de busca.
obterMacros Histórico de macros utilizando macro inicial (id) como critério.
obterMacrosPeriodo Histórico de macros informando período como critério.
obterMacrosCriterio Histórico de macros informando uma combinação de critérios de busca.
obterMensagens Histórico de mensagens informando mensagem inicial (id) como critério.
obterMensagensPeriodo Histórico de mensagens informando período como critério.
obterMensagensCriterio Histórico de mensagens informando uma combinação de critérios de busca.
enviarMensagem Envio de mensagem para o veículo.
obterInfracoes Histórico de infrações utilizando infração inicial (id) como critério.
obterInfracoesPeriodo Histórico de infrações informando período como critério.
obterInfracoesCriterio Histórico de infrações informando uma combinação de critérios de busca.
obterTelemetria Histórico de relatórios de telemetria utilizando relatório inicial (id)
como critério.
obterTelemetriaPeriodo Histórico de relatórios de telemetria informando período como critério.
obterTelemetriaCriterio Histórico de relatórios de telemetria informando
uma combinação de critérios de busca.
enviarMotoristas Envia informação de motoristas para o veículo.
desativarMotoristas Desativa cadastro de motoristas.
ativarMotoristas Reativa cadastro dos motoristas.
enviarConfiguracoesMacro Envia grupos de macros para os veículos selecionados.
enviarConfiguracoesArea Envio de grupos de áreas para os veículos.
enviarConfiguracoesMensagemPre Envio de grupos de mensagens pré-formatadas para os veículos.
enviarComandoTelefonico Solicitação de contrassenha para execução de comando pelo motorista.
enviarComando Envio de comando para um veículo.
enviarConfiguracoesSensor Habilitação/Desabilitação de sensores para os veículos.
obterVersao Retorna a versão do WebService.

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 7 de 77
Código
3.1 obterUltimaPosicao
Método para obter a última posição dos veículos ativos cadastrados na base.
3.1.1 Parâmetros de Entrada

Nome Tipo Obrigatório Descrição
usuario String S Usuário de acesso ao sistema
senha String S Senha de acesso ao sistema
3.1.2 Exemplo de Requisição

<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ws="http://ws.sighra.com/">
<soapenv:Header/>
<soapenv:Body>
<ws:obterUltimaPosicao>
<usuario>usuario</usuario>
<senha>senha</senha>
</ws:obterUltimaPosicao>
</soapenv:Body>
</soapenv:Envelope>
3.1.3 Retorno
Nome Tipo Descrição
posicao List<Posicao> Lista contendo 0 ou mais posições.
codigoRetorno int 0 – Consulta retornada com sucesso
1 – Consulta não retornou dados
2-999 – Código de erro
mensagemRetorno String Mensagem representando o código de retorno.
3.1.4 Exemplo de Retorno

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
<S:Body>
<w:obterPosicoesResponse xmlns:w="http://ws.sighra.com/">
<return xmlns:ns0="http://ws.sighra.com/">
<posicao>
<alarme>false</alarme>
<cidade>PAULINIA</cidade>
<pontoReferencia>PAULINIA</ pontoReferencia>
<curso>302</curso>
<dataPosicao>2019-04-13T12:39:59-03:00</dataPosicao>
<dataRecepcao>2019-04-13T12:40:08-03:00</dataRecepcao>
<estado>SP</estado>
<idVeiculo>99999</idVeiculo>
<ignicao>true</ignicao>
<latitude>-22.7582</latitude>

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 8 de 77
Código
<logradouro>Não foi possível definir</logradouro>

<longitude>-47.1059</longitude>
<meioComunicacao>GPRS</meioComunicacao>
<placa>AAA9999</placa>
<sequencial>49676</sequencial>
<velocidade>0</velocidade>
<hodometro>104388</hodometro>
<numeroSat>11</numeroSat>
<dop>0</dop>
<tensaoBateria>25595</tensaoBateria>
<horimetro>1501904</horimetro>
<memoria>false</memoria>
<motorista>
<cpf>99999999999</cpf>
<idCliente>99999</idCliente>
<login>26355</login>
<nome>NOME DO MOTORISTA</nome>
<nomeCliente>NOME DO CLIENTE</nomeCliente>
</motorista>
<sensorAtuador>
<descricao>Porta Motorista</descricao>
<sigla>PM</sigla>
<descricaoStatus>Porta de Motorista Fechada</descricaoStatus>
<status>false</status>
<tipo>Sensor</tipo>
</sensorAtuador>
</posicao>
<codigoRetorno>0</codigoRetorno>
<mensagemRetorno>Consulta executada com sucesso</mensagemRetorno>
</return>
</w:obterPosicoesResponse>
</S:Body>
</S:Envelope>
3.1.5 Detalhe Retorno (Posicao)

Campo Tipo Descrição
sequencial Integer Número sequencial da última posição gerado pelo
equipamento
placa String Placa do veículo
idVeiculo Integer Id do veículo
frota String Identificação do veículo na Frota
dataRecepcao Date Data/Hora da recepção da posição no servidor
dataPosicao Date Data/Hora da geração da posição GPS
latitude Double Latitude do veículo
longitude Double Longitude do veículo

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 9 de 77
Código
curso Integer Curso (direção) do Veículo (em graus)

ignicao Boolean Indica se a ignição estava ligada no momento da geração da
posição
velocidade Integer Velocidade do veículo
hodometro Integer Hodômetro do Veículo (em metros)
meioComunicacao String Meio de comunicação utilizado no envio pelo equipamento
(GPRS ou Satelital)
alarme Boolean Indica se o equipamento estava em alarme
cidade String Cidade na qual o veículo se encontra
estado String Estado no qual o veículo se encontra
logradouro String Logradouro mais próximo
pontoReferencia String Ponto de referência mais próximo
numeroSat Integer Número de satélites utilizados para a obtenção da posição GPS
dop Integer DOP da última posição GPS
tensaoBateria Integer Tensão da bateria (em mV)
horimetro Integer Horímetro do veículo
memoria Boolean Indica se posição foi obtida da memória (histórico) ou se é
online.
motorista Motorista Motorista logado no veículo. Verificar Tipo 5.2.
statusSensor SensorAtuador Status dos Sensores/Atuadores

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 10 de 77
Código
3.2 obterPosicoes
3.2.1 Descrição
Método para obter histórico de posições a partir do ponteiro informado (id inicial) nos
parâmetros de entrada.
Retorno limitado a 1000 posições. Para obter as posições seguintes, o método deve ser
chamado novamente utilizando o último id obtido na chamada anterior.

idPosicao Long S Ponteiro (id inicial) para o retorno das posições.
Quando o valor informado for igual a 0 (zero), serão
consideradas as posições do dia atual.

<soapenv:Envelope
<soapenv:Header/>
<soapenv:Body>
<ws:obterPosicoes>
<idPosicao>0</idPosicao>
</ws:obterPosicoes>
</soapenv:Body>
</soapenv:Envelope>
3.2.4 Retorno
posicao List<Posicao> Lista contendo 0 ou mais posições.

<S:Body>
<w:obterPosicoesResponse xmlns:w="http://ws.sighra.com/">
<posicao>
<alarme>false</alarme>

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 11 de 77
Código
<cidade>PAULINIA</cidade>
<pontoReferencia>PAULINIA</pontoReferencia>
<curso>302</curso>
<dataPosicao>2019-04-13T12:39:59-03:00</dataPosicao>
<estado>SP</estado>
<id>7042006902089</id>
<ignicao>true</ignicao>
<dop>0</dop>
<tensaoBateria>25595</tensaoBateria>
<memoria>false</memoria>
<motorista>
<cpf>99999999999</cpf>
</motorista>
<sensorAtuador>
<descricao>Porta Motorista</descricao>
<sigla>PM</sigla>
<descricaoStatus>Porta de Motorista Fechada</descricaoStatus>
<tipo>Sensor</tipo>
</sensorAtuador>
</posicao>
</return>
</w:obterPosicoesResponse>
</S:Body>
</S:Envelope>
3.2.6 Detalhe Retorno (Posicao)


Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 12 de 77
Código
id Long Id da posição
sequencial Integer Número sequencial da posição gerado pelo equipamento
dataRecepcao Date Data/Hora da recepção da posição no servidor
idEvento Integer Código do evento. Verificar tabela 4.3.
dataPosicao Date Data/Hora da geração da posição GPS
ignição Boolean Indica se a ignição estava ligada no momento da geração da
posição
velocidade Integer Velocidade do veículo
hodometro Integer Hodômetro do Veículo (em metros)
(GPRS ou Satelital)
alarme Boolean Indica se o equipamento estava em alarme
tensaoBateria Integer Tensão da bateria (em mV)
horimetro Integer Horímetro do veículo
memoria Boolean Indica se posição foi obtida da memória (histórico) ou se é
online.
statusSensor SensorAtuador Status dos Sensores/Atuadores

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 13 de 77
Código
3.3 obterPosicoesPeriodo
3.3.1 Descrição
Método para obter histórico de posições no período informado nos parâmetros de entrada.
chamado novamente utilizando novo período.

dataIni String S Data inicial do período no formato “aaaa-mm-dd‘T’HH:mm:ss”
dataFim String S Data final do período no formato “aaaa-mm-dd‘T’HH:mm:ss”

<soapenv:Envelope
<soapenv:Header/>
<soapenv:Body>
<ws:obterPosicoesPeriodo>
<dataIni>2019-06-01T09:30:27</dataIni>
<dataFim>2019-06-01T14:30:27</dataFim>
</ws:obterPosicoesPeriodo>
</soapenv:Body>
</soapenv:Envelope>
3.3.4 Retorno
Igual ao método obterPosicoes.


Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 14 de 77
Código
3.4 obterPosicoesCriterio
3.4.1 Descrição
Método para obter histórico de posições utilizando uma combinação de critérios de entrada.
chamado novamente utilizando novos parâmetros.

requisicao RequisicaoPosicao S Parâmetros de Entrada (Verificar Abaixo)
3.4.3 RequisicaoPosicao
Nome Tipo Obr. Descrição
ultimaPosicao Boolean N Sinaliza se devem ser retornadas apenas as últimas posições dos
veículos. Caso utilizado, serão ignorados os critérios de id e de
data. Padrão: false.
id Long N Ponteiro (id inicial) para o retorno das posições. Quando o valor
informado for igual a 0 (zero), serão consideradas as posições do
dia atual. Será priorizado em relação aos critérios de data.
dataPosicaoInicio Date N Data inicial (GPS) do período no formato “aaaa-mm-dd’T’
HH:mm:ss”. Ex: 2020-10-01T00:00:00.
dataPosicaoFim Date N Data final (GPS) do período no formato “aaaa-mm-
dd’T’HH:mm:ss”. Ex: 2020-10-01T01:00:00.
dataRecepcaoInicio Date N Data inicial (Recepção) do período no formato “aaaa-mm-
dd’T’HH:mm:ss”.
dataRecepcaoFim Date N Data final (Recepção) do período no formato “aaaa-mm-
status Boolean N Sinaliza se devem ser retornadas informações de sensores e
atuadores no retorno. Padrão: true.
motorista Boolean N Sinaliza se devem ser retornadas informações de motorista no
retorno. Padrão: true.

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
<soapenv:Header/>
<soapenv:Body>
<ws:obterPosicoesCriterio>
<requisicao>
<id>0</id>

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 15 de 77
Código
</requisicao>
</ws:obterPosicoesCriterio>
</soapenv:Body>
</soapenv:Envelope>
3.4.5 Retorno


Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 16 de 77
Código
3.5 obterMacros
3.5.1 Descrição
Método para obter histórico de macros a partir do ponteiro informado nos parâmetros de
entrada.
Retorno limitado a 1000 macros. Para obter as macros seguintes, o método deve ser

idMacro Long S Ponteiro (id inicial) para o retorno das macros. Quando
o valor informado for igual a 0 (zero), serão
consideradas as macros do dia atual.

<soapenv:Envelope
<soapenv:Header/>
<soapenv:Body>
<ws:obterMacros>
<idMacro>0</idMacro>
</ws:obterMacros>
</soapenv:Body>
</soapenv:Envelope>
3.5.4 Retorno
macro List<Macro> Lista contendo 0 ou mais macros.

<S:Body>
<w:obterMacrosResponse xmlns:w="http://ws.sighra.com/">
<macro>
<cidade>PILAR DO SUL</cidade>

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 17 de 77
Código
<curso>72</curso>
<dataMacro>2019-07-11T23:59:58-03:00</dataMacro>
<estado>SÃO PAULO</estado>
<formulario>1-INICIO DE JORNADA LOGIN:[999 ] SENHA:[*****]</formulario>
<id>18746262</id>
<ignicao>false</ignicao>
<logradouro>Estrada Vicinal José Waldemar Mazzer</logradouro>
<dop>0</dop>
<macro>INICIO JORNADA</macro>
<numeroMacro>1</numeroMacro>
<placa>AAA-9999</placa>
<tipoMacro>Início de Jornada</tipoMacro>
<motorista>
<cpf>99999999999</cpf>
</motorista>
</macro>
</return>
</w:obterMacrosResponse>
</S:Body>
</S:Envelope>
3.5.6 Detalhe Retorno (Macro)

id Long Id da Macro
sequencial Integer Número sequencial da macro gerado pelo equipamento
dataRecepcao Date Data da recepção da macro no servidor

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 18 de 77
Código

ignição Boolean Indica se a ignição estava ligada no momento do envio da macro
velocidade Integer Velocidade do veículo no momento do envio da macro
(GPRS ou Satelital)
numeroMacro String Número da macro informada pelo motorista
dataMacro Date Data/Hora em que o motorista enviou a macro
macro String Nome da macro
formulario String Formulário preenchido pelo motorista no envio da macro
tipoMacro String Tipo da macro (Verificar Tabela 4.2)
hodometro Long Hodômetro do veículo

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 19 de 77
Código
3.6 obterMacrosPeriodo
3.6.1 Descrição
Método para obter histórico de macros no período informado nos parâmetros de entrada.

dataIni String S Data inicial do período no formato “aaaa-mm-dd’T’HH:mm:ss”
dataFim String S Data final do período no formato “aaaa-mm-dd’T’HH:mm:ss”

<soapenv:Header/>
<soapenv:Body>
<ws:obterMacrosPeriodo>
<dataIni>2019-06-01T09:30:27</dataIni>
<dataFim>2019-06-01T14:30:27</dataFim>
</ws:obterMacrosPeriodo>
</soapenv:Body>
</soapenv:Envelope>
3.6.4 Retorno
Igual ao método obterMacros.


Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 20 de 77
Código
3.7 obterMacrosCriterio
3.7.1 Descrição
Método para obter histórico de macros utilizando uma combinação de critérios de entrada.

requisicao RequisicaoMacro S Parâmetros de Entrada (Verificar Abaixo)
3.7.3 RequisicaoMacro
id Long N Ponteiro (id inicial) para o retorno das macros. Quando o
valor informado for igual a 0 (zero), serão consideradas
as macros do dia atual. Será priorizado em relação aos
critérios de data.
dataPosicaoInicio Date N Data inicial (GPS) do período no formato “aaaa-mm-dd’T’
HH:mm:ss”. Ex: 2020-10-01T00:00:00.
dd’T’HH:mm:ss”. Ex: 2020-10-01T01:00:00.
dataRecepcaoInicio Date N Data inicial (Recepção) do período no formato “aaaa-
mm-dd’T’HH:mm:ss”.

<soapenv:Header/>
<soapenv:Body>
<ws:obterPosicoesMacro>
<requisicao>
<id>0</id>
</requisicao>
</ws:obterPosicoesMacro>
</soapenv:Body>
</soapenv:Envelope>
3.7.5 Retorno

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 21 de 77
Código


Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 22 de 77
Código
3.8 obterMensagens
3.8.1 Descrição
Método para obter histórico de mensagens a partir do ponteiro informado nos parâmetros de
entrada.
Retorno limitado a 1000 mensagens. Para obter as mensagens seguintes, o método deve ser

idMensagem Long S Ponteiro (id inicial) para o retorno das mensagens.
consideradas as mensagens do dia atual.

<soapenv:Header/>
<soapenv:Body>
<ws:obterMensagens>
<idMensagem>0</idMensagem>
</ws:obterMensagens>
</soapenv:Body>
</soapenv:Envelope>
3.8.4 Retorno
mensagem List<Mensagem> Lista contendo 0 ou mais mensagens.

<S:Body>
<w:obterMensagensResponse xmlns:w="http://ws.sighra.com/">
<mensagem>
<cidade>CURITIBA</cidade>
<curso>128</curso>

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 23 de 77
Código
<dataMensagem>2019-07-11T23:59:53-03:00</dataMensagem>
<estado>PARANÁ</estado>
<id>5031102</id>
<ignicao>false</ignicao>
<logradouro>AC P/ROD BR-277</logradouro>
<dop>0</dop>
<mensagem>OK LIBERADO SMP: 9999999 - 11/07/2019 23:59:56</mensagem>
<origem>V</origem>
<idEvento>11024</idEvento>
</mensagem>
</return>
</w:obterMensagensResponse>
</S:Body>
</S:Envelope>
3.8.6 Detalhe Retorno (Mensagem)

Campo Descrição
id Long Id da mensagem
sequencial Integer Número sequencial da mensagem gerado pelo equipamento
dataRecepcao Date Data/Hora da recepção da mensagem no servidor
dataMensagem Date Data/Hora em que o motorista enviou a mensagem
ignição Boolean Indica se a ignição estava ligada no momento do envio da mensagem
velocidade Integer Velocidade do veículo no momento do envio da mensagem

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 24 de 77
Código
meioComunicacao String Meio de comunicação utilizado no envio pelo equipamento (GPRS

ou Satelital)
hodometro Long Hodômetro do Veículo
mensagem String Mensagem enviada pelo motorista ou operador
origem String Origem da Mensagem.
V = Veículo
O = Operação (Base)
idEvento Integer ID do evento correspondente ao tipo de mensagem.
Verificar tabela 4.3, eventos do tipo Mensagem.
3.9 obterMensagensPeriodo
3.9.1 Descrição
Método para obter histórico de mensagens no período informado nos parâmetros de entrada.
Retorno limitado a 1000 mensagens. Para obter as mensagens seguintes, o método deve ser


<soapenv:Header/>
<soapenv:Body>
<ws:obterMensagensPeriodo>
<dataIni>2019-06-01 09:30:27</dataIni>
<dataFim>2019-06-01 14:30:27</dataFim>
</ws:obterMensagensPeriodo>
</soapenv:Body>
</soapenv:Envelope>
3.9.4 Retorno
Igual ao método obterMensagens.

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 25 de 77
Código


Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 26 de 77
Código
3.10 obterMensagensCriterio
3.10.1 Descrição
Método para obter histórico de mensagens utilizando uma combinação de critérios de
entrada.
Retorno limitado a 1000 mensagens. Para obter as mensagensseguintes, o método deve ser

requisicao RequisicaoMensagem S Parâmetros de Entrada (Verificar Abaixo)
3.10.3 RequisicaoMensagem
id Long N Ponteiro (id inicial) para o retorno das mensagens. Quando o
valor informado for igual a 0 (zero), serão consideradas as
mensagens do dia atual. Será priorizado em relação aos
critérios de data.
dataPosicaoInicio Date N Data inicial (GPS) do período no formato “aaaa-mm-
dd’T’HH:mm:ss”. Ex: 2020-10-01T00:00:00.
dd’T’HH:mm:ss”. Ex: 2020-10-01T01:00:00.
dataRecepcaoInicio Date N Data inicial (Recepção) do período no formato “aaaa-mm-

<soapenv:Header/>
<soapenv:Body>
<ws:obterMensagensCriterio>
<requisicao>
<id>0</id>
</requisicao>
</ws:obterMensagensCriterio>
</soapenv:Body>
</soapenv:Envelope>

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 27 de 77
Código
3.10.5 Retorno


Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 28 de 77
Código
3.11 enviarMensagem
3.11.1 Descrição
Envio de mensagem para o veículo.

idVeiculo Integer S ID do veículo.
mensagem String S Texto da mensagem a ser enviadas. (Limite de 450
caracteres).

<soapenv:Header/>
<soapenv:Body>
<ws:enviarMensagem>
<mensagem>Não esqueça entregar a documentação no posto de fiscalização</mensagem>
</ws:enviarMensagem>
</soapenv:Body>
</soapenv:Envelope>
3.11.4 Retorno
codigoRetorno Integer 0 – Envio solicitado com sucesso

<S:Body>
<w:enviarMensagemResponse xmlns:w="http://ws.sighra.com/">
<mensagemRetorno>Envio solicitado com sucesso</mensagemRetorno>
</return>
</w:enviarMensagemResponse>
</S:Body>
</S:Envelope>

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 29 de 77
Código
3.12 obterInfracoes
3.12.1 Descrição
Método para obter histórico de infrações a partir do ponteiro informado nos parâmetros de
entrada.
Retorno limitado a 1000 infrações. Para obter as infrações seguintes, o método deve ser

idInfracao Long S Ponteiro (id inicial) para o retorno das infrações.
consideradas as primeiras infrações do dia atual.

<soapenv:Header/>
<soapenv:Body>
<ws:obterInfracoes>
<idInfracao>0</idInfracao>
</ws:obterInfracoes>
</soapenv:Body>
</soapenv:Envelope>
3.12.4 Retorno
infracao List<Infracao> Lista contendo 0 ou mais infrações.
codigoRetorno Integer 0 – Consulta retornada com sucesso

<S:Body>
<w:obterInfracoesResponse xmlns:w="http://ws.sighra.com/">
<infracao>
<cidade>SÃO BERNARDO DO CAMPO</cidade>

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 30 de 77
Código
<dataInfracao>2020-09-13T23:55:05-03:00</dataInfracao>
<duracao>17</duracao>
<id>113050581</id>
<infracao>INFRACAO_VELOCIDADE_MAXIMA</infracao>
<logradouro>Rodovia dos Imigrantes</logradouro>
<dop>0</dop>
<velocidadeLimite>80</velocidadeLimite>
<velocidadeMaxima>85</velocidadeMaxima>
<velocidadeMedia>83</velocidadeMedia>
<motorista>
<cpf>99999999999</cpf>
</motorista>
</infracao>
<infracao>
<cidade>GLORINHA</cidade>
<estado>RIO GRANDE DO SUL</estado>
<id>113051275</id>
<infracao>INFRACAO_VELOCIDADE_MAXIMA_CHUVA</infracao>
<logradouro>Freeway</logradouro>
<motorista>
<cpf>99999999999</cpf>
</motorista>

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 31 de 77
Código
<velocidadeLimite>60</velocidadeLimite>
</infracao>
<infracao>
<id>113051288</id>
<infracao>INFRACAO_ROTACAO</infracao>
<rotacaoLimite>2600</rotacaoLimite>
<rotacaoMaxima>2645</rotacaoMaxima>
</infracao>
<infracao>
<cidade>ITU</cidade>
<id>113051200</id>
<infracao>INFRACAO_BANGUELA</infracao>
<logradouro>Rodovia Presidente Castelo Branco</logradouro>
<motorista>
<cpf>99999999999</cpf>
</motorista>

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 32 de 77
Código
</infracao>
<infracao>
<desaceleracao>12</desaceleracao>
<desaceleracaoLimite>12</desaceleracaoLimite>
<id>113051267</id>
<infracao>INFRACAO_FRENAGEM_BRUSCA</infracao>
<logradouro>Rodovia Cônego Domênico Rangoni</logradouro>
<motorista>
<cpf>99999999999</cpf>
</motorista>
<velocidadeInicial>63</velocidadeInicial>
</infracao>
<infracao>
<cidade>RIO DE JANEIRO</cidade>
<dop>0</dop>
<estado>RJ</estado>
<forca>0.668</forca>
<forcaLimite>0.448</forcaLimite>
<id>167427944</id>
<logradouro>Estrada do Gabinal</logradouro>
<motorista>
<cpf>99999999999</cpf>

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 33 de 77
Código
</motorista>
<pontoReferencia>RIO DE JANEIRO</pontoReferencia>
<tipoInfracao>INFRACAO_GUINADA_BRUSCA_ESQUERDA</tipoInfracao>
<velocidadeInicial>31</velocidadeInicial>
</infracao>
</return>
</w:obterInfracoesResponse>
</S:Body>
</S:Envelope>
3.12.6 Detalhe Retorno (Infracao)

id Long Id da Macro
sequencial Integer Número sequencial da infração gerado pelo equipamento
dataRecepcao Date Data da recepção da infração no servidor
numeroSat Integer Número de satélites utilizados para a obtenção da posição
GPS
dataInfracao Date Data/Hora GPS que ocorreu a infração.
cidade String Cidade na qual o veículo se encontrava no momento da
infração
estado String Estado no qual o veículo se encontrava no momento da
infração
(GPRS ou Satelital)
tipoInfracao String Tipo da infração:
INFRACAO_VELOCIDADE_MAXIMA
INFRACAO_VELOCIDADE_MAXIMA_CHUVA

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 34 de 77
Código
INFRACAO_BANGUELA
INFRACAO_ROTACAO
INFRACAO_FRENAGEM_BRUSCA
INFRACAO_GUINADA_BRUSCA_DIREITA
INFRACAO_GUINADA_BRUSCA_ESQUERDA
INFRACAO_ACELERACAO_LONGITUDINAL
INFRACAO_DESACELERACAO_LONGITUDINAL
INFRACAO_VELOCIDADE_AREA_ROTOGRAMA
ALARME_TEMPO_MINIMO_REFEICAO
ALERTA_TEMPO_DIRECAO_EXCEDIDO
ALARME_TEMPO_DIRECAO_EXCEDIDO
ALERTA_TEMPO_JORNADA_EXCEDIDO
ALARME_TEMPO_JORNADA_EXCEDIDO
ALERTA_TEMPO_RESERVA_EXCEDIDO
ALARME_TEMPO_RESERVA_EXCEDIDO
ALERTA_TEMPO_HORA_EXTRA_EXCEDIDO
ALARME_TEMPO_HORA_EXTRA_EXCEDIDO
ALERTA_DIRECAO_HORARIO_NAO_PERMITIDO
ALARME_DIRECAO_HORARIO_NAO_PERMITIDO
ALERTA_REFEICAO_NAO_REALIZADA
ALARME_REFEICAO_NAO_REALIZADA
ALARME_TEMPO_JORNADA_DESCANSO_MIN
ALERTA_TEMPO_REFEICAO_TOTAL
velocidadeLimite Integer Velocidade limite configurada no equipamento (km/h).
Disponível para tipo(s):
velocidadeMaxima Integer Velocidade máxima aferida durante a infração (km/h).
INFRACAO_BANGUELA
duracao Integer Duração da infração em segundos.
INFRACAO_BANGUELA
INFRACAO_ROTACAO
desaceleracaoLimite Integer Desaceleração limite configurada no equipamento (km/h/s).

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 35 de 77
Código

desaceleracao Integer Desaceleração aferida durante a infração (km/h/s).
forcaLimite Double Força de aceleração ou desaceleração limite configurada no
equipamento (G).
forca Double Força de aceleração ou desaceleração aferida durante a
infração (G).
velocidadeInicial Integer Velocidade aferida no início da infração (km/h).
rotacaoLimite Integer Rotação máxima configurada no equipamento (rpm).
INFRACAO_ROTACAO
rotacaoMaxima Integer Rotação máxima aferida durante a infração (rpm).
INFRACAO_ROTACAO
velocidadeMedia Integer Velocidade média aferida durante a infração (km/h).

INFRACAO_BANGUELA
INFRACAO_ROTACAO
areaInfracao Integer Nome da Área de Rotograma onde ocorreu a infração.
Disponível para
tipo(s):INFRACAO_VELOCIDADE_AREA_ROTOGRAMA.

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 36 de 77
Código
3.13 obterInfracoesPeriodo
3.13.1 Descrição
Método para obter histórico de infrações no período informado nos parâmetros de entrada.


<soapenv:Header/>
<soapenv:Body>
<ws:obterInfracoesPeriodo>
<dataIni>2020-09-14 09:00:00</dataIni>
<dataFim>2020-09-14 10:00:00</dataFim>
</ws:obterInfracoesPeriodo>
</soapenv:Body>
</soapenv:Envelope>
3.13.4 Retorno
Igual ao método obterInfracoes.


Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 37 de 77
Código
3.14 obterInfracoesCriterio
3.14.1 Descrição
Método para obter histórico de infrações utilizando uma combinação de critérios de entrada.

requisicao RequisicaoInfracao S Parâmetros de Entrada (Verificar Abaixo)
3.14.3 RequisicaoInfracao
id Long N Ponteiro (id inicial) para o retorno das infrações. Quando
o valor informado for igual a 0 (zero), serão consideradas
as mensagens do dia atual. Será priorizado em relação
aos critérios de data.
dataPosicaoInicio Date N Data inicial (GPS) do período no formato “aaaa-mm-

<soapenv:Header/>
<soapenv:Body>
<ws:obterInfracoesCriterio>
<requisicao>
<id>0</id>
</requisicao>
</ws:obterInfracoesCriterio>
</soapenv:Body>
</soapenv:Envelope>
3.14.5 Retorno

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 38 de 77
Código


Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 39 de 77
Código
3.15 obterTelemetria
3.15.1 Descrição
Método para obter histórico de relatórios de telemetria a partir do ponteiro informado nos
parâmetros de entrada.
Retorno limitado por padrão a 1000 relatórios. Para obter os relatórios seguintes, o método
deve ser chamado novamente utilizando o último id obtido na chamada anterior.

Id Long S Ponteiro (id inicial) para o retorno dos relatórios de
telemetria. Quando o valor informado for igual a 0
(zero), serão considerados os primeiros relatórios do
dia atual.

<soapenv:Header/>
<soapenv:Body>
<ws:obterTelemetria>
<id>0</id>
</ws:obterTelemetria>
</soapenv:Body>
</soapenv:Envelope>
3.15.4 Retorno
infracao List<Infracao> Lista contendo 0 ou mais infrações.
codigoRetorno Integer 0 – Consulta retornada com sucesso

<S:Body>
<w:obterInfracoesResponse xmlns:w="http://ws.sighra.com/">

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 40 de 77
Código
<mensagemRetorno>Sucesso</mensagemRetorno>
<relatorioTelemetria>
<acionamentoFreio>0</acionamentoFreio>
<acionamentoParaBrisa>0</acionamentoParaBrisa>
<combustivelTotal>0</combustivelTotal>
<consumoMedio>0.0</consumoMedio>
<dataFim>2022-07-10T23:59:38-03:00</dataFim>
<dataInicio>2022-07-10T22:48:36-03:00</dataInicio>
<distancia>19920</distancia>
<id>130787924</id>
<mediaRotacao>0</mediaRotacao>
<motorista>
<cpf>99999999999</cpf>
</motorista>
<nivelArla>0</nivelArla>
<nivelCombustivel1>0</nivelCombustivel1>
<placa>GIB-6A68</placa>
<tempoAcelerandoMovimento>0</tempoAcelerandoMovimento>
<tempoAcelerandoParado>0</tempoAcelerandoParado>
<tempoDirecaoChuva>0</tempoDirecaoChuva>
<tempoDirecaoNoite>250</tempoDirecaoNoite>
<tempoFaixaAmarela>0</tempoFaixaAmarela>
<tempoFaixaAzul>0</tempoFaixaAzul>
<tempoFaixaVerde>0</tempoFaixaVerde>
<tempoFaixaVermelha>0</tempoFaixaVermelha>
<tempoFreioMotor>0</tempoFreioMotor>
<tempoInercia>0</tempoInercia>
<tempoInerciaFaixaAmarela>0</tempoInerciaFaixaAmarela>
<tempoInerciaFaixaVerde>0</tempoInerciaFaixaVerde>
<tempoInerciaFaixaVermelha>0</tempoInerciaFaixaVermelha>
<tempoMarchaLenta>16</tempoMarchaLenta>
<tempoMovimento>231</tempoMovimento>
<tempoSemAceleracaoEngrenado>0</tempoSemAceleracaoEngrenado>
<tempoTotal>0</tempoTotal>
<velocidadeMaximaChuva>0</velocidadeMaximaChuva>

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 41 de 77
Código
<velocidadeMaximaNoite>42</velocidadeMaximaNoite>
<velocidadeMediaChuva>0</velocidadeMediaChuva>
<velocidadeMediaNoite>16</velocidadeMediaNoite>
</relatorioTelemetria>
<relatorioTelemetria>
<acionamentoFreio>137</acionamentoFreio>
<acionamentoParaBrisa>0</acionamentoParaBrisa>
<combustivelTotal>56007368</combustivelTotal>
<consumoMedio>0.0</consumoMedio>
<dataFim>2022-07-10T23:38:03-03:00</dataFim>
<dataInicio>2022-07-10T22:44:06-03:00</dataInicio>
<distancia>51240</distancia>
<id>130787925</id>
<mediaRotacao>1080</mediaRotacao>
<motorista>
<cpf>99999999999</cpf>
</motorista>
<nivelArla>0</nivelArla>
<placa>GGP-3A43</placa>
<tempoAcelerandoMovimento>1541</tempoAcelerandoMovimento>
<tempoAcelerandoParado>0</tempoAcelerandoParado>
<tempoDirecaoChuva>0</tempoDirecaoChuva>
<tempoDirecaoNoite>250</tempoDirecaoNoite>
<tempoFaixaAmarela>0</tempoFaixaAmarela>
<tempoFaixaAzul>205</tempoFaixaAzul>
<tempoFaixaVerde>205</tempoFaixaVerde>
<tempoFaixaVermelha>0</tempoFaixaVermelha>
<tempoFreioMotor>18</tempoFreioMotor>
<tempoInercia>0</tempoInercia>
<tempoInerciaFaixaAmarela>3</tempoInerciaFaixaAmarela>
<tempoInerciaFaixaVerde>203</tempoInerciaFaixaVerde>
<tempoInerciaFaixaVermelha>2</tempoInerciaFaixaVermelha>
<tempoMarchaLenta>11</tempoMarchaLenta>
<tempoMovimento>238</tempoMovimento>
<tempoSemAceleracaoEngrenado>82</tempoSemAceleracaoEngrenado>

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 42 de 77
Código
<tempoTotal>0</tempoTotal>
<velocidadeMaximaChuva>0</velocidadeMaximaChuva>
<velocidadeMaximaNoite>83</velocidadeMaximaNoite>
<velocidadeMediaChuva>0</velocidadeMediaChuva>
<velocidadeMediaNoite>57</velocidadeMediaNoite>
</relatorioTelemetria>
</return>
</w:obterInfracoesResponse>
</S:Body>
</S:Envelope>
3.15.6 Detalhe Retorno (Infracao)

id Integer Id do Relatório
sequencial Integer Número sequencial do relatório gerado pelo
equipamento.
placa String Placa do veículo.
idVeiculo Integer Id do veículo.
frota String Identificação do veículo na Frota.
dataRecepcao Date Data da recepção do relatório de telemetria no
servidor.
dataInicio Date Data de início do relatório.
dataFim Date Data de final do relatório.
meioComunicacao String Meio de Comunicação (GPRS/Satelital).
tempoTotal Integer Tempo de duração do relatório (em segundos).
distancia Integer Distância percorrida (m).
hodometro Integer Hodômetro atual do veículo (KM).
horimetro Integer Horímetro atual do veículo.
tempoMarchaLenta Integer Tempo em marcha lenta (s).
consumoMedio Double Consumo médio do veículo.
tempoFaixaVerde Integer Tempo em faixa verde.
velocidadeMaxima Integer Velocidade máxima atingida.
velocidadeMediaChuva Integer Velocidade média em chuva.
velocidadeMaximaChuva Integer Velocidade máxima em chuva.
velocidadeMediaNoite Integer Velocidade média em período noturno.
velocidadeMaximaNoite Integer Velocidade máxima em período noturno.
tempoDirecaoChuva Integer Tempo de direção em chuva.
tempoDirecaoNoite Integer Tempo de direção em período noturno.
tempoMovimento Integer Tempo em movimento.
acionamentoParaBrisa Integer Número de acionamentos do para brisa.

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 43 de 77
Código
acionamentoFreio Integer Número de acionamentos do freio.

combustivelTotal Integer Total de combustível.
nivelCombustivel1 Integer Nível de combustível 1.
nivelCombustivel2 Integer Nível de combustível 2.
tempoAcelerandoParado Integer Tempo acelerando parado.
tempoSemAceleracaoEngrenado Integer Tempo sem aceleração com veículo engrenado.
tempoFreioMotor Integer Tempo de freio motor acionado.
tempoFaixaAzul Integer Tempo em faixa azul.
tempoFaixaAmarela Integer Tempo em faixa amarela.
tempoFaixaVermelha Integer Tempo em faixa vermelha.
tempoAcelerandoMovimento Integer Tempo acelerando com veículo em movimento.
mediaRotacao Integer Média de rotação.
tempoInercia Integer Tempo em inércia.
tempoInerciaFaixaVerde Integer Tempo em inércia faixa verde.
tempoInerciaFaixaAmarela Integer Tempo em inércia faixa amarela.
tempoInerciaFaixaVermelha Integer Tempo em inércia faixa vermelha.
nivelArla Integer Nível ARLA.

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 44 de 77
Código
3.16 obterTelemetriaPeriodo
3.16.1 Descrição
Método para obter histórico de relatório de telemetria no período informado nos parâmetros
de entrada.
Retorno limitado a 1000 relatórios por padrão. Para obter os relatórios seguintes, o método
deve ser chamado novamente utilizando novo período.


<soapenv:Header/>
<soapenv:Body>
<ws:obterTelemetriaPeriodo>
<dataIni>2020-09-14 09:00:00</dataIni>
<dataFim>2020-09-14 10:00:00</dataFim>
</ws:obterTelemetriaPeriodo>
</soapenv:Body>
</soapenv:Envelope>
3.16.4 Retorno
Igual ao método obterTelemetria.


Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 45 de 77
Código
3.17 obterTelemetriaCriterio
3.17.1 Descrição
Método para obter histórico de relatórios de telemetria utilizando uma combinação de critérios
de entrada.
Retorno limitado a 1000 relatórios por padrão. Para obter os relatórios seguintes, o método
deve ser chamado novamente utilizando novos parâmetros.

requisicao RequisicaoTelemetria S Parâmetros de Entrada (Verificar Abaixo)
3.17.3 RequisicaoTelemetria
id Long N Ponteiro (id inicial) para o retorno dos relatórios.
consideradas os relatórios do dia atual. Será priorizado
em relação aos critérios de data.
dataInicio Date N Data inicial do período no formato “aaaa-mm-
dataFim Date N Data final do período no formato “aaaa-mm-

<soapenv:Header/>
<soapenv:Body>
<ws:obterTelemetriaCriterio>
<requisicao>
<id>0</id>
</requisicao>
</ws:obterTelemetriaCriterio>
</soapenv:Body>
</soapenv:Envelope>

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 46 de 77
Código
3.17.5 Retorno


Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 47 de 77
Código
3.18 enviarMotoristas
Método para enviar informação dos motoristas para os veículos.

requisicao RequisicaoEmbarqueMotorista S Lista de embarque de motoristas.
(Verificar Abaixo)

<soapenv:Header/>
<soapenv:Body>
<ws:enviarMotoristas>
<requisicao>
<embarque>
<veiculo>
</veiculo>
<motorista>
</motorista>
<motorista>
<cpf>11111111111</cpf>
</motorista>
</embarque>
<embarque>
<veiculo>
</veiculo>
<motorista>
</motorista>
</embarque>
</requisicao>
</ws:enviarMotoristas>
</soapenv:Body>
</soapenv:Envelope>
3.18.3 RequisicaoEmbarqueMotorista

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 48 de 77
Código
embarque List<ComandoEmbarqueMotorista> S Lista de embarques a serem realizados.

(Verificar Abaixo)
3.18.4 ComandoEmbarqueMotorista
veiculo Veiculo S Veículo para o qual será enviada a informação dos
motoristas. Verificar Tipo 5.3.
Deverá ser informado um dos dois campos: placa ou
idVeiculo.
motorista List<Motorista> S Um ou mais motoristas a serem embarcados no
veículo. Verificar Tipo 5.2.
Deverá ser informado um dos dois campos: login ou
cpf.
codigoRetorno Integer - Somente utilizado no retorno.
0 – Requisição realizada com sucesso
mensagemRetorno String - Somente utilizado no retorno.
Mensagem representando o código de retorno.
3.18.5 Retorno
embarque List<ComandoEmbarqueMotorista> Lista contendo 0 ou mais posições.
codigoRetorno int 0 – Requisição realizada com sucesso
mensagemRetorno String Mensagem representando o código de
retorno.

<S:Body>
<w:enviarMotoristasResponse xmlns:w="http://ws.sighra.com/">
<embarque>
<veiculo>
<limiteMotorista>200</limiteMotorista>
</veiculo>
<motorista>
<cpf>11111111111</cpf>
</motorista>

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 49 de 77
Código
</embarque>
<embarque>
<veiculo>
</veiculo>
<embarque>
<veiculo>
</veiculo>
<mensagemRetorno>Veículo não encontrado</mensagemRetorno>
</embarque>
</return>
</w:enviarMotoristasResponse>
</S:Body>
</S:Envelope>
3.18.7 Detalhe Retorno (ComandoEmbarqueMotorista)

O retorno da requisição é semelhante ao formato de entrada, com as seguintes diferenças de
preenchimento:
- Adição de código de retorno para o arquivo como um todo. Caso seja retornado um erro no
arquivo (codigoRetorno > 0), nenhum motorista terá sido embarcado, em nenhum veículo.
- Adição de código de retorno para cada veículo. Caso seja retornado um código de erro
(codigoRetorno > 0), nenhum motorista foi embarcado para aquele veículo.
- Constarão no retorno apenas os motoristas cujo embarque foi realizado de forma bem-
sucedida, sendo ignorados motoristas não cadastrados.

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 50 de 77
Código
3.19 desativarMotoristas
Método para desativar o cadastro dos motoristas informados e enviar essa informação para
o SIGhRA SmartTab, evitando assim a realização de logins por motoristas desativados.

requisicao RequisicaoOperacaoMotorista S Lista de motoristas a serem desativados
(Verificar Abaixo).

<soapenv:Header/>
<soapenv:Body>
<ws:desativarMotoristas>
<requisicao>
<operacao>
<motorista>
</motorista>
</operacao>
<operacao>
<motorista>
</motorista>
</operacao>
</requisicao>
</ws:desativarMotoristas>
</soapenv:Body>
</soapenv:Envelope>
3.19.3 RequisicaoOperacaoMotorista
embarque List<ComandoMotorista> S Lista de motoristas a serem desativados
(Verificar abaixo).
3.19.4 ComandoMotorista
motorista Motorista S Motorista a ser desativado. Verificar Tipo 5.2.
cpf.

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 51 de 77
Código

3.19.5 Retorno
operacao List<ComandoMotorista> Lista contendo os motoristas cuja desativação foi
solicitada.

<S:Body>
<w:desativarMotoristasResponse xmlns:w="http://ws.sighra.com/">
<operacao>
<motorista>
<cpf>22222222222</cpf>
</motorista>
</operacao>
</return>
</w:desativarMotoristasResponse>
</S:Body>
</S:Envelope>
3.19.7 Detalhe Retorno (ComandoMotorista)

preenchimento:
arquivo (codigoRetorno > 0), nenhum motorista teve sua desativação solicitada.
- Adição de código de retorno para cada motorista. Caso seja retornado um código de erro
(codigoRetorno > 0), há algum erro na solicitação de desativação do motorista.
- Serão ignorados os motoristas não cadastrados.

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 52 de 77
Código
3.20 ativarMotoristas
Método para reativar o cadastro dos motoristas informados que tenham sido previamente
desativados e enviar essa informação para o SIGhRA SmartTab.

requisicao RequisicaoOperacaoMotorista S Lista de motoristas a serem reativados
(Verificar Abaixo).

<soapenv:Header/>
<soapenv:Body>
<ws:ativarMotoristas>
<requisicao>
<operacao>
<motorista>
</motorista>
</operacao>
<operacao>
<motorista>
</motorista>
</operacao>
</requisicao>
</ws:ativarMotoristas>
</soapenv:Body>
</soapenv:Envelope>
3.20.3 RequisicaoOperacaoMotorista
embarque List<ComandoMotorista> S Lista de motoristas a serem reativados
(Verificar abaixo).
3.20.4 ComandoMotorista
motorista Motorista S Motorista a ser reativado. Verificar Tipo 5.2.

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 53 de 77
Código

cpf.
3.20.5 Retorno
operacao List<ComandoMotorista> Lista contendo os motoristas cuja reativação foi
solicitada.

<S:Body>
<w:ativarMotoristasResponse xmlns:w="http://ws.sighra.com/">
<operacao>
<motorista>
<cpf>22222222222</cpf>
</motorista>
</operacao>
</return>
</w:ativarMotoristasResponse>
</S:Body>
</S:Envelope>
3.20.7 Detalhe Retorno (ComandoMotorista)

preenchimento:
arquivo (codigoRetorno > 0), nenhum motorista teve sua reativação solicitada.
- Adição de código de retorno para cada motorista. Caso seja retornado um código de erro
(codigoRetorno > 0), há algum erro na solicitação de reativação do motorista.

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 54 de 77
Código
- Serão ignorados os motoristas não cadastrados.

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 55 de 77
Código
3.21 enviarConfiguracoesArea
Método para enviar configuração dos grupos de área para o veículo.

requisicao RequisicaoConfiguracaoArea S Lista de configurações de áreas a serem
enviadas para os veículos

<soapenv:Header/>
<soapenv:Body>
<ws:enviarConfiguracoesArea>
<requisicao>
<configuracaoArea>
<veiculo>
</veiculo>
<grupoArea>
<idGrupo>1</idGrupo>
<idTipoArea>1</idTipoArea>
</grupoArea>
</configuracaoArea>
</requisicao>
</ws:enviarConfiguracoesArea>
</soapenv:Body>
</soapenv:Envelope>
3.21.3 RequisicaoConfiguracaoArea
configuracaoArea List< ComandoConfiguracaoArea> S Lista de configurações a serem
enviadas.
(Verificar Abaixo)
3.21.4 ComandoConfiguracaoArea
veiculo Veiculo S Veículo para o qual será enviado o grupo de áreas.
Verificar Tipo 5.3.
idVeiculo.

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 56 de 77
Código
grupoArea GrupoArea S Grupo de área a ser embarcado no veículo. Verificar

Tipo 5.4.
Deverá ser informado um dos dois campos: idGrupo
ou codigoGrupo.
Para apagar as áreas existentes no veículo, informar
idGrupo com o valor 0 (zero).
3.21.5 Retorno
configuracaoArea List<ComandoConfiguracaoArea> Lista contendo o retorno das configurações.

<S:Body>
<w:enviarConfiguracoesAreaResponse xmlns:w="http://ws.sighra.com/">
<configuracaoArea>
<veiculo>
<placa>ABC-1234</placa>
</veiculo>
<grupoArea>
<idTipoArea>1</idTipoArea>
<nome>Áreas de Risco</nome>
</grupoArea>
</configuracaoArea>
</return>
</w:enviarConfiguracoesAreaResponse>
</S:Body>
</S:Envelope>

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 57 de 77
Código
3.21.7 Detalhe Retorno (ComandoConfiguracaoArea)

preenchimento:
arquivo (codigoRetorno > 0), nenhuma configuração será enviada, em nenhum veículo.
(codigoRetorno > 0), nenhuma configuração foi enviada para aquele veículo.
- Constarão no retorno apenas as configurações enviadas de forma bem-sucedida, sendo
ignorados grupos de áreas não encontrados.

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 58 de 77
Código
3.22 enviarConfiguracoesMacro
Método para enviar configuração dos grupos de macro para o veículo.

requisicao RequisicaoConfiguracaoMacro S Lista de configurações de macros a
serem enviadas para os veículos

<soapenv:Header/>
<soapenv:Body>
<ws:enviarConfiguracoesMacro>
<requisicao>
<configuracaoMacro>
<veiculo>
</veiculo>
<grupoMacro>
</grupoMacro>
</configuracaoMacro>
</requisicao>
</ws:enviarConfiguracoesMacro>
</soapenv:Body>
</soapenv:Envelope>
3.22.3 RequisicaoConfiguracaoMacro
configuracaoMacro List< ComandoConfiguracaoMacro> S Lista de configurações a serem
enviadas.
(Verificar Abaixo)
3.22.4 ComandoConfiguracaoMacro
veiculo Veiculo S Veículo para o qual será enviado o grupo de macros.
Verificar Tipo 5.3.
idVeiculo.

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 59 de 77
Código
grupoMacro GrupoMacro S Grupo de macro a ser embarcado no veículo. Verificar

Tipo 5.5.
Deverá ser informado um dos dois campos: idGrupo
ou codigoGrupo.
Para apagar os grupos de macros existentes no
veículo, informar idGrupo com o valor 0 (zero).
3.22.5 Retorno
configuracaoMacro List<ComandoConfiguracaoMacro> Lista contendo o retorno das configurações.
codigoRetorno Integer 0 – Requisição realizada com sucesso
retorno.

<S:Body>
<w:enviarConfiguracoesMacroResponse xmlns:w="http://ws.sighra.com/">
<configuracaoMacro>
<veiculo>
</veiculo>
<grupoMacro>
<nome>JORNADA</nome>
</grupoMacro>
</configuracaoMacro>
</return>
</w:enviarConfiguracoesMacroResponse>
</S:Body>
</S:Envelope>

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 60 de 77
Código
3.22.7 Detalhe Retorno (ComandoConfiguracaoArea)

preenchimento:
arquivo (codigoRetorno > 0), nenhuma configuração será enviada, para nenhum veículo.
ignorados grupos de macros não encontrados.

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 61 de 77
Código
3.23 enviarConfiguracoesMensagemPre
Método para enviar configuração dos grupos de mensagens pré-formatadas para o veículo.

requisicao RequisicaoConfiguracaoMensagemPre S Lista de configurações de
mensagens pré a serem enviadas
para os veículos

<soapenv:Header/>
<soapenv:Body>
<ws:enviarConfiguracoesMensagemPre>
<requisicao>
<configuracaoMensagemPre>
<veiculo>
</veiculo>
<grupoMensagem>
</grupoMensagem>
</configuracaoMensagemPre>
</requisicao>
</ws:enviarConfiguracoesMensagemPre>
</soapenv:Body>
</soapenv:Envelope>
3.23.3 RequisicaoConfiguracaoMacro
configuracaoMensagemPre List<ComandoConfiguracaoMensagemPre> S Lista de configurações
a serem enviadas.
(Verificar Abaixo)
3.23.4 ComandoConfiguracaoMensagemPre
veiculo Veiculo S Veículo para o qual será enviado o grupo de
mensagens pré-formatadas. Verificar Tipo 5.3.
Deverá ser informado um dos dois campos:
placa ou idVeiculo.

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 62 de 77
Código
grupoMensagem GrupoMensagemPre S Grupo de mensagem pré-formatada a ser

embarcado no veículo. Verificar Tipo 5.6.
idGrupo ou codigoGrupo.
Para apagar os grupos de mensagens existentes
no veículo, informar idGrupo com o valor 0
(zero).
3.23.5 Retorno
configuracaoMensagemPre List<ComandoConfiguracaoMensagemPre> Lista contendo o retorno das
configurações.
codigoRetorno Integer 0 – Requisição realizada com
sucesso
mensagemRetorno String Mensagem representando o
código de retorno.

<S:Body>
<w:enviarConfiguracoesMensagemPreResponse xmlns:w="http://ws.sighra.com/">
<configuracaoMensagemPre>
<veiculo>
</veiculo>
<grupoMensagem>
<nome>Mensagens Padrão</nome>
</grupoMensagem>
</configuracaoMensagemPre>
</return>
</w:enviarConfiguracoesMensagemPreResponse>
</S:Body>
</S:Envelope>

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 63 de 77
Código
3.23.7 Detalhe Retorno (ComandoConfiguracaoMensagemPre)

preenchimento:
ignorados grupos de mensagens não encontrados.

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 64 de 77
Código
3.24 enviarConfiguracoesSensor
Método para habilitar/desabilitar sensores presentes no veículo.

requisicao RequisicaoConfiguracaoSensor S Lista de sensores a serem
habilitados/desabilitados nos veículos.

<soapenv:Header/>
<soapenv:Body>
<ws:enviarConfiguracoesSensor>
<usuario>admin</usuario>
<senha>admin</senha>
<requisicao>
<configuracaoSensor>
<veiculo>
</veiculo>
<sensor>
<sigla>P1</sigla>
<ativo>true</ativo>
</sensor>
<sensor>
<sigla>PM</sigla>
<ativo>false</ativo>
</sensor>
<sensor>
<sigla>PP</sigla>
</sensor>
</configuracaoSensor>
</requisicao>
</ws:enviarConfiguracoesSensor>
</soapenv:Body>
</soapenv:Envelope>
3.24.3 RequisicaoConfiguracaoSensor
configuracaoSensor List<ComandoConfiguracaoSensor> S Lista de configurações a serem
enviadas.

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 65 de 77
Código
(Verificar Abaixo)
3.24.4 ComandoConfiguracaoSensor
veiculo Veiculo S Veículo a serem configurados os sensores.
Verificar Tipo 5.3.
placa ou idVeiculo.
sensor List<ConfiguracaoSensor> S Lista de sensores a serem
habilitados/desabilitados.
Verificar Tipo 5.7.
Mensagem representando o código de
retorno.
3.24.5 Retorno
configuracaoSensor List<ComandoConfiguracaoSensor> Lista contendo o retorno das configurações.
retorno.

<S:Body>
<w:enviarConfiguracoesSensorResponse xmlns:w="http://ws.sighra.com/">
<configuracaoSensor>
<veiculo>
</veiculo>
<sensor>
<sigla>P1</sigla>
<ativo>true</ativo>
</sensor>
<sensor>
<sigla>PM</sigla>
</sensor>

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 66 de 77
Código
<sensor>
<sigla>PP</sigla>
</sensor>
</configuracaoSensor>
</return>
</w:enviarConfiguracoesSensorResponse>
</S:Body>
</S:Envelope>
3.24.7 Detalhe Retorno (ComandoConfiguracaoMensagemPre)

preenchimento:
- Sensores não encontrados no veículo serão ignorados.

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 67 de 77
Código
3.25 enviarComandoTelefonico
Método para geração de contra-senha para execução de comando por parte do motorista.

requisicao RequisicaoEnvioComandoTel S Requisição de comando a ser executado.

<soapenv:Header/>
<soapenv:Body>
<ws:enviarComandoTelefonico>
<usuario>admin</usuario>
<senha>admin</senha>
<requisicao>
<comando>
<veiculo>
</veiculo>
<idAplicacao>0</idAplicacao>
<idComando>10130</idComando>
<senha1>4EFE</senha1>
<senha2>BDFF</senha2>
<senha3>7EDB</senha3>
<senha4>FF3C</senha4>
</comando>
</requisicao>
</ws:enviarComandoTelefonico>
</soapenv:Body>
</soapenv:Envelope>
3.25.3 RequisicaoEnvioComandoTel
comando ComandoVeiculoTel S Comando a ser executado.
(Verificar Abaixo)
3.25.4 ComandoVeiculoTel
veiculo Veiculo S Veículo a serem configurados os sensores. Verificar
Tipo 5.3.
idVeiculo.

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 68 de 77
Código
idAplicacao Integer S Aplicação.

Informar 0.
idComando Integer S Verificar tabela 4.4.
senha1 String S Bloco 1 da senha informada pelo motorista.
contrasenha String - Somente utilizado no retorno.
Senha gerada a ser informada para o motorista.
3.25.5 Retorno
comando ComandoVeiculoTel Comando a ser executado.

<S:Body>
<w:enviarComandoTelefonicoResponse xmlns:w="http://ws.sighra.com/">
<comando>
<veiculo>
</veiculo>
<senha1>4EFE</senha1>
<senha2>BDFF</senha2>
<senha3>7EDB</senha3>
<senha4>FF3C</senha4>
<contrasenha>585826425</contrasenha>
</comando>
</return>
</w:enviarComandoTelefonicoResponse>
</S:Body>
</S:Envelope>

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 69 de 77
Código
3.25.7 Detalhe Retorno (ComandoVeiculoTel)

O retorno da requisição é semelhante ao formato de entrada, com a adição do campo
contrasenha. Esta senha deverá ser passada para o motorista para que o comando seja executado
no veículo.
Caso seja retornado um código de erro (codigoRetorno > 0), não será gerada contrasenha.

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 70 de 77
Código
3.26 enviarComando
3.26.1 Descrição
Envio de comando para o veículo.

idVeiculo Integer S ID do veículo.
idAplicacao Integer S Informar 0.
idComando Integer S Verificar tabela 4.4.

<soapenv:Header/>
<soapenv:Body>
<ws:enviarComando>
</ws:enviarComando>
</soapenv:Body>
</soapenv:Envelope>
3.26.4 Retorno (RespostaComando)

comando ComandoVeiculo Retorno do comando enviado (verificar abaixo).
codigoRetorno Integer 0 – Envio solicitado com sucesso
3.26.5 ComandoVeiculo
idVeiculo Integer S Veículo para o qual foi enviado o comando
idAplicacao Integer S Aplicação relacionada ao comando.
Informar 0.
idComando Integer S Código do Comando enviado
id Integer S ID do comando gerado.

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 71 de 77
Código


<S:Body>
<w:enviarComandoResponse xmlns:w="http://ws.sighra.com/">
<comando>
<id>372297</id>
</comando>
</return>
</w:enviarComandoResponse>
</S:Body>
</S:Envelope>

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 72 de 77
Código
3.27 obterVersao
3.27.1 Descrição
Método para obter a versão do WebService.

<soapenv:Header/>
<soapenv:Body>
<ws:obterVersao/>
</soapenv:Body>
</soapenv:Envelope>

<S:Body>
<w:obterVersaoResponse xmlns:w="http://ws.sighra.com/">
<return>01.06.00</return>
</w:obterVersaoResponse>
</S:Body>
</S:Envelope>

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 73 de 77
Código
4 Tabelas
4.1 Sensores/Atuadores
Sigla Descrição Status
Sensores
P1 Botão de Pânico 1 (true se botão de pânico acionado, false caso contrário)
P2 Botão de Pânico 2 true se botão de pânico acionado, false caso contrário
PM Porta de Motorista true se porta fechada
PP Porta de Passageiro true se porta fechada
PI Porta de Baú Intermediária true se porta fechada
PT Porta de Baú Traseira true se porta fechada
PL Porta de Baú Lateral true se porta fechada
IG Ignição true se porta fechada
CA Carreta true se carreta engatada
PN Painel Violação, true se painel violado
TJ Tela de Janela Violada true se janela violada
Atuadores
SI Sirene true se sirene ligada
ST Setas true se setas ligadas
BL Bloqueio true se bloqueio acionado
BC Bloqueio de Carreta true se bloqueio da carreta acionado
TT Trava de Baú Traseiro true se trava acionada
TL Trava de Baú Lateral true se trava acionada
TI Trava de Baú Interna true se trava acionada

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 74 de 77
Código
4.2 Tipos de Macro

Tipo
Início de Viagem
Parada
Operação
Solicitação
Reinício de Viagem
Fim de Viagem
Outros
Script de Segurança
Início de Jornada
Fim de Jornada
Refeição
Entrada em Reserva
Saída de Reserva
Início de Carregamento
Fim de Carregamento
Início de Descarregamento
Fim de Descarregamento
Início de Espera
Fim de Espera
Descanso

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 75 de 77
Código
4.3 Eventos
Código Descrição Tipo
1023 Posição de Histórico – Satelital Posição
1025 Mensagem Livre (Veículo para Base) Mensagem
1027 Mensagem Pré-Formatada (Veículo para Base) Mensagem
1038 Confirmação de Leitura de Mensagem de Texto (Veículo para Base) Mensagem
2108 Posição Automática (Veículo Parado com ignição desligada) Posição
2112 Posição Automática via Satélite Posição
2131 Posição Automática On Line Posição
2132 Posição de Histórico Posição
11024 Mensagem de Texto (Base para Veículo) Mensagem
11025 Mensagem Pré-Formatada (Base para Veículo) Mensagem
4.4 Comandos
Código Comando Aplicação
10128 Reset Alarmes e Desbloqueio (Limpando Perfil) 0
10129 Reset Alarmes e Desbloqueio (Mantendo Perfil) 0
10130 Iniciar Seqüência de Bloqueio 0
12048 Ativar Sirene 0
12049 Desativar Sirene 0
12052 Ativar Setas 0
12053 Desativar Setas 0
12054 Bloquear Veículo 0
12055 Desbloquear Veículo 0
12058 Travar Baú Porta Traseira 0
12059 Destravar Baú Porta Traseira 0
12060 Travar Baú Porta Lateral 0
12061 Destravar Baú Porta Lateral 0
12062 Travar Baú Porta Interna 0
12063 Destravar Baú Porta Interna 0
12064 Destravar Baú Porta Traseira + Travamento Automático 0
12065 Destravar Baú Porta Lateral + Travamento Automático 0
12066 Destravar Baú Porta Interna + Travamento Automático 0
12070 Bloquear Veículo fixando Status de Alarme 0

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 76 de 77
Código
5 Tipos Comuns
5.1 Status dos Sensores/Atuadores (SensorAtuador)

tipo String ‘Sensor’ ou ‘Atuador’
sigla String Verificar Tabela 4.1
descrição String Descrição do Sensor/Atuador
status Boolean Verificar Tabela 4.1
descricaoStatus String Descrição do Status
5.2 Motorista
cpf String CPF do Motorista
login String Login do Motorista
nome String Nome do Motorista
idCliente Integer Cliente do Motorista
nomeCliente String Nome do Cliente do Motorista
5.3 Veiculo
idVeiculo Integer ID do veículo.
placa String Placa do Veículo.
idFrota String Identificação de Frota do Veículo.
idCliente Integer ID do Cliente ao qual o veículo está associado.
limiteMotorista Integer Limite de motoristas que podem ser embarcados no veículo.
5.4 GrupoArea
idGrupo Integer ID do Grupo.
Obrigatório informar o idGrupo ou códigoGrupo no envio.
idTipoArea Integer Tipo de grupo de área a ser enviado:
1 – Área de Risco
2 – Centro de Distribuição
3 – Áreas de Entrega/Coleta
4 – Área de Checagem (Checkpoint)
5 – Área de Parada Autorizada
6 – Área de Rotograma.
Obrigatório.
nome String Somente utilizado no retorno.
Nome do grupo.

Data 03/02/2023
Versão 1.7.3
Cópia
Páginas 77 de 77
Código
codigoGrupo Integer Código do grupo configurado pelo cliente.

Obrigatório informar codigoGrupo ou idGrupo.
5.5 GrupoMacro
Nome do grupo.
5.6 GrupoMensagemPre
Nome do grupo.
5.7 ConfiguracaoSensor
sigla String Sigla do Sensor a ser habilitado/desabilitado.
Verificar tabela 4.1.
ativo boolean Informar true para habilitar o sensor, false para desabilitar o sensor


Documentacao Web Service SIGhRA v01.07.03

Enviado por

Dados do documento

Descrição original:

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Documentacao Web Service SIGhRA v01.07.03

Enviado por

Direitos autorais:

Formatos disponíveis

Data 03/02/2023

Web Service SOAP

Autores Carlos Henrique da Cunha Pereira

Projeto e propriedade intelectual – SIGHRA SISTEMAS INOVADORES

1.1 Histórico de Versões ......................................................................................................... 4

3.1 obterUltimaPosicao ........................................................................................................... 7

3.2 obterPosicoes ................................................................................................................. 10

3.3 obterPosicoesPeriodo ..................................................................................................... 13

3.4 obterPosicoesCriterio ...................................................................................................... 14

3.5 obterMacros .................................................................................................................... 16

3.6 obterMacrosPeriodo ........................................................................................................ 19

3.7 obterMacrosCriterio ......................................................................................................... 20

3.9 obterMensagensPeriodo ................................................................................................. 24

3.10 obterMensagensCriterio .................................................................................................. 26

3.11 enviarMensagem ............................................................................................................. 28

3.12 obterInfracoes ................................................................................................................. 29

3.13 obterInfracoesPeriodo ..................................................................................................... 36

3.14 obterInfracoesCriterio ...................................................................................................... 37

3.15 obterTelemetria ............................................................................................................... 39

3.16 obterTelemetriaPeriodo ................................................................................................... 44

3.17 obterTelemetriaCriterio .................................................................................................... 45

3.18 enviarMotoristas .............................................................................................................. 47

3.19 desativarMotoristas ......................................................................................................... 50

3.20 ativarMotoristas ............................................................................................................... 52

3.21 enviarConfiguracoesArea ................................................................................................ 55

Projeto e propriedade intelectual – SIGHRA SISTEMAS INOVADORES

3.22 enviarConfiguracoesMacro .............................................................................................. 58

3.24 enviarConfiguracoesSensor ............................................................................................ 64

3.25 enviarComandoTelefonico ............................................................................................... 67

3.26 enviarComando ............................................................................................................... 70

4.1 Sensores/Atuadores ........................................................................................................ 73

4.2 Tipos de Macro................................................................................................................ 74

4.3 Eventos ........................................................................................................................... 75

4.4 Comandos ....................................................................................................................... 75

5 Tipos Comuns ....................................................................................................................... 76

5.1 Status dos Sensores/Atuadores (SensorAtuador) ........................................................... 76

5.2 Motorista ......................................................................................................................... 76

5.3 Veiculo ............................................................................................................................ 76

5.5 GrupoMacro .................................................................................................................... 77

5.6 GrupoMensagemPre ....................................................................................................... 77

5.7 ConfiguracaoSensor ........................................................................................................ 77

Projeto e propriedade intelectual – SIGHRA SISTEMAS INOVADORES

1.1 Histórico de Versões

Adição de método para verificação da versão.

Adição de informação de número de satélites e dop na infração, macro

Adição de métodos obterPosicoesCriterio, obterMacrosCriterio,

Adição de infrações de jornada.

Adição de código de evento no retorno de posições.

Adição de método para embarque de motoristas (enviarMotoristas).

Projeto e propriedade intelectual – SIGHRA SISTEMAS INOVADORES

Adição de métodos de obtenção de infrações.

Projeto e propriedade intelectual – SIGHRA SISTEMAS INOVADORES

Projeto e propriedade intelectual – SIGHRA SISTEMAS INOVADORES

3.1.1 Parâmetros de Entrada

3.1.2 Exemplo de Requisição

3.1.4 Exemplo de Retorno

Projeto e propriedade intelectual – SIGHRA SISTEMAS INOVADORES

<logradouro>Não foi possível definir</logradouro>

3.1.5 Detalhe Retorno (Posicao)

Projeto e propriedade intelectual – SIGHRA SISTEMAS INOVADORES

curso Integer Curso (direção) do Veículo (em graus)

Projeto e propriedade intelectual – SIGHRA SISTEMAS INOVADORES

3.2.2 Parâmetros de Entrada