FareBenefitCategory

​

Campos

​

Relacionamentos

• Relaciona-se com múltiplos PassengerBenefitRequest.
• Relaciona-se com múltiplos BenefitUsageHistory.

​

Regras de Negócio

• code deve ser único no catálogo global de benefícios.
• type define se a categoria representa gratuidade total ou desconto.
• Quando type = DISCOUNT, discountType e discountValue são obrigatórios.
• Quando type = GRATUITY, discountType e discountValue devem ser nulos.
• discountValue usa centavos quando discountType = FIXED.
• discountValue usa basis points quando discountType = PERCENTAGE; por exemplo, 5000 representa 50%.
• requiredDocumentTypes orienta quais documentos normalmente comprovam a categoria.
• eligibilityRules guarda regras descritivas; a validação executável deve ficar no backend.
• Categorias inativas não podem receber novas solicitações nem ser aplicadas em vendas.
• createdBy, updatedBy e deletedBy seguem o padrão de auditoria do DEVMOB e registram o usuário responsável pela mutação, quando aplicável.

​

Exemplos de categorias

​

Enums

​

FareBenefitType

​

FareBenefitDiscountType

​

FareBenefitCategoryStatus

​

Example

{
  "fareBenefitCategoryId": "0197f710-b826-77f0-a60b-6c62b9fdd301",
  "code": "STUDENT_HALF_FARE",
  "name": "Meia passagem estudantil",
  "description": "Desconto para estudantes com documentação aprovada",
  "type": "DISCOUNT",
  "discountType": "PERCENTAGE",
  "discountValue": 5000,
  "requiredDocumentTypes": ["STUDENT_ID", "ENROLLMENT_PROOF"],
  "eligibilityRules": {
    "requiresActiveEnrollment": true
  },
  "status": "ACTIVE",
  "createdBy": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "createdAt": "2026-07-04T10:00:00.000Z",
  "updatedBy": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "updatedAt": "2026-07-04T10:00:00.000Z",
  "deletedBy": null,
  "deletedAt": null
}