Open APIs

Hello,

While implementing the TMF678 Billing API, I encountered a scenario where a single billing item may have two different tax rates applied during different time intervals within the billing month.

However, the TaxItem entity does not include a field to specify a time period or interval.

How do you typically model this situation in practice?

• Is it common to create separate CustomerBillItem objects for each tax period?

• Or is there a recommended way to use custom fields or extensions to indicate the time intervals?

• Are there any plans in future TMF678 versions to support time intervals in TaxItem?

Thank you for your advice!

Hi Adnan,

I don't know the exact use case.

`CustomerBill` does contain an array of `TaxItem`, so you should be able to support different tax rates. Also, there is a single field for `taxIncludedAmount` and `taxExcludedAmount`. So, if there is a requirement it looks like all these need be considered when extending.

I agree with Manu's reply.  TaxItem is an array, so there could be a tax item for the period before the change in rate and another for after.  Hence, there shouldn't really be a need for multiple bill items.  If you need to specify the time period for each of these tax rates then you could consider a polymorphic extension to the TaxItem to add this concrete field