API Version
Product Catalog
Library

The invoice for a subscription in Chargebee is generated at the time of subscription renewal. Invoices can also be generated in advance for an upcoming renewal or set of renewals. With Advance Invoicing Schedules, you can set up a plan for when such advance invoices are generated for the lifetime of the subscription. This helps you:

  • Set up a contract with your customers so that they can be notified of their payment schedules in advance.
  • Allow customers who make offline payments to be alerted about their upcoming dues well ahead of actual subscription renewals.
  • Prevent post-renewal unpaid usage of your services by customers.

Advance invoices can be scheduled in two ways:

Specific Dates Schedule

Advance invoices for a subscription can be scheduled to be generated on specific dates in the future. You must specify the number of billing cycles to be invoiced on each date. A maximum of 5 dates can be specified.

Fixed Interval Schedule

Advance invoices can be scheduled to be generated at fixed intervals of time, where each interval spans the same number of billing cycles of the subscription. The invoice for each interval is generated a specified number of days (days_before_interval) before the start of the interval. You can configure the schedule to end on a certain date or after a specified number of advance invoices have been generated.

The start date of the first interval depends on the number of days remaining from current time till the next renewal of the subscription. If this is more than days_before_interval, the interval begins at the next renewal. On the other hand, if the number of days remaining before the next renewal is less than days_before_interval, the first interval begins at the renewal following the next.

Sample advance invoice schedule [ JSON ]

{ "id": "__test__KyVkmQSCX2vRK2t", "object": "advance_invoice_schedule", "schedule_type": "specific_dates", "specific_dates_schedule": { "date": 1518339706, "object": "specific_dates_schedule", "terms_to_charge": 2 } }

API Index URL GET

https://{site}.chargebee.com/api/v2/advance_invoice_schedules

Model Class

id
string, max chars=40
System-generated and immutable unique Id for the advance_invoice_schedule.
schedule_type
optional, enumerated string
The type of advance invoice or advance invoicing schedule.
Possible values are
fixed_intervalsThe advance charges occur at fixed intervals of time.specific_datesThe advance charges occur on specific dates. For each date, a fixed number of billing cycles is charged for. There can be up to 5 dates configured.
Show all values[+]
fixed_interval_schedule
Show attributes [+]
optional, fixed_interval_schedule
When the schedule_type is fixed_intervals, this object gives further details of the schedule.
specific_dates_schedule
Show attributes [+]
optional, specific_dates_schedule
The advance charges occur on specific dates. For each date, a fixed number of billing cycles is charged for. There can be up to 5 dates configured.
id id
string, max chars=40
System-generated and immutable unique Id for the advance_invoice_schedule.
schedule_type schedule_type
optional, enumerated string
The type of advance invoice or advance invoicing schedule.
fixed_interval_schedule
optional, fixed_interval_schedule
When the schedule_type is fixed_intervals, this object gives further details of the schedule.
specific_dates_schedule
optional, specific_dates_schedule
The advance charges occur on specific dates. For each date, a fixed number of billing cycles is charged for. There can be up to 5 dates configured.