BenefitDocumentValidation

​

Campos

​

Relacionamentos

• Relaciona-se com PassengerBenefitRequest.
• Relaciona-se com Customer.
• Relaciona-se com User por validatedByUserId.
• O arquivo é referenciado por storageKey e segue as regras de Storage.

​

Regras de Negócio

• storageKey deve guardar a chave do objeto, nunca uma URL assinada.
• documentType deve corresponder a um item exigido por requiredDocumentTypes da categoria.
• O documento deve ser analisado por usuário autorizado para revisar a solicitação de benefício.
• rejectionReason é obrigatório quando status for REJECTED.
• Documentos expirados não devem permitir aprovação ou uso do benefício.
• A solicitação só pode avançar para aprovação quando todos os documentos obrigatórios estiverem aprovados.
• validatedByUserId indica quem analisou o documento; createdBy, updatedBy e deletedBy registram a auditoria da mutação do registro.

​

Enums

​

BenefitDocumentValidationStatus

​

Example

{
  "benefitDocumentValidationId": "0197f713-cd5f-77d9-b8d5-9751e96f2b39",
  "passengerBenefitRequestId": "0197f712-8a7e-7a53-9d28-51f8f3c77d41",
  "customerId": "0197a7f6-4d36-7c0a-a7cb-54fcb33a3148",
  "validatedByUserId": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "documentType": "STUDENT_ID",
  "storageKey": "benefits/0197f712-8a7e-7a53-9d28-51f8f3c77d41/student-id.pdf",
  "fileName": "carteirinha-estudantil.pdf",
  "contentType": "application/pdf",
  "status": "APPROVED",
  "rejectionReason": null,
  "expiresAt": "2027-01-04T12:00:00.000Z",
  "validatedAt": "2026-07-04T11:55:00.000Z",
  "createdBy": "0197a7f6-2c4d-74ae-b89b-9d36d9c341f2",
  "createdAt": "2026-07-04T11:35:00.000Z",
  "updatedBy": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "updatedAt": "2026-07-04T11:55:00.000Z",
  "deletedBy": null,
  "deletedAt": null
}