Order Scheduling 

Once Orders have been enabled and configured in Chargebee, orders are automatically created for your shippable plans/addons whenever they are subscribed to and the invoice gets paid. For gift subscriptions, the order schedule is determined and the orders are created only when the gift claim is made. Orders in Chargebee can be scheduled for multiple scenarios such as scheduling an order with or without calendar billing.

Let's look at how orders are scheduled by considering various scenarios.

Order Scheduling without Calendar Billing 

Consider the case when calendar billing is disabled on your Chargebee site.

Consider a shippable plan of 6 months that ships an item every two months. Such a plan would thus have three shipments. For any given order, the date around which it is processed is called the order date. Once the invoice gets paid, an order is created in Chargebee.

Important Note
Orders in Chargebee are created only when the invoice is paid by the customers. There is a deadline for every invoice before the orders can be actually created in Chargebee:

  • For a billing period with just one order, the invoice must be paid before the end of the billing period.
  • For a billing period with multiple orders, the invoice must be paid before the second order date.
    Otherwise, no orders for the plan/addon are created. You may choose to remove such late payments and void the invoice in Chargebee or manually handle such orders in your fulfillment platform.
From the shippable plan described in the example above, if it is signed-up for with billing period starting on Jan 1 and is paid for on the same date, the order dates would look as follows:

If there are attached addons with different shipping frequencies than that of the plan, additional orders are automatically created to serve those addon deliveries that fall out of step with the order dates for the plan. See this section for an example.

The first order date for an order schedule is subject to the payment deadline(provided payment is received by that time). So, in the example, although the billing period started on Jan 1st, if the invoice is only paid on Jan 10th, first order date will always be Jan 10th. Also, the remaining order schedule is not affected by the payment date and remains same as determined during order sign-up.

Order Scheduling with Calendar Billing 

Calendar Billing without Billing Cut-Off 

Consider a plan of 6 months duration that ships an item two months. In this case the calendar billing date to be 10th and calendar billing cut-off date to be 15th of every month. If a customer signs up for this plan with billing period starting on Jan 5th (calendar billing cut-off is not overstepped) and pays for the invoice on the same date, then the order date would automatically align with the calendar billing date. The order schedule for this would be as follows:


In the above scenario, if the payment happens after the calendar billing date of the month but before the billing cut-off date, say on 12th Jan, then the first order date would be the date when the payment is made.

Calendar Billing with Billing Cut-off 

In the same case as above, consider that the customer signs up for the plan with the billing start date as Jan 20th (thereby overstepping the billing cut-off) and pays on the same date. This introduces calendar billing shift so that the next calendar billing date post the billing cut-off date becomes the first order date.

Shipping Dates for Orders 

In the order schedule, every order would have a shipping date associated with it. This is the date around which the order is set to start getting shipped. For instance, this date could be used to determine the day when an order is pushed into a fulfillment platform such as ShipStation from Chargebee.


You can also schedule an email to be sent a few days before the order is getting shipped.

Once the order dates have been determined as described in the previous sections, a site setting determines how shipping dates are arrived at. There are two options for this in the site settings:

Option 1: Shipping date is an offset from the order date 

In this case, the shipping date for all orders is a certain number of days from order date. For the example shown in the last diagram, if the shipping date offset was set as 5 days, then we have:

Order date

Shipping date

Feb 25 Mar 2
Apr 25 Apr 30
June 25 June 30

Option 2: Shipping date is a preferred day-of-the-week/month 

A preferred day-of-the-week/month can be set for shipping. The shipping date for any order is the first available preferred day of shipping within that order period.
In this case, the shipping date for any order is the first available preferred day of shipping within that order period.

Example: Consider a plan of 6 months that ships an item every two months for which a customer signs-up with billing period starting on Jan 1 and making the payment on Jan 10. If the preferred shipping day was set to 7th Jan of every month, then the item is shipped to customer before the actual payment date. The illustration shows the shipping date for each order.


The site settings allow you to make an exception for the first order in a schedule and ship it immediately on the first order date instead of waiting till the preferred shipping day. Moreover, you can choose to make this exception for all orders or just gift orders.

If the preferred shipping day is not available within the order period, then by default the shipping date is set to the order date for the period.

Consider a quarterly plan that ships a product every month. Assume that calendar billing is enabled with calendar billing date set to 25th. Also, say the preferred shipping date is set to 10th. Now, say the customer signs up on Jan 1st and the payment only happens on Jan 15th. Since the payment happens after the preferred shipping date, the shipping date for the first order now becomes Jan 15th.

Shipping Cut-off for Orders 

There might be the case when it is not possible to fulfill the first order in a schedule unless the payment happens by a certain day of the month. You can configure the shipping day in Chargebee as shipping cut-off. If payment is delayed beyond the last shipping cut-off day in the first order period, then the first order is cancelled and a refundable credit noteis raised for the order amount.

Note that Shipping cut-off is not applicable for week-based shipping periods and gift subscriptions.


Consider a shippable plan of 6 months duration that ships a product every two months. Assume calendar billing date to be 10th and calendar billing cut-off date to be 15th. The customer signs-up on Jan 5th with the same billing period start date. Since the billing cut-off date is not overstepped, thus we have the first order period ending on Mar 10th.

Moreover, if the shipping cut-off is set as 20th then there are two such dates (Jan 20th and Feb 20th) till the end of the first order period for which the shipping cut-off date is set to the latest of those dates (Feb 20th). Further, if payment happens on Feb 25th, it oversteps the shipping cut-off. Consequently, the first order on Feb 25th is in cancelled status then the remaining orders will be created in the queued status. The scenario is shown in the example below:


If the subscription is set to start in the future or if it is invoiced in advance, then the orders are scheduled such that the first order date is the start date of the billing period or the date of payment of the invoice, whichever is later.

Plans/addons with only one order 

When there is only one shipment to be fulfilled for the entire plan/addon, the order is scheduled based on the other rules. Also, the invoice must be paid before the end of the billing period. The order is scheduled for the plans/addons with only one order period whose length is the entire billing period of the subscription/addon.

Non-recurring Addons 

A non-recurring addon can be added to a subscription or customer at any time.

For example, say you have a plan that ships coffee packets every month. A few months into the subscription, a customer may decide to purchase a brewing machine or a coffee mug. Such items would be examples of non-recurring addons in Chargebee.

For addons:

  • If invoiced immediately, any shipping date preference does not apply since it is assumed that the shipping must be done immediately upon payment for such an addon. The order date and shipping date hence would be the same as the payment date.
  • Whenever an addon is added to an unbilled charges then it becomes the part of the first (or only) order associated with that invoice.

Consolidated Invoicing 

If consolidated invoicing is enabled in Chargebee, the billing and shipping address is taken from the consolidated invoice. If the consolidated invoice does not contains shipping address then orders are scheduled based on the subscriptions.

Was this article helpful?