Skip to main content
Combo represents the tax combination of a category code and rate key.

Schema ID

https://gobl.org/draft-0/tax/set#/$defs/Combo

Properties

TitlePropertyTypeDescription
Categorycatcbc.CodeTax category code from those available inside a region.
Countrycountryl10n.TaxCountryCodeCountry code override when issuing with taxes applied from different countries.
keycbc.KeyKey helps determine the tax situation within the category.
Rateratecbc.KeyRate within a category and for a given key to apply.
Percentpercentnum.PercentagePercent defines the percentage set manually or determined from the key. A nil percent implies that this tax combo is either exempt or not-subject.
Surchargesurchargenum.PercentageSome countries require an additional surcharge (may be determined if key present).
Extensionsexttax.ExtensionsLocal codes that apply for a given rate or percentage that need to be identified and validated.

Validation Rules

FieldTestValidation Code / Message
Combo
  • Category in regime
GOBL-TAX-COMBO-01
Tax category not valid for regime
Combo
  • Key in category
GOBL-TAX-COMBO-02
Tax combo key not valid for category in regime
Combo
  • Rate in key
GOBL-TAX-COMBO-03
Tax combo rate not valid for key in regime
Combo
  • Percent valid for key
GOBL-TAX-COMBO-04
Tax combo percent required or invalid for key in regime
Combo
  • Surcharge requires percent
GOBL-TAX-COMBO-05
Tax combo surcharge requires percent in regime
Combo
  • Extension keys defined
GOBL-TAX-COMBO-06
Tax combo extension key not defined in regime