> For the complete documentation index, see [llms.txt](https://docs.xorosoft.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.xorosoft.com/xoroerp-1/admin/item/hs-code/creating-hs-codes.md).

# Creating HS Codes

Creating HS Codes is simple. XoroERP offers a dedicated module for creating and managing the HS codes. Users can add new HS Codes in the system from this module and view the already added HS codes in the system.

{% hint style="info" %}
To create an HS Code, go to Menu > Admin > Item > HS Code
{% endhint %}

### Entering HS Codes

To create an HS Code, enter the name of the HS Code in the **Name** field and the corresponding details in the **Description** field, then click **Add**. The Name should be a unique identifier that accurately represents the product classification, while the Description can be used to provide additional information about the HS Code. 

The new HS Code will be added to the system and displayed in the HS Code grid. This module lists all the HS Codes added in the system.

<figure><img src="/files/htV4YWvMMM4lTmRqddDf" alt=""><figcaption></figcaption></figure>

#### HS Code Fields

<table><thead><tr><th width="203">Field</th><th>Description</th></tr></thead><tbody><tr><td>Name</td><td>This field displays the name of the HS Code. It serves as the primary identifier for each code within the system.</td></tr><tr><td>Description</td><td>This field allows users to enter additional details about the HS Code. The description is displayed as subtext in the HS Code dropdown within the Item module to help users identify and select the appropriate HS Code.</td></tr><tr><td>Is Active?</td><td>This checkbox indicates whether an HS Code is currently active. An active HS Code is available for use in transactions and documentation. To deactivate an HS Code, simply uncheck the box.</td></tr><tr><td>Delete</td><td>To remove an HS Code, click on the "Bin" icon next to the respective code. This action will permanently delete the code from the system.</td></tr></tbody></table>

### HS Code Options

* **Batch Delete:** This option allows users to delete multiple HS Codes simultaneously. To use batch delete, select the HS Codes you wish to remove and click the "Batch Delete" option. This can save time and effort, especially when cleaning up obsolete or redundant codes.

<figure><img src="/files/ghtqZIrvhwCtGYtc5anh" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
**Please Note:&#x20;*****If any HS Code is being used in one or more Items, it cannot be deleted or inactivated from the HS Code module.***&#x20;
{% endhint %}

### Adding HS Code to Items

Once an HS Code is created, it can be assigned to any item in the system. To assign the HS Code, go to the **Other Attributes** tab in the Item Details and select the code from the **HS Code** dropdown. The dropdown displays both the HS Code Name and its configured Description, helping users quickly identify the appropriate classification. Click **Save** to apply the changes.

<figure><img src="/files/sb5YvRpHhaRh0BSt8N5B" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.xorosoft.com/xoroerp-1/admin/item/hs-code/creating-hs-codes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.