# Chapter 4.3.5 - Interstate/Intrastate Determination Source: https://developer.avalara.com/products/communications/integration-guides/dev-guide_rest_v2/customizing-transactions/sample-transactions/inter-intrastate/ The Communications REST v2 Interstate/Intrastate Determination feature allows you to apply interstate or intrastate charges without specifying either the transaction type or the service type. To use the Interstate/Intrastate Determination feature, pick one of the following: - Transaction Type Determination: Set the transaction type (`tran`) to "-1" and the service type (`serv`) to a supported auto-fill service type. - Service Type Determination: Set the transaction type (`tran`) to a supported auto-fill transaction type and the service type (`serv`) to "-1". REST v2 determines the correct interstate or intrastate transaction or service type based on the jurisdiction and Transaction/Service Pair provided. ## How to use Interstate/Intrastate determination ### Interstate vs Intrastate determination The RESTv2 API will examine the relationship of the`from` and`to` jurisdictions when auto-fill (`-1`) for either the transaction type or service type has been set. - The jurisdictions must reside in the same country or an error will occur. - If the`from` and`to` state are the same, then auto-fill will use the INTRASTATE pairings. - If the`from` and`to` states are different, then auto-fill will use the INTERSTATE pairings. - By definition, if neither the`from` nor`to` is to the state level (both at country level), it will be handled as an INTRASTATE pairing. - By definition, if only one of either`from` or`to` is to the state level or below, and the other is to the country level, it will be handled as an INTERSTATE pairing. - The usage of PCodes, Addresses, NpaNxx, FIPS, or embedded Geocoding for jurisdiction selection is immaterial.  All valid jurisdiction specifications are supported. ## Transaction type auto selection For Transaction Type auto selection, use the applicable **service type** (`serv`) from the table below, and set the **transaction type** (`tran`) to `-1`. Service type Service type description Transaction type set for Interstate Transaction type set for Intrastate 1 TOLL 1: Interstate 2: Intrastate 2 TOLL FREE 1: Interstate 2: Intrastate 3 WATS 1: Interstate 2: Intrastate 4 PRIVATE LINE 1: Interstate 2: Intrastate 14 LATE CHARGE 1: Interstate 2: Intrastate 16 900 1: Interstate 2: Intrastate 27 DATA 1: Interstate 2: Intrastate 54 DIRECTORY ASSISTANCE 1: Interstate 2: Intrastate 635 TOLL FREE NUMBER 1: Interstate 2: Intrastate ## Service type auto selection For Service Type auto selection, use the applicable **transaction type** (`tran`) from the table below, and set the **service type** (`serv`) to`-1`. Transaction type Transaction type description Service type set for Interstate Service type set for Intrastate 13 CELLULAR 49: Interstate Usage 50: Intrastate Usage 64 CONFERENCING 684: Interstate dial in with enhanced features 685: Intrastate dial in with enhanced features 3 OTHER 608: Conference bridge-interstate with dial in 576: Conference bridge-intrastate with dial in 21 PAYPHONE 49: Interstate Usage 50: Intrastate Usage 19 VoIP 49: Interstate Usage 50: Intrastate Usage 20 VoIPA 49: Interstate Usage 50: Intrastate Usage 59 VoIP NOMADIC 49: Interstate Usage 50: Intrastate Usage 65 NON-INTERCONNECTED VoIP 49: Interstate Usage 50: Intrastate Usage 61 VPN 49: Interstate Usage 50: Intrastate Usage ## Error messages unique to auto selection The table below lists error messages associated with Auto Selection. Error code Error message Description \-28 `"A valid TransactionType and/or ServiceType are required."` Line-item error in response. This occurs when both the **transaction type** and the **service type** are set to`-1`. \-28 `"TransactionType does not support auto-determination of ServiceType."` Line-item error in response. This occurs when the **transaction type** is not a supported value. \-28 `"ServiceType does not support auto-determination of TransactionType."` Line-item error in response. This occurs when the **service type** is not a supported value. \-28 `"TransactionType is invalid."` Line-item error in response. This occurs when **transaction type** is not a valid transaction type and the **service type** is`-1`. \-28 `"ServiceType is invalid."` Line-item error in response. This occurs when **service type** is not a valid service type and **transaction type** is`-1`. \-48 "Transaction/service auto-determination not supported for cross-country transaction." Line-item error in response. This occurs when from/to locations are not in the same country. ## Example 1: Transaction type determination Request The Transaction Type (`tran`) is set to`-1` and is automatically determined based on the jurisdiction and Service Type (`serv`) provided. In this example the`from` and`to` addresses are in the same country but in different states. The auto-fill will set the transaction type to "1: Interstate and calculate taxes using 1/4 as the transaction/service pair." If instead the`from`/`to` were in the same state, then 2/4 (intrastate) would have been used. ``` { "cfg": { "retnb": true, "retext": true, "incrf": true }, "cmpn": { "idnt": "VoIP BSU", "bscl": 0, "svcl": 0, "fclt": false, "frch": false, "reg": false }, "inv": [ { "doc": "TEST AUTOFILL TRANSACTION TYPE INVOICE", "acct": "ABC Services", "custref": "Customer Z-00A1", "invn": "INV-BD0134627", "cmmt": false, "bill": { "ctry": "USA", "st": "CA", "cnty": "San Francisco", "city": "San Francisco", "zip": "94102", "int": true }, "cust": 0, "lfln": false, "date": "2024-01-01T12:00:00Z", "itms": [ { "ref": "Line Item 001: -1/4 Private Line Interstate Test", "glref": "GL-001-3561A", "from": { "ctry": "US", "st": "WA" }, "to": { "ctry": "US", "st": "CA" }, "chg": 100, "line": 0, "sale": 1, "incl": false, "tran": -1, "serv": 4, "dbt": false, "adj": false } ], "bpd": { "month": 1, "year": 2024 }, "ccycd": "USD", "invm": true, "dtl": true, "summ": false } ]} ``` Response ``` { "inv": [ { "doc": "TEST AUTOFILL TRANSACTION TYPE INVOICE", "itms": [ { "ref": "Line Item 001: -1/4 Private Line Interstate Test", "txs": [ { "bill": true, "cmpl": true, "tm": 100.0, "calc": 1, "cat": "CONNECTIVITY CHARGES", "cid": 5, "name": "Fed Universal Service Fund", "exm": 0.0, "lns": 0, "min": 0.0, "pcd": 0, "taxpcd": 377300, "rate": 0.346, "sur": false, "tax": 34.6, "lvl": 0, "tid": 18, "usexm": false, "notax": false, "trans": 1, "svc": 4, "chg": 100.0 }, { "bill": false, "cmpl": true, "tm": 100.0, "calc": 1, "cat": "CONNECTIVITY CHARGES", "cid": 5, "name": "Telecom Relay Surcharge", "exm": 0.0, "lns": 0, "min": 0.0, "pcd": 0, "taxpcd": 377300, "rate": 0.00025, "sur": false, "tax": 0.025, "lvl": 0, "tid": 23, "usexm": false, "notax": false, "trans": 1, "svc": 4, "chg": 100.0 }, { "bill": true, "cmpl": true, "tm": 100.0, "calc": 1, "cat": "REGULATORY CHARGES", "cid": 6, "name": "FCC Regulatory Fee (Wireline)", "exm": 0.0, "lns": 0, "min": 0.0, "pcd": 0, "taxpcd": 377300, "rate": 0.0054, "sur": false, "tax": 0.54, "lvl": 0, "tid": 169, "usexm": false, "notax": false, "trans": 1, "svc": 4, "chg": 100.0 }, { "bill": false, "cmpl": true, "tm": 100.0, "calc": 1, "cat": "CONNECTIVITY CHARGES", "cid": 5, "name": "Telecom Relay Surcharge IP CTS", "exm": 0.0, "lns": 0, "min": 0.0, "pcd": 0, "taxpcd": 377300, "rate": 0.01615, "sur": false, "tax": 1.615, "lvl": 0, "tid": 585, "usexm": false, "notax": false, "trans": 1, "svc": 4, "chg": 100.0 } ] } ], "incrf": { "acct": "ABC Services", "custref": "Customer Z-00A1", "invn": "INV-BD0134627", "ccycd": "USD", "ccydesc": "US Dollar" } } ]} ``` ## Example 2: Service type determination Request The Service Type (`serv`) is set to`-1` and is automatically determined based on the jurisdiction provided. ``` { "cmpn": { "bscl": 0, "svcl": 0, "fclt": false, "frch": false, "reg": false }, "inv": [ { "doc": "TEST-VOIP INVOICE", "cmmt": false, "bill": { "cnty": "San Francisco", "ctry": "USA", "int": true, "geo": false, "city": "San Francisco", "st": "CA", "zip": "94102" }, "cust": 0, "lfln": false, "date": "2017-05-01T12:00:00Z", "itms": [ { "ref": "Line Item 002: 19/-1 Intra/Inter for Service (Intrastate Test)", "chg": 100, "line": 10, "sale": 1, "incl": false, "tran": 19, "serv": -1, "dbt": false, "adj": false } ], "invm": true, "dtl": true, "summ": true, "opt": [ { "key": "1", "val": "VoIP Sample Line Items Invoice ABC-ZZZ" } ] } ]} ``` Response Taxes are returned based on the **Intrastate** service type since San Francisco is the only jurisdiction set in the`CalcTaxes` request. ``` { "inv": [ { "doc": "TEST-VOIP INVOICE", "itms": [ { "ref": "Line Item 002: 19/-1 Intra/Inter for Service (Intrastate Test)", "txs": [ { "bill": true, "cmpl": true, "tm": 35.099999999999994, "calc": 1, "cat": "CONNECTIVITY CHARGES", "cid": 5, "name": "Universal Lifeline Telephone Service Charge (VoIP)", "exm": 64.9, "lns": 0, "min": 0, "pcd": 253500, "rate": 0.0475, "sur": true, "tax": 1.6672499999999997, "lvl": 1, "tid": 454 }, { "bill": true, "cmpl": true, "tm": 35.099999999999994, "calc": 1, "cat": "CONNECTIVITY CHARGES", "cid": 5, "name": "CA Teleconnect Fund (VoIP)", "exm": 64.9, "lns": 0, "min": 0, "pcd": 253500, "rate": 0.0108, "sur": true, "tax": 0.37908, "lvl": 1, "tid": 452 }, { "bill": true, "cmpl": true, "tm": 35.099999999999994, "calc": 1, "cat": "CONNECTIVITY CHARGES", "cid": 5, "name": "CA High Cost Fund A (VoIP)", "exm": 64.9, "lns": 0, "min": 0, "pcd": 253500, "rate": 0.0035, "sur": true, "tax": 0.12284999999999999, "lvl": 1, "tid": 450 }, { "bill": true, "cmpl": true, "tm": 35.099999999999994, "calc": 1, "cat": "CONNECTIVITY CHARGES", "cid": 5, "name": "TRS (VoIP)", "exm": 64.9, "lns": 0, "min": 0, "pcd": 253500, "rate": 0.005, "sur": true, "tax": 0.17549999999999996, "lvl": 1, "tid": 217 }, { "bill": true, "cmpl": true, "tm": 35.099999999999994, "calc": 1, "cat": "E-911 CHARGES", "cid": 7, "name": "E911 (VoIP)", "exm": 64.9, "lns": 0, "min": 0, "pcd": 253500, "rate": 0.0075, "sur": false, "tax": 0.26324999999999993, "lvl": 1, "tid": 161 }, { "bill": true, "cmpl": true, "tm": 64.9, "calc": 1, "cat": "CONNECTIVITY CHARGES", "cid": 5, "name": "FUSF (VoIP)", "exm": 35.099999999999994, "lns": 10, "min": 0, "pcd": 0, "rate": 0.174, "sur": false, "tax": 11.2926, "lvl": 0, "tid": 162 }, { "bill": true, "cmpl": true, "tm": 64.9, "calc": 1, "cat": "REGULATORY CHARGES", "cid": 6, "name": "FCC Regulatory Fee (VoIP)", "exm": 35.099999999999994, "lns": 10, "min": 0, "pcd": 0, "rate": 0.00302, "sur": false, "tax": 0.19599800000000003, "lvl": 0, "tid": 226 } ] } ], "summ": [ { "max": 2147483647, "min": 0, "tchg": 35.099999999999994, "calc": 1, "cat": "CONNECTIVITY CHARGES", "cid": 5, "name": "Universal Lifeline Telephone Service Charge (VoIP)", "exm": 64.9, "lns": 0, "pcd": 253500, "rate": 0.0475, "sur": true, "tax": 1.6672499999999997, "lvl": 1, "tid": 454 }, { "max": 2147483647, "min": 0, "tchg": 35.099999999999994, "calc": 1, "cat": "CONNECTIVITY CHARGES", "cid": 5, "name": "CA Teleconnect Fund (VoIP)", "exm": 64.9, "lns": 0, "pcd": 253500, "rate": 0.0108, "sur": true, "tax": 0.37908, "lvl": 1, "tid": 452 }, { "max": 2147483647, "min": 0, "tchg": 35.099999999999994, "calc": 1, "cat": "CONNECTIVITY CHARGES", "cid": 5, "name": "CA High Cost Fund A (VoIP)", "exm": 64.9, "lns": 0, "pcd": 253500, "rate": 0.0035, "sur": true, "tax": 0.12284999999999999, "lvl": 1, "tid": 450 }, { "max": 2147483647, "min": 0, "tchg": 35.099999999999994, "calc": 1, "cat": "CONNECTIVITY CHARGES", "cid": 5, "name": "TRS (VoIP)", "exm": 64.9, "lns": 0, "pcd": 253500, "rate": 0.005, "sur": true, "tax": 0.17549999999999996, "lvl": 1, "tid": 217 }, { "max": 2147483647, "min": 0, "tchg": 35.099999999999994, "calc": 1, "cat": "E-911 CHARGES", "cid": 7, "name": "E911 (VoIP)", "exm": 64.9, "lns": 0, "pcd": 253500, "rate": 0.0075, "sur": false, "tax": 0.26324999999999993, "lvl": 1, "tid": 161 }, { "max": 2147483647, "min": 0, "tchg": 64.9, "calc": 1, "cat": "CONNECTIVITY CHARGES", "cid": 5, "name": "FUSF (VoIP)", "exm": 35.099999999999994, "lns": 10, "pcd": 0, "rate": 0.174, "sur": false, "tax": 11.2926, "lvl": 0, "tid": 162 }, { "max": 2147483647, "min": 0, "tchg": 64.9, "calc": 1, "cat": "REGULATORY CHARGES", "cid": 6, "name": "FCC Regulatory Fee (VoIP)", "exm": 35.099999999999994, "lns": 10, "pcd": 0, "rate": 0.00302, "sur": false, "tax": 0.19599800000000003, "lvl": 0, "tid": 226 } ] } ]} ```