Line item elements

The LineItem object contains detailed information about a single transaction. Each transaction request can include up to 10,000 line items.

The table below describes the fields available on a line item.


Object/field	Description
`ref`	`[string]` Reference codeReference ID for line item Max length: 150 bytes
`from`	`[Location]`The point of origin for the line item. There are several ways to input location information. For more information, see Location.
`to`	`[location]`The destination of the line itemThere are several ways to input location information. For more information, see Location.
`chg`	`[double]` Charge Amount
`line`	`[int]` Number of lines
`loc`	`[int]` Number of locations
`min`	`[double]` Number of minutes
`sale`	`[int]` required Sale TypeIndicates the type transaction, such as retail or wholesale `0` Wholesale `1` Retail `2` Consumed (Sales and Use Only) `3` Vendor Use (Sales and Use Only)
`plsp`	`[double]` Private Line SplitA percentage used to split a transaction charge between 2 points. For example: A transaction has 2 points: Point 'A' and Point 'Z' A `plsp` of`0.25` means 25% of the taxes are attributed to Point 'A', the remaining 75% to Point 'Z' Remove the key from the line item if you don't want to use the Private Line functionality. Setting `plsp` to 0 means 0% for Point 'A' and 100% for Point 'Z'
`incl`	`[bool]` Tax InclusiveIndicates if the charge for this line item is tax inclusive `true` Tax is included in the charge `false` Tax is exclusive to the charge
`pror`	`[double]` Pro-rated PercentageA percentage used for the pro-rated calculation of fixed taxesRemove the key from the line item if you don't want to use Proration functionality. Setting `prop` to 0 means 0% proration for pro-rateable fixed taxes.
`proadj`	`[int]` Pro-Rated Adjustment TypeDefines the adjustment type for pro-rated credit or adjustment calculations. `0` Default `1` Don't return non-proratable fixed taxes in the response `2` Return non-proratable fixed taxes in the response
`tran`	`[int]` required Transaction Type ID. The first part of the T/S Pair that defines the product to be taxed. For a list of transaction/service types, check out the GetTsPairs endpoint.
`serv`	`[int]` required Service Type ID. The second part of the T/S Pair that defines the product to be taxed. For a list of transaction/service types, check out the GetTsPairs endpoint.
`dbt`	`[bool]` DebitIndicates if the Line Item is prepaid `true` The Line Item is prepaid `false` The Line Item isn’t prepaid
`adj`	`[bool]` IsAdjustmentIndicates if this line item is an adjustment `true` The transaction represents a credit or adjustment `false` The transaction doesn’t represent a credit or adjustment
`disc`	`[int]` Discount Type for adjustments Note: Using a Discount Type other than`0 None` results in a $0.00 tax calculation, because some jurisdictions don't allow tax refunds for other discount types. `0` None `1` Retail Product: An amount subtracted from the original price to arrive at a lower price `2` Manufacturer Product: A discount of the total amount reimbursed to either the retailer or the customer by the manufacturer `3` Account Level: A stand-alone discount that isn’t applied against any service but instead as a stand-alone product `4` Subsidized: A discount is caused exclusively in telephone service where the telephone provider provides a service to a lifeline eligible customer. The discount will be on the local exchange service `5` Goodwill: The total discount of a service that is recorded for accounting purposes but never billed to a customer
`opt`	`[KeyValuePair]` Optional Fields. A list of Optional Fields to apply to the line item
`prop`	`[int]` Attribute Property. The attribute and property used for supported Sales and Use Transaction/Service pairs
`bill`	`[location]`Bill To Location. There are several ways to input location information. For more information, see Location.
`cust`	`[int]` Customer Type `0`: Residential `1`: Business `2`: Senior Citizen `3`: Industrial
`lfln`	`[bool]` Lifeline `true`: The customer is a Lifeline participant `false`: The customer isn’t a Lifeline participant Lifeline is a federal program that subsidizes the cost of phone and internet for eligible customers.
`date`	`[timestamp]` Invoice Date ex. `2009-12-01T03:00:00`The date when the transaction took place. An accurate timestamp in this field is important! This affects the rules that our tax engine applies when calculating taxes. For example, if you submit a CalcTaxes request with a `date` of`7/1/2018`, the tax engine uses the rules that apply for your jurisdiction on`7/1/2018`. If the transaction actually occurred on`7/25/2018`, and the tax rate for this transaction changed after`7/1/2018`, you may receive incorrect tax information.
`qty`	`[int]` Quantity. The quantity to be applied to the line item - taxation is equivalent to repeating the item the number of times of the quantity. The field must be a positive integer greater than or equal to 1. Quantity isn’t supported on Tax Inclusive or Prorated transactions.
`glref`	`[string]` General Ledger Reference. General Ledger Reference field for use in reporting Max length: 150 bytes

View example:

 "itms": [
  {
    "ref": "Reference Code for Line Item",
    "from": {
      // Location
    },
    "to": {
      // Location
    },
    "chg": 100,
    "line": 0,
    "loc": 0,
    "min": 0,
    "sale": 1,
    "plsp": 0,
    "incl": false,
    "pror": 0,
    "proadj": 0,
    "tran": 19,
    "serv": 6,
    "dbt": false,
    "adj": false,
    "adjm": 0,
    "disc": 0,
    "opt": [
      {
        // Key Value Pair
      }
    ],
    "prop": 0,
    "bill": {
      // Location
    },
    "cust": 0,
    "lfln": false,
    "date": "2018-09-23T20:31:53.452Z",
    "qty": 1,
    "glref": "General Ledger Reference"
  }
]