# Tax type exemptions Source: https://developer.avalara.com/products/communications/integration-guides/communications-integration/dcy9237155762871/ Guide: Communications # Tax type exemptions Learn about tax type exemptions, their fields, and examples of their application. A tax type exemption allows you to exempt taxes based on a tax type (`tpe`) and domain (`dom`) for a specific jurisdiction (`loc`). The tax type exemption is set on the invoice and applies to all line items included in the invoice. A list of tax types is available in the [GetTaxType](https://developer.avalara.com/api-reference/communications/v2/methods/Lookups/GetTaxType/) endpoint to retrieve information about a specific tax type. Or pass “\*” in`{taxType}` to return all tax types. Tip Use the tax type wildcard (setting both `tpe` and `dom` to`0`) to exempt all taxes types. The following table shows the exemption fields used for tax type exemptions and default values for the applicable fields: Table 1. Key Name Default `tpe` Tax type ID None. Must be set. `loc` [Jurisdiction](https://developer.avalara.com/api-reference/communications/v2/models/Location/) None. Must be set. `exnb` Exempt nonbillable `false` `dom` Domain None. Must be set. `scp` Scope Scope level `frc` Force level exemptible `true` when the tax type wildcard is used ## Example 1: Wildcard tax type with scope all **View request**: This example demonstrates the use of the wildcard tax type (`tpe` and `dom` both are 0) to exempt all tax types at all levels (`scp` is 1920). Update the scope (`scp`) to limit where the wildcard tax type is applied. ``` { "cmpn": { "bscl": 1, "svcl": 0, "fclt": true, "frch": true, "reg": false }, "inv": [ { "bill": {"ctry": "USA","st": "PR","city": "Adjuntas","zip": "00601","int": true }, "cust": 1, "lfln": false, "date": "2018-02-01T12:00:00Z", "exms": [{ "loc": { "pcd": 5116000 }, "tpe": 0, "dom": 0, "scp": 1920} ], "itms": [{ "ref": "1.04.wild", "chg": 100, "line": 0, "sale": 1, "incl": false, "tran": 13, "serv": 6, "dbt": false, "adj": false} ], "invm": true, "dtl": true, "summ": false } ] } ``` **View response**: All taxes are exempt except for the nonbillable tax (`bill` is `false`). ``` { "inv": [ { "itms": [{ "ref": "1.04.wild", "txs": [ { "bill": true, "cmpl": true, "tm": 0, "calc": 2, "cat": "E-911 CHARGES", "cid": 7, "name": "E911 (Business)", "exm": 0, "lns": 0, "min": 0, "pcd": 5115900, "rate": 1, "sur": false, "tax": 0, "lvl": 1, "tid": 35 }, { "bill": true, "cmpl": true, "tm": 0, "calc": 1, "cat": "CONNECTIVITY CHARGES", "cid": 5, "name": "State Universal Service Fund", "exm": 100, "lns": 0, "min": 0, "pcd": 5115900, "rate": 0.0139, "sur": false, "tax": 0, "lvl": 1, "tid": 13 }, { "bill": true, "cmpl": true, "tm": 0, "calc": 1, "cat": "SALES AND USE TAXES", "cid": 1, "name": "Sales Tax", "exm": 100, "lns": 0, "min": 0, "pcd": 5116000, "rate": 0.01, "sur": false, "tax": 0, "lvl": 3, "tid": 1 }, { "bill": true, "cmpl": true, "tm": 0, "calc": 1, "cat": "SALES AND USE TAXES", "cid": 1, "name": "Sales Tax", "exm": 100, "lns": 0, "min": 0, "pcd": 5116000, "rate": 0.105, "sur": false, "tax": 0, "lvl": 1, "tid": 1 }, { "bill": true, "cmpl": true, "tm": 0, "calc": 1, "cat": "CONNECTIVITY CHARGES", "cid": 5, "name": "Fed USF Cellular", "exm": 100, "lns": 0, "min": 0, "pcd": 0, "rate": 0.195, "sur": false, "tax": 0, "lvl": 0, "tid": 55 }, { "bill": true, "cmpl": true, "tm": 0, "calc": 2, "cat": "REGULATORY CHARGES", "cid": 6, "name": "FCC Regulatory Fee (Wireless)", "exm": 100, "lns": 0, "min": 0, "pcd": 0, "rate": 0.0175, "sur": false, "tax": 0, "lvl": 0, "tid": 170 }, { "bill": false, "cmpl": true, "tm": 37.1, "calc": 1, "cat": "CONNECTIVITY CHARGES", "cid": 5, "name": "Telecommunications Relay Surcharge (Cellular)", "exm": 62.9, "lns": 0, "min": 0, "pcd": 0, "rate": 0.02289, "sur": false, "tax": 0.8492190000000001, "lvl": 0, "tid": 232 } ]} ] } ] } ``` ## Example 2: Wildcard tax type with exclude nonbillable **View request**: This example sets the wildcard tax type (`tpe` and `dom` both 0) to exempt all tax types at all levels (`scp` is 1920), with the additional Exclude Non-Billable flag (`exnb`) set to `true`. Update the scope (`scp`) to limit where the wildcard tax type is applied. ``` { "cmpn": { "bscl": 1, "svcl": 0, "fclt": true, "frch": true, "reg": false }, "inv": [ { "bill": {"ctry": "USA","st": "PR","city": "Adjuntas","zip": "00601","int": true }, "cust": 1, "lfln": false, "date": "2018-02-01T12:00:00Z", "exms": [{ "loc": { "pcd": 5116000 }, "tpe": 0, "dom": 0, "scp": 1920, "exnb": true} ], "itms": [{ "ref": "1.05.wild.nba", "chg": 100, "line": 0, "sale": 1, "incl": false, "tran": 13, "serv": 6, "dbt": false, "adj": false} ], "invm": true, "dtl": true, "summ": false } ] } ``` **View response**: All taxes are exempt, including the nonbillable tax (`bill` is`true`). ``` { "inv": [ { "itms": [{ "ref": "1.05.wild.nba", "txs": [ { "bill": true, "cmpl": true, "tm": 0, "calc": 2, "cat": "E-911 CHARGES", "cid": 7, "name": "E911 (Business)", "exm": 0, "lns": 0, "min": 0, "pcd": 5115900, "rate": 1, "sur": false, "tax": 0, "lvl": 1, "tid": 35 }, { "bill": true, "cmpl": true, "tm": 0, "calc": 1, "cat": "CONNECTIVITY CHARGES", "cid": 5, "name": "State Universal Service Fund", "exm": 100, "lns": 0, "min": 0, "pcd": 5115900, "rate": 0.0139, "sur": false, "tax": 0, "lvl": 1, "tid": 13 }, { "bill": true, "cmpl": true, "tm": 0, "calc": 1, "cat": "SALES AND USE TAXES", "cid": 1, "name": "Sales Tax", "exm": 100, "lns": 0, "min": 0, "pcd": 5116000, "rate": 0.01, "sur": false, "tax": 0, "lvl": 3, "tid": 1 }, { "bill": true, "cmpl": true, "tm": 0, "calc": 1, "cat": "SALES AND USE TAXES", "cid": 1, "name": "Sales Tax", "exm": 100, "lns": 0, "min": 0, "pcd": 5116000, "rate": 0.105, "sur": false, "tax": 0, "lvl": 1, "tid": 1 }, { "bill": true, "cmpl": true, "tm": 0, "calc": 1, "cat": "CONNECTIVITY CHARGES", "cid": 5, "name": "Fed USF Cellular", "exm": 100, "lns": 0, "min": 0, "pcd": 0, "rate": 0.195, "sur": false, "tax": 0, "lvl": 0, "tid": 55 }, { "bill": true, "cmpl": true, "tm": 0, "calc": 2, "cat": "REGULATORY CHARGES", "cid": 6, "name": "FCC Regulatory Fee (Wireless)", "exm": 100, "lns": 0, "min": 0, "pcd": 0, "rate": 0.0175, "sur": false, "tax": 0, "lvl": 0, "tid": 170 }, { "bill": false, "cmpl": true, "tm": 0, "calc": 1, "cat": "CONNECTIVITY CHARGES", "cid": 5, "name": "Telecommunications Relay Surcharge (Cellular)", "exm": 100, "lns": 0, "min": 0, "pcd": 0, "rate": 0.02289, "sur": false, "tax": 0, "lvl": 0, "tid": 232 } ]} ] } ] } ``` ## Example 3: Wildcard tax type with exclude nonbillable and no force level exemptible **View request**: This example sets the wildcard tax type (`tpe` and `dom` both 0) to exempt all tax types at all levels (`scp` is 1920), with the additional Exclude Non-Billable flag (`exnb`) set to `true`. In addition, the Force Level Exemptible flag (`frc`) is set to `false`. Update the scope (`scp`) to limit where the wildcard tax type is applied. ``` { "cmpn": { "bscl": 1, "svcl": 0, "fclt": true, "frch": true, "reg": false }, "inv": [ { "bill": {"ctry": "USA","st": "PR","city": "Adjuntas","zip": "00601","int": true }, "cust": 1, "lfln": false, "date": "2018-02-01T12:00:00Z", "exms": [{ "frc": false, "loc": { "pcd": 5116000 }, "tpe": 0, "dom": 0, "scp": 1920, "exnb": true} ], "itms": [{ "ref": "1.06.wild.nba.nofrc", "chg": 100, "line": 0, "sale": 1, "incl": false, "tran": 13, "serv": 6, "dbt": false, "adj": false} ], "invm": true, "dtl": true, "summ": false } ] } ``` **View response**: All taxes are exempt except for the taxes that aren’t level exemptible (in this example, all of the Federal level taxes (`lvl` is 0). ``` { "inv": [ { "itms": [{ "ref": "1.06.wild.nba.nofrc", "txs": [ { "bill": true, "cmpl": true, "tm": 0, "calc": 2, "cat": "E-911 CHARGES", "cid": 7, "name": "E911 (Business)", "exm": 0, "lns": 0, "min": 0, "pcd": 5115900, "rate": 1, "sur": false, "tax": 0, "lvl": 1, "tid": 35 }, { "bill": true, "cmpl": true, "tm": 0, "calc": 1, "cat": "CONNECTIVITY CHARGES", "cid": 5, "name": "State Universal Service Fund", "exm": 100, "lns": 0, "min": 0, "pcd": 5115900, "rate": 0.0139, "sur": false, "tax": 0, "lvl": 1, "tid": 13 }, { "bill": true, "cmpl": true, "tm": 0, "calc": 1, "cat": "SALES AND USE TAXES", "cid": 1, "name": "Sales Tax", "exm": 100, "lns": 0, "min": 0, "pcd": 5116000, "rate": 0.01, "sur": false, "tax": 0, "lvl": 3, "tid": 1 }, { "bill": true, "cmpl": true, "tm": 0, "calc": 1, "cat": "SALES AND USE TAXES", "cid": 1, "name": "Sales Tax", "exm": 100, "lns": 0, "min": 0, "pcd": 5116000, "rate": 0.105, "sur": false, "tax": 0, "lvl": 1, "tid": 1 }, { "bill": true, "cmpl": true, "tm": 37.1, "calc": 1, "cat": "CONNECTIVITY CHARGES", "cid": 5, "name": "Fed USF Cellular", "exm": 62.9, "lns": 0, "min": 0, "pcd": 0, "rate": 0.195, "sur": false, "tax": 7.234500000000001, "lvl": 0, "tid": 55 }, { "bill": true, "cmpl": true, "tm": 100, "calc": 2, "cat": "REGULATORY CHARGES", "cid": 6, "name": "FCC Regulatory Fee (Wireless)", "exm": 0, "lns": 0, "min": 0, "pcd": 0, "rate": 0.0175, "sur": false, "tax": 0.0175, "lvl": 0, "tid": 170 }, { "bill": false, "cmpl": true, "tm": 37.1, "calc": 1, "cat": "CONNECTIVITY CHARGES", "cid": 5, "name": "Telecommunications Relay Surcharge (Cellular)", "exm": 62.9, "lns": 0, "min": 0, "pcd": 0, "rate": 0.02289, "sur": false, "tax": 0.8492190000000001, "lvl": 0, "tid": 232 } ]} ] } ] } ```