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):
tran
) to "-1" and a valid service type (serv
)tran
) to a valid 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.
For Transaction Type determination, you already know the service type, so the transaction type needs to be determined. Provide a service type (serv
) found in this table and set the transaction type (tran
) to “-1”.
Service Type | Service Type Description |
---|---|
1 | TOLL |
2 | TOLL FREE |
3 | WATS |
4 | PRIVATE LINE |
14 | LATE CHARGE |
16 | 900 |
27 | DATA |
54 | DIRECTORY ASSISTANCE |
635 | TOLL FREE NUMBER |
serv
):1
: INTERSTATE2
: INTRASTATEFor Service Type Determination, you already know the transaction type, so the service type needs to be determined. Provide a transaction type (tran
) from in these tables and set the service type (serv
) is to set to “-1”.
Transaction Type | Transaction Type Description |
---|---|
61 | VPN |
The service types is set to one of these based on the jurisdiction information and transaction type (tran
) from above:
585
: INTERSTATE MPLS586
INTRASTATE MPLSOr
Transaction Type | Transaction Type Description |
---|---|
19 | VoIP |
20 | VoIPA |
21 | PAYPHONE |
59 | VoIP NOMADIC |
The service types is set to one of these based on the jurisdiction information and transaction type (tran
) from above:
49
: INTERSTATE USAGE50
: INTRASTATE USAGEThe Transaction Type (tran
) is set to -1
and is automatically determined based on the jurisdiction and Service Type (serv
) 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 001: -1/4 Intra/Inter for Transaction (Intrastate Test)", "chg": 100, "line": 0, "sale": 1, "incl": false, "tran": -1, "serv": 4, "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 transaction type since San Francisco is the only jurisdiction set in the CalcTaxes
request.
{ "inv": [ { "doc": "TEST-VOIP INVOICE", "itms": [ { "ref": "Line Item 001: -1/4 Intra/Inter for Transaction (Intrastate Test)", "txs": [ { "bill": true, "cmpl": true, "tm": 100, "calc": 1, "cat": "REGULATORY CHARGES", "cid": 6, "name": "CA PUC Fee", "exm": 0, "lns": 0, "min": 0, "pcd": 253500, "rate": 0.003, "sur": true, "tax": 0.3, "lvl": 1, "tid": 468 }, { "bill": true, "cmpl": true, "tm": 100, "calc": 1, "cat": "CONNECTIVITY CHARGES", "cid": 5, "name": "CA TRS", "exm": 0, "lns": 0, "min": 0, "pcd": 253500, "rate": 0.005, "sur": true, "tax": 0.5, "lvl": 1, "tid": 466 }, { "bill": true, "cmpl": true, "tm": 100, "calc": 1, "cat": "CONNECTIVITY CHARGES", "cid": 5, "name": "CA High Cost Fund A", "exm": 0, "lns": 0, "min": 0, "pcd": 253500, "rate": 0.0035, "sur": true, "tax": 0.35000000000000003, "lvl": 1, "tid": 60 }, { "bill": true, "cmpl": true, "tm": 100, "calc": 1, "cat": "CONNECTIVITY CHARGES", "cid": 5, "name": "Universal Lifeline Telephone Service Charge", "exm": 0, "lns": 0, "min": 0, "pcd": 253500, "rate": 0.0475, "sur": true, "tax": 4.75, "lvl": 1, "tid": 22 }, { "bill": true, "cmpl": true, "tm": 100, "calc": 1, "cat": "CONNECTIVITY CHARGES", "cid": 5, "name": "CA Teleconnect Fund", "exm": 0, "lns": 0, "min": 0, "pcd": 253500, "rate": 0.0108, "sur": true, "tax": 1.08, "lvl": 1, "tid": 21 }, { "bill": true, "cmpl": true, "tm": 106.98, "calc": 1, "cat": "UTILITY USER TAXES", "cid": 8, "name": "Utility Users Tax", "exm": 0, "lns": 0, "min": 0, "pcd": 377300, "rate": 0.075, "sur": false, "tax": 8.0235, "lvl": 3, "tid": 16 } ] } ], "summ": [ { "max": 2147483647, "min": 0, "tchg": 100, "calc": 1, "cat": "REGULATORY CHARGES", "cid": 6, "name": "CA PUC Fee", "exm": 0, "lns": 0, "pcd": 253500, "rate": 0.003, "sur": true, "tax": 0.3, "lvl": 1, "tid": 468 }, { "max": 2147483647, "min": 0, "tchg": 100, "calc": 1, "cat": "CONNECTIVITY CHARGES", "cid": 5, "name": "CA TRS", "exm": 0, "lns": 0, "pcd": 253500, "rate": 0.005, "sur": true, "tax": 0.5, "lvl": 1, "tid": 466 }, { "max": 2147483647, "min": 0, "tchg": 100, "calc": 1, "cat": "CONNECTIVITY CHARGES", "cid": 5, "name": "CA High Cost Fund A", "exm": 0, "lns": 0, "pcd": 253500, "rate": 0.0035, "sur": true, "tax": 0.35000000000000003, "lvl": 1, "tid": 60 }, { "max": 2147483647, "min": 0, "tchg": 100, "calc": 1, "cat": "CONNECTIVITY CHARGES", "cid": 5, "name": "Universal Lifeline Telephone Service Charge", "exm": 0, "lns": 0, "pcd": 253500, "rate": 0.0475, "sur": true, "tax": 4.75, "lvl": 1, "tid": 22 }, { "max": 2147483647, "min": 0, "tchg": 100, "calc": 1, "cat": "CONNECTIVITY CHARGES", "cid": 5, "name": "CA Teleconnect Fund", "exm": 0, "lns": 0, "pcd": 253500, "rate": 0.0108, "sur": true, "tax": 1.08, "lvl": 1, "tid": 21 }, { "max": 2147483647, "min": 0, "tchg": 106.98, "calc": 1, "cat": "UTILITY USER TAXES", "cid": 8, "name": "Utility Users Tax", "exm": 0, "lns": 0, "pcd": 377300, "rate": 0.075, "sur": false, "tax": 8.0235, "lvl": 3, "tid": 16 } ] } ]}
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 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 } ] } ]}