Ticket

Campos

Campo	Tipo	Descrição
`ticketId`	`UUID`	Identificador único
`orderId`	`UUID`	Referência ao pedido
`cooperativeId`	`UUID`	Cooperativa responsável pelo ticket
`transportOperatorId`	`UUID`	Permissionário que opera a viagem
`tripId`	`UUID`	Referência à viagem
`tripItineraryId`	`UUID`	Referência ao itinerário
`seatId`	`UUID`	Referência ao assento
`seatTypeId`	`UUID`	Referência ao tipo de assento
`passengerId`	`UUID`	Referência ao Passenger
`passengerBenefitRequestId`	`UUID?`	Solicitação aprovada usada pelo passageiro neste ticket
`benefitDocumentValidationId`	`UUID?`	Documento validado que comprovou o benefício aplicado
`seatPrice`	`Int`	Preço do tipo de assento no momento da emissão (centavos)
`tripItineraryPrice`	`Int`	Preço do itinerário no momento da emissão (centavos)
`baseAmount`	`Int`	Valor bruto da passagem antes de descontos e crédito
`benefitDiscountAmount`	`Int`	Desconto aplicado por benefício tarifário
`discountAmount`	`Int`	Soma dos descontos aplicados
`creditAmount`	`Int`	Crédito corporativo capturado neste ticket
`paidAmount`	`Int`	Valor pago por meio externo depois de descontos e crédito
`price`	`Int`	Valor final comercial da passagem após descontos, antes do crédito
`qrCode`	`String`	Payload codificado para validação de embarque
`code`	`String`	Código legível da passagem
`snapshot`	`Json?`	Snapshot denormalizado (trip, itinerário, assento, tipo, passageiro) para exibição
`boardedAt`	`DateTime?`	Data/hora do embarque (null se ainda não embarcou)
`issuedAt`	`DateTime`	Data de emissão da passagem
`status`	`TicketStatus`	Status da passagem (default `VALID`)
`createdBy`	`UUID?`	Usuário que criou o registro, quando aplicável
`createdAt`	`DateTime`	Data de criação
`updatedBy`	`UUID?`	Usuário que fez a última atualização, quando aplicável
`updatedAt`	`DateTime`	Data da última atualização

Relacionamentos

Relaciona-se com Order
Relaciona-se com Cooperative
Relaciona-se com TransportOperator
Relaciona-se com Trip
Relaciona-se com TripItinerary
Relaciona-se com Seat
Relaciona-se com SeatType
Relaciona-se com Passenger
Relaciona-se com PassengerBenefitRequest, quando benefício aprovado é usado.
Relaciona-se com BenefitDocumentValidation, quando a aplicação depende de documento validado.
Relaciona-se com múltiplos TicketActivity
Relaciona-se com múltiplos TripSeatSegment
Relaciona-se com múltiplos CreditLedgerEntry, quando crédito é capturado ou estornado no nível da passagem

Regras de Negócio

Os preços são congelados no momento da compra (snapshot).
baseAmount = seatPrice + tripItineraryPrice.
discountAmount = benefitDiscountAmount.
price = baseAmount - discountAmount.
paidAmount = price - creditAmount.
paidAmount não pode ser menor que zero.
cooperativeId e transportOperatorId repetem o ownership operacional da Trip no momento da emissão.
O ticket pertence operacionalmente à cooperativa, mesmo quando o pagamento usa crédito concedido por uma Company.
Benefício é aplicado no nível do passageiro/ticket. Se houver benefício nominal, passengerBenefitRequestId e benefitDocumentValidationId registram a evidência usada.
Todos os valores monetários são armazenados em centavos.
O code é único e identifica a passagem de forma legível; qrCode é o payload usado na validação de embarque.
O boardedAt é preenchido quando o motorista registra o embarque. Embarque é bloqueado se a passagem estiver cancelada ou já embarcada.
Ao cancelar um Ticket, os TripSeatSegments do ticket são liberados e o assento volta a ficar disponível para os mesmos segmentos.
Tentativas de validação, reimpressões e eventos operacionais do ticket ficam em TicketActivity.

Snapshot

TicketSnapshot

Campo	Tipo	Descrição
`trip`	`{ departureAt, estimatedArrivalAt }`	Horários da viagem no momento da emissão
`itinerary`	`{ fromStop, toStop }`	Paradas de origem e destino do trecho
`seat`	`{ label, floor, row, column, side }`	Assento escolhido
`seatType`	`{ name, color }`	Categoria do assento
`passenger`	`{ name, document, documentType, birthDate }`	Snapshot do passageiro da passagem

TicketSnapshotStop

Campo	Tipo	Descrição
`name`	`String`	Nome do ponto
`stopOrder`	`Int`	Ordem da parada
`arrivalAt`	`DateTime?`	Data/hora de chegada
`departureAt`	`DateTime?`	Data/hora de partida

Enums

TicketStatus

Valor	Descrição
`VALID`	Passagem válida
`CANCELLED`	Passagem cancelada

Example

{
  "ticketId": "0197a813-a9a6-7752-8173-d40a2a2d0ef0",
  "orderId": "0197a813-0fb9-7d42-9c81-50c0f6d9ae5a",
  "cooperativeId": "0197a800-24e6-76a2-90ed-ff0f6fba7b0c",
  "transportOperatorId": "01980d30-6a3c-7a42-9182-17ad6324d3aa",
  "tripId": "0197a80f-2d8f-7710-b243-b67fb477a1c0",
  "tripItineraryId": "0197a810-87ce-7b60-9d80-660d0ee1c413",
  "seatId": "0197a80a-bc30-70c3-954f-657c74277162",
  "seatTypeId": "0197a80a-56f4-71cb-93a6-6e69d1506ef7",
  "passengerId": "0197a814-2460-74c2-a8d7-819a6a0d6f54",
  "passengerBenefitRequestId": "0197f712-8a7e-7a53-9d28-51f8f3c77d41",
  "benefitDocumentValidationId": "0197f713-3b6d-7ba4-a3d5-a16035cbbeca",
  "seatPrice": 2500,
  "tripItineraryPrice": 8900,
  "baseAmount": 11400,
  "benefitDiscountAmount": 2500,
  "discountAmount": 2500,
  "creditAmount": 1500,
  "paidAmount": 7400,
  "price": 8900,
  "qrCode": "ticket:0197a813-a9a6-7752-8173-d40a2a2d0ef0:OAB-TCK-0001",
  "code": "OAB-TCK-0001",
  "snapshot": {
    "trip": {
      "departureAt": "2026-07-04T08:00:00.000Z",
      "estimatedArrivalAt": "2026-07-04T12:30:00.000Z"
    },
    "itinerary": {
      "fromStop": {
        "name": "Terminal Rodoviário Tietê",
        "stopOrder": 0,
        "arrivalAt": null,
        "departureAt": "2026-07-04T08:00:00.000Z"
      },
      "toStop": {
        "name": "Ribeirão Preto",
        "stopOrder": 2,
        "arrivalAt": "2026-07-04T12:30:00.000Z",
        "departureAt": null
      }
    },
    "seat": {
      "label": "01A",
      "floor": "FIRST",
      "row": 1,
      "column": "A",
      "side": "LEFT"
    },
    "seatType": {
      "name": "Executivo",
      "color": "#2563EB"
    },
    "passenger": {
      "name": "Mariana Costa",
      "document": "12345678909",
      "documentType": "CPF",
      "birthDate": "1992-04-18"
    }
  },
  "boardedAt": null,
  "issuedAt": "2026-07-03T16:02:00.000Z",
  "status": "VALID",
  "createdBy": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "createdAt": "2026-07-03T16:02:00.000Z",
  "updatedBy": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "updatedAt": "2026-07-03T16:02:00.000Z"
}

Data Modelling

Authorization

Benefits

Billing

Communication

Credit Grant

Export

Fleet

Identity

Observability

Operations

Sales

Support

Tenant

Webhooks

Campos

Relacionamentos

Regras de Negócio

Snapshot

TicketSnapshot

TicketSnapshotStop

Enums

TicketStatus

Example

​Campos

​Relacionamentos

​Regras de Negócio

​Snapshot

​TicketSnapshot

​TicketSnapshotStop

​Enums

​TicketStatus

​Example

Campos

Relacionamentos

Regras de Negócio

Snapshot

TicketSnapshot

TicketSnapshotStop

Enums

TicketStatus

Example