---
title: "Create taxation items for an invoice"
method: POST
path: "/v1/invoices/{invoiceKey}/taxation-items"
tags: ["Invoices"]
---

# Create taxation items for an invoice

`POST /v1/invoices/{invoiceKey}/taxation-items`

Creates taxation items for an invoice.

## Path parameters

- `invoiceKey` string, required

## Headers

- `Idempotency-Key` string
- `Accept-Encoding` string
- `Content-Encoding` string
- `Zuora-Track-Id` string
- `Zuora-Entity-Ids` string
- `Zuora-Org-Ids` string
- `Zuora-Version` string

## Request body

- POSTTaxationItemList
  - `taxationItems` POSTTaxationItemTypeForInvoice[] — Container for taxation items.
    - `exemptAmount` string, number — The calculated tax amount excluded due to the exemption.
    - `financeInformation` object — Container for the finance information related to the taxation item.
      - `accountsReceivableAccountingCode` string — The accounting code for accounts receivable.
      - `salesTaxPayableAccountingCode` string — The accounting code for the sales taxes payable.
    - `invoiceItemId` string, required — The ID of the invoice associated with the taxation item.
    - `jurisdiction` string, required — The jurisdiction that applies the tax or VAT. This value is typically a state, province, county, or city.
    - `locationCode` string — The identifier for the location based on the value of the `taxCode` field.
    - `name` string, required — The name of taxation.
    - `taxAmount` string, number, required — The amount of the taxation item in the invoice item.
    - `taxCode` string — The tax code identifies which tax rules and tax rates to apply to a specific invoice item.
    - `taxCodeDescription` string — The description of the tax code.
    - `taxDate` string, date, required — The date that the tax is applied to the invoice item, in `yyyy-mm-dd` format.
    - `taxMode` 'TaxInclusive' | 'TaxExclusive' — The tax mode of the invoice item, indicating whether the amount of the invoice item includes tax.
    - `taxRate` string, number, required — The tax rate applied to the invoice item.
    - `taxRateDescription` string — The description of the tax rate.
    - `taxRateType` 'Percentage' | 'FlatFee', required — The type of the tax rate applied to the invoice item.

## Response `200`

OK

- GETTaxationItemListType
  - `success` boolean — Returns `true` if the request was processed successfully.
  - `taxationItems` GETTaxationItemTypewithSuccess[] — Container for taxation items.
    - `createdById` string — The ID of the Zuora user who created the taxation item.
    - `createdDate` string — The date and time when the taxation item was created in the Zuora system, in `yyyy-mm-dd hh:mm:ss` format.
    - `exemptAmount` number, double — The calculated tax amount excluded due to the exemption.
    - `financeInformation` object — Container for the finance information related to the taxation item.
      - `accountsReceivableAccountingCode` string — The accounting code for accounts receivable.
      - `accountsReceivableAccountingCodeType` string — The type of the accounting code for accounts receivable.
      - `salesTaxPayableAccountingCode` string — The accounting code for the sales taxes payable.
      - `salesTaxPayableAccountingCodeType` string — The type of the accounting code for the sales taxes payable.
    - `id` string — The ID of the taxation item.
    - `invoiceItemId` string, nullable — The ID of the invoice associated with the taxation item.
    - `jurisdiction` string — The jurisdiction that applies the tax or VAT. This value is typically a state, province, county, or city.
    - `locationCode` string, nullable — The identifier for the location based on the value of the `taxCode` field.
    - `name` string — The name of the taxation item.
    - `taxAmount` number, double — The amount of the tax applied to the invoice.
    - `taxCode` string — The tax code identifies which tax rules and tax rates to apply to a specific invoice.
    - `taxCodeDescription` string, nullable — The description of the tax code.
    - `taxDate` string, date — The date when the tax is applied to the invoice.
    - `taxMode` 'TaxInclusive' | 'TaxExclusive' — The tax mode of the invoice item, indicating whether the amount of the invoice item includes tax.
    - `taxRate` number, double — The tax rate applied to the invoice.
    - `taxRateDescription` string, nullable — The description of the tax rate.
    - `taxRateType` 'Percentage' | 'FlatFee' — The type of the tax rate applied to the invoice.
    - `updatedById` string — The ID of the Zuora user who last updated the taxation item.
    - `updatedDate` string — The date and time when the taxation item was last updated, in `yyyy-mm-dd hh:mm:ss` format.

## Other responses

- `500` — Internal Server Error
- `4XX` — Request Errors

---

[API](https://skmtc.dev/zuora/apis/api-reference.md) · [All operations](https://skmtc.dev/zuora/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zuora/api-reference/revisions/d11e237f3e54/schema)