Skip to main content
RegimeDef defines the holding structure for the definitions of taxes inside a country or territory.

Schema ID

https://gobl.org/draft-0/tax/regime-def

Properties

TitlePropertyTypeReq.Description
Namenamei18n.StringtrueName of the tax regime.
Descriptiondescriptioni18n.StringIntroductory details about the regime.
Sourcessourcesarray of cbc.SourceSources is a list of references to tax authority or other relevant documentation that can be used to validate the regime’s data and be used in the future to check for updates and changes.
Time Zonetime_zonestringtrueLocation name for the country’s central time zone. Accepted values from IANA Time Zone Database (https://iana.org/time-zones). If a country has multiple time zones, the most common or central one should be used.
Codecountryl10n.TaxCountryCodetrueCountry code for tax purposes which usually coincides with the ISO 3166-1 alpha-2 code, but not always.
Alternative Country Codesalt_country_codesarray of l10n.CodeAlternative localization codes that may be used to identify the tax regime in specific circumstances.
Zonezonel10n.CodeSpecific Locality, region, city, province, county, or similar code inside the country, if needed.
Currencycurrencycurrency.CodetrueCurrency used by the country.
Tax Schemetax_schemecbc.CodeTaxScheme defines the principal scheme of consumption tax that should be applied to the regime and associated with Tax IDs in some export formats such as UBL or CII. Some regimes may not have a Tax Scheme and as a consequence will not use tax identities, like the US.
Calculator Rounding Rulecalculator_rounding_rulecbc.KeyRounding rule to use when calculating the tax totals. See the RoundingRule constants for more details. If not provided, the default is RoundingRulePrecise.
Tagstagsarray of tax.TagSetTags that can be applied at the document level to identify additional considerations.
Extensionsextensionsarray of cbc.DefinitionExtensions defines the keys that can be used for extended or extra data inside the regime that is specific to the regime and cannot be easily determined from other GOBL structures. Typically these are used to define local codes for suppliers, customers, products, or tax rates.
Identitiesidentitiesarray of cbc.DefinitionIdentities used in addition to regular tax identities and specific for the regime that may be validated against.
Payment Means Keyspayment_means_keysarray of cbc.DefinitionPaymentMeansKeys specific for the regime that extend the original base payment means keys.
Inbox Keysinbox_keysarray of cbc.DefinitionInboxKeys specific to the regime that can be used to identify where a document should be forwarded to.
Scenariosscenariosarray of tax.ScenarioSetScenarios are used to describe a specific set of conditions and rules that apply to a specific document schema. These provide a more generic solution for normalization and validation of documents in regimes with specific requirements.
Correctionscorrectionstax.CorrectionSetConfiguration details for corrections to be used with correction options.
Categoriescategoriesarray of tax.CategoryDeftrueList of tax categories.