# Tax item data feed
<a name="data-feed-tax-item"></a>

This data feed provides information about tax calculations for a customer invoice.

There can be multiple line items (`line_item_id`) for a given product (`product_id`) of a given customer invoice (`invoice_id`), one or more for each tax jurisdiction. This happens, for example, with usage-based bills for customers who are using different AWS Region rules by different AWS entities (say, the US and Ireland). To learn more about where AWS collects sales tax, VAT, or GST on your sales and remits such taxes to the local tax authorities, in the name of AWS, Inc., see [Amazon Web Service Tax Help](https://aws.amazon.com/tax-help/).

The tax item data feed is refreshed every 24 hours, so new data is available daily.

Tax item data is immutable. 

The following table explains the names and descriptions of the data feed's columns. For information about data history columns, see [Historization of the data](data-feed-details.md#data-feed-historization). 


| Column name  | Description  | 
| --- | --- | 
| tax\$1item\$1id | A unique identifier for a tax item record. | 
| invoice\$1id | The AWS invoice ID. You can use this value with the value of product\$1id to find related tax billing events. | 
| line\$1item\$1id | A unique identifier for a customer bill line item. Refund transactions have the same line item ID as their forward tax transactions. | 
| customer\$1bill\$1id | The unique identifier of the customer bill. Buyers can share this identifier with the seller to help identify and resolve tax calculation questions.  | 
| tax\$1liable\$1party | Either `AWS` or `Seller`. If the seller is the tax liable party, taxes are collected. If AWS is the tax liable party, sales tax is collected and remitted by AWS. For more information, see [AWS Marketplace Sellers & Tax Collection](https://aws.amazon.com/tax-help/marketplace). If no taxes are collected, there is no value shown here. The seller needs to determine whether some taxes were collected for each invoice, as the seller is liable for tax collection.  | 
| transaction\$1type\$1code | The type of transaction. Possible values are as follows: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/marketplace/latest/userguide/data-feed-tax-item.html) Refund transactions share the line item ID with their original forward transactions. | 
| product\$1id | A foreign key to the product.Can be used to join to the `Product` data feed on the `product_id` field. | 
| product\$1tax\$1code | A standard code to identify the tax properties for a product. Sellers choose the properties when creating or modifying the product. | 
| invoice\$1date | The date the invoice was created.  | 
| taxed\$1customer\$1account\$1id | A foreign key to the account entity who is taxed.Can be used to join to the `Account` data feed on the `account_id` field. | 
| taxed\$1customer\$1country | The ISO 3166 alpha 2 country code of the address used for tax calculations.  | 
| taxed\$1customer\$1state\$1or\$1region | The state, region, or province used for tax calculations. | 
| taxed\$1customer\$1city | The city used for tax calculations. | 
| taxed\$1customer\$1postal\$1code | The postal code used for tax calculations. | 
| tax\$1location\$1code\$1taxed\$1jurisdiction | The vertex geocode that is associated with the taxed location.  | 
| tax\$1type\$1code | The type of tax that is applied to the transaction. The possible values are None, Sales, and SellerUse. | 
| jurisdiction\$1level | The jurisdiction level of the address that is used for tax location. The possible values are State, County, City, and District. | 
| taxed\$1jurisdiction | The name of the tax jurisdiction.  | 
| display\$1price\$1taxability\$1type | Whether the price that buyers see is inclusive or exclusive of taxes. All AWS Marketplace offerings are exclusive of taxes.  | 
| taxable\$1amount | The amount of the transaction that is taxable, at this jurisdiction level. | 
| nontaxable\$1amount | The amount of the transaction that is nontaxable, at this jurisdiction level. | 
| tax\$1jurisdiction\$1rate | The tax rate that is applied, at this jurisdiction level. | 
| tax\$1amount | The amount of tax that is charged, at this jurisdiction level. | 
| tax\$1currency | The ISO 4217 alpha 3 currency code for above amounts. | 
| tax\$1calculation\$1reason\$1code | Whether the transaction is taxable, not taxable, exempt, or zero-rated, organized by the jurisdiction level. | 
| date\$1used\$1for\$1tax\$1calculation | The date that is used for calculating tax on the transaction. | 
| customer\$1exemption\$1certificate\$1id | The certificate ID of the exemption certificate. | 
| customer\$1exemption\$1certificate\$1id\$1domain | The location where the certificate is stored on Amazon systems.  | 
| customer\$1exemption\$1certificate\$1level | The jurisdiction level that supplied the exemption. | 
| customer\$1exemption\$1code | The code that specifies the exemption; for example, RESALE. | 
| customer\$1exemption\$1domain | The Amazon system that is used to capture the customer exemption information, if available. | 
| transaction\$1reference\$1id | An identifier that allows you to cross-reference data from the following reports: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/marketplace/latest/userguide/data-feed-tax-item.html)  | 
| legal\$1amount | The tax amount in the legal currency for the tax to be paid. | 
| legal\$1currency | The legal currency for the tax to be paid. | 
| tax\$1invoice\$1id | The tax invoice identifier for the tax line in cases of dual invoicing. This field will be null for unified invoicing scenarios. | 
| tax\$1invoice\$1date | The date of the tax invoice. This field will be null for unified invoicing scenarios. | 

**Note**  
Beginning August 5, 2021, international Marketplace Facilitator taxes for AWS Marketplace sales will have entries in the tax item data feed. This means that, beginning August 5, 2021, every AWS\$1TAX\$1SHARE and SELLER\$1TAX\$1SHARE record in the billing event data feed is expected to have a corresponding record in the tax item data feed.

## Example of tax item data feed
<a name="data-feed-tax-item-sample-data"></a>

The following shows an example of the tax item data feed. In the data feed, this information is presented in a single table. For readability, the data is shown in multiple tables here, and all columns aren't shown. 


| tax\$1item\$1id | invoice\$1id | line\$1item\$1id | customer\$1bill\$1id | 
| --- | --- | --- | --- | 
| 6p2ni6tu041xagvhbyanbgxl3xameha16txjoav\$10001 | 781216640 | 71000000000000000000 | 2210000000000000000 | 
| 6p2ni6tu041xagvhbyanbgxl3xameha16txjoav\$10002 | 781216640 | 53000000000000000000 | 2210000000000000000 | 
| flr4jobxjzww8czdsrq4noue2uxd56j39wxw0k7\$10001 | 250816266 | 76400000000000000000 | 5720000000000000000 | 
| gfkjjobxjzw56jgkrsrqgjtk52uxd56j39wgj567d\$10002 | 280336288 | 76400000000000000000 | 5724390000000000000 | 
| wwk1qpvb8ran3geiw8e3mp6dgs2qj7wpkuwhgk1\$10001 | 451431024 | 99300000000000000000 | 1230000000000000000 | 
| wwk1qpvb8ran3geiw8e3mp6dgs2qj7wpkuwhgk1\$10002 | 451431024 | 99300000000000000000 | 3120000000000000000 | 
| fnohdid8kwgqq9lvii2k30spn3ftgwihbe8h75x\$10001 | 229987654 | 92100000000000000000 | 6390000000000000000 | 




| tax\$1liable\$1party | transaction\$1type\$1code | product\$1id | product\$1tax\$1code | invoice\$1date | 
| --- | --- | --- | --- | --- | 
| Seller | AWS | prod-o4grxfafcxxxx | AWSMP\$1SOFTWARE\$1RA | 2018-12-31T00:00:00Z | 
| Seller | AWS | prod-o4grxfafcxxxx | AWSMP\$1SOFTWARE\$1RA | 2018-12-31T00:00:00Z | 
| Seller | AWS | prod-t3grxfafcxxxy | AWS\$1REMOTE\$1ACCESS\$1SOFTWARE | 2018-08-31T00:00:00Z | 
| Seller | REFUND | prod-t3grxfafcxxxy | AWS\$1REMOTE\$1ACCESS\$1SOFTWARE | 2018-08-31T00:00:00Z | 
| Seller | AWS | prod-x8faxxfafcxxy | AWS\$1REMOTE\$1ACCESS\$1SOFTWARE | 2018-08-31T00:00:00Z | 
| Seller | TAXONLYREFUND | prod-x8faxxfafcxxy | AWS\$1REMOTE\$1ACCESS\$1SOFTWARE | 2018-05-31T00:00:00Z | 
| AWS | AWS | prod-wghj8xfafrhgj | AWS\$1REMOTE\$1ACCESS\$1SOFTWARE | 2019-07-31T00:00:00Z | 




| taxed\$1customer\$1account\$1id | taxed\$1customer\$1country | taxed\$1customer\$1state\$1or\$1region | taxed\$1customer\$1city | taxed\$1customer\$1postal\$1code | 
| --- | --- | --- | --- | --- | 
| VIeGa2t9j3MuxioH9wc8lsndXXCgGCGUreeXriocM5 | US | GA | MILTON | 48573-4839 | 
| VIeGa2t9j3MuxioH9wc8lsndXXCgGCGUreeXriocM5 | US | GA | MILTON | 48573-4839 | 
| 7nyo5jwTRoPlyX81vx9ji04eEwTurO1Ff8biQi88W8 | US | NC | DURHAM | 27517-4834 | 
| 7nyo5jwTRoPlyX81vx9ji04eEwTurO1Ff8biQi88W8 | US | NC | DURHAM | 27517-4834 | 
| 7nyo5jwTRoPlyX81vx9ji04eEwTurO1Ff8biQi88W8 | US | TX | NOT APPLICABLE | 75844-1235 | 
| 7nyo5jwTRoPlyX81vx9ji04eEwTurO1Ff8biQi88W8 | US | TX | HOUSTON | 75844-1235 | 
| 192a0421313e41f069b52962ed7babf716291b688 | US | CT | NEW HAVEN | 06002-2948 | 




| tax\$1location\$1code\$1taxed\$1jurisdiction | tax\$1type\$1code | jurisdiction\$1level | taxed\$1jurisdiction | display\$1price\$1taxability\$1type | taxable\$1amount | nontaxable\$1amount | 
| --- | --- | --- | --- | --- | --- | --- | 
| 460473664 | Sales | State | GA | Exclusive | 100 | 0 | 
| 66301164 | Sales | County | FULTON | Exclusive | 0 | 100 | 
| 692938178 | SellerUse | State | NC | Exclusive | 58.1 | 523.8 | 
| 692938178 | SellerUse | State | NC | Exclusive | -58.1 | 523.8 | 
| 356794387 | Sales | State | TX | Exclusive | 1105.14 | 0 | 
| 528887443 | Sales | City | HOUSTON | Exclusive | -36 | 0 | 
| 171248162 | Sales | State | CT | Exclusive | 0 | 114.55 | 




| tax\$1jurisdication\$1rate | tax\$1amount | tax\$1currency | tax\$1calculation\$1reason\$1code | date\$1used\$1for\$1tax\$1calculation | 
| --- | --- | --- | --- | --- | 
| 0.206 | 20.6 | USD | Taxable | 2018-10-31T00:00:00Z | 
| 0 | 0 | USD | NonTaxable | 2018-10-31T00:00:00Z | 
| 0.1 | 5.8 | USD | Taxable | 2018-07-31T00:00:00Z | 
| 0.1 | -5.8 | USD | Taxable | 2018-07-31T00:00:00Z | 
| 0.06 | 66.3 | USD | Taxable | 2018-07-31T00:00:00Z | 
| 0.01 | -0.36 | USD | NonTaxable | 2018-07-31T00:00:00Z | 
| 0 | 0 | USD | Exempt | 2019-06-30T00:00:00Z |