Skip to main content

TIPOS DE MENSAGENS

Os tipos de mensagens podem ser divididos em solicitações (request) e resposta (response) pela outra parte. O não envio da resposta em tempo hábil para uma mensagem do tipo “Request” poderá ocasionar seu repetido reenvio, em intervalos regulares por um número determinado de vezes. O tempo máximo de resposta (timeout), quantidade de repetições de envio e tempo de espera entre reenvio deverão ser configuráveis no sistema de controle de OSA.

Os seguintes tipos de mensagem estão disponíveis para uso pelos sistemas:

MENSAGEM ENVIADA POR SITUAÇÃO DE USO
MsgHandshake ambos Primeiro comunicação entre os sistemas
MsgPreEntryRequest OSA Solicitação de entrada
MsgPreEntryResponse LINK Resposta à solicitação de entrada
MsgPostEntryNotification OSA Confirmação de entrada
MsgPreExitrequest OSA Solicitação de saída
MsgPreExitResponse LINK Resposta à solicitação de saída
MsgExitAuthorization OSA Confirmação de saída
MsgPostExitNotification LINK Resposta à confirmação de saída
MsgCancelTicketRequest LINK Solicitação de cancelamento de entrada
MsgCancelTicketResponse OSA Confirmação de cancelamento de entrada
MsgHandshake

Esta mensagem deverá ser enviada uma única vez, no início da comunicação entre os sistemas.

CAMPO TIPO DESCRIÇÃO EXEMPLO
DateTime string Data e hora local do sistema 20201230164505.000 
{
  "DateTime":"20201230164505.000"
}


MsgPreEntryRequest

Esta mensagem deverá ser enviada sempre que o sistema de controle dea OSA desejar realizar a entrada de um veículo.

CAMPO TIPO DESCRIÇÃO EXEMPLO
DateTime string Data e hora local do sistema 20201230164505.000
Issuer string Entidade responsável pelo meio de pagamento OSA
VehicleId string Placa do veículo ABC1234
Lane string Identificação da pista na qual o veículo foi detectado e identificado EN01
Message string Opcional. Mensagem de texto para ser exibida ao motorista do veículo, contendo, no máximo 20 caracteres SALDO: 15,00 
{
  "DateTime":"20201230164505.000",
  "Issuer":"OSA",
  "VehicleId":"ABC1234",
  "Lane":"EN01",
  "Message":"SALDO: 15,00"
}

 

MsgPreEntryResponse

Esta mensagem deverá ser enviada como resposta a uma solicitação de entrada.

CAMPO TIPO DESCRIÇÃO EXEMPLO
DateTime string Data e hora local do sistema 20201230164505.000
VehicleId string Placa do veículo ABC1234
CanContinue boolean Indica se a OSA tem autorização para continuar o processamento do veículo true
Reason string Texto com o motivo da rejeição do veículo null
TicketNumber string Número do ticket gerado pela LINK 2012123456 
{
  "DateTime":"20201230164505.000",
  "VehicleId":"ABC1234",
  "CanContinue": true,
  "Reason":null,
  "TicketNumber":"2012123456"
}

MsgPostEntryNotification

Esta mensagem deverá ser enviada pela OSA após o recebimento de uma mensagem MsgPreEntryResponse com CanContinue=true, para informar a confirmação do processamento do veículo. A LINK não responde essa mensagem.

CAMPOTIPODESCRIÇÃOEXEMPLO
VehicleIdstringPlaca do veículoABC1234
TicketNumberstringNúmero do ticket gerado pela LINK2012123456
LanestringIdentificação da pista na qual o veículo foi detectado e identificadoEN01
{
  "VehicleId":"ABC1234",
  "TicketNumber":"2012123456",
  "Lane":"EN01"
}

MsgPreExitRequest

Esta mensagem deverá ser enviada sempre que a OSA desejar realizar a saída de um veículo.

CAMPOTIPODESCRIÇÃOEXEMPLO
DateTimestringData e hora local do sistema20201230164505.000
IssuerstringEntidade responsável pelo meio de pagamentoOSA
VehicleIdstringPlaca do veículoABC1234
LanestringIdentificação da pista na qual o veículo foi detectado e identificadoEN01
MessagestringOpcional. Mensagem de texto para ser exibida ao motorista do veículo, contendo, no máximo 20 caracteresSALDO: 15,00
TicketNumberstringNúmero do ticket gerado pela LINK2012123456
{
  "DateTime":"20201230164505.000",
  "Issuer":"OSA",
  "VehicleId":"ABC1234",
  "Lane":"EN01",
  "Message":"SALDO: 15,00",
  "TicketNumber":"2012123456"
}

MsgPreExitResponse

Esta mensagem deverá ser enviada como resposta a uma solicitação de saída.

CAMPOTIPODESCRIÇÃOEXEMPLO
DateTimestringData e hora local do sistema20201230164505.000
VehicleIdstringPlaca do veículoABC1234
CanContinuebooleanIndica se a OSA tem autorização para continuar o processamento do veículotrue
ReasonstringTexto com o motivo da rejeição do veículonull
TicketNumberstringNúmero do ticket gerado pela LINK2012123456
TotalAmountDuedecimalValor total da tarifa devida, já calculados os descontos123.45
DiscountdecimalValor total dos descontos concedidos0.00
DiscountReasondecimalTexto explicando os descontosnull
StayTimeMinutesintegerTempo de permanência em minutos123
{
  "DateTime":"20201230164505.000",
  "VehicleId":"ABC1234",
  "CanContinue": true,
  "Reason":null,
  "TicketNumber":"2012123456",
  "TotalAmountDue":123.45,
  "Discount":0.00
  "DiscountReason":null,
  "StayTimeMinutes":123
}

MsgExitAuthorization

Esta mensagem deverá ser enviada pela OSA em resposta a uma mensagem MsgPreExitResponse. Sua função é informar à LINK a respeito do processamento da saída do veículo. Esta mensagem é enviada após a OSA determinar se o veículo tem saldo para o pagamento da tarifa informada na mensagem MsgPreEntryResponse e informa à LINK sobre a autorização para liberação do controle de acesso físico (cancela). Sendo assim, a LINK abrirá a cancela somente após o recebimento e processamento desta mensagem, caso ela contenha uma autorização positiva.

CAMPOTIPODESCRIÇÃOEXEMPLO
TicketNumberstringNúmero do ticket gerado pela LINK2012123456
LanestringIdentificação da pista na qual o veículo foi detectado e identificadoEN01
CanContinuebooleanIndica se a OSA tem autorização para continuar o processamento do veículotrue
ReasonstringTexto com o motivo da rejeição do veículonull
{
  "TicketNumber":"2012123456",
  "Lane":"EN01",
  "CanContinue":true,
  "Reason":null
}

 

MsgPostExitAuthorization

Esta mensagem deverá ser enviada pela LINK em resposta a uma mensagem MsgExitAuthorization.

CAMPOTIPODESCRIÇÃOEXEMPLO
TicketNumberstringNúmero do ticket gerado pela LINK2012123456
{
  "TicketNumber":"2012123456"
}

 

 

 

 

 

Back to top