> ## Documentation Index
> Fetch the complete documentation index at: https://integrations.docs.commenda.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> The Items Data Model is designed to simplify the management and retrieval of item-related information across various accounting platforms. 

* Unified item properties: The model unifies essential item details such as name, description, status, and type, making it easier to work with item data from different platforms.
* Item detail flexibility: The model supports separate details for items being purchased (`bill_item`) and items being sold (`invoice_item`), enabling accurate tracking of item-related transactions.
* Associated accounts and tax rates: Each item can be linked to specific purchase and sales accounts, as well as purchase and sales tax rates, for seamless integration with other accounting data models.

### Properties Supported

| Property           | Type                                                                   | Description                                                                      |
| ------------------ | ---------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
| platform\_id       | string                                                                 | The Platform's ID for this item                                                  |
| name               | string                                                                 | Name of the item                                                                 |
| description        | string                                                                 | Description of the item                                                          |
| status             | enum                                                                   | Status of the item. Values are: `ACTIVE`, `ARCHIVED`, `UNKNOWN`                  |
| type               | enum                                                                   | Type of the item. Values are: `INVENTORY`, `NON_INVENTORY`, `SERVICE`, `UNKNOWN` |
| code               | string                                                                 | Reference code of the item                                                       |
| quantity\_on\_hand | float                                                                  | Quantity on hand                                                                 |
| is\_bill\_item     | boolean                                                                | Check if there are details (bill\_item) of this item getting purchased           |
| bill\_item         | [Item Detail](/api-reference/v3/accounting/items/overview#item-detail) | Item details of this item getting purchased                                      |
| is\_invoice\_item  | boolean                                                                | Check if there are details (invoice\_item) of this item getting sold             |
| invoice\_item      | [Item Detail](/api-reference/v3/accounting/items/overview#item-detail) | Item details of this item getting sold                                           |
| updated\_at        | date                                                                   | The date on which the information was updated on the accounting platform         |

## Item Detail

**The Item Details Data Model** is a nested object providing additional information about individual items.

* Associated account and tax: The model links items to their respective accounts and tax rates using `account_id` and `tax_id`, enabling seamless integration with other accounting data models.
* Detailed item description: The `description` property allows for a more in-depth understanding of each item's nature and purpose.
* Unit price tracking: The `unit_price` property records the cost of a single unit of the item, making it easy to calculate the total cost of transactions involving the item.

### Properties Supported

| Property    | Type   | Description                                              |
| ----------- | ------ | -------------------------------------------------------- |
| account\_id | string | The platform ID of the account associated with this item |
| tax\_id     | string | The platform ID of the tax associated with this item     |
| description | string | A description of the item                                |
| unit\_price | float  | The unit price of the item                               |

<ResponseExample name="The Items Object">
  ```json The Items Response Object theme={null}
  {
    "platform_id": "3770712000001345066",
    "name": "Toy",
    "description": "Toy Story",
    "status": "ACTIVE",
    "type": "INVENTORY",
    "code": "T-40",
    "quantity_on_hand": 44,
    "is_bill_item": true,
    "bill_item": {
      "account_id": "3770712000001313073",
      "tax_id": "3770712000001313073",
      "description": "Bill Item Description",
      "unit_price": 1320
    },
    "is_invoice_item": true,
    "invoice_item": {
      "account_id": "3770712000000000394",
      "tax_id": "3770712000000000394",
      "description": "Invoice Item Description",
      "unit_price": 1500
    },
    "updated_at": "2023-09-22T00:00:00.000Z"
  }
  ```
</ResponseExample>