Bill
Tax
Tax defines a summary of the taxes which may be applied to an invoice.
Schema ID
https://gobl.org/draft-0/bill/tax
Properties
Title | Property | Type | Req. | Description |
---|---|---|---|---|
Prices Include | prices_include | cbc.Code | Category of the tax already included in the line item prices, especially useful for B2C retailers with customers who prefer final prices inclusive of tax. | |
Rounding Model | rounding | cbc.Key | Rounding model used to perform tax calculations on the invoice. This will be configured automatically based on the tax regime, or sum-then-round by default, but you can override here if needed. Use with caution, as some conversion tools may make assumptions about the rounding model used. | |
Extensions | ext | tax.Extensions | Additional extensions that are applied to the invoice as a whole as opposed to specific sections. | |
Meta | meta | cbc.Meta | Any additional data that may be required for processing, but should never be relied upon by recipients. |
Rounding Model Values
Value | Description |
---|---|
precise | The default method of calculating the totals in GOBL, and provides the best results for most cases as the precision is maintained to the maximum amount possible. The tradeoff however is that sometimes the totals may not sum exactly based on what is visible. |
currency | The alternative method of calculating the totals that will first round all the amounts to the currency’s precision before making the sums. Totals using this approach can always be recalculated using the amounts presented, but can lead to rounding errors in the case of pre-payments and when line item prices include tax. |