Plugins

Last Updated: 2023-10-29 02:00:08
The billing plugin is the foundation for plugins requiring transactions.  It allows customers to manage their debit/credit cards as well as view transaction details for subscriptions and/or orders. It's also responsible for managing your banking account and negotiating banking information requests.
    
Most of the features this plugin offers are run in the background with the exception of taxes.
   
The billing plugin supports the creation of a flexible taxation table with rule-set filtering. The rule-sets defined are filtering by locality which can be a combination of city, county, or township.  Rule-sets apply to a tax definition which starts with a country and region.  For example, in the Us this will be a state and in Canada, this will be a province.  
        
A couple of taxation concepts need to be explained in order to understanding and create your tax definitions and rules.  
        
Taxation Direction
When a purchase is made the taxation direction defines which jurisdictions tax rule to apply.  It can be either the source ( your business location ) or the destination ( the customers location ).  
                
For example, Most states and Washington, D.C., are destination-based. There are 11 source based states. Arizona, Illinois, Mississippi, Missouri, New Mexico, Ohio, Pennsylvania, Tennessee, Texas, Utah, Virginia and California
                    
California is a unique case. Its considered a mixed direction state as city, county and state sales taxes are source based a while district sales taxes and supplementary local taxes are destination based.

Note: Currently, the billing plugin taxation table doesn't support this special cases.

Compound Taxes
Compound taxation is a tax which is applied optop of another tax.  In otherwords, the tax is calculated on the amount after the primary tax has been applied ( not the untaxed amount ).  
                
When creating rates, it's not always necessary to declare the definition as being a compound tax, an adjusted tax percentage can be used instead yeilding the same result.
                
For example, in Canada, Quebecs' QST is a compound tax.  Taxes are applied at a fixed rate so it is possible to define the following for Quebec: GST = 5%, QST = 8.925% ( instead of 8.5% ). This is because ( 100% + 5% ) * 8.5% = 8.925%. The total effective tax will be 13.925% as the PST includes the GST amount.

Shipping Tax
Some jurisdictions require that freight be taxed and it depends on the tax-ability of the products being shipped.  You can define a taxation rules with the option to tax the freight or tax freight as a percentage of taxable items.  This means that freight is taxable when all products being shipped are taxable or as a percentage if some products are taxable.
                
If the shipment contains both exemptions and taxable products, the portion of the charge allocated to the taxable sale is taxable, and the portion attributed to the exemption sale is exempt.
                             
Note: There are exceptions to every rule and some states have different rules for different situations. The billing plugin taxation table doesn't support these special cases.
                 
When creating a definition you will also need to indicate the direction, shipping logic and how to filter rule-set matches ( filtered by locality ).  Options to filter matches can either be set to select the highest tax rate or all matching tax rates.
        
A definition can have many rates. Each rule you define is filtered through an optional list of localities ( cities, counties, districts ).  If no localities are specified then the rate applies to all localities.
        
Note: Rates change periodically, it is recommended to consult with an accountant regarding regulations.

         
There are situations where items can be taxed at a different or reduced rates, tax exemptions and reductions.  Subscriptions and/or products will need to be explicitly assigned either or both.  Lets go through the available options.
        
Tax Exemptions
To create a tax exemption, a locality, condition and amount must be applied to the exemption. The conditions are either less than or greater than X amount.  This determines whether to apply the rule.

For example, in New York, clothing items priced at $110 or less are not taxable.  
            
Tax Reductions
To create a tax reductions, a locality and reduced percentage must be applied to the reduction. This determines whether to apply the rule.
                
For example, in Illinois, groceries are taxable at a reduced rate of one percent.
       
Taxes are complicated in some countries, for example, in the United States taxes are based on not only the state, county and city but also geographical jurisdictions.  Despite the complexity of US taxation a fairly accurate representation is possible by building a complete taxation rule-set of every jurisdiction you expect business from.
Was this page helpful?