Skip to main content
O PromotionalMultiTicketRule representa a regra de validação para uma promoção do tipo MULTI_TICKET. Ela define a quantidade mínima de passagens e as restrições de agrupamento para aplicar o desconto.

Campos

CampoTipoDescrição
promotionalMultiTicketRuleIdUUIDIdentificador único
promotionalIdUUIDPromoção dona da regra
organizationIdUUIDOrganização da Company responsável pela promoção
companyIdUUIDCompany dona da promoção
minTicketQuantityIntQuantidade mínima de passagens exigida
maxTicketQuantityInt?Quantidade máxima de passagens elegíveis, quando aplicável
sameOrderBooleanIndica se as passagens devem estar no mesmo Order
sameTripBooleanIndica se as passagens devem pertencer à mesma Trip
samePassengerBooleanIndica se as passagens devem ser do mesmo passageiro
applyToPromotionalMultiTicketApplyTargetOnde o desconto é aplicado
createdByUUID?Usuário que criou o registro, quando aplicável
createdAtDateTimeData de criação
updatedByUUID?Usuário que fez a última atualização, quando aplicável
updatedAtDateTimeData da última atualização
deletedByUUID?Usuário que removeu o registro, quando aplicável
deletedAtDateTime?Data de remoção lógica

Relacionamentos

Regras de Negócio

  • Deve existir apenas para Promotional com type = MULTI_TICKET.
  • Cada Promotional MULTI_TICKET deve ter exatamente uma PromotionalMultiTicketRule ativa.
  • minTicketQuantity deve ser maior que zero.
  • maxTicketQuantity, quando preenchido, deve ser maior ou igual a minTicketQuantity.
  • Quando sameOrder = true, somente tickets do mesmo Order contam para a regra.
  • Quando sameTrip = true, somente tickets da mesma Trip contam para a regra.
  • Quando samePassenger = true, somente tickets do mesmo Passenger contam para a regra.
  • applyTo = ALL_TICKETS aplica o desconto em todos os tickets elegíveis.
  • applyTo = EXTRA_TICKETS aplica o desconto apenas nos tickets acima de minTicketQuantity.
  • applyTo = CHEAPEST_TICKET aplica o desconto no ticket de menor valor.
  • O front pode usar minTicketQuantity para exibir a promoção antes de o cliente concluir o carrinho.
  • 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.

Enums

PromotionalMultiTicketApplyTarget

ValorDescrição
ALL_TICKETSAplica o desconto em todos os tickets elegíveis
EXTRA_TICKETSAplica o desconto nos tickets acima da quantidade mínima
CHEAPEST_TICKETAplica o desconto no ticket de menor valor

Example

{
  "promotionalMultiTicketRuleId": "0197f7c4-7f61-7d70-813b-49aef69c1568",
  "promotionalId": "0197f7c0-55de-7b18-9073-c7d7c8c9a441",
  "organizationId": "0197a801-1690-7590-b3cf-19599b9be3e4",
  "companyId": "0197a801-6a42-79aa-9e56-d3c85148c0fa",
  "minTicketQuantity": 3,
  "maxTicketQuantity": null,
  "sameOrder": true,
  "sameTrip": false,
  "samePassenger": false,
  "applyTo": "CHEAPEST_TICKET",
  "createdBy": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "createdAt": "2026-07-04T15:07:00.000Z",
  "updatedBy": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "updatedAt": "2026-07-04T15:07:00.000Z",
  "deletedBy": null,
  "deletedAt": null
}