--- title: "Create or delete association between items and tax rates" method: POST path: "/v3/merchants/{mId}/tax_rate_items" tags: ["INVENTORY"] --- # Create or delete association between items and tax rates `POST /v3/merchants/{mId}/tax_rate_items` Creates or deletes association between line items and tax rates. For more information, see [Use object associations](https://docs.clover.com/docs/using-object-associations). ## Path parameters - `mId` string, required ## Query parameters - `delete` boolean ## Headers - `User-Agent` string, required ## Request body - object - `elements` object[], required — An array of item and tax rate associations. - `item` object - `id` string — Item's unique identifier. - `taxRate` object - `id` string — Tax rate's unique identifier. ## Response `200` - object - `taxRate` object, required — Name of line items. - `id` string — Tax rates identifier. - `name` string, required — Tax rates name. - `taxType` 'VAT_TAXABLE' | 'VAT_NON_TAXABLE' | 'VAT_EXEMPT' | 'INTERNAL_TAX' | 'PARTNER_TAX' — Tax type used in Argentina. - `rate` integer — For percentage based discounts like sales tax - `isDefault` boolean - `items` object[] — Items associated with this tax rate - `id` string — Unique identifier. - `taxAmount` integer — For a flat tax like recycling redemption fee, expressed as number of cents - `deletedTime` integer — Timestamp when tax rate was last deleted - `modifiedTime` integer — Timestamp when tax rate was last modified - `item` object, required - `id` string — Unique identifier - `hidden` boolean — True if this item is hidden from Clover Register App - `available` boolean — True if this item is available for sale across all channels - `autoManage` boolean — False manually manage item availability, True item availability depends on stock count - `itemGroup` object — Reference to an item group - `id` string — Unique identifier. - `options` object[] — List of options pertaining to this item's attribute variation - `id` string — Unique identifier - `name` string, required — Name of the option - `attribute` object - `id` string — Unique identifier. - `items` object[] — Items associated with this option - `id` string — Unique identifier. - `name` string, required — Name of the item - `alternateName` string — Alternate name of the item - `code` string — Product code, e.g. UPC or EAN - `sku` string — SKU of the item - `price` integer, required — Price of the item, typically in cents; use priceType and merchant currency to determine actual item price. For non-VAT merchants, this field is exclusive of tax. For VAT merchants, this field is inclusive of tax. - `priceType` 'FIXED' | 'VARIABLE' | 'PER_UNIT' - `defaultTaxRates` boolean — Flag to indicate whether or not to use default tax rates - `unitName` string — Unit name, e.g. oz, lb - `cost` integer — Cost of the item to merchant, as opposed to customer price - `isRevenue` boolean — True if this item should be counted as revenue. For example, gift cards and donations would not be counted as revenue. - `stockCount` integer — Deprecated, use itemStock instead. - `taxRates` object[] - `id` string - `name` string, required - `taxType` 'VAT_TAXABLE' | 'VAT_NON_TAXABLE' | 'VAT_EXEMPT' | 'INTERNAL_TAX' | 'PARTNER_TAX' — Tax type used in Argentina. - `rate` integer — For percentage based discounts like sales tax - `isDefault` boolean - `items` object[] — Items associated with this tax rate - `id` string — Unique identifier. - `taxAmount` integer — For a flat tax like recycling redemption fee, expressed as number of cents - `deletedTime` integer — Timestamp when tax rate was last deleted - `modifiedTime` integer — Timestamp when tax rate was last modified - `modifierGroups` object[] - `id` string — Unique identifier - `name` string — Name of the modifier group - `alternateName` string - `minRequired` integer — The minimum amount of modifiers from this group that must be applied to associated lineItems when using Register - `maxAllowed` integer — The maximum amount of modifiers from this group that can be applied to associated lineItems when using Register - `showByDefault` boolean — Whether employees will be automatically prompted to add modifiers from this category when using Register - `modifiers` object[] - `id` string — Unique identifier - `name` string — Name of the modifier - `alternateName` string — Alternate name of the modifier - `available` boolean — True if this modifier is available across all channels - `price` integer — Additional cost when used - `modifierGroup` object - `id` string — Unique identifier. - `modifierIds` string — An ordered, comma-separated list of modifier ids in this group. (READ ONLY) - `items` object[] - `id` string — Unique identifier. - `sortOrder` integer — The ordinal value used to determine where in an ordered list this modifier group should appear relative to others. - `categories` object[] — Categories associated with this item - `id` string — Unique identifier - `name` string, required — The name of the category which will appear in Clover Register App. - `sortOrder` integer — Integer used to determine how this category is sorted against other categories. - `items` object[] — Ordered list of items associated with this category. - `id` string — Unique identifier. - `colorCode` string — Hex code representation of the color assigned to this category and its items, in the form of #fff, #ffffff, or #ffffffff - `deleted` boolean — Whether the category has been deleted. - `modifiedTime` integer — The time this category was last modified - `canonical` object — Reference to canonical category - `id` string — Unique identifier. - `tags` object[] — Tags associated with this item - `id` string — Unique identifier - `name` string, required — Tag name - `showInReporting` boolean — True if tag is a summary label in the reporting app - `items` object[] — Items associated with this tag - `id` string — Unique identifier. - `printers` object[] — Printers associated with this tag - `id` string — Unique identifier. - `canonical` object — Reference to canonical items - `id` string — Unique identifier. - `itemStock` object — Item stock attribute that can be expanded to show stock quantity - `item` object — Reference to an item - `id` string — Unique identifier. - `stockCount` integer — Deprecated, use quantity instead. - `quantity` number — Current count of this item in stock. - `modifiedTime` integer - `modifiedTime` integer - `deletedTime` integer — Timestamp when item was last deleted - `priceWithoutVat` integer — The price without value-added tax (VAT). For non-VAT merchants, this field is ignored. For VAT merchants, this field is the base price of an item. - `colorCode` string — Hex code representation of the color assigned to item in the form of #fff, #ffffff, or #ffffffff --- [API](https://skmtc.net/clover/apis/platform-api.md) · [All operations](https://skmtc.net/clover/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clover/platform-api/versions/08da265101a3/schema)