Documentation Index Fetch the complete documentation index at: https://gobl-improv.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
Base Details
Key Value Tax Country Code PTCurrency EURBase Time Zone Europe/Lisbon
Tax Categories
Code Name Title VATVAT Value Added Tax
VAT Rates
Key Name Percents Description standardStandard Rate 16.0% intermediateIntermediate Rate 9.0% reducedReduced Rate 4.0% exemptExempt otherOther
Correction Definitions
Auto-generation of corrective invoices or credit and debit notes is
supported.
Invoice Types
The types of invoices that can be created with a preceding definition:
Extensions
Region Code
SAF-T’s TaxCountryRegion (País ou região do imposto) specifies the region of taxation
(Portugal mainland, Açores, Madeira or any ISO country) in a Portuguese invoice. Each
region has their own tax rates which can be determined automatically.
To set the specific a region different to Portugal mainland, the pt-region extension of
each line’s VAT tax should be set to one of the following values:
Code Description PT Mainland Portugal (default) PT-AC Açores PT-MA Madeira … Any ISO country code (e.g. ES, FR, DE, etc.)
For example:
{
"$schema" : "https://gobl.org/draft-0/bill/invoice" ,
// ...
"lines" : [
{
// ...
"item" : {
"name" : "Some service" ,
"price" : "25.00"
},
"tax" : [
{
"cat" : "VAT" ,
"rate" : "exempt" ,
"ext" : {
"pt-region" : "PT-AC" ,
// ...
}
}
]
}
]
}
Code Name PTMainland Portugal PT-ACAzores PT-MAMadeira AFAfghanistan AXÅland Islands ALAlbania DZAlgeria ASAmerican Samoa ADAndorra AOAngola AIAnguilla AQAntarctica AGAntigua and Barbuda ARArgentina AMArmenia AWAruba AUAustralia ATAustria AZAzerbaijan BSBahamas BHBahrain BDBangladesh BBBarbados BYBelarus BEBelgium BZBelize BJBenin BMBermuda BTBhutan BOBolivia, Plurinational State of BQBonaire, Sint Eustatius and Saba BABosnia and Herzegovina BWBotswana BVBouvet Island BRBrazil IOBritish Indian Ocean Territory BNBrunei Darussalam BGBulgaria BFBurkina Faso BIBurundi CVCabo Verde KHCambodia CMCameroon CACanada KYCayman Islands CFCentral African Republic TDChad CLChile CNChina CXChristmas Island CCCocos (Keeling) Islands COColombia KMComoros CGCongo CDCongo, Democratic Republic of the CKCook Islands CRCosta Rica CICôte d’Ivoire HRCroatia CUCuba CWCuraçao CYCyprus CZCzechia DKDenmark DJDjibouti DMDominica DODominican Republic ECEcuador EGEgypt SVEl Salvador GQEquatorial Guinea EREritrea EEEstonia SZEswatini ETEthiopia FKFalkland Islands FOFaroe Islands FJFiji FIFinland FRFrance GFFrench Guiana PFFrench Polynesia TFFrench Southern Territories GAGabon GMGambia GEGeorgia DEGermany GHGhana GIGibraltar GRGreece GLGreenland GDGrenada GPGuadeloupe GUGuam GTGuatemala GGGuernsey GNGuinea GWGuinea-Bissau GYGuyana HTHaiti HMHeard Island and McDonald Islands VAHoly See (the) HNHonduras HKHong Kong HUHungary ISIceland INIndia IDIndonesia IRIran, Islamic Republic of IQIraq IEIreland IMIsle of Man ILIsrael ITItaly JMJamaica JPJapan JEJersey JOJordan KZKazakhstan KEKenya KIKiribati KPKorea, Democratic People’s Republic of KRKorea, Republic of KWKuwait KGKyrgyzstan LALao People’s Democratic Republic LVLatvia LBLebanon LSLesotho LRLiberia LYLibya LILiechtenstein LTLithuania LULuxembourg MOMacao MKNorth Macedonia MGMadagascar MWMalawi MYMalaysia MVMaldives MLMali MTMalta MHMarshall Islands MQMartinique MRMauritania MUMauritius YTMayotte MXMexico FMMicronesia, Federated States of MDMoldova, Republic of MCMonaco MNMongolia MEMontenegro MSMontserrat MAMorocco MZMozambique MMMyanmar NANamibia NRNauru NPNepal NLNetherlands NCNew Caledonia NZNew Zealand NINicaragua NENiger NGNigeria NUNiue NFNorfolk Island MPNorthern Mariana Islands NONorway OMOman PKPakistan PWPalau PSPalestine, State of PAPanama PGPapua New Guinea PYParaguay PEPeru PHPhilippines PNPitcairn PLPoland PRPuerto Rico QAQatar RERéunion RORomania RURussian Federation RWRwanda BLSaint Barthélemy SHSaint Helena, Ascension and Tristan da Cunha KNSaint Kitts and Nevis LCSaint Lucia MFSaint Martin (French part) PMSaint Pierre and Miquelon VCSaint Vincent and the Grenadines WSSamoa SMSan Marino STSao Tome and Principe SASaudi Arabia SNSenegal RSSerbia SCSeychelles SLSierra Leone SGSingapore SXSint Maarten (Dutch part) SKSlovakia SISlovenia SBSolomon Islands SOSomalia ZASouth Africa GSSouth Georgia and the South Sandwich Islands SSSouth Sudan ESSpain LKSri Lanka SDSudan SRSuriname SJSvalbard and Jan Mayen SESweden CHSwitzerland SYSyrian Arab Republic TWTaiwan (Province of China) TJTajikistan TZTanzania, the United Republic of THThailand TLTimor-Leste TGTogo TKTokelau TOTonga TTTrinidad and Tobago TNTunisia TRTürkiye TMTurkmenistan TCTurks and Caicos Islands TVTuvalu UGUganda UAUkraine AEUnited Arab Emirates GBUnited Kingdom USUnited States of America UMUnited States Minor Outlying Islands UYUruguay UZUzbekistan VUVanuatu VEVenezuela, Bolivarian Republic of VNViet Nam VGVirgin Islands (British) VIVirgin Islands (U.S.) WFWallis and Futuna EHWestern Sahara YEYemen ZMZambia ZWZimbabwe