Skip to main content

Overview

The tax.scheme field identifies the tax system/regime applied to invoice items, supporting all major global tax frameworks from VAT to GST to sales taxes. Current Implementation: ["VAT", "GST", "sales_tax"] Field Type: string (enum) Required: No (optional) Standards: OECD Tax Treaties, WTO Tax Codes Usage: The tax regime used

Complete Tax Scheme Enum

πŸ‡ͺπŸ‡Ί Value Added Tax (VAT) Systems

SchemeFull NameRegionsRate RangeDescription
VATValue Added TaxEU, UK, 100+ countries0-27%Most common global system
EU_VATEuropean Union VAT27 EU member states15-27%Harmonized EU system
UK_VATUnited Kingdom VATUnited Kingdom0-20%Post-Brexit UK system
MOSS_VATMini One Stop Shop VATEU digital servicesVariableDigital services to consumers
OSS_VATOne Stop Shop VATEU cross-borderVariableCross-border B2C services
IOSS_VATImport One Stop ShopEU importsVariableImport of low-value goods

🌏 Goods and Services Tax (GST) Systems

SchemeFull NameRegionsRate RangeDescription
GSTGoods and Services TaxAustralia, Canada, India+0-28%Comprehensive consumption tax
AU_GSTAustralian GSTAustralia0-10%Broad-based consumption tax
CA_GSTCanadian GSTCanada5%Federal GST
CA_HSTHarmonized Sales TaxCanada (some provinces)13-15%Combined federal + provincial
CA_PSTProvincial Sales TaxCanada (some provinces)6-10%Provincial-level tax
CA_QSTQuebec Sales TaxQuebec, Canada9.975%Quebec provincial tax
IN_GSTIndian GSTIndia0-28%Unified Indian tax system
IN_CGSTCentral GSTIndia0-14%Central government GST
IN_SGSTState GSTIndia0-14%State government GST
IN_IGSTIntegrated GSTIndia (interstate)0-28%Interstate transactions
IN_UTGSTUnion Territory GSTIndia (UT)0-14%Union Territory GST
SG_GSTSingapore GSTSingapore0-9%Singapore consumption tax
MY_GSTMalaysian GSTMalaysia0-6%Malaysian goods/services tax
MY_SSTSales and Service TaxMalaysia6-10%Replaced GST in 2018
NZ_GSTNew Zealand GSTNew Zealand0-15%New Zealand consumption tax

πŸ‡ΊπŸ‡Έ Sales Tax Systems

SchemeFull NameRegionsRate RangeDescription
SALES_TAXSales TaxUS States, others0-12%Point-of-sale taxation
US_STATE_TAXUS State Sales TaxUS States0-7.5%State-level sales tax
US_LOCAL_TAXUS Local Sales TaxUS Cities/Counties0-5%Local jurisdiction tax
US_USE_TAXUS Use TaxUS StatesVariableTax on out-of-state purchases
CA_RETAIL_TAXCalifornia Retail TaxCalifornia, US7.25-10.75%California state + local
NY_SALES_TAXNew York Sales TaxNew York, US4-8.875%NY state + local
TX_SALES_TAXTexas Sales TaxTexas, US6.25-8.25%Texas state + local

🌍 Regional Tax Systems

SchemeFull NameRegionsDescription
JCTJapan Consumption TaxJapanJapanese consumption tax (10%)
KR_VATKorean VATSouth KoreaKorean value-added tax (10%)
CN_VATChinese VATChinaChinese value-added tax (6-13%)
RU_VATRussian VATRussiaRussian value-added tax (0-20%)
BR_ICMSBrazilian ICMSBrazilState-level circulation tax
BR_IPIBrazilian IPIBrazilFederal industrialized products
BR_PIS_COFINSPIS/COFINSBrazilSocial contribution taxes
MX_IVAMexican IVAMexicoMexican value-added tax (16%)
AR_IVAArgentinian IVAArgentinaArgentine value-added tax
CL_IVAChilean IVAChileChilean value-added tax (19%)

🌐 International and Trade Taxes

SchemeFull NameApplicationDescription
CUSTOMS_DUTYCustoms DutyImportsTax on imported goods
IMPORT_DUTYImport DutyImportsDuty on goods entering country
EXPORT_DUTYExport DutyExportsDuty on goods leaving country
ANTI_DUMPING_DUTYAnti-Dumping DutyDumped importsProtective duty against dumping
COUNTERVAILING_DUTYCountervailing DutySubsidized importsDuty against subsidized imports
TARIFFTariffTrade protectionProtective trade barrier

πŸ’° Excise and Luxury Taxes

SchemeFull NameApplicationDescription
EXCISE_TAXExcise TaxSpecific goodsTax on specific products (alcohol, tobacco)
LUXURY_TAXLuxury TaxHigh-value itemsTax on luxury goods above threshold
SIN_TAXSin TaxVice productsTax on alcohol, tobacco, gambling
CARBON_TAXCarbon TaxCarbon emissionsEnvironmental tax on carbon content
FUEL_TAXFuel TaxMotor fuelsTax on gasoline, diesel, etc.
TOBACCO_TAXTobacco TaxTobacco productsSpecific excise on tobacco
ALCOHOL_TAXAlcohol TaxAlcoholic beveragesSpecific excise on alcohol
DIGITAL_TAXDigital Services TaxDigital servicesTax on digital platform revenues

⚑ Environmental and Green Taxes

SchemeFull NameApplicationDescription
ENVIRONMENTAL_TAXEnvironmental TaxEnvironmental impactTax on environmental damage
PLASTIC_TAXPlastic TaxPlastic productsTax on plastic usage
PACKAGING_TAXPackaging TaxProduct packagingTax on packaging materials
WASTE_TAXWaste TaxWaste disposalTax on waste generation
CONGESTION_TAXCongestion TaxTraffic congestionTax on city center driving

🏘️ Property and Asset Taxes

SchemeFull NameApplicationDescription
PROPERTY_TAXProperty TaxReal estateTax on property ownership
TRANSFER_TAXTransfer TaxProperty transfersTax on property sales
STAMP_DUTYStamp DutyProperty/documentsTax on legal documents
INHERITANCE_TAXInheritance TaxInherited assetsTax on inherited property
GIFT_TAXGift TaxGift transfersTax on gifted property
WEALTH_TAXWealth TaxNet wealthTax on total wealth

πŸ‘₯ Employment and Payroll Taxes

SchemeFull NameApplicationDescription
PAYROLL_TAXPayroll TaxEmployee wagesTax on payroll expenses
SOCIAL_SECURITY_TAXSocial Security TaxSocial programsTax for social security
UNEMPLOYMENT_TAXUnemployment TaxUnemployment insuranceTax for unemployment benefits
DISABILITY_TAXDisability TaxDisability insuranceTax for disability coverage
MEDICARE_TAXMedicare TaxHealthcareTax for Medicare (US)

πŸ”¬ Specialized and Industry Taxes

SchemeFull NameApplicationDescription
FINANCIAL_TRANSACTION_TAXFinancial Transaction TaxFinancial tradesTax on financial transactions
BANK_TAXBank TaxBanking servicesTax on banking activities
INSURANCE_PREMIUM_TAXInsurance Premium TaxInsurance premiumsTax on insurance premiums
TELECOM_TAXTelecommunications TaxTelecom servicesTax on telecom services
UTILITY_TAXUtility TaxUtilitiesTax on utility services
AVIATION_TAXAviation TaxAir travelTax on aviation services
SHIPPING_TAXShipping TaxMaritime transportTax on shipping services

🏒 Business and Corporate Taxes

SchemeFull NameApplicationDescription
CORPORATE_TAXCorporate Income TaxBusiness profitsTax on corporate earnings
WITHHOLDING_TAXWithholding TaxPayments to non-residentsTax withheld at source
BRANCH_PROFITS_TAXBranch Profits TaxForeign branch earningsTax on foreign branch profits
TURNOVER_TAXTurnover TaxGross receiptsTax based on gross sales
GROSS_RECEIPTS_TAXGross Receipts TaxBusiness receiptsTax on total business receipts

πŸ›οΈ Municipal and Local Taxes

SchemeFull NameApplicationDescription
MUNICIPAL_TAXMunicipal TaxLocal servicesLocal government tax
CITY_TAXCity TaxCity servicesCity-level taxation
COUNTY_TAXCounty TaxCounty servicesCounty-level taxation
DISTRICT_TAXDistrict TaxSpecial districtsSpecial district levies
TOURIST_TAXTourist TaxTourismTax on tourists/visitors
OCCUPANCY_TAXOccupancy TaxHotel staysTax on accommodation

❓ Administrative and Fallback

SchemeDescriptionUsage
OTHEROther tax schemeNon-standard tax systems
MIXEDMultiple tax schemesItems with multiple taxes
UNKNOWNUnknown tax schemeCannot determine from OCR
NONENo tax schemeTax-free transactions
PENDINGTax determination pendingAwaiting classification
⌘I