Invoice Timing
The invoiceDateStrategy field controls when the invoice is issued relative to the billing period.
Invoice date strategies
FIRST_OF_PERIOD — Invoice generated on the first day of the billing period. Use for billing in advance.
LAST_OF_PERIOD — Invoice generated on the last day of the billing period.
ARREARS — Invoice generated on the first day after the billing period ends.
ADVANCED_DUE_START — Invoice generated before the billing period starts, dated so the payment due date lands on the first day of the period: invoice date = period start − payment terms. Use when payment must clear before service begins.
January billing period — billed monthly
When to use each
FIRST_OF_PERIOD
LAST_OF_PERIOD
ARREARS or LAST_OF_PERIOD
ARREARS
ADVANCED_DUE_START
Usage billing note: Unit and tiered products should almost always use ARREARS or LAST_OF_PERIOD. Using FIRST_OF_PERIOD on a usage-based product will invoice before any events have been reported.
Invoice date strategy Required: Controls when the invoice is generated relative to the billing period. Must be one of FIRST_OF_PERIOD, LAST_OF_PERIOD, ARREARS, or ADVANCED_DUE_START.