Package com.broadleafcommerce.subscriptionoperation.domain

Class Subscription

java.lang.Object
com.broadleafcommerce.subscriptionoperation.domain.Subscription
All Implemented Interfaces:
com.broadleafcommerce.data.tracking.core.ContextStateAware, com.broadleafcommerce.money.CurrencyConsumer, Serializable, javax.money.CurrencySupplier
public class Subscription extends Object implements com.broadleafcommerce.data.tracking.core.ContextStateAware, javax.money.CurrencySupplier, com.broadleafcommerce.money.CurrencyConsumer, Serializable
This is a domain representing a user's subscription to a service or a good. The particular line items of the subscription are contained in SubscriptionItem objects, while any price changes would be held by adjustments. Changes to a subscription's status should be followed by a SubscriptionStatusAudit to track them.
See Also:

  • Constructor Details

    • Subscription

      public Subscription()

    • Subscription

      public Subscription(String id, String name, String subscriptionStatus, String subscriptionNextStatus, Date nextStatusChangeDate, String nextStatusChangeReason, Date resumeDate, String rootItemRefType, String rootItemRef, String userRefType, String userRef, String alternateUserRefType, String alternateUserRef, String subscriptionSource, String subscriptionSourceRef, String secondarySourceType, String secondarySourceRef, String siteIdentifier, String billingFrequency, int periodFrequency, String periodType, String paymentStrategy, Date priorBillDate, Date nextBillDate, String preferredPaymentAccountId, javax.money.CurrencyUnit currency, String nextSubscription, String lastBillingBatchId, String lastBillingOperationStatus, Date lastBillingSuccessDate, Date createdDate, boolean chargeback, Integer nextPeriod, List<SubscriptionPeriod> periods, List<DelayedSubscriptionAction> delayedActions, List<PriceDataChange> priceDataChanges, boolean needGrantEntitlements, List<SubscriptionAdjustment> subscriptionAdjustments, boolean autoRenewalEnabled, boolean allowAutoRenewalModification, Instant startOfTermDate, Instant endOfTermDate, Integer termDurationLength, String termDurationType, String cancellationPolicyRef, String fulfillmentWorkflow, @Nullable String customerTimezone, Map<String,Object> attributes, Map<String,Object> internalAttributes, Integer version, com.broadleafcommerce.data.tracking.core.filtering.business.domain.ContextState contextState)
      Deprecated.
      in favor of periodType & periodFrequency
      Creates a new Subscription instance.
      Parameters:
      id -
      name - Name of this subscription
      subscriptionStatus - Current status of this subscription
      subscriptionNextStatus - Next status for this subscription
      nextStatusChangeDate - Date when the next status should begin
      nextStatusChangeReason - Reason for the update to the next status
      resumeDate - Date this subscription will or did continue. This is likely to be used only after a subscription was paused or stopped.
      rootItemRefType - Type of the item for which this subscription was provisioned
      rootItemRef - Reference to the item id for which this subscription was provision
      userRefType - Type of user owning this subscription
      userRef - Reference to the user to whom this subscription belongs
      alternateUserRefType - Type of the alternative user reference
      alternateUserRef - Alternate reference to the user. Useful for third-party authentication system identifiers
      subscriptionSource - This field shows from which process or user action this subscription originated.
      subscriptionSourceRef - This field shows the identifier of the process or user action this subscription originated.
      secondarySourceType - The type of the secondary source to reference, e.g, an Order Item on an Order. Optional.
      secondarySourceRef - The secondary source to reference, e.g, an Order Item on an Order. Optional.
      siteIdentifier - Multi-tenancy support
      billingFrequency - Frequency of billing for this subscription
      periodFrequency - The frequency with which the recurring price should be charged., e.g., a value of 1 combined with periodType of MONTH would indicate to a subscription service that the price should be charged every 1 month.
      periodType - The period type for the price, e.g. MONTHLY, QUARTERLY, ANNUALLY
      paymentStrategy - Declares that payments made against a subscription are going towards the goods/services rendered in the previous vs current period.
      priorBillDate - The bill date for the previous period
      nextBillDate - Next date this subscription will be billed
      preferredPaymentAccountId - References an identifier of a PaymentAccount that is considered preferred for this subscription.
      currency - Currency of this subscription
      nextSubscription - If this subscription was upgraded or downgraded, holds the reference to the subscription replacing this one
      lastBillingBatchId - The batch id of the last billing job run for this subscription
      lastBillingOperationStatus - The most current status of the last billing event for this subscription
      lastBillingSuccessDate - Last date this that the Billing Job succeeded billing this subscription
      createdDate - Date this subscription was created. This field should not be updated or set by a request.
      chargeback - Whether this subscription is being cancelled due to a chargeback
      nextPeriod - The next period this subscription will cover. This value is related to 'beginPeriod' and 'endPeriod' fields of SubscriptionAdjustment and SubscriptionItemAdjustment
      periods - List tracking the Subscription's periods. Typically, this correlates to the set of periods for which a BillingEvent has been created.
      delayedActions - List of delayed actions for this subscription.

      Often, these delayed actions are related to requested actions against a subscription with a DefaultSubscriptionPaymentStrategy.PREPAID getPaymentStrategy() where instead of refunding the customer, the action is delayed until the end of the period, causing the next period to naturally identify the updated price.

      priceDataChanges - List of price data changes for this subscription
      needGrantEntitlements - Whether the system has outstanding entitlements to grant on this subscription
      subscriptionAdjustments - Adjustments for this subscription. This field is used for creation from an API request and is not persisted with the object
      autoRenewalEnabled - Whether this subscription automatically renews at the end of the current subscription term.
      allowAutoRenewalModification - This flag indicates whether this subscription's auto-renewability can be modified after declaration on the subscription.
      startOfTermDate - The start of term date for this subscription.
      endOfTermDate - The end of term date for this subscription.
      termDurationLength - The length of the terms, e.g., if this is 36 and termDurationType is MONTHS, then the user should be billed for 36 months.
      termDurationType - The term duration type, e.g. DAYS, WEEKS, MONTHS, YEARS.
      cancellationPolicyRef - A reference of the CancellationPolicy that governs how this subscription would be cancelled.
      fulfillmentWorkflow - A reference to the workflow used to fulfill the creation of, & modifications to, this subscription.
      customerTimezone - The customer's timezone. It's an optional field used to truncate the dates to the beginning of the day in customer's timezone. If null, UTC time is used.
      attributes - Miscellaneous attributes for this subscription.
      internalAttributes - Miscellaneous internal attributes for this subscription. Distinguished from getAttributes() in that this map is used for attributes that assist in the internal working of Broadleaf.
      version - The version of this subscription. Used for checking if the requested version of the subscription is up-to-date before saving changes. This should never be manually decremented/incremented.
      contextState - A subset of Tracking information to expose the context state for this object.
      See Also:

  • Method Details

    • setCurrencyCode

      public void setCurrencyCode(String currencyCode)

    • getCurrentPeriodDefinition

      @Nullable public SubscriptionPeriod getCurrentPeriodDefinition()

    • getCurrentPeriod

      public Integer getCurrentPeriod()
      Gets the current period for this subscription by comparing Instant.now() and each SubscriptionPeriod's timeframe. If none are found, it falls back to nextPeriod - 1.
      Returns:
      The current period of the subscription.
      See Also:

    • getPeriodDefinition

      @Nullable public SubscriptionPeriod getPeriodDefinition(Instant dateToCheck)
      Gets the period definition for this subscription by comparing the given Instant and each SubscriptionPeriod's timeframe. If none are found, null is returned.

      In the case where there are two periods both fitting the current time, which can happen if the subscription had just lost a free trial causing the free trial period to be shortened, the period that is not shortened is used.

      Returns:
      The SubscriptionPeriod matching the given Instant, or null if none

    • getPeriodDefinition

      @Nullable public SubscriptionPeriod getPeriodDefinition(int periodNumber)

    • getFreeTrialEndDate

      @Nullable public Instant getFreeTrialEndDate()

    • getId

      public String getId()

    • getName

      public String getName()
      Name of this subscription

    • getSubscriptionStatus

      public String getSubscriptionStatus()
      Current status of this subscription
      See Also:

    • getSubscriptionNextStatus

      public String getSubscriptionNextStatus()
      Next status for this subscription
      See Also:

    • getNextStatusChangeDate

      public Date getNextStatusChangeDate()
      Date when the next status should begin
      See Also:
      • subscriptionNextStatus

    • getNextStatusChangeReason

      public String getNextStatusChangeReason()
      Reason for the update to the next status
      See Also:
      • subscriptionNextStatus

    • getResumeDate

      public Date getResumeDate()
      Date this subscription will or did continue. This is likely to be used only after a subscription was paused or stopped.

    • getRootItemRefType

      public String getRootItemRefType()
      Type of the item for which this subscription was provisioned

    • getRootItemRef

      public String getRootItemRef()
      Reference to the item id for which this subscription was provision

    • getUserRefType

      public String getUserRefType()
      Type of user owning this subscription
      See Also:

    • getUserRef

      public String getUserRef()
      Reference to the user to whom this subscription belongs

    • getAlternateUserRefType

      public String getAlternateUserRefType()
      Type of the alternative user reference
      See Also:

    • getAlternateUserRef

      public String getAlternateUserRef()
      Alternate reference to the user. Useful for third-party authentication system identifiers

    • getSubscriptionSource

      public String getSubscriptionSource()
      This field shows from which process or user action this subscription originated.
      See Also:

    • getSubscriptionSourceRef

      public String getSubscriptionSourceRef()
      This field shows the identifier of the process or user action this subscription originated.
      See Also:
      • subscriptionSource

    • getSecondarySourceType

      public String getSecondarySourceType()
      The type of the secondary source to reference, e.g, an Order Item on an Order. Optional.
      See Also:

    • getSecondarySourceRef

      public String getSecondarySourceRef()
      The secondary source to reference, e.g, an Order Item on an Order. Optional.
      See Also:
      • secondarySourceType

    • getSiteIdentifier

      public String getSiteIdentifier()
      Multi-tenancy support

    • getBillingFrequency

      @Deprecated public String getBillingFrequency()
      Deprecated.
      in favor of periodType & periodFrequency
      Frequency of billing for this subscription

    • getPeriodFrequency

      public int getPeriodFrequency()
      The frequency with which the recurring price should be charged., e.g., a value of 1 combined with periodType of MONTH would indicate to a subscription service that the price should be charged every 1 month.
      See Also:
      • periodType

    • getPeriodType

      public String getPeriodType()
      The period type for the price, e.g. MONTHLY, QUARTERLY, ANNUALLY
      See Also:
      • periodFrequency

    • getPaymentStrategy

      public String getPaymentStrategy()
      Declares that payments made against a subscription are going towards the goods/services rendered in the previous vs current period.
      See Also:

    • getPriorBillDate

      public Date getPriorBillDate()
      The bill date for the previous period

    • getNextBillDate

      public Date getNextBillDate()
      Next date this subscription will be billed

    • getPreferredPaymentAccountId

      public String getPreferredPaymentAccountId()
      References an identifier of a PaymentAccount that is considered preferred for this subscription.

    • getCurrency

      public javax.money.CurrencyUnit getCurrency()
      Currency of this subscription
      Specified by:
      getCurrency in interface javax.money.CurrencySupplier

    • getNextSubscription

      public String getNextSubscription()
      If this subscription was upgraded or downgraded, holds the reference to the subscription replacing this one

    • getLastBillingBatchId

      public String getLastBillingBatchId()
      The batch id of the last billing job run for this subscription

    • getLastBillingOperationStatus

      public String getLastBillingOperationStatus()
      The most current status of the last billing event for this subscription

    • getLastBillingSuccessDate

      public Date getLastBillingSuccessDate()
      Last date this that the Billing Job succeeded billing this subscription

    • getCreatedDate

      public Date getCreatedDate()
      Date this subscription was created. This field should not be updated or set by a request.

    • isChargeback

      public boolean isChargeback()
      Whether this subscription is being cancelled due to a chargeback

    • getNextPeriod

      public Integer getNextPeriod()
      The next period this subscription will cover. This value is related to 'beginPeriod' and 'endPeriod' fields of SubscriptionAdjustment and SubscriptionItemAdjustment

    • getPeriods

      public List<SubscriptionPeriod> getPeriods()
      List tracking the Subscription's periods. Typically, this correlates to the set of periods for which a BillingEvent has been created.

    • getDelayedActions

      public List<DelayedSubscriptionAction> getDelayedActions()
      List of delayed actions for this subscription.

      Often, these delayed actions are related to requested actions against a subscription with a DefaultSubscriptionPaymentStrategy.PREPAID getPaymentStrategy() where instead of refunding the customer, the action is delayed until the end of the period, causing the next period to naturally identify the updated price.

    • getPriceDataChanges

      public List<PriceDataChange> getPriceDataChanges()
      List of price data changes for this subscription

    • isNeedGrantEntitlements

      public boolean isNeedGrantEntitlements()
      Whether the system has outstanding entitlements to grant on this subscription

    • getSubscriptionAdjustments

      public List<SubscriptionAdjustment> getSubscriptionAdjustments()
      Adjustments for this subscription. This field is used for creation from an API request and is not persisted with the object

    • isAutoRenewalEnabled

      public boolean isAutoRenewalEnabled()
      Whether this subscription automatically renews at the end of the current subscription term.

    • isAllowAutoRenewalModification

      public boolean isAllowAutoRenewalModification()
      This flag indicates whether this subscription's auto-renewability can be modified after declaration on the subscription.

    • getStartOfTermDate

      public Instant getStartOfTermDate()
      The start of term date for this subscription.

    • getEndOfTermDate

      public Instant getEndOfTermDate()
      The end of term date for this subscription.

    • getTermDurationLength

      public Integer getTermDurationLength()
      The length of the terms, e.g., if this is 36 and termDurationType is MONTHS, then the user should be billed for 36 months.
      See Also:
      • termDurationType

    • getTermDurationType

      public String getTermDurationType()
      The term duration type, e.g. DAYS, WEEKS, MONTHS, YEARS.
      See Also:
      • termDurationLength

    • getCancellationPolicyRef

      public String getCancellationPolicyRef()
      A reference of the CancellationPolicy that governs how this subscription would be cancelled.

    • getFulfillmentWorkflow

      public String getFulfillmentWorkflow()
      A reference to the workflow used to fulfill the creation of, & modifications to, this subscription.

    • getCustomerTimezone

      @Nullable public String getCustomerTimezone()
      The customer's timezone. It's an optional field used to truncate the dates to the beginning of the day in customer's timezone. If null, UTC time is used.

    • getAttributes

      public Map<String,Object> getAttributes()
      Miscellaneous attributes for this subscription.

    • getInternalAttributes

      public Map<String,Object> getInternalAttributes()
      Miscellaneous internal attributes for this subscription. Distinguished from getAttributes() in that this map is used for attributes that assist in the internal working of Broadleaf.

    • getVersion

      public Integer getVersion()
      The version of this subscription. Used for checking if the requested version of the subscription is up-to-date before saving changes. This should never be manually decremented/incremented.

    • getContextState

      public com.broadleafcommerce.data.tracking.core.filtering.business.domain.ContextState getContextState()
      A subset of Tracking information to expose the context state for this object.
      Specified by:
      getContextState in interface com.broadleafcommerce.data.tracking.core.ContextStateAware

    • setId

      public void setId(String id)

    • setName

      public void setName(String name)
      Name of this subscription

    • setSubscriptionStatus

      public void setSubscriptionStatus(String subscriptionStatus)
      Current status of this subscription
      See Also:

    • setSubscriptionNextStatus

      public void setSubscriptionNextStatus(String subscriptionNextStatus)
      Next status for this subscription
      See Also:

    • setNextStatusChangeDate

      public void setNextStatusChangeDate(Date nextStatusChangeDate)
      Date when the next status should begin
      See Also:
      • subscriptionNextStatus

    • setNextStatusChangeReason

      public void setNextStatusChangeReason(String nextStatusChangeReason)
      Reason for the update to the next status
      See Also:
      • subscriptionNextStatus

    • setResumeDate

      public void setResumeDate(Date resumeDate)
      Date this subscription will or did continue. This is likely to be used only after a subscription was paused or stopped.

    • setRootItemRefType

      public void setRootItemRefType(String rootItemRefType)
      Type of the item for which this subscription was provisioned

    • setRootItemRef

      public void setRootItemRef(String rootItemRef)
      Reference to the item id for which this subscription was provision

    • setUserRefType

      public void setUserRefType(String userRefType)
      Type of user owning this subscription
      See Also:

    • setUserRef

      public void setUserRef(String userRef)
      Reference to the user to whom this subscription belongs

    • setAlternateUserRefType

      public void setAlternateUserRefType(String alternateUserRefType)
      Type of the alternative user reference
      See Also:

    • setAlternateUserRef

      public void setAlternateUserRef(String alternateUserRef)
      Alternate reference to the user. Useful for third-party authentication system identifiers

    • setSubscriptionSource

      public void setSubscriptionSource(String subscriptionSource)
      This field shows from which process or user action this subscription originated.
      See Also:

    • setSubscriptionSourceRef

      public void setSubscriptionSourceRef(String subscriptionSourceRef)
      This field shows the identifier of the process or user action this subscription originated.
      See Also:
      • subscriptionSource

    • setSecondarySourceType

      public void setSecondarySourceType(String secondarySourceType)
      The type of the secondary source to reference, e.g, an Order Item on an Order. Optional.
      See Also:

    • setSecondarySourceRef

      public void setSecondarySourceRef(String secondarySourceRef)
      The secondary source to reference, e.g, an Order Item on an Order. Optional.
      See Also:
      • secondarySourceType

    • setSiteIdentifier

      public void setSiteIdentifier(String siteIdentifier)
      Multi-tenancy support

    • setBillingFrequency

      @Deprecated public void setBillingFrequency(String billingFrequency)
      Deprecated.
      in favor of periodType & periodFrequency
      Frequency of billing for this subscription

    • setPeriodFrequency

      public void setPeriodFrequency(int periodFrequency)
      The frequency with which the recurring price should be charged., e.g., a value of 1 combined with periodType of MONTH would indicate to a subscription service that the price should be charged every 1 month.
      See Also:
      • periodType

    • setPeriodType

      public void setPeriodType(String periodType)
      The period type for the price, e.g. MONTHLY, QUARTERLY, ANNUALLY
      See Also:
      • periodFrequency

    • setPaymentStrategy

      public void setPaymentStrategy(String paymentStrategy)
      Declares that payments made against a subscription are going towards the goods/services rendered in the previous vs current period.
      See Also:

    • setPriorBillDate

      public void setPriorBillDate(Date priorBillDate)
      The bill date for the previous period

    • setNextBillDate

      public void setNextBillDate(Date nextBillDate)
      Next date this subscription will be billed

    • setPreferredPaymentAccountId

      public void setPreferredPaymentAccountId(String preferredPaymentAccountId)
      References an identifier of a PaymentAccount that is considered preferred for this subscription.

    • setCurrency

      public void setCurrency(javax.money.CurrencyUnit currency)
      Currency of this subscription
      Specified by:
      setCurrency in interface com.broadleafcommerce.money.CurrencyConsumer

    • setNextSubscription

      public void setNextSubscription(String nextSubscription)
      If this subscription was upgraded or downgraded, holds the reference to the subscription replacing this one

    • setLastBillingBatchId

      public void setLastBillingBatchId(String lastBillingBatchId)
      The batch id of the last billing job run for this subscription

    • setLastBillingOperationStatus

      public void setLastBillingOperationStatus(String lastBillingOperationStatus)
      The most current status of the last billing event for this subscription

    • setLastBillingSuccessDate

      public void setLastBillingSuccessDate(Date lastBillingSuccessDate)
      Last date this that the Billing Job succeeded billing this subscription

    • setCreatedDate

      public void setCreatedDate(Date createdDate)
      Date this subscription was created. This field should not be updated or set by a request.

    • setChargeback

      public void setChargeback(boolean chargeback)
      Whether this subscription is being cancelled due to a chargeback

    • setNextPeriod

      public void setNextPeriod(Integer nextPeriod)
      The next period this subscription will cover. This value is related to 'beginPeriod' and 'endPeriod' fields of SubscriptionAdjustment and SubscriptionItemAdjustment

    • setPeriods

      public void setPeriods(List<SubscriptionPeriod> periods)
      List tracking the Subscription's periods. Typically, this correlates to the set of periods for which a BillingEvent has been created.

    • setDelayedActions

      public void setDelayedActions(List<DelayedSubscriptionAction> delayedActions)
      List of delayed actions for this subscription.

      Often, these delayed actions are related to requested actions against a subscription with a DefaultSubscriptionPaymentStrategy.PREPAID getPaymentStrategy() where instead of refunding the customer, the action is delayed until the end of the period, causing the next period to naturally identify the updated price.

    • setPriceDataChanges

      public void setPriceDataChanges(List<PriceDataChange> priceDataChanges)
      List of price data changes for this subscription

    • setNeedGrantEntitlements

      public void setNeedGrantEntitlements(boolean needGrantEntitlements)
      Whether the system has outstanding entitlements to grant on this subscription

    • setSubscriptionAdjustments

      public void setSubscriptionAdjustments(List<SubscriptionAdjustment> subscriptionAdjustments)
      Adjustments for this subscription. This field is used for creation from an API request and is not persisted with the object

    • setAutoRenewalEnabled

      public void setAutoRenewalEnabled(boolean autoRenewalEnabled)
      Whether this subscription automatically renews at the end of the current subscription term.

    • setAllowAutoRenewalModification

      public void setAllowAutoRenewalModification(boolean allowAutoRenewalModification)
      This flag indicates whether this subscription's auto-renewability can be modified after declaration on the subscription.

    • setStartOfTermDate

      public void setStartOfTermDate(Instant startOfTermDate)
      The start of term date for this subscription.

    • setEndOfTermDate

      public void setEndOfTermDate(Instant endOfTermDate)
      The end of term date for this subscription.

    • setTermDurationLength

      public void setTermDurationLength(Integer termDurationLength)
      The length of the terms, e.g., if this is 36 and termDurationType is MONTHS, then the user should be billed for 36 months.
      See Also:
      • termDurationType

    • setTermDurationType

      public void setTermDurationType(String termDurationType)
      The term duration type, e.g. DAYS, WEEKS, MONTHS, YEARS.
      See Also:
      • termDurationLength

    • setCancellationPolicyRef

      public void setCancellationPolicyRef(String cancellationPolicyRef)
      A reference of the CancellationPolicy that governs how this subscription would be cancelled.

    • setFulfillmentWorkflow

      public void setFulfillmentWorkflow(String fulfillmentWorkflow)
      A reference to the workflow used to fulfill the creation of, & modifications to, this subscription.

    • setCustomerTimezone

      public void setCustomerTimezone(@Nullable String customerTimezone)
      The customer's timezone. It's an optional field used to truncate the dates to the beginning of the day in customer's timezone. If null, UTC time is used.

    • setAttributes

      public void setAttributes(Map<String,Object> attributes)
      Miscellaneous attributes for this subscription.

    • setInternalAttributes

      public void setInternalAttributes(Map<String,Object> internalAttributes)
      Miscellaneous internal attributes for this subscription. Distinguished from getAttributes() in that this map is used for attributes that assist in the internal working of Broadleaf.

    • setVersion

      public void setVersion(Integer version)
      The version of this subscription. Used for checking if the requested version of the subscription is up-to-date before saving changes. This should never be manually decremented/incremented.

    • setContextState

      public void setContextState(com.broadleafcommerce.data.tracking.core.filtering.business.domain.ContextState contextState)
      A subset of Tracking information to expose the context state for this object.
      Specified by:
      setContextState in interface com.broadleafcommerce.data.tracking.core.ContextStateAware

    • equals

      public boolean equals(Object o)
      Overrides:
      equals in class Object

    • canEqual

      protected boolean canEqual(Object other)

    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Object

    • toString

      public String toString()
      Overrides:
      toString in class Object