Understanding T/S pairs and input types

AFC uses a a paired numbering system to represent the Transaction Types and Service Types (T/S) for the service you want to tax. You must pass a valid T/S pair in order for AFC to calculate the the appropriate tax for a specific jurisdiction. AFC will not return accurate tax if an improper T/S pair is specified.

AFC provides a GetTsPairs endpoint for retrieving valid T/S pairs. The response includes:

Transaction type value and description
Service type value and description
T/S pair description
Market type
Interface type
Input type
Whether the pair is part of a bundle

[
    {
        "TransactionType": 0,
        "ServiceType": 0,
        "MarketType": 6,
        "InterfaceType": 1,
        "InputType": 15,
        "IsBundle": false,
        "TransactionDescription": "No Tax",
        "ServiceDescription": "No Tax",
        "TSPairDescription": "No Tax/No Tax"
    },
    {
        "TransactionType": 1,
        "ServiceType": 1,
        "MarketType": 1,
        "InterfaceType": 1,
        "InputType": 9,
        "IsBundle": false,
        "TransactionDescription": "Interstate",
        "ServiceDescription": "Toll",
        "TSPairDescription": "Interstate/Toll"
    },
    ....
]

After retrieving the T/S pairs, review theInputType for a T/S pair that you want to include in a transaction. The input type shows the fields that might be used when calculating taxes. This calculation can be based on Charges, Lines, Minutes, Locations (deprecated), or a combination of these. Available input types include:

0: None. Tax is based per invoice per account per billing cycle. Taxable amount or numbers of lines are irrelevant for the T/S pair.
1: Charge (chg)
2: Lines (line)
4: Locations (loc) (deprecated)
8: Minutes (min)
9: Charge and Minutes (chg andmin)
11: Charge, Lines, and Minutes (chg,line, andmin)
15: Charge, Lines, Locations (deprecated), and Minutes (chg,line,loc, andmin)

For example, when calculating taxes for a T/S pair with anInputType of1, then you may also want to specify achg amount. You can populate additional fields, but only the fields that apply to the specific request (taxing jurisdiction rules for the T/S pair) will be used.

"itms": [
    {
        "ref": "test", 
        "chg": 15,  
        "sale": 1, 
        "tran": 1, 
        "serv": 14, 
        "adj": false 
    }
]

Note: When multiple fields are listed, then only charge (chg) is required unless the jurisdiction in question (the one the user is taxing in) requires additional input types for taxation.

For any given line item that is to be taxed, AFC collects two types of data for filing purposes:

Taxes generated
Revenue

A line-based T/S pair will have a corresponding charge-based T/S pair that is to be taxed in conjunction with the lines.