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.
The RESTv2 API will examine the relationship of thefrom andto jurisdictions when auto-fill (-1) for either the transaction type or service type has been set.
from andto state are the same, then auto-fill will use the INTRASTATE pairings.from andto states are different, then auto-fill will use the INTERSTATE pairings.from norto is to the state level (both at country level), it will be handled as an INTRASTATE pairing.from orto is to the state level or below, and the other is to the country level, it will be handled as an INTERSTATE pairing.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 |
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 |
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 |
| -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 |
| -28 |
| Line-item error in response. This occurs when service type is not a valid service type and transaction type is |
| -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. |
The Transaction Type (tran) is set to-1 and is automatically determined based on the jurisdiction and Service Type (serv) provided. In this example thefrom andto 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 thefrom/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 } ]}{ "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" } } ]}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" } ] } ]}Taxes are returned based on the Intrastate service type since San Francisco is the only jurisdiction set in theCalcTaxes 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 } ] } ]}