Reembolsos
Um reembolso regista o acto de devolução de uma compra.
O que é são transações de reembolso?
Reembolso é um evento referente a uma devolução de uma compra de um produto (bilhete de bordo, passe mensal, etc.). Na APEX um reembolso é uma transação do tipo 6. No GO focamo-nos apenas em reembolsos de títulos de bordo.
Estrutura Simplificada
| Propriedade | Tipo | Descrição |
|---|---|---|
| _id | GUID | Identificador único da transação de reembolso. |
| agency_id | Identificador único do Operador. | |
| apex_version | Versão do protocolo APEX utilizado para comunicar a transação. | |
| block_id | Identificação do plano de trabalho de um veículo. Placa - Conjunto de Circulações, Deslocações em Vazio e Tempos de Reserva cumpridos por um mesmo veículo. | |
| card_physical_type | ENUM | Tipo de suporte físico do cartão do passageiro. |
| card_serial_number | Número de série identificador do cartão associado à transação. | |
| created_at | UNIX Timestamp em milisegundos do momento em que a transação foi criada no equipamento local. | |
| device_id | GUID | Identificador único do equipamento que regista a transação APEX de reembolso. |
| duty_id | Identificação do plano de trabalho de um motorista/maquinista. Chapa - Conjunto de Circulações, Deslocações em Vazio e Tempos de Reserva em que intervém um mesmo motorista. | |
| line_id | Identificador da linha em que ocorreu a transação. | |
| mac_ase_counter_value | Valor no contador de transações APEX feitos pelo cartão SAM que se encontra no equipamento que regista a venda. | |
| mac_sam_serial_number | Número de série do cartão SAM que se encontra no equipamento que regista a venda. | |
| on_board_sale_id | Identificador da venda do título de bordo a que o reembolso está associado. | |
| pattern_id | Código de identificação do percurso de viagem associado ao reembolso. | |
| payment_method | ENUM | Modo de pagamento do reembolso. |
| price | Preço em céntimos de EUR, associado à transação. O valor é negativo devido a ser uma operação de reembolso. | |
| product_long_id | STRING | Identificador do produto, ou seja, do tipo de título da viagem que está a ser reembolsada. |
| product_quantity | NUM | Número de unidades vendidas/carregadas no cartão reembolsadas. |
| received_at | UNIX Timestamp em milisegundos do momento em que a transação foi recebida na central de base de dados. | |
| stop_id | Identificador único da paragem. | |
| trip_id | Identificador único da trip de um determinado plano de operação de um determinado operador. | |
| updated_at | UNIX Timestamp em milisegundos da última atualização deste refund. | |
| validation_id | Identificador único da validação. | |
| vehicle_id | STRING | Identificador do veículo, unívoco por operador. |