org.killbill.billing.entitlement.api

Interface Entitlement

All Superinterfaces:

Entity

All Known Subinterfaces:

Subscription

public interface Entitlement
extends Entity

An Entitlement is created using the EntitlementApi

It contains all the catalog information and current state that answers the entitlement question.

The users of that API will control all the entitlement behavior when making changes such as the effectiveDate, catalog info,... By default the system will use system wide policies to control the billing aspect, but specific APIs also allow to override those.

See Also:

EntitlementApi

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	Entitlement.EntitlementActionPolicy Used to control the effective date that should be used on Plan change or on cancellation.
static class	Entitlement.EntitlementSourceType Possible Entitlement source types.
static class	Entitlement.EntitlementState Possible states of an Entitlement

Method Summary

Methods

Modifier and Type	Method and Description
Entitlement	cancelEntitlementWithDate(org.joda.time.LocalDate effectiveDate, boolean overrideBillingEffectiveDate, Iterable<PluginProperty> properties, CallContext context) Cancels the Entitlement at the specified date.
Entitlement	cancelEntitlementWithDateOverrideBillingPolicy(org.joda.time.LocalDate effectiveDate, BillingActionPolicy billingPolicy, Iterable<PluginProperty> properties, CallContext context) Cancels the Entitlement at the specified date After this operation, the existing object becomes stale.
Entitlement	cancelEntitlementWithPolicy(Entitlement.EntitlementActionPolicy policy, Iterable<PluginProperty> properties, CallContext context) Cancel the Entitlement with a policy.
Entitlement	cancelEntitlementWithPolicyOverrideBillingPolicy(Entitlement.EntitlementActionPolicy policy, BillingActionPolicy billingPolicy, Iterable<PluginProperty> properties, CallContext context) Cancels the Entitlement at the specified date and overrides the default billing policy.
Entitlement	changePlan(String productName, BillingPeriod billingPeriod, String priceList, List<PlanPhasePriceOverride> overrides, Iterable<PluginProperty> properties, CallContext context) Change Entitlement plan using default policy.
Entitlement	changePlanOverrideBillingPolicy(String productName, BillingPeriod billingPeriod, String priceList, List<PlanPhasePriceOverride> overrides, org.joda.time.LocalDate effectiveDate, BillingActionPolicy billingPolicy, Iterable<PluginProperty> properties, CallContext context) Change Entitlement plan at the specified date and overrides the billing policy.
Entitlement	changePlanWithDate(String productName, BillingPeriod billingPeriod, String priceList, List<PlanPhasePriceOverride> overrides, org.joda.time.LocalDate effectiveDate, Iterable<PluginProperty> properties, CallContext context) Change Entitlement plan at the specified date.
UUID	getAccountId()
UUID	getBaseEntitlementId()
Integer	getBillCycleDayLocal() The billCycleDay should be interpreted in the account timezone.
UUID	getBundleId()
org.joda.time.LocalDate	getEffectiveEndDate()
org.joda.time.LocalDate	getEffectiveStartDate()
String	getExternalKey()
PlanPhase	getLastActivePhase()
Plan	getLastActivePlan()
PriceList	getLastActivePriceList()
Product	getLastActiveProduct()
ProductCategory	getLastActiveProductCategory()
Entitlement.EntitlementSourceType	getSourceType()
Entitlement.EntitlementState	getState()
void	uncancelEntitlement(Iterable<PluginProperty> properties, CallContext context) Removes a pending future cancellation on an entitlement.
void	updateBCD(int bcd, org.joda.time.LocalDate effectiveFromDate, CallContext context)

Methods inherited from interface org.killbill.billing.util.entity.Entity

getCreatedDate, getId, getUpdatedDate

Method Detail

getBaseEntitlementId

UUID getBaseEntitlementId()

Returns:

the unique id of the base entitlement

getBundleId

UUID getBundleId()

Returns:

the unique Id of the SubscriptionBundle

getAccountId

UUID getAccountId()

Returns:

the account id

getExternalKey

String getExternalKey()

Returns:

the external key that was supplied when creating the base entitlement

getState

Entitlement.EntitlementState getState()

Returns:

the state of the entitlement

getSourceType

Entitlement.EntitlementSourceType getSourceType()

Returns:

the entitlement source type

getEffectiveStartDate

org.joda.time.LocalDate getEffectiveStartDate()

Returns:

the start date of the entitlement

getEffectiveEndDate

org.joda.time.LocalDate getEffectiveEndDate()

Returns:

the end date of the entitlement, that is the date at which it got cancelled.

getLastActiveProduct

Product getLastActiveProduct()

Returns:

the last Product prior to cancellation

getLastActivePlan

Plan getLastActivePlan()

Returns:

the last Plan prior to cancellation

getLastActivePhase

PlanPhase getLastActivePhase()

Returns:

the last Phase prior to cancellation

getLastActivePriceList

PriceList getLastActivePriceList()

Returns:

the last active PriceList

getLastActiveProductCategory

ProductCategory getLastActiveProductCategory()

Returns:

the last active ProductCategory

getBillCycleDayLocal

Integer getBillCycleDayLocal()

The billCycleDay should be interpreted in the account timezone. The billCycleDay is used to determine when to bill a specific subscription

Returns:

the billCycleDay for that subscription

cancelEntitlementWithDate

Entitlement cancelEntitlementWithDate(org.joda.time.LocalDate effectiveDate,
                                    boolean overrideBillingEffectiveDate,
                                    Iterable<PluginProperty> properties,
                                    CallContext context)
                                      throws EntitlementApiException

Cancels the Entitlement at the specified date. After this operation, the existing object becomes stale.

The date is interpreted by the system to be in the timezone specified at the Account

Parameters:

effectiveDate - the date at which the entitlement should be cancelled

overrideBillingEffectiveDate - use effectiveDate for billing cancellation date as well

properties - plugin specific properties

context - the context

Returns:

the new Entitlement after the cancellation was performed

Throws:

EntitlementApiException - if cancellation failed

cancelEntitlementWithPolicy

Entitlement cancelEntitlementWithPolicy(Entitlement.EntitlementActionPolicy policy,
                                      Iterable<PluginProperty> properties,
                                      CallContext context)
                                        throws EntitlementApiException

Cancel the Entitlement with a policy. After this operation, the existing object becomes stale.

Parameters:

policy - the policy that is used by the system to calculate the cancellation date

properties - plugin specific properties

context - the context

Returns:

the new Entitlement after the cancellation was performed

Throws:

EntitlementApiException - if cancellation failed

cancelEntitlementWithDateOverrideBillingPolicy

Entitlement cancelEntitlementWithDateOverrideBillingPolicy(org.joda.time.LocalDate effectiveDate,
                                                         BillingActionPolicy billingPolicy,
                                                         Iterable<PluginProperty> properties,
                                                         CallContext context)
                                                           throws EntitlementApiException

Cancels the Entitlement at the specified date After this operation, the existing object becomes stale.

The date is interpreted by the system to be in the timezone specified at the Account

Parameters:

effectiveDate - the date at which the entitlement should be cancelled

billingPolicy - the billingPolicy

properties - plugin specific properties

context - the context

Returns:

the new Entitlement after the cancellation was performed

Throws:

EntitlementApiException - if cancellation failed

cancelEntitlementWithPolicyOverrideBillingPolicy

Entitlement cancelEntitlementWithPolicyOverrideBillingPolicy(Entitlement.EntitlementActionPolicy policy,
                                                           BillingActionPolicy billingPolicy,
                                                           Iterable<PluginProperty> properties,
                                                           CallContext context)
                                                             throws EntitlementApiException

Cancels the Entitlement at the specified date and overrides the default billing policy. After this operation, the existing object becomes stale.

Parameters:

policy - the policy that is used by the system to calculate the cancellation date

billingPolicy - the override billing policy

properties - plugin specific properties

context - the context

Returns:

the new Entitlement after the cancellation was performed

Throws:

EntitlementApiException - if cancellation failed

uncancelEntitlement

void uncancelEntitlement(Iterable<PluginProperty> properties,
                       CallContext context)
                         throws EntitlementApiException

Removes a pending future cancellation on an entitlement.

The call will only succeed if the entitlement has been cancelled previously and if the effectiveDate of the cancellation did not occur yet. In such a case it will remove both the cancellation event at the entitlement and billing level-- regardless of when is the effectiveDate of the billing cancellation event.

Parameters:

properties - plugin specific properties

context - the context

Throws:

EntitlementApiException

changePlan

Entitlement changePlan(String productName,
                     BillingPeriod billingPeriod,
                     String priceList,
                     List<PlanPhasePriceOverride> overrides,
                     Iterable<PluginProperty> properties,
                     CallContext context)
                       throws EntitlementApiException

Change Entitlement plan using default policy. After this operation, the existing object becomes stale.

The date is interpreted by the system to be in the timezone specified at the Account

Parameters:

productName - the new product name

billingPeriod - the new billing period

priceList - the new priceList

overrides - the price override for each phase and for a specific currency

properties - plugin specific properties

context - the context

Returns:

the new Entitlement after the change was performed

Throws:

EntitlementApiException - if change failed

changePlanWithDate

Entitlement changePlanWithDate(String productName,
                             BillingPeriod billingPeriod,
                             String priceList,
                             List<PlanPhasePriceOverride> overrides,
                             org.joda.time.LocalDate effectiveDate,
                             Iterable<PluginProperty> properties,
                             CallContext context)
                               throws EntitlementApiException

Change Entitlement plan at the specified date. After this operation, the existing object becomes stale.

The date is interpreted by the system to be in the timezone specified at the Account

Parameters:

productName - the new product name

billingPeriod - the new billing period

priceList - the new priceList

overrides - the price override for each phase and for a specific currency

effectiveDate - the date at which the entitlement should be changed

properties - plugin specific properties

context - the context

Returns:

the new Entitlement after the change was performed

Throws:

EntitlementApiException - if change failed

changePlanOverrideBillingPolicy

Entitlement changePlanOverrideBillingPolicy(String productName,
                                          BillingPeriod billingPeriod,
                                          String priceList,
                                          List<PlanPhasePriceOverride> overrides,
                                          org.joda.time.LocalDate effectiveDate,
                                          BillingActionPolicy billingPolicy,
                                          Iterable<PluginProperty> properties,
                                          CallContext context)
                                            throws EntitlementApiException

Change Entitlement plan at the specified date and overrides the billing policy. After this operation, the existing object becomes stale.

The date is interpreted by the system to be in the timezone specified at the Account

Parameters:

productName - the new product name

billingPeriod - the new billing period

priceList - the new priceList

overrides - the price override for each phase and for a specific currency

effectiveDate - the date at which the entitlement should be changed

billingPolicy - the override billing policy

properties - plugin specific properties

context - the context

Returns:

the new Entitlement after the change was performed

Throws:

EntitlementApiException - if change failed

updateBCD

void updateBCD(int bcd,
             org.joda.time.LocalDate effectiveFromDate,
             CallContext context)
               throws EntitlementApiException

Parameters:

bcd - the new BCD for that subscription

effectiveFromDate - date after which that BCD change becomes active

context - the context

Throws:

EntitlementApiException