CategoryDef contains the definition of a general type of tax inside a region.

Schema ID

https://gobl.org/draft-0/tax/regime-def#/$defs/CategoryDef

Properties

TitlePropertyTypeReq.Description
Codecodecbc.CodetrueCode to be used in documents
Namenamei18n.StringtrueShort name of the category to be used instead of code in output
Titletitlei18n.StringHuman name for the code to use for titles
Descriptiondesci18n.StringUseful description of the category.
RetainedretainedbooleanRetained when true implies that the tax amount will be retained by the buyer on behalf of the supplier, and thus subtracted from the invoice taxable base total. Typically used for taxes related to income.
Ratesratesarray of tax.RateDefSpecific tax definitions inside this category.
Extensionsextensionsarray of cbc.KeyExtensions defines a list of extension keys that may be used or required as an alternative or alongside choosing a rate for the tax category. Every key must be defined in the Regime’s extensions table.
Mapmapcbc.CodeMapMap defines a set of regime specific code mappings.
Sourcessourcesarray of tax.SourceList of sources for the information contained in this category.
Extensionsexttax.ExtensionsExtensions key-value pairs that will be copied to the tax combo if this category is used.
Metametacbc.MetaMeta contains additional information about the category that is relevant for local frequently used formats.