Transaction date

Element type: Required

Enpoints/models used: Invoice

Your integration must provide a method for specifying a date on the invoice for when the transaction took place. Specifying an invoice date is done using the date field in the Invoice model.

Note

An accurate timestamp in this field is important. This date affects the rules that the AFC tax engine applies when calculating taxes. For example, if you submit a CalcTaxes request with a date of 2/1/2022, the tax engine uses the rules that apply for your jurisdiction on 2/1/2022. If the transaction actually occurred on 2/25/2022, and the tax rate for this transaction changed after 2/1/2022, you may receive incorrect tax information.

View example:

"inv": [
  {
    "doc": "StreamingContent1",
    "cmmt": false,
    "cust": 0,
    "date": "2021-01-01T12:00:00Z",
    "invm": true,
    "dtl": true,
    "summ": true,
    "acct": "Broadcaster",
    "custref": "Customer1234",
    "invn": "Invoice1234",
    "bcyc": "202010",
    "bpd": {
        "month": "10",
        "year": "2020"
    },
    "opt": [
        {
            "key": "1",
            "val": "StreamingSamples"
        }
    ],
    "bill": {
      "ctry": "USA",
      "addr": "11 West 53 Street",
      "city": "Manhattan",
      "st": "NY",
      "zip": "10019"
    },
    "itms": [
      {
        ...
      }
    ]
  }
]