*** title: "PromotionService" generated: true --------------- Contains methods relating to [Promotion](/current/core/reference/typescript-api/entities/promotion#promotion) entities. ```ts title="Signature" class PromotionService { availableConditions: PromotionCondition[] = []; availableActions: PromotionAction[] = []; constructor(connection: TransactionalConnection, configService: ConfigService, channelService: ChannelService, listQueryBuilder: ListQueryBuilder, configArgService: ConfigArgService, customFieldRelationService: CustomFieldRelationService, eventBus: EventBus, translatableSaver: TranslatableSaver, translator: TranslatorService) findAll(ctx: RequestContext, options?: ListQueryOptions, relations: RelationPaths = []) => Promise>; findOne(ctx: RequestContext, adjustmentSourceId: ID, relations: RelationPaths = []) => Promise; getPromotionConditions(ctx: RequestContext) => ConfigurableOperationDefinition[]; getPromotionActions(ctx: RequestContext) => ConfigurableOperationDefinition[]; createPromotion(ctx: RequestContext, input: CreatePromotionInput) => Promise>; updatePromotion(ctx: RequestContext, input: UpdatePromotionInput) => Promise>; softDeletePromotion(ctx: RequestContext, promotionId: ID) => Promise; assignPromotionsToChannel(ctx: RequestContext, input: AssignPromotionsToChannelInput) => Promise; removePromotionsFromChannel(ctx: RequestContext, input: RemovePromotionsFromChannelInput) => ; validateCouponCode(ctx: RequestContext, couponCode: string, customerId?: ID, excludeOrderId?: ID) => Promise | Promotion>; getActivePromotionsInChannel(ctx: RequestContext) => ; getActivePromotionsOnOrder(ctx: RequestContext, orderId: ID) => Promise; runPromotionSideEffects(ctx: RequestContext, order: Order, promotionsPre: Promotion[]) => ; addPromotionsToOrder(ctx: RequestContext, order: Order) => Promise; getExhaustedPromotionIds(ctx: RequestContext, promotions: Promotion[], customerId?: ID) => Promise>; } ```
### availableConditions \PromotionCondition[]`} /> ### availableActions \PromotionAction[]`} /> ### findAll \RequestContext, options?: ListQueryOptions<Promotion>, relations: RelationPaths<Promotion> = []) => Promise<PaginatedList<Promotion>>`} /> ### findOne \RequestContext, adjustmentSourceId: ID, relations: RelationPaths<Promotion> = []) => Promise<Promotion | undefined>`} /> ### getPromotionConditions \RequestContext) => ConfigurableOperationDefinition[]`} /> ### getPromotionActions \RequestContext) => ConfigurableOperationDefinition[]`} /> ### createPromotion \RequestContext, input: CreatePromotionInput) => Promise<ErrorResultUnionPromotion>>`} /> ### updatePromotion \RequestContext, input: UpdatePromotionInput) => Promise<ErrorResultUnionPromotion>>`} /> ### softDeletePromotion \RequestContext, promotionId: ID) => Promise`} /> ### assignPromotionsToChannel \RequestContext, input: AssignPromotionsToChannelInput) => Promise<Promotion[]>`} /> ### removePromotionsFromChannel \RequestContext, input: RemovePromotionsFromChannelInput) => `} /> ### validateCouponCode \RequestContext, couponCode: string, customerId?: ID, excludeOrderId?: ID) => Promise | Promotion>`} /> Checks the validity of a coupon code, by checking that it is associated with an existing, enabled and non-expired Promotion. The comparison is case-insensitive, so e.g. "SUMMER20" and "summer20" are treated as the same code. Additionally, if there is a usage limit on the coupon code, this method will enforce that limit against the specified Customer. ### getActivePromotionsInChannel \RequestContext) => `} /> ### getActivePromotionsOnOrder \RequestContext, orderId: ID) => Promise<Promotion[]>`} /> ### runPromotionSideEffects \RequestContext, order: Order, promotionsPre: Promotion[]) => `} /> ### addPromotionsToOrder \RequestContext, order: Order) => Promise<Order>`} /> Used internally to associate a Promotion with an Order, once an Order has been placed. ### getExhaustedPromotionIds \RequestContext, promotions: Promotion[], customerId?: ID) => Promise>`} /> Returns a Set of Promotion IDs (as strings) that have exceeded their `usageLimit` or `perCustomerUsageLimit`. Only checks promotions without a coupon code (coupon-based promotions are validated separately in `validateCouponCode()`).