Invoicing Error Scenarios

[Shaun Forgie]

Hi All,

I would like to clarify my understanding of what happens in Kill Bill when an invoicing error occurs and the way in which these errors can be configured and resolved. Hopefully this conversation will allow the documentation to be improved in this area.

Current documentation on parked accounts can be found here https://docs.killbill.io/latest/invoice_subsystem.html#_parked_accounts

The following list describes the invoicing error scenarios that can occur, the configuration values that control those behaviours, the system default values for those settings. And how to resolve those errors.

1. Daily Items Maximum Exception -> setting org.killbill.invoice.maxDailyNumberOfItemsSafetyBound [15]

Can be disabled by setting the value to -1 or setting a higher number of daily items at the Tenant level, removing the ___parked___ control tag from the account and then rerunning invoicing for account or removing extra items for the day.

2. Invoice Monthly Increase Safety Margin Exception -> org.killbill.invoice.sanitySafetyBoundEnabled [True] and org.killbill.invoice.readMaxRawUsagePreviousPeriod [2]. 

Typically triggered if an account was tagged with AUTO_INVOICING_OFF and the tag gets removed. Documentation is not clear what default value the boundary margin is or the effect of the error and or how to resolve the error. 

3. Unknown Usage Items ->org.killbill.invoice.parkAccountsWithUnknownUsage [False]. 

If this setting is changed to True unknown usage items will put a control tag on the Account with the value "___parked___". Manually turning this tag off puts the account back into an active billing state.

Note that the default settings come from the killbill.properties file but can be overridden at a tenant level by making calls to the 1.0/kb/tenants/uploadPerTenantConfig API endpoint with the appropriate settings.

Comments welcome as always

Rgs

Shaun

ᐧ

[Mary McCauley-Stiff]

Thank you, Shaun, for taking the time to document this. I've logged it at https://github.com/killbill/killbill-docs/issues.

Regards,

Mary