> ## Documentation Index
> Fetch the complete documentation index at: https://gobl-cli-install-gobl-dev.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Item

Item is used to describe a single product or service.

## Schema ID

`https://gobl.org/draft-0/org/item`

## Properties

| Title | Property | Type | Description |
| - | - | - | - |
| UUID | `uuid` | string | Universally Unique Identifier. |
| Ref | `ref` | [cbc.Code](/draft-0/cbc/code) | Primary reference code that identifies this item. Additional codes can be provided in the 'identities' property. |
| Key | `key` | [cbc.Key](/draft-0/cbc/key) | Special key used to classify the item sometimes required by some regimes. |
| Name | `name` | string | Brief name of the item |
| Identities | `identities` | array of [org.Identity](/draft-0/org/identity) | List of additional codes, IDs, or SKUs which can be used to identify the item. They should be agreed upon between supplier and customer. |
| Attributes | `attributes` | array of [org.Attribute](/draft-0/org/attribute) | Attributes describe named features or properties of the item, such as color or size. |
| Description | `description` | string | Detailed description of the item. |
| Images | `images` | array of [org.Image](/draft-0/org/image) | Images associated with the item. |
| Currency | `currency` | [currency.Code](/draft-0/currency/code) | Currency used for the item's price. |
| Price | `price` | [num.Amount](/draft-0/num/amount) | Base price of a single unit to be sold. Must be either zero or positive. |
| Alternative Prices | `alt_prices` | array of [currency.Amount](/draft-0/currency/amount) | AltPrices defines a list of prices with their currencies that may be used as an alternative to the item's base price. |
| Unit | `unit` | [org.Unit](/draft-0/org/unit) | Unit of measure. |
| Country of Origin | `origin` | [l10n.ISOCountryCode](/draft-0/l10n/i_s_o_country_code) | Country code of where this item was from originally. |
| Extensions | `ext` | [tax.Extensions](/draft-0/tax/extensions) | Extension code map for any additional regime specific codes that may be required. |
| Meta | `meta` | [cbc.Meta](/draft-0/cbc/meta) | Additional meta information that may be useful |

## Key Values

| Value | Description |
| - | - |
| `goods` | Goods |
| `services` | Services |

## Validation Rules

| Field | Test | Validation Code / Message |
| - | - | - |
| `name` | <ul class="gobl-test"><li class="gobl-test-present">Present</li></ul> | `GOBL-ORG-ITEM-01`<br />Item name is required |
| `price` | <ul class="gobl-test"><li>Min 0</li></ul> | `GOBL-ORG-ITEM-02`<br />Item price must be zero or positive |
| `attributes` | <ul class="gobl-test"><li>Attribute keys must be unique</li></ul> | `GOBL-ORG-ITEM-03`<br />Item attributes must not contain duplicate keys |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.