Bill-to location

Element type: Required

Enpoints/models used: Invoice

Your integration must provide a method for specifying the bill-to location for the transaction. This field will usually originate from a customer account profile within the SoldTo address. AFC will return the level of granularity in taxation based on the granularity of the address provided. This object can be a PCode value if you use the GEO or PCODE APIs for assigning a PCODE to a location. This location can be overridden on the line item.

Specifying a bill-to location is done using the bill field in the Invoice model.

Note

Bill-to-number is actually a legal term specific to the telephone business and represents an amalgamation of the billing address and phone number switch location, which are assumed to be the same, but there’s a legal framework for resolving situations where they isn’t.

None of this is relevant for non-wireline phone services. For non phone services, AFC will calculate based on the location include here. If you have better information for where the product is being used besides the billing location, then that is the location you would want to use here.

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": [
      {
        ...
      }
    ]
  }
]