> For the complete documentation index, see [llms.txt](https://www.boxhero.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.boxhero.io/docs/documentation/ko/concepts/items.md).

# 제품

***

<figure><img src="/files/L5u5LSSJUiJ9DdTbKzct" alt="박스히어로 제품이 등록되어 있는 모습"><figcaption></figcaption></figure>

***

## 제품 등록 <a href="#how-to-add-items" id="how-to-add-items"></a>

### 개별 등록 <a href="#items" id="items"></a>

제품은 `제품목록` > `제품추가`를 선택해 등록할 수 있습니다.

<figure><img src="/files/v0HuQumgEf7FxlfY1NlJ" alt="박스히어로 제품 추가하는 방법"><figcaption></figcaption></figure>

<table><thead><tr><th width="138">이름</th><th width="606.999755859375" valign="middle">설명</th></tr></thead><tbody><tr><td><strong>사진</strong></td><td valign="middle"><p>사진은 최대 3MB 까지 등록할 수 있습니다. 박스히어로 모바일 앱을 사용하면 스마트폰으로 사진을 찍어 바로 등록할 수 있습니다.</p><ul><li><strong>사진 여러개 추가 :</strong> <a href="/pages/JRJuk7sPHZVddpVwz3Ve"><strong>속성</strong></a>으로 사진/파일 항목을 추가할 수 있습니다. </li></ul></td></tr><tr><td><a href="https://www.boxhero.io/ko/blog/sku-stock-keeping-unit-iran/"><strong>SKU</strong></a></td><td valign="middle"><strong>제품 고유 식별 코드</strong>이며 중복으로 등록할 수 없습니다. 입력하지 않을 경우 제품 등록 시 자동 생성됩니다. 영어, 한글, 특수문자를 모두 사용할 수 있으며, 대소문자는 구분하지 않습니다.</td></tr><tr><td><strong>제품명</strong></td><td valign="middle">항상 필수로 입력해야 합니다.</td></tr><tr><td><strong>바코드</strong></td><td valign="middle"><ul><li><strong>바코드가 없는 경우 :</strong> <code>자동 생성</code> 버튼을 누르면 20으로 시작하는 13자리 랜덤 번호가 생성됩니다. 제품 등록 후 <code>바코드 인쇄</code>에서 <a href="/pages/wbxtRDLsPf0AYagMBjU7"><strong>라벨을 만들어 인쇄 한 후</strong></a> 사용할 수 있습니다.</li><li><strong>바코드가 있는 경우 :</strong> 제품에 있는 바코드를 직접 입력하거나, <a href="/pages/NsX9OLwQM1DkxcN8m4GW#desktop"><strong>PC에 스캐너를 연결</strong></a>하고 스캔 모드 버튼을 눌러 등록할 수 있습니다. 모바일 앱에서는 <a href="/pages/NsX9OLwQM1DkxcN8m4GW#mobile-device-scanner"><strong>카메라로 바코드를 스캔</strong></a>해 제품 등록할 수 있습니다.</li></ul><p>필요한 경우 <strong>하나의 바코드를 여러 제품에 중복 등록</strong>할 수 있습니다. 이 경우 해당 바코드를 스캔하면 등록된 제품이 모두 보여지며, 원하는 품목을 선택한 뒤 제품조회·입고·출고 등의 작업을 진행합니다.</p></td></tr><tr><td><a href="/pages/JRJuk7sPHZVddpVwz3Ve"><strong>속성</strong></a></td><td valign="middle">카테고리, 브랜드, 컬러, 사이즈, 추가 사진/파일 등 원하는 항목을 추가해 사용할 수 있는 <strong>사용자 정의 필드</strong>입니다.</td></tr><tr><td><strong>가격 정보</strong></td><td valign="middle">구매가, 판매가는 제품의 <strong>기본 단가</strong>입니다. <a href="/pages/GSu5Jbd4YsCBoRSK7zx6#purchase"><strong>발주서(구매)</strong></a>나 <a href="/pages/GSu5Jbd4YsCBoRSK7zx6#sales-order"><strong>판매서(판매)</strong></a> 작성 시 자동으로 불러올 수 있습니다. 거래처별 또는 프로모션별 가격 정책은 <a href="https://docs-ko.boxhero.io/key-features/purchase-and-sales#price-lists"><strong>가격 템플릿</strong></a> 기능을 사용합니다.</td></tr><tr><td><strong>초기 수량</strong></td><td valign="middle">초기 수량 입력은 선택 사항이므로, 입력하지 않아도 제품을 등록할 수 있습니다. 여러 장소에 재고를 나누어 보관한다면, <a href="/pages/4gch8w5CCxMYuiXd34pw"><strong>위치</strong></a>를 추가해 각 위치별 수량을 관리할 수 있습니다.</td></tr></tbody></table>

{% hint style="warning" %}
등록 가능한 제품 수에는 한도가 있습니다. 자세한 내용은 [**요금 안내**](/docs/documentation/ko/pricing.md)에서 확인해 주세요.
{% endhint %}

### 엑셀 대량 등록 <a href="#bulk-add-excel" id="bulk-add-excel"></a>

여러 제품을 한 번에 등록해야 하는 경우 `대량 추가` 기능을 사용해 엑셀로 한꺼번에 제품을 등록할 수 있습니다.

{% embed url="<https://customer-0jrbilsa8yt3k758.cloudflarestream.com/ff3be3d9c7f74697a1bb3b31e81bbb31/iframe?autoplay=true&controls=false&letterboxColor=transparent&loop=true&muted=true&poster=https://customer-0jrbilsa8yt3k758.cloudflarestream.com/ff3be3d9c7f74697a1bb3b31e81bbb31/thumbnails/thumbnail.jpg?height=1080&preload=true>" %}

{% stepper %}
{% step %}

#### **엑셀 양식 다운로드**

아래 경로에서 제품 등록용 엑셀 양식을 다운로드할 수 있습니다.

* `데이터 관리` > `제품` > `엑셀 가져오기` > `대량 추가` > `엑셀 양식 다운로드`
  {% endstep %}

{% step %}

#### **엑셀 양식 확인하기**

다운로드한 엑셀 파일을 열어 각 컬럼을 확인해 주세요.

<figure><img src="/files/Ct2br7pgGVMZmnP1S3D5" alt="박스히어로 엑셀 양식"><figcaption></figcaption></figure>

<table><thead><tr><th width="144.6666259765625">컬럼</th><th>설명</th></tr></thead><tbody><tr><td><strong>고정 필드</strong></td><td>삭제하거나 이름을 수정할 수 없는 기본 컬럼입니다.</td></tr><tr><td><strong>커스텀 속성</strong></td><td><p><code>데이터 관리</code> > <code>속성</code>에서 사용자가 설정한 <a href="/pages/JRJuk7sPHZVddpVwz3Ve"><strong>속성</strong></a>입니다. </p><p></p><p>속성을 아직 설정하지 않았다면 위 경로에서 먼저 추가해 주세요.
 이후 엑셀 양식을 다시 다운로드하면 설정한 속성이 자동 반영됩니다.</p></td></tr><tr><td><strong>위치별 수량</strong></td><td><p><code>데이터 관리</code> > <code>위치</code>에서 사용자가 설정한 <a href="/pages/4gch8w5CCxMYuiXd34pw"><strong>위치</strong></a>입니다. </p><p></p><p>위치를 추가하지 않았다면 '수량(기본 위치)' 컬럼만 표시됩니다. </p><p>하나의 품목이 여러 위치에 분산되어 있는 경우, 위 경로에서 <a href="/pages/4gch8w5CCxMYuiXd34pw"><strong>위치</strong></a>를 추가해 주세요. 이후 엑셀 양식을 다시 다운로드하면 설정한 위치별 수량 컬럼이 자동 반영됩니다.</p></td></tr></tbody></table>

{% hint style="warning" %}
위치는 [**비즈니스 플랜**](/docs/documentation/ko/pricing.md#id-2-1)에서 기본 3개까지 추가할 수 있고, 필요에 따라 추가 결제해서 사용할 수 있습니다.
{% endhint %}
{% endstep %}

{% step %}

#### **엑셀 양식 입력하기**

아래 예시를 참고해 엑셀 파일에 제품 정보를 입력하고 저장합니다.

<figure><img src="/files/i4SLMrgTOFq5X0G3X1el" alt="엑셀 양식 입력 샘플"><figcaption></figcaption></figure>

1. 제품명은 필수 입력이며, 그 외 항목은 입력하지 않으면 빈칸으로 등록됩니다.
2. SKU와 바코드를 자동 생성하려면 엑셀에서는 일단 빈칸으로 남겨주세요.
3. [**구매 및 판매**](/docs/documentation/ko/key-features/purchase-and-sales.md) 기능을 사용하지 않는다면 구매가, 판매가는 입력하지 않아도 됩니다.
4. 수량은 입력하지 않으면 0개로 등록됩니다.
   {% endstep %}

{% step %}

#### 파일 추가하기

엑셀 파일에 **SKU**가 비어 있는 경우에는 자동으로 생성됩니다.&#x20;

**바코드**를 생성하려면 `자동생성`에 체크해 주세요.

<figure><img src="/files/s61nwH3Ck79lAQtPAHgQ" alt="바코드 자동 생성 체크 위치"><figcaption></figcaption></figure>

등록할 제품 목록을 확인한 후, 하단의 `완료`버튼을 눌러 등록을 마칩니다.

{% hint style="warning" %}
제품 등록 후 박스히어로에서 사용할 엑셀 기능은 **SKU를 기준으로 제품을 식별**합니다.\
만약 식별 기준을 바코드로 설정하려면 아래 경로에서 변경해 주세요.

* `설정` > `팀 설정` > `엑셀 가져오기` > `제품 식별 방법`
  {% endhint %}
  {% endstep %}
  {% endstepper %}

### 옵션 일괄 추가 <a href="#add-item-variants" id="add-item-variants"></a>

동일한 상품에 **사이즈나 컬러 등 여러 옵션이 있을 때 사용**할 수 있습니다. 예를 들어 A 티셔츠가 블랙/화이트 색상과 S/M/L 사이즈로 구성된 경우, 간편하게 등록할 수 있습니다.

{% embed url="<https://customer-0jrbilsa8yt3k758.cloudflarestream.com/333c7fe8d46446afa92ac07fbaeaba9c/iframe?autoplay=true&controls=false&letterboxColor=transparent&loop=true&muted=true&poster=https://customer-0jrbilsa8yt3k758.cloudflarestream.com/333c7fe8d46446afa92ac07fbaeaba9c/thumbnails/thumbnail.jpg?height=1080&preload=true>" %}

## 제품 조회 <a href="#product-list" id="product-list"></a>

### 제품 목록 <a href="#list" id="list"></a>

원하는 제품을 검색하거나, [**묶어보기**](/docs/documentation/ko/concepts/attributes.md#group-by) 기능으로 분류해 확인할 수 있습니다.

<figure><img src="/files/Z8Nk8BODq5Zcn6TrIYxP" alt="제품목록에서 제품 묶어보기를 한 화면"><figcaption></figcaption></figure>

제품을 선택하면 **상세 정보**를 확인할 수 있고, 우측에는 해당 제품의 히스토리가 표시됩니다.

<figure><img src="/files/rRuHt9VvZH9tp5LlhsfI" alt="제품 선택 시 확인할 수 있는 상세 정보"><figcaption></figcaption></figure>

### 데이터 관리 <a href="#data-center" id="data-center"></a>

데이터 관리에서는 제품을 **표 형식**으로 조회할 수 있습니다. 컬럼명을 선택해 정렬을 변경할 수 있고, **제품을 대량으로 추가, 수정, 삭제**할 수 있습니다.

<figure><img src="/files/NsOXsNeVHT2PDHYcwcvm" alt="데이터관리에서 표형식으로 제품이 정렬된 모습"><figcaption></figcaption></figure>

{% hint style="success" %}
'총 수량' 컬럼명을 클릭하면 재고 수량이 0인 제품만 모아서 볼 수 있습니다.
{% endhint %}

## 제품 정보 업데이트 <a href="#product-update" id="product-update"></a>

### 제품 수정 <a href="#individual-update" id="individual-update"></a>

`데이터 관리` > `제품`에서 제품 정보를 수정할 수 있습니다. 또한 여러 제품을 선택해 **특정 항목을 동일한 값으로 한 번에 변경**할 수 있습니다.

{% embed url="<https://customer-0jrbilsa8yt3k758.cloudflarestream.com/de0b154d4f2ba8aa225019d8ed87f4b3/iframe?autoplay=true&controls=false&letterboxColor=transparent&loop=true&muted=true&poster=https://customer-0jrbilsa8yt3k758.cloudflarestream.com/de0b154d4f2ba8aa225019d8ed87f4b3/thumbnails/thumbnail.jpg?height=1080&preload=true>" %}

{% hint style="danger" %}
선택한 제품은 페이지를 이동하거나 검색을하더라도 **선택 상태가 유지**됩니다. 수정 전 선택된 제품 수를 다시 한번 확인해 주세요.
{% endhint %}

### 제품 삭제 <a href="#bulk-delete" id="bulk-delete"></a>

`데이터 관리` > `제품`에서 제품을 삭제할 수 있습니다. 삭제한 제품의 입출고 이력은 유지되지만, 히스토리 메뉴에서는 해당 제품으로 필터링할 수 없습니다.

<figure><img src="/files/Vw4fLLGUijdK0mGrZGV1" alt="제품 삭제 방법 미리보기"><figcaption></figcaption></figure>

{% hint style="danger" %}
선택한 제품은 페이지를 이동하거나 검색을하더라도 **선택 상태가 유지**됩니다. 삭제 전 선택된 제품 수를 다시 한번 확인해 주세요.
{% endhint %}

### 엑셀 대량 수정 <a href="#edit-items-via-excel" id="edit-items-via-excel"></a>

엑셀을 활용해 여러 제품의 정보와 수량을 한 번에 수정할 수 있습니다.&#x20;

{% embed url="<https://customer-0jrbilsa8yt3k758.cloudflarestream.com/5d91e6737005473c81c6e764667f4ab0/iframe?autoplay=true&controls=false&letterboxColor=transparent&loop=true&muted=true&poster=https://customer-0jrbilsa8yt3k758.cloudflarestream.com/5d91e6737005473c81c6e764667f4ab0/thumbnails/thumbnail.jpg?height=1080&preload=true>" %}

{% hint style="success" %}
엑셀 대량 수정은 여러 [**위치**](/docs/documentation/ko/concepts/locations.md)의 수량을 한 번에 변경할 때 유용하게 활용할 수 있습니다.
{% endhint %}

{% stepper %}
{% step %}

#### **엑셀 양식 다운로드**

현재 박스히어로에 등록된 모든 제품의 정보와 재고 수량이 포함된 엑셀 파일을 다운로드할 수 있습니다.

대량 수정 작업 전에는 **원본 파일을 별도로 보관하는 것을 권장**합니다. 실수로 데이터를 변경한 경우 해당 파일을 통해 복구할 수 있습니다.
{% endstep %}

{% step %}

#### **엑셀 파일 수정하기**

엑셀 파일에서 **변경이 필요한 항목만 수정**해 주세요.&#x20;

**값을 유지하려는 항목은 기존 데이터를 그대로 남겨 두어야 합니다.** 셀을 빈칸으로 변경한 후 업로드하면 해당 값이 빈값 또는 0으로 변경될 수 있습니다.
{% endstep %}

{% step %}

#### **엑셀 파일 업로드**

수정이 완료된 파일을 추가해 주세요.&#x20;

수정하지 않을 항목은 `수정 안 함`을 선택하시면 실수로 데이터가 변경되는 것을 방지할 수 있습니다. 업로드 후 변경될 데이터를 다시 한 번 확인한 뒤 `완료`를 눌러 주세요.

<figure><img src="/files/vExrK43QPTIZSggCyLBr" alt="수정안함 선택하는 방법"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
엑셀 파일에서 제품 행을 삭제해도 박스히어로에 등록된 제품은 삭제되지 않습니다. 제품 삭제는 [**데이터 관리**](#bulk-delete)에서 진행해 주세요.
{% endhint %}

### 변경 이력 <a href="#product-info-change-history" id="product-info-change-history"></a>

제품명, 속성, 구매가, 판매가 등 제품 정보가 변경된 이력은 `제품 목록` > `제품 선택` > `…` > `변경 이력`에서 확인할 수 있습니다.

<figure><img src="/files/i5Zj2RynaTz24SsTIdQB" alt="제품 정보 변경 이력 확인하는 화면"><figcaption></figcaption></figure>

## 제품 다운로드 <a href="#export-items-to-excel" id="export-items-to-excel"></a>

### 엑셀로 내보내기 <a href="#excel" id="excel"></a>

`데이터 관리` > `제품` > `엑셀 내보내기`를 클릭해 다운로드 받을 수 있습니다.

{% hint style="info" %}
히스토리, 입출고 요약 등 박스히어로의 주요 기능은 모두 엑셀 내보내기를 지원합니다.
{% endhint %}

### 사진과 함께 내보내기 <a href="#image" id="image"></a>

제품 정보를 사진과 함께 내보내려면, `데이터 관리` > `제품` > `…` > `HTML로 내보내기`를 눌러주세요. 다운로드한 파일은 상대방에게 공유할 수 있습니다.

<figure><img src="/files/EkJVG4fzEb2CTRz9AnPd" alt="HTML 내보내기 화면"><figcaption></figcaption></figure>

{% hint style="danger" %}
엑셀에 붙여넣어 사용할 경우, 엑셀 최신 버전이 아닌 컴퓨터에서는 사진이 보이지 않을 수 있습니다.
{% endhint %}

검색 후 **원하는 제품만 선택**해 HTML 내보내기 하는 것도 가능합니다. 만약 일부 컬럼만 표기하려면, 우측 `컬럼 설정`을 눌러 변경해 주세요.

<figure><img src="/files/UMww4ZuAiovTYC5Ct8Rs" alt="검색 후 원하는 제품만 선택하기"><figcaption></figcaption></figure>

***

## FAQ

제품을 관리하는 방법에 대한 **자주 묻는 질문**은 아래에서 확인하실 수 있습니다.

{% content-ref url="/spaces/dR2xvRG0Ds13315BlP8a/pages/o1QUYgYzTl7nrKvm04Z2" %}
[제품 및 속성](/docs/faq/ko/inventory-and-transactions/items-and-attributes.md)
{% endcontent-ref %}

***


---

# 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, and the optional `goal` query parameter:

```
GET https://www.boxhero.io/docs/documentation/ko/concepts/items.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.