PassengerBenefitRequest

​

Campos

​

Relacionamentos

• Relaciona-se com Customer.
• Relaciona-se com FareBenefitCategory.
• Relaciona-se com User como solicitante e revisor.
• Relaciona-se com múltiplas BenefitDocumentValidation.
• Relaciona-se com múltiplos BenefitUsageHistory, quando aprovado e utilizado.

​

Regras de Negócio

• Uma solicitação só pode ser aprovada se os documentos obrigatórios da categoria estiverem aprovados.
• A análise deve ser executada por usuário autorizado para revisar solicitações de benefício.
• rejectionReason é obrigatório quando status for REJECTED.
• validFrom e validUntil definem a janela em que o benefício pode ser aplicado.
• Um passageiro não deve ter duas solicitações aprovadas e ativas para a mesma categoria.
• Solicitações APPROVED, REJECTED, CANCELED ou EXPIRED são terminais para o fluxo de análise.
• requestedByUserId indica quem abriu a solicitação; createdBy, updatedBy e deletedBy registram a auditoria da mutação do registro.

​

Enums

​

PassengerBenefitRequestStatus

​

Example

{
  "passengerBenefitRequestId": "0197f712-8a7e-7a53-9d28-51f8f3c77d41",
  "customerId": "0197a7f6-4d36-7c0a-a7cb-54fcb33a3148",
  "fareBenefitCategoryId": "0197f710-b826-77f0-a60b-6c62b9fdd301",
  "requestedByUserId": "0197a7f6-2c4d-74ae-b89b-9d36d9c341f2",
  "reviewedByUserId": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "code": "BEN-20260704-0001",
  "notes": "Solicitação de meia passagem estudantil",
  "rejectionReason": null,
  "status": "APPROVED",
  "validFrom": "2026-07-04T12:00:00.000Z",
  "validUntil": "2027-01-04T12:00:00.000Z",
  "reviewedAt": "2026-07-04T12:00:00.000Z",
  "createdBy": "0197a7f6-2c4d-74ae-b89b-9d36d9c341f2",
  "createdAt": "2026-07-04T11:30:00.000Z",
  "updatedBy": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "updatedAt": "2026-07-04T12:00:00.000Z",
  "deletedBy": null,
  "deletedAt": null
}