All Collections
API
Tax Setting API
Tax Setting API

Use tax settings API to return current tax configuration

Peter Virly avatar
Written by Peter Virly
Updated over a week ago

LIST Current Tax Settings - GET /tax_settings.xml


You can retrieve current tax settings and tax rates using this GET /tax_settings.xml. Tax settings returns 2 settings and list of tax rates.

Tax Settings

FIELD NAME

DESCRIPTION

compute_tax

indicates whether tax needs to be applied (default is false)

tax_inclusive

indicates whether price already includes tax (default is false)

Tax Rate Fields

FIELD NAME

DESCRIPTION

id

unique id of the tax rate

branch_id

if branch id is specified, it is applicable to only this branch, otherwise, applicable to branches.

name

name of tax

status

is nil if the tax rate is active, otherwise, it is "D"

value

tax rate is express in decimal (0.1 means 10%)

tax_rate_type

0 - applicable to all products, 1 - applicable to selected products only

The default tax rate will have no id, no branch_id and tax_rate_type of 0.

Example

curl -u 4acc660ce98b9d38d7fea10705aa1ebd7d836fe0:X \
-H "Accept: application/xml" \
-H "Content-Type: application/xml" \
"https://test_account.imonggo.com/api/tax_settings.xml"

Sample result

<?xml version="1.0" encoding="UTF-8"?>
<hash>
  <compute_tax type="boolean">true</compute_tax>
  <tax_inclusive type="boolean">false</tax_inclusive>
  <tax_rates type="array">
    <tax_rate>
      <branch_id nil="true"></branch_id>
      <id nil="true"></id>
      <name>Tax</name>
      <status nil="true"></status>
      <value>0.1</value>
      <tax_rate_type>0</tax_rate_type>
    </tax_rate>
  </tax_rates>
</hash>

Tax Exemption

Any tax by default is applicable to all products, except if the product is tax exempt. The tax computation should also be ignored if a particular customer has tax_exempt set to true.

Product Specific Tax and Branch Specific Tax

If the a tax has tax_rate_type of 1, it is applicable to only selected products. When downloading products, the tax_rates array is returned if the items contains product specific tax.

A tax can be applied to only specific branch. In this case, the branch id will be specified. Please see the 3rd entry in the example below.

Example:

Example below shows the system is configured with multiple tax rates. It has two 3 rates.

The first one is VAT of 10% applicable to all items.

<tax_rate>
  <branch_id nil="true"></branch_id>
  <id>1</id>
  <name>VAT</name>
  <status nil="true"></status>
  <value>0.1</value>
  <tax_rate_type>0</tax_rate_type>
</tax_rate>

While the second is the alcohol tax of 5% applicable to only selected items.

<tax_rate>
  <branch_id nil="true"></branch_id>
  <id>2</id>
  <name>Alchohol Tax</name>
  <status nil="true"></status>
  <value>0.05</value>
  <tax_rate_type>1</tax_rate_type>
</tax_rate>

The 3rd tax rate is Gambling tax of 3% applicable to only selected products and selected branch only (branch id 9).

<tax_rate>
  <branch_id>9</branch_id>
  <id>3</id>
  <name>State Tax</name>
  <status nil="true"></status>
  <value>0.03</value>
  <tax_rate_type>0</tax_rate_type>
</tax_rate>

The following XML results contains 2 products. The first item is California Nap Red Wine should be tax with Alcohol tax of 5%, as well as VAT of 10% which is applicable to all items.

The second item wine glass only needs to be taxed 10% VAT.

<?xml version="1.0" encoding="UTF-8"?>
<products type="array">
  <product>
    <allow_decimal_quantities>false</allow_decimal_quantities>
    <cost>100.0</cost>
    <description></description>
    <disable_discount>false</disable_discount>
    <disable_inventory>false</disable_inventory>
    <enable_open_price>false</enable_open_price>
    <id>62</id>
    <name>California Napa Red Wine</name>
    <retail_price>120.0</retail_price>
    <status nil="true"></status>
    <stock_no>A1</stock_no>
    <tax_exempt>false</tax_exempt>
    <tag_list></tag_list>
    <barcode_list></barcode_list>
    <utc_created_at>2011-04-23T11:24:58Z</utc_created_at>
    <utc_updated_at>2011-04-23T11:24:58Z</utc_updated_at>
    <thumbnail_url></thumbnail_url>
    <tax_rates type="array">
      <tax_rate>
        <branch_id nil="true"></branch_id>
        <id>2</id>
        <name>Alchohol Tax</name>
        <status nil="true"></status>
        <value>0.05</value>
        <tax_rate_type>1</tax_rate_type>
      </tax_rate>
    </tax_rates>
    <branch_prices type="array"/>
  </product>
  <product>
    <allow_decimal_quantities>false</allow_decimal_quantities>
    <cost>10.0</cost>
    <description></description>
    <disable_discount>false</disable_discount>
    <disable_inventory>false</disable_inventory>
    <enable_open_price>false</enable_open_price>
    <id>63</id>
    <name>Correl Wine Glass</name>
    <retail_price>20.0</retail_price>
    <status nil="true"></status>
    <stock_no>A2</stock_no>
    <tax_exempt>false</tax_exempt>
    <tag_list></tag_list>
    <barcode_list></barcode_list>
    <utc_created_at>2011-04-23T11:25:31Z</utc_created_at>
    <utc_updated_at>2011-04-23T11:25:31Z</utc_updated_at>
    <thumbnail_url></thumbnail_url>
    <tax_rates type="array"/>
    <branch_prices type="array"/>
  </product>
</products>
Did this answer your question?