When a promotion is associated with a customer’s profile, it is wrapped inside a PromotionStatus RepositoryItem. This repository item tracks the number of times a customer can use an individual promotion. A PromotionStatus RepositoryItem is a repository item with an ItemDescriptor that describes the status of the promotion.

A customer’s profile has an activePromotions property that contains a list of PromotionStatus RepositoryItems. Each PromotionStatus item contains the following information:

During the pricing process, pricing engines inspect the customer’s profile to see which promotions should be considered when generating prices.