Validações
As validações permitem às equipas compreender a utilização da rede e melhorar a oferta para os utilizadores.
O que são transações de validação?
São transações do tipo 11 geradas pelos equipamentos embarcados sempre que um passageiro efetua a validação do seu título de transporte (passe/zapping) ou compra um bilhete de bordo.
Estas transações são fundamentais pois permitem registar cada entrada e/ou saída de um passageiro no sistema de transportes públicos. É possível contabilizar o número de pessoas transportados em cada viagem, percurso, linha ou paragem, compreender quais serviços estão a ser mais utilizados, e com isso ajustar a rede para melhor responder às necessidades dos utilizadores.
Estrutura Simplificada
| Propriedade | Tipo | Descrição |
|---|---|---|
| _id | GUID | identificador único da transação |
| agency_id | STRING | código do Operador de transporte |
| apex_version | STRING | versão da APEX em utilização |
| card_serial_number | STRING | número de série do título de transporte do passageiro (codificado) |
| category | ENUM | categoria do tipo de título de transporte utilizado: ocasional a bordo -> on_board_sale ocasional pré-pago -> prepaid passe mensal -> subscription |
| created_at | INTEGER | timestamp (data+hora) da geração da transação |
| device_id | STRING | identificador do equipamento embarcado que gerou a transação |
| event_type | ENUM | tipo de validação (entrada/saída/reentrada/entrada com recuperação) |
| is_passenger | BOOLEAN | verificação de que 1) a validação é válida e 2) não tem uma anulação associada (para aferição do número de passageiros transportados) |
| line_id | STRING | código identifiador da linha |
| pattern_id | STRING | código identificador do percurso |
| trip_id | STRING | código identificador da circulação |
| stop_id | STRING | código identificador da paragem |
| vehicle_id | STRING | identificador do veículo |
| updated_at | INTEGER | timestamp (data+hora) da integração da transação nos sistemas da TML |
| mac_sam_serial_number | INTEGER | identificador do número de série do cartão SAM que gerou a transação |
| mac_ase_counter_value | INTEGER | número de contador incremental associado à transação, atribuído pelo equipamento embarcado, que permite a avaliação da sequencialidade das transações geradas por aquele cartão SAM |
| on_board_refund_id | GUID | identificador único do reembolso a que a validação está associada, quando aplicável |
| on_board_sale_id | GUID | identificador único da venda do título de bordo a que a validação está associada, quando aplicável |
| product_id | STRING | identificador do tipo de título utilizado |
| units_qty | INTEGER | valor descontado do cartão (apenas aplicável quando o título utilizado é ocasional pré-pago) |
| validation_status | ENUM | resultado da validação |