Difference between revisions of "Freeside:3:Documentation:Administration:Tax Districts"

From Freeside
Jump to: navigation, search
(Created page with "==Overview == Freeside currently supports billing taxes by district in the state of Washington. The information is pulled from the Washington Department of Revenue for updati...")
 
(Updating tax rates)
 
(8 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 +
See also: [[Freeside:4:Documentation:Administration:Tax_Districts]]
 +
 
==Overview ==
 
==Overview ==
Freeside currently supports billing taxes by district in the state of Washington.  The information is pulled from the Washington Department of Revenue for updating customer records with tax districts while also updating the tax rates in the internal tax editor located at Configuration -> Billing -> Locales and tax rates.
+
Freeside currently supports billing taxes by district, instead of city/county/state. Currently this is only supported in the state of Washington.  The information is pulled from the Washington Department of Revenue for updating customer records with tax districts while also updating the tax rates in the internal tax editor located at Configuration -> Billing -> Locales and tax rates.
 
 
  
 
== Setup ==  
 
== Setup ==  
  
Configure the option: tax_district_method located in the UI, Configuration -> Settings.  Currently the only option is Washington sales tax.
+
Configure option: tax_district_method, in Configuration -> Settings.  Currently the only option is Washington sales tax.
  
The command freeside-tax-district-update will need to be ran.   
+
The command freeside-tax-district-update will need to be ran. User should be replaced with a valid user in Freeside.   
  
<pre>freeside-tax-district-update</pre>
+
<pre>sudo -u freeside freeside-tax-district-update user</pre>
  
The command will update the 'district' field for all customers nd service locations using an online tax information lookup method.  Currently the only one supported is the Washington Department of Revenue sales tax table, and looking up the tax district will create a cust_main_county record with the tax rate for that district.
+
The command will update the 'district' field for all customers and service locations using an online tax information lookup method.  Looking up the tax district will create a cust_main_county record with the tax rate for that district.  All jobs are queued so their may be some delay before all records are modified.
  
 
== Updating tax rates ==
 
== Updating tax rates ==
Line 19: Line 20:
 
Example usage:
 
Example usage:
  
<pre>wa_tax_rate_update -t "State Sales Tax" -c "Sales"</pre>
+
<pre>sudo -u freeside wa_tax_rate_update -t "State Sales Tax" -c "Sales"</pre>
  
-t defines the tax name
+
-t defines the tax name<br>
 
-c defines the tax class
 
-c defines the tax class
  
 
This will download the new rates and upgrade the tax tables.  You will need to do this for each tax class
 
This will download the new rates and upgrade the tax tables.  You will need to do this for each tax class
 
you have setup in your system.
 
you have setup in your system.

Latest revision as of 11:01, 6 June 2019

See also: Freeside:4:Documentation:Administration:Tax_Districts

Overview

Freeside currently supports billing taxes by district, instead of city/county/state. Currently this is only supported in the state of Washington. The information is pulled from the Washington Department of Revenue for updating customer records with tax districts while also updating the tax rates in the internal tax editor located at Configuration -> Billing -> Locales and tax rates.

Setup

Configure option: tax_district_method, in Configuration -> Settings. Currently the only option is Washington sales tax.

The command freeside-tax-district-update will need to be ran. User should be replaced with a valid user in Freeside.

sudo -u freeside freeside-tax-district-update user

The command will update the 'district' field for all customers and service locations using an online tax information lookup method. Looking up the tax district will create a cust_main_county record with the tax rate for that district. All jobs are queued so their may be some delay before all records are modified.

Updating tax rates

The script wa_tax_rate_update can be used to update taxes in the cust_main_county table.

Example usage:

sudo -u freeside wa_tax_rate_update -t "State Sales Tax" -c "Sales"

-t defines the tax name
-c defines the tax class

This will download the new rates and upgrade the tax tables. You will need to do this for each tax class you have setup in your system.