Address types

Address types help determine tax for a transaction in a specific situation. A retail transaction and an ecommerce transaction both use addresses. Retail locations generally use the SingleLocation address type. Most ecommerce transactions use the ShipFrom and ShipTo address types.

You can specify addresses at the document level or the line level.

Document level: A transaction uses document-level addresses as the default. If a transaction doesn’t have any addresses at the line level, each line uses the document-level addresses. When all invoice lines on a transaction use the same addresses, set the address values once at the root level of the transaction, no matter how many invoice lines you calculate.
Line level: Line-level addresses represent individual, separate shipments. For example, an end customer might check out with products or services from different merchants. In this case, the shipFrom address can be different for some or all lines. The shipTo address is likely to be the same for a given checkout process, but you should pass both addresses together at the line level. Any time you set a value in the addresses field on an invoice line, that line ignores all document-level addresses.

The following table describes the address types available in AvaTax, including those used for VAT calculation. Whenever possible, pass all known addresses in a transaction.


Field name	Attributes	Summary	Document types	Supported product types
`shipFrom`	AddressLocationInfo Conditional	The location where the item is shipped from. Submit this address in every transaction. If other addresses or data are missing from the transaction, AvaTax uses this address to assume establishment and calculate VAT.	All	Physical goods Digital goods General services
`shipTo`	AddressLocationInfo Conditional	The location where the items are shipped to. Submit this address in every transaction. If other addresses or data are missing from the transaction, AvaTax uses this address to assume establishment and calculate VAT.	All	Physical goods Digital goods General services
`pointOfOrderOrigin`	AddressLocationInfo Conditional	The location where your customer, home, or business, placed the order with you. AvaTax uses this address to determine the establishment country of your customer. For B2B transactions, AvaTax assumes that your customer is established in this country.	Sales	Physical goods
`pointOfOrderAcceptance`	AddressLocationInfo Conditional	The location where the order was accepted by your supplier, such as a call center, a business office where purchase orders are accepted, or a server location where orders are processed and accepted. AvaTax uses this address to determine the establishment country of your supplier in the transaction. For B2B transactions, AvaTax assumes that the supplier is established in this country.	Purchase	Physical goods
`goodsPlaceOrServiceRendered`	AddressLocationInfo Conditional	The full address where the goods are located when there is no transportation. This address is required when goods are already at their destination and no transport is involved. Don’t include this address if both the `ShipFrom` and `ShipTo` addresses are in the U.S..	Any document type that includes cases where `"transport"="none"` and goods are at their final destination.	Physical goods
`import`	AddressLocationInfo Conditional	The full address where goods are imported. This address is required when goods are imported into a country that’s different from the `ShipTo` address. Don’t include this address if both the `ShipFrom` and `ShipTo` addresses are in the U.S..	Any document type with cases that involve cross-border transactions	Physical goods

Note

The goodsPlaceOrServiceRendered and/or an import address types are not used for U.S. indirect tax calculations.