Avalara Developer Network Developer communications

Chapter 5.3 - Invoice

Invoice

The Invoice object contains information about one or more transactions:

Key Value
doc [string] Document Code
The Document Code is a unique string that is used to Commit or Uncommit transactions.
cmmt [bool] Commit
bill [Location] Bill To Location
There are several ways to input location information. See the Location section for more details.
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 is not a lifeline participant
Lifeline is a federal program that subsidizes the cost of phone and internet for eligible customers.
date [timestamp] Date
ex. 2009-12-01T03:00:00
The date when the transaction took place. An accurate timestamp in this field is important! This will affect the rules our tax engine applies when calculating taxes.

For example, if you submit a CalcTaxes request with a date of 7/1/2018, our tax engine will use 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.
exms [Exemption] optional Exemptions
A list of Exemptions to apply to this transaction.
itms [LineItems] Line Items
A list of Line Items to process for this transaction.


Example

"inv": [
    {
      "doc": "DocumentCode12345",
      "cmmt": true,
      "bill": {
        // Location
      },
      "cust": 0,
      "lfln": true,
      "date": "2018-09-23T20:31:53.452Z",
      "exms": [
        {
          // Exemptions
        }
      ],
      "itms": [
        {
          // Line Items
        }
      ],