MONITRIIP Documento de Interface de Software Versão 1.
Sumár 1. INTRODUÇÃO... 4. ARQUITETURA DO SERVIÇO... 4.1. Padrões técnicos... 4.. Padrão de codificação... 4.3. Padrão de comunicação... 4.4. Padrão de Mensagens... 4.4.1. Mensagens de autenticação (Cód. Retorno 0)... 4.4.. Mensagens de sucesso (Cód. Retorno 1)... 4.4.3. Mensagens de erro (Cód. Retorno )... 5.4.1. Mensagens de erros não identificados (Cód. Retorno 4)... 5 3. FORMAS DE INTEGRAÇÃO... 5 4. AMBIENTES... 5 5. DICIONÁRIO DE DADOS.... AUTENTICAÇÃO Método Valida Token....1. Fluxo de autenticação..... Parâmetros de autenticação... 7. métodos de integração... 7 7.1. InserirLogVendaPassagem... 7 7.1.1. Descrição... 7 7.1.. Parâmetros... 7 7.. InserirLogRegistroOcorrenciaRodoviar... 8 7..1. Descrição... 8 7... Parâmetros... 8 7.3. InserirLogCartaoEmitidoRecargaEfetuada... 9 7.3.1. Descrição... 9 7.3.. Parâmetros... 9 7.4. InserirLogRegistroOcorrenciaSemiUrbano... 10 7.4.1. Descrição... 10 7.4.. Parâmetros... 10 7.5. InserirLogVelocidadeTempoLocalizacao... 11 7.5.1. Descrição... 11 7.5.. Parâmetros... 11 7.. InserirLogJornadaTrabalhoMotorista... 1 7..1. Descrição... 1 7... Parâmetros... 1 7.7. InserirLogDetectorParada... 13 Página 1 de 1
7.7.1. Descrição... 13 7.7.. Parâmetros... 13 7.8. InserirLogInicFimViagemRegular... 14 7.8.1. Descrição... 14 7.8.. Parâmetros... 14 7.9. InserirLogInicFimViagemFretamento... 15 7.9.1. Descrição... 15 7.9.. Parâmetros... 15 7.10. InserirLogBilheteEmbarque... 1 7.10.1. Descrição... 1 7.10.. Parâmetros (Viagem)... 17 7.10.3. Parâmetros (BilheteEmbarque - List)... 17 7.11. InserirLogLeitorCartaoRFID... 18 7.11.1. Descrição... 18 7.11.. Parâmetros (Viagem)... 18 7.11.3. Parâmetros (LeitorCartao - List)... 19 8. INFORMAÇÕES COMPLEMENTARES... 19 8.1. Tabelas de domín:... 19 8.1.1. Tabela que define o domín do campo CodigoServico:... 19 8.1.. Tabela que define o domín do campo CodigoViagem:... 19 8.1.3. Tabela que define o domín do campo CodigoMotivoDesconto:... 19 8.1.4. Tabela que define o domín do campo CodigoOcorrencia:... 0 8.1.5. Tabela que define o domín do campo CodigoCartao:... 0 8.1.. Tabela que define o domín do campo CodigoMotivoParada:... 1 Página de 1
Documento de Interface de Software 1. INTRODUÇÃO. ARQUITETURA DO SERVIÇO.1. Padrões técnicos Não se aplica.. Padrão de codificação Não se aplica.3. Padrão de comunicação Os códigos de retorno devem possuir 4 tipos. Código de retorno de mensagem 0 Erro de autenticação 1 Ação executada com sucesso. Erro de validação 3 Erro não identificado..4. Padrão de Mensagens.4.1. Mensagens de autenticação (Cód. Retorno 0) Identificador Mensagem 001 Token {0} Inválido (0 Número do Token). 00 Token {0} Inativo (0 Número do Token). Token {0} passado não tem permissão ao 003 serviço {1} (0 Número do Token, 1 Nome do serviço solicitado)..4.. Mensagens de sucesso (Cód. Retorno 1) Identificador Mensagem 101 [metodo] registrado com sucesso Página 4 de 1
.4.3. Mensagens de erro (Cód. Retorno ) Código Restrição Mensagem 01 Domin = [valor] O valor do campo [parâmetro] é inválido. 0 NumeroChar [mínimo] e [máximo] 03 ValidaEmail E-mail inválido. 04 ValidaCNPJ CNPJ inválido 05 ValidaData Data inválida. O valor do campo [parâmetro] é inválido. É permitida a inclusão de valores entre [mínimo] e [máximo]. 0 NumeroChar = [limite de caracteres] Número de caracteres do campo [parâmetro] inválido. 07 ValidaHora Hora inválida. 08 ValidaCPF CPF inválido..4.1. Mensagens de erros não identificados (Cód. Retorno 4) Identificador 301 Erro inesperado. Mensagem 3. FORMAS DE INTEGRAÇÃO Tecnologia WebService Barramento de Serviços Banco (view e/ou table) Fila de Mensagem Transferência de Arquivo Componente de software Outro (especificar) 4. AMBIENTES Página 5 de 1
Desenvolvimento Teste Homologação Produção 5. DICIONÁRIO DE DADOS Campo Significado. AUTENTICAÇÃO MÉTODO VALIDA TOKEN.1. Fluxo de autenticação.. Parâmetros de autenticação Parâmetros de Entrada Parâmetro Descrição Valores e formatos possíveis gatór Token Campo único alfanumérico de até 3 caracteres que identifica a aplicação Identificador único e global Não Parâmetros de Saída Parâmetro Valores e formatos possíveis Não se aplica Página de 1
7. MÉTODOS DE INTEGRAÇÃO InserirLogVendaPassagem; InserirLogRegistroOcorrenciaRodoviar; InserirLogCartaoEmitidoRecargaEfetuada; InserirLogRegistroOcorrenciaSemiUrbano; InserirLogVelocidadeTempoLocalizacao; InserirLogJornadaTrabalhoMotorista; InserirLogDetectorParada; InserirLogInicFimViagemRegular; InserirLogInicFimViagemFretamento; InserirLogBilheteEmbarque; InserirLogLeitorCartaoRFID; 7.1. InserirLogVendaPassagem 7.1.1. Descrição Realiza a inclusão da quantidade de passagens vendidas durante um determinado período. A execução desse método é realizada ao menos uma vez ao dia, somente para subsistema não embarcados e o transporte regular (semiurbano e rodoviár) 7.1.. Parâmetros ga tór IdLog Identificador de Log 0 Integer CodigoBilheteEmbarque Código identificador do bilhete de embarque [0, 1] 0 = Normal; Integer 01 = Gratuidade; CNPJEmpresa CNPJ da empresa ValidarCNPJ() 14 NumeroChar = 14 NumeroSerieEquipamento Número de série do NumeroChar(1..0); Fiscal equipamento fiscal que emitiu o 0 bilhete de passagem NumeroBilheteEmbarque Número do bilhete de NumeroChar(1..9); 9 embarque DataEmissaoBilhete Data de emissão do bilhete de embarque AAAAMMDD; 8 DataValida(); HoraEmissaoBilhete CodigoCategoria Transporte Hora de emissão do bilhete de embarque Categoria do Transporte NumeroChar HHMMSS; HoraValida(); NumeroChar = ; [0, 1,, 3, 4] 1 = interestadual = internacnal 3 = intermunicipal 4 = municipal String Integer Página 7 de 1
IdentificacaoLinha Identificação da linha 8 NumeroChar = 8; IdPontoOrigem Código do ponto de origem da MIN:0 0 Viagem viagem Integer IdPontoDestino Código do ponto de destino da MIN:0 0 Viagem viagem Integer CodigoServico de serviço [0, 1,, 3, 4, 5,, 7] Domín ver Item 8.1.1 Integer DataViagem Data da viagem 8 AAAAMMDD; DataValida(); NumeroChar = 8; HoraViagem Hora da viagem HHMMSS; HoraValida(); NumeroChar = ; CodigoViagem de viagem [0, 1,,.., 99] Domín ver Item 8.1. Integer NumeroPoltrona Número da poltrona 7 Integer PlataformaEmbarque Plataforma de Embarque 15 NumeroChar(1..15); CodigoMotivoDesconto Motivo do desconto [1,,.., 1] Domín ver Item 8.1.3 Integer ValorTarifa Valor da Tarifa Min: 0; Decimal(10, 10 Max: 9999; ) PercentualDesconto Percentual de desconto Min: 0; Decimal(5, 5 Max: 100; ) AliquotaICMS Percentual da Alíquota do Min: 0; Decimal(5, 5 ICMS Max: 100; ) ValorPedag Valor do Pedág Min: 0; Decimal(10, 10 Max: 9999 ) ValorTaxaEmbarque Valor da Taxa de embarque Min: 0; Decimal(10, 10 Max: 9999 ) ValorTotal Valor Total Min: 0; Decimal(10, 10 Max: 9999 ) NomePassageiro Nome do Passageiro 50 NumeroChar(3..50); DocumentoIdentificacao Documento de identificação do NumeroChar(1..0); 0 Passageiro passageiro CPFPassageiro CPF do Passageiro ValidarCPF(); 11 NumeroChar = 11; String Não CelularPassageiro Celular do passageiro 1 NumeroChar(10..1); String Não 7.. InserirLogRegistroOcorrenciaRodoviar 7..1. Descrição Realiza a inclusão das ocorrências geradas automaticamente quando um passageiro registrar uma ocorrência em um Ponto de Registro de Ocorrências. A execução desse método é realizada ao menos uma vez ao dia, somente para subsistema não embarcados e o transporte regular rodoviár. 7... Parâmetros Página 8 de 1
ga tór IdLog Identificador de Log Integer NumeroBilheteEmbarque Número do bilhete de NumeroChar(1..9); 9 embarque NomeReclamante Nome completo do reclamante 50 NumeroChar(3..50); DocumentoIdentificacao Documento de identificação do NumeroChar(1..0); 0 Reclamante reclamante EnderecoReclamante Endereço do reclamante 80 NumeroChar(10..80); String Não TelefoneContato Telefone de contato do NumeroChar(10..1); 1 Reclamante reclamante emailreclamante E-mail do reclamante 50 NumeroChar(5..50); String ValidaEmail(); Não CodigoOcorrencia de ocorrência [0, 1,,.., 99] Domín ver Item 8.1.4 Integer DataOcorrencia Data da ocorrência 8 AAAAMMDD; DataValida(); NumeroChar = 8; HoraOcorrencia Hora da ocorrência HHMMSS HoraValida(); NumeroChar = ; DataRegistroOcorrencia Data do registro da ocorrência 8 AAAAMMDD; DataValida(); NumeroChar = 8; HoraRegistroOcorrencia Hora do registro da ocorrência HHMMSS HoraValida(); NumeroChar = ; DescricaoOcorrencia Descrição da ocorrência 104 NumeroChar(10..104) NumeroProtocolo Número do Protocolo 15 NumeroChar(1..15) 7.3. InserirLogCartaoEmitidoRecargaEfetuada 7.3.1. Descrição Realiza a inclusão de cartões emitidos ou recargas efetuadas deve ser gerado automaticamente quando o sistema de venda de cartões da empresa de transporte finalizar uma venda. A execução desse método é realizada ao menos uma vez ao dia, somente para subsistema não embarcados e o transporte regular semiurbano. 7.3.. Parâmetros gatór IdLog Identificador de Log 1 Integer Página 9 de 1
CNPJEmpresa CNPJ da empresa ValidarCNPJ() 14 NumeroChar = 14 CodigoCategoria Transporte Categoria do transporte [0, 1,, 3, 4] 1 = interestadual = internacnal Integer 3 = intermunicipal 4 = municipal NumeroCartao Número do cartão 0 NumeroChar(1..0); CodigoCartao de cartão [0, 1,, 3] Domín ver Item 8.1.5 Integer DataVenda Data da venda 8 AAAAMMDD; DataValida(); NumeroChar = 8; HoraVenda Hora da viagem HHMMSS; HoraValida(); NumeroChar = ; BonusRecarga Bônus de recarga Min: 0; 10 Max: 9999 Decimal(10,) ValorTotalRecarga Valor da total da recarga Min: 0; 10 Max: 9999 Decimal(10,) SaldoTotalCartao Saldo total do cartão Min: 0; 10 Max: 9999 Decimal(10,) NomePassageiro Nome do Passageiro 50 NumeroChar(3..50); DocumentoIdentificacao Documento de identificação do NumeroChar(1..0); 0 Passageiro passageiro CPFPassageiro CPF do Passageiro ValidarCPF(); 11 NumeroChar = 11; String Não CelularPassageiro Celular do passageiro 1 NumeroChar(10..1); String Não 7.4. InserirLogRegistroOcorrenciaSemiUrbano 7.4.1. Descrição Realiza a inclusão das ocorrências geradas automaticamente quando um passageiro registrar uma ocorrência em um Ponto de Registro de Ocorrências. A execução desse método é realizada ao menos uma vez ao dia, somente para subsistema não embarcados e o transporte regular semiurbano. 7.4.. Parâmetros Valores, Restrições e IdLog Identificador de Log 3 Integer IdentificacaoLinha Identificação da linha 8 NumeroChar(4..8); EmpresaResponsavel Empresa Responsável 80 NumeroChar(3..80); gatór Página 10 de 1
NomeReclamante Nome completo do reclamante 50 NumeroChar(3..50); DocumentoIdentificacao Documento de identificação do NumeroChar(1..0); 0 Reclamante reclamante EnderecoReclamante Endereço do reclamante 80 NumeroChar(10..80); String Não TelefoneContato Telefone de contato do NumeroChar(10..1); 1 Reclamante reclamante emailreclamante E-mail do reclamante 50 NumeroChar(5..50); String ValidaEmail(); Não CodigoOcorrencia de ocorrência [0, 1,,.., 99] Domín ver Item 8.1.4 Integer DataOcorrencia Data da ocorrência 8 AAAAMMDD DataValida(); NumeroChar = 8; HoraOcorrencia Hora da ocorrência HHMMSS HoraValida(); NumeroChar = ; DataRegistroOcorrencia Data do registro da ocorrência 8 AAAAMMDD DataValida(); NumeroChar = 8; HoraRegistroOcorrencia Hora do registro da ocorrência HHMMSS HoraValida(); NumeroChar = ; DescricaoOcorrencia Descrição da ocorrência 104 NumeroChar(10..104) NumeroProtocolo Número do Protocolo 15 NumeroChar(1..15) 7.5. InserirLogVelocidadeTempoLocalizacao 7.5.1. Descrição Realiza a inclusão dos dados de velocidade, tempo e localização deve ser gerado automaticamente a cada 30 ou 0 segundos, conforme o caso, e também quando a situação da porta ou ignição for alterada. O intervalo de criação do log deve ser parametrizável, permitindo alterá-lo a qualquer tempo. A execução desse método é realizada somente para subsistema embarcado e para todos os tipos de transporte 7.5.. Parâmetros gatór IdLog Identificador de Log 4 Integer CNPJEmpresaTransporte CNPJ da empresa de ValidarCNPJ() 14 Transporte NumeroChar = 14 PlacaVeiculo Placa do veículo 8 NumeroChar(7..8); VelocidadeAtual Velocidade Atual 3 Min: 0; Integer Página 11 de 1
Max: 00; DistanciaPercorrida Distância percorrida pelo Min: 0; 8 veículo Max: 9999 SituacaoIgnicaoMotor Situação da ignição do motor 1 [0,1] 0 = Desligado; 1 = Ligado; SituacaoPortaVeiculo Situação da porta do veículo 1 [0,1] 0 = Fechada; 1 = Aberta; Latitude Latitude Max: 90,0; Min: -90,0; DATUM: Longitude Longitude Max: 180,0; Min: -180,0; DATUM: PDOP PDOP (Positn Dilutn of Precisn) DataHoraEvento Data e hora do registro da ocorrência IMEI Número IMEI do equipamento de transmissão aaaa-mmddthh:mm:ss Hora deve considerar padrão UTC Integer Integer Integer Decimal(3,0) Decimal(3,0) Decimal(10,) String 18 Integer 7.. InserirLogJornadaTrabalhoMotorista 7..1. Descrição A jornada de trabalho do motorista deve ser gerada automaticamente sempre que o motorista se identificar e sempre que houver alteração no status da ignição. A execução desse método é realizada somente para subsistema embarcado e para todos os tipos de transporte. 7... Parâmetros gatór IdLog Identificador de Log 5 Integer CNPJEmpresaTransporte CNPJ da empresa de ValidarCNPJ(); 14 Transporte NumeroChar = 14 PlacaVeiculo Placa do veículo 8 NumeroChar(7..8); CPFMotorista CPF do Motorista ValidarCPF(); 11 NumeroChar = 11; Página 1 de 1
RegistroEvento de Registro do Evento 1 [0,1] 0 = Fim; Integer 1 = Iníc; Latitude Latitude Max: 90,0; Min: -90,0; DATUM: Decimal(3,0) Longitude Longitude Max: 180,0; Min: -180,0; DATUM: Decimal(3,0) PDOP PDOP (Positn Dilutn of Precisn) Decimal(10,) DataHoraEvento Data e hora do evento aaaa-mmddthh:mm:ss Hora deve considerar padrão UTC IMEI Número IMEI do equipamento de transmissão 18 Integer 7.7. InserirLogDetectorParada 7.7.1. Descrição O registro do detector de parada deve ser gerado sempre que o veículo parar completamente, a porta for aberta e fechada, e o veículo reiniciar o movimento. Por padrão o terminal integrado ao Subsistema Embarcado selecnará a opção de parada programada, se não houver outra indicação de motivo de parada. A execução desse método é realizada para todos os tipos de transporte. 7.7.. Parâmetros gatór IdLog Identificador de Log Integer CNPJEmpresaTransporte CNPJ da empresa de ValidarCNPJ(); 14 Transporte NumeroChar = 14 PlacaVeiculo Placa do veículo 8 NumeroChar(7..8); CodigoMotivoParada Motivo da parada ou evento [0, 1,,.., 10] Domín ver Item Integer 8.1. Latitude Latitude Max: 90,0; Min: -90,0; DATUM: Decimal(3,0) Página 13 de 1
Longitude Longitude Max: 180,0; Min: -180,0 DATUM: Decimal(3,0) PDOP PDOP (Positn Dilutn of Precisn) Decimal(10,) DataHoraEvento Data e hora do evento aaaa-mmddthh:mm:ss Hora deve considerar padrão UTC IMEI Número IMEI do equipamento de transmissão 18 Integer 7.8. InserirLogInicFimViagemRegular 7.8.1. Descrição O registro de iníc/fim da viagem deve ser gerado automaticamente quando o motorista ou um funcnár da empresa de transporte iniciar/finalizar uma viagem através de terminal integrado ao Subsistema Embarcado. A execução desse método é realizada somente para os tipos de transporte regular (Semiurbano e rodoviár). 7.8.. Parâmetros gatór IdLog Identificador de Log 7 Integer CNPJEmpresaTransporte CNPJ da empresa de ValidarCNPJ(); 14 Transporte NumeroChar = 14 PlacaVeiculo Placa do veículo 8 NumeroChar(7..8); IdentificacaoLinha Identificação da linha 8 NumeroChar = 8 Integer CodigoViagem de viagem [0, 1,,.., 99] Domín ver Item Integer 8.1. DataProgramadaViagem Data programada da viagem 8 AAAAMMDD; DataValida(); NumeroChar = 8; HoraProgramadaViagem Hora programada da viagem ; HHMMSS HoraValida(); NumeroChar = ; RegistroViagem de Registro da Viagem 1 [0, 1,, 3] 0 = Fim; 1 = Iníc; = Fim com Transbordo; 3 = Iníc com Transbordo Integer Página 14 de 1
SentidoLinha Sentido da linha 1 [0, 1] 0 = Volta; 1 = Ida; Integer Latitude Latitude Max: 90,0; Min: -90,0; DATUM: Decimal(3,0) Longitude Longitude Max: 180,0; Min: -180,0 DATUM: Decimal(3,0) PDOP PDOP (Positn Dilutn of Precisn) Decimal(10,) DataHoraEvento Data e hora do evento aaaa-mmddthh:mm:ss Hora deve considerar padrão UTC IMEI Número IMEI do equipamento de transmissão 18 Integer 7.9. InserirLogInicFimViagemFretamento 7.9.1. Descrição O registro de iníc/fim da viagem deve ser gerado automaticamente quando o motorista ou um funcnár da empresa de transporte iniciar/finalizar uma viagem através de terminal integrado ao Subsistema Embarcado. A execução desse método é realizada somente para os tipos de transporte fretado. 7.9.. Parâmetros gatór IdLog Identificador de Log 8 Integer CNPJEmpresaTransporte CNPJ da empresa de ValidarCNPJ(); 14 Transporte NumeroChar = 14 PlacaVeiculo Placa do veículo 8 NumeroChar(7..8); AutorizacaoViagem Código da autorização de NumeroChar(1..18) 18 viagem RegistroViagem de Registro da Viagem [0, 1,, 3] 0 = Fim; 1 1 = Iníc; = Fim com Integer Transbordo; 3 = Iníc com Página 15 de 1
SentidoLinha Sentido da linha 1 Transbordo [0, 1] 0 = Volta; 1 = Ida; Integer Latitude Latitude Max: 90,0; Min: -90,0; DATUM: Decimal(3,0) Longitude Longitude Max: 180,0; Min: -180,0 DATUM: Decimal(3,0) PDOP PDOP (Positn Dilutn of Precisn) Decimal(10,) DataHoraEvento Data e hora do evento aaaa-mmddthh:mm:ss Hora deve considerar padrão UTC IMEI Número IMEI do equipamento de transmissão 18 Integer 7.10. InserirLogBilheteEmbarque 7.10.1. Descrição A inclusão do registro do leitor do bilhete de embarque deve ser gerada automaticamente quando da detecção de uma leitura válida. O Subsistema Embarcado deve agrupar todos os logs gerados e enviá-los em até 30 minutos após o veículo entrar em movimento ou na próxima parada, o que ocorrer primeiro. Se em movimento, ele deve associar todos os logs gerados à data, hora, latitude e longitude em que o veículo abriu a porta no ponto de embarque anterr. No caso de erro de leitura do código de barras do bilhete, a empresa de transporte de passageiros deverá disponibilizar me de inserção de dados de contingência para o registro do número do bilhete de embarque, como a disponibilização de teclado numérico físico ou em tela sensível ao toque. Devido à possibilidade de transbordo e/ou utilização de veículos de terceiros, deve ser permitida a leitura de bilhete de embarque emitido por outras empresas de transporte, com as quais foi firmado acordo operacnal para uso de seus veículos. A execução desse método é realizada somente para os tipos de transporte rodoviár. Página 1 de 1
7.10.. Parâmetros (Viagem) gatór IdLog Identificador de Log 9 Integer CNPJEmpresaTransporte CNPJ da empresa de 14 ValidarCNPJ(); Transporte NumeroChar = 14 PlacaVeiculo Placa do veículo 8 NumeroChar(7..8); Latitude Latitude Max: 90,0; Min: -90,0; DATUM: Longitude Longitude Max: 180,0; Min: -180,0 DATUM: PDOP PDOP (Positn Dilutn of Precisn) DataHoraAberturaPorta Data e hora de abertura da porta aaaa-mmddthh:mm:ss Hora deve considerar padrão UTC IMEI Número IMEI do equipamento de transmissão 7.10.3. Parâmetros (BilheteEmbarque - List) Decimal(3,0) Decimal(3,0) Decimal(10,) String 18 Integer NumeroEquipamento últimos dígitos do nº de série NumeroChar = ; Fiscal do equipamento fiscal emissor NumeroBilheteEmbarque últimos dígitos do número do NumeroChar = ; bilhete de embarque IdentificacaoLinha Identificação da linha 8 NumeroChar = 8; DataPrevistaViagem Data prevista da viagem 8 AAAAMMDD; DataValida(); NumeroChar = 8; HoraPrevistaViagem CodigoDesconto ValorTarifa PercentualDesconto Hora prevista da viagem Código do desconto Valor da Tarifa Percentual de desconto CelularPassageiro Número de celular do passageiro 10 5 1 HHMMSS; HoraValida(); NumeroChar = ; [0, 1,, 5,, 7, 8, 9, 10, 11, 1] Domín ver Item 8.1.3 Min: 0; Max: 9999 Min: 0; Max: 100; NumeroChar(10..1); String Integer Decimal(10,) Decimal(5,) String gatór Não Não Página 17 de 1
IdPontoOrigem Viagem IdPontoDestino Viagem Código do ponto de origem da viagem Código do ponto de destino da viagem Min: 0; Min: 0; Integer Integer 7.11. InserirLogLeitorCartaoRFID 7.11.1. Descrição A inclusão do registro do leitor de cartão de embarque RFID deve ser gerado automaticamente quando da detecção de uma leitura válida. O Subsistema Embarcado deve agrupar todos os logs gerados e enviá-los em até 30 minutos após o veículo entrar em movimento ou na próxima parada, o que ocorrer primeiro. Se em movimento, ele deve associar todos os logs gerados à data, hora, latitude e longitude em que o veículo abriu a porta no ponto de embarque anterr. A execução desse método é realizada somente para os tipos de transporte semiurbano. 7.11.. Parâmetros (Viagem) gatór IdLog Identificador de Log 10 Integer CNPJEmpresaTransporte CNPJ da empresa de 14 ValidarCNPJ(); Transporte NumeroChar = 14 PlacaVeiculo Placa do veículo 8 NumeroChar(7..8); Latitude Latitude Max: 90,0; Min: -90,0; DATUM: Longitude Longitude Max: 180,0; Min: -180,0; DATUM: PDOP PDOP (Positn Dilutn of Precisn) DataHoraAberturaPorta Data e hora de abertura da porta aaaa-mmddthh:mm:ss Hora deve considerar padrão UTC IMEI Número IMEI do equipamento de transmissão Decimal(3,0) Decimal(3,0) Decimal(10,) String 18 Integer Página 18 de 1
7.11.3. Parâmetros (LeitorCartao - List) gatór NumeroCartao Número do cartão 0 NumeroChar(1..0); CodigoCartao de cartão [0, 1,, 3] Domín ver Item 8.1.5 Integer ValorTarifa Valor Debitado (tarifa) Min: 0; 10 Max: 9999; Decimal(10,) 8. INFORMAÇÕES COMPLEMENTARES 8.1. Tabelas de domín: 8.1.1. Tabela que define o domín do campo CodigoServico: CodigoServico Uso 1 Convencnal com sanitár Convencnal sem sanitár 3 Semileito 4 Leito com ar condicnado 5 Leito sem ar condicnado Executivo 7 Semiurbano 8.1.. Tabela que define o domín do campo CodigoViagem: Código do de viagem Uso 00 regular 01 extra01 0 extra0 03 extra03...... XX extraxx 8.1.3. Tabela que define o domín do campo CodigoMotivoDesconto: Código do Motivo Uso do desconto 01 Tarifa Normal sem desconto 0 Tarifa Promocnal - Parágrafo 3º, art. 7 do Decreto nº.51/98 05 Bilhete de Viagem do Idoso 100% - Inciso I, art. 40 da Lei nº 10.741/03 Página 19 de 1
0 Bilhete de Viagem do Idoso 50% - Inciso II, art. 40 da Lei nº 10.741/03 07 Autorização de Viagem - Passe Livre Art. 1º da Lei nº 8.899/94 08 Passe Livre Auditores e Agentes do Trabalho - Art. 34 do Decreto nº 4.55/0 09 Gratuidade de Criança - Inciso XVII, art. 9 do Decreto nº.51/98 10 Gratuidade Jovem de Baixa Renda 100% - Inciso I, art. 3 da Lei nº 1.85/13 11 Gratuidade Jovem de Baixa Renda 50% - Inciso II, art. 3 da Lei nº 1.85/13 1 Autorização de Viagem - Passe Livre Acompanhante Art. 1º da Lei nº 8.899/94 8.1.4. Tabela que define o domín do campo CodigoOcorrencia: de ocorrência Uso 0 reservado 1 Sugestão Reclamação 3 Elog 4 Solicitação 5 Dano de Bagagem Extrav de Bagagem 7 Vlação de Bagagem 8 Pesquisa de Opinião 9 reservado...... 99 reservado 8.1.5. Tabela que define o domín do campo CodigoCartao: Código do de Uso Cartão 00 tarifa normal 01 promocnal 0 vale-transporte 03 gratuidade Página 0 de 1
8.1.. Tabela que define o domín do campo CodigoMotivoParada: Código do Motivo Uso de parada 00 parada programada 01 solicitação de passageiro 0 solicitação de motorista 03 solicitação externa 04 solicitação agente rodoviár ou fiscalização 05 acidente na via 0 acidente com o veículo 07 acidente com passageiro 08 defeito no veículo 09 troca programada de veículo 10 outro Página 1 de 1