Retrieve “billed until” dates for recurring billings.
This API call calculates the end date of the last billed period for each specified billing. Check these dates against the parameters of respective billings to find out which customers are already due for their next invoice. Detailed information about each billing can be retrieved with API call getBillingStatements.
Most importantly, you need to know:
For billings that are based on meter readings, a “billing period” is the time span from one reading to the next one; and the “billed until” date is the date of the last invoiced reading.
API returns “0000-00-00” for a particular billing if:
Generally, recurring billing works best if invoices are issued in order. If there are any gaps in billing, back office and API at the moment treat fixed-fee billings and metered billings differently. For a fixed-fee billing, API returns the date of the most recent billed period; while for metered billings, API identifies the earliest “gap” in invoices (earliest reading that has not been invoiced yet) and returns the date of the reading before that.
|Parameter name||Description||Possible value||Required|
A comma-separated list of billing statement IDs, containing at most 500 IDs.
If the list contains more than 500 IDs, error code 1138 is returned..
|String (comma-separated list of integers)||yes|
|billingStatementID||Integer||Billing statement ID.|
|billedUntil||ISO date (yyyy-mm-dd)||End date of the last billed period, or "0000-00-00" if the billing is deactivated, no invoices have been issued yet, or no readings have been entered yet.|