> 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/changelog/ko/readme.md).

# 업데이트 노트

{% updates format="full" %}
{% update date="2026-06-10" tags="api" %}

## Open API 업데이트 : SKU 기반 연동과 구매 및 판매 지원 <a href="#open-api-sku-purchase-sales" id="open-api-sku-purchase-sales"></a>

이제 박스히어로 Open API에서 내부 `item_id` 없이 **SKU만으로 제품을 조회하고 관리**할 수 있습니다. 또한 구매 및 판매와 반품, 묶음제품, 가격 템플릿까지 API를 통해 관리할 수 있도록 지원 범위가 확대되었습니다.

#### **업데이트 내용** <a href="#update-details" id="update-details"></a>

* **SKU 기반 처리 지원**
  * SKU만으로 제품을 조회, 수정, 삭제할 수 있는 `by-sku` 엔드포인트가 추가되었습니다.
    * 예: `/v1/items/by-sku/{sku}`
  * 요청 본문에서도 `item_sku`, `bundle_sku`를 사용할 수 있어 내부 ID 없이 연동이 가능합니다.
* [**발주서/판매서**](/docs/ko/key-features/purchase-and-sales.md)
  * 생성, 조회, 수정, 삭제를 모두 지원합니다.
  * 상태를 변경할 수 있습니다. (입고 대기, 입고 완료 등)
  * 생성한 주문서를 통해 부분 입출고와 전체 입출고를 처리할 수 있습니다.
* [**반품**](/docs/ko/key-features/purchase-and-sales.md#returns)
  * 생성, 조회, 수정, 삭제를 모두 지원합니다.
  * 생성한 반품서를 통해 입고 처리할 수 있습니다.
  * 반품 번호로 조회할 수 있는 `by-number` 엔드포인트가 추가되었습니다.
* [**묶음제품**](/docs/ko/key-features/purchase-and-sales/bundles.md)
  * 생성, 조회, 수정, 삭제를 모두 지원합니다.
  * SKU를 기준으로 묶음제품을 조회할 수 있습니다.
  * 묶음제품을 구성하는 각 제품을 SKU 기준으로 연결할 수 있습니다.
* [**가격 템플릿**](/docs/ko/key-features/purchase-and-sales.md#price-lists)
  * 생성, 조회, 수정, 삭제를 모두 지원합니다.
  * 구매와 판매를 구분하여 관리할 수 있습니다.

자세한 요청과 응답 형식은 [**API 레퍼런스**](https://rest.boxhero-app.com/docs/api)를 참고해 주세요.

{% endupdate %}

{% update date="2026-06-08" tags="web,mobile" %}

## 태국어 지원 <a href="#thai-language-support" id="thai-language-support"></a>

PC Web과 Mobile App에 태국어 언어 옵션이 추가되었습니다. 사용가이드 또한 [**태국어**](https://www.boxhero.io/docs/documentation/th)로 제공되어 더욱 편리하게 이용하실 수 있습니다.

<figure><img src="/files/rJCdo3fY54VqpC4Mwk6r" alt="태국어로 언어 변경하는 화면"><figcaption></figcaption></figure>

#### **언어 변경 방법** <a href="#how-to-switch-languages" id="how-to-switch-languages"></a>

* **PC :** `우측 상단 프로필 아이콘` > `언어`
* **Mobile :** `설정` > `우측 상단 프로필 아이콘` > `언어 설정`

{% hint style="success" icon="globe" %}
**박스히어로가 현재 지원하는 언어 목록**

한국어 · 영어 · 스페인어 · 프랑스어 · 독일어 · 일본어 · 인도네시아어 · 포르투갈어(브라질) · 중국어 간체 · 중국어 번체 · 베트남어 · 러시아어 · 태국어
{% endhint %}
{% endupdate %}

{% update date="2026-05-11" tags="web,mobile" %}

## 구매 및 판매 다중 통화 지원 <a href="#multi-currency" id="multi-currency"></a>

구매 및 판매에서 발주서/판매서를 작성할 때 통화를 자유롭게 선택할 수 있게 되었습니다.

<figure><img src="/files/zeOwepm5RsnyfFf9kp6F" alt="구매 및 판매에서 통화를 선택하는 방법"><figcaption></figcaption></figure>

#### 업데이트 내용 <a href="#update-details" id="update-details"></a>

* 사용하는 언어와 관계없이 기본 통화를 설정할 수 있습니다.&#x20;
* 발주서/판매서 작성 시 기본 통화가 자동 선택되며, 작성 화면에서 바로다른 통화로 변경할 수 있습니다.
* [`가격 템플릿`](/docs/ko/key-features/purchase-and-sales.md#price-lists)을 사용하는 경우 템플릿에 저장된 통화가 자동으로 적용됩니다.
* [`매출 분석`](/docs/ko/key-features/purchase-and-sales/sales-reports.md)에서는 항상 현재 환율 기준으로 자동 환산됩니다.

#### **설정 방법** <a href="#currency-settings" id="currency-settings"></a>

업데이트 후 처음 접속하면 통화 선택 팝업이 표시됩니다. 한 명이 설정하면 팀 전체에 바로 적용되며, 이후에는 아래 경로에서 변경할 수 있습니다.

* **PC :** `설정` > `팀 설정` > `표시 설정` > `통화`
* **Mobile :** `설정` > `표시 설정` > `통화기호`
  {% endupdate %}

{% update date="2026-05-11" tags="web" %}

## 커스텀 리포트 차트 보기 추가 <a href="#custom-report-chart" id="custom-report-chart"></a>

AI 어시스턴트로 조회한 데이터를 **차트로 시각화해서 확인**할 수 있습니다. 표 형식으로만 보던 재고 데이터를 한눈에 파악할 수 있어 추이와 패턴을 확인하기 훨씬 쉬워졌습니다.

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

{% update date="2026-04-28" tags="web" %}

## 커스텀 리포트 AI 어시스턴트 추가 <a href="#custom-report-ai-assistant" id="custom-report-ai-assistant"></a>

이제 **누구나 AI 채팅으로** **원하는 재고 데이터를 간편하게 확인**할 수 있습니다.&#x20;

조회한 결과는 **엑셀로 다운로드**할 수 있고, 자주 확인하는 데이터라면 **저장해 두고 언제든 다시 조회**할 수 있습니다.

재고 분석, 매출 분석, 입출고 요약 같은 기존 분석 메뉴에서 원하는 데이터를 확인하기 어려웠거나, 박스히어로 데이터를 엑셀로 내려받아 직접 가공해 사용했다면 이제 커스텀 리포트로 손쉽게 해결해 보세요.

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

#### 업데이트 내용 <a href="#update-details" id="update-details"></a>

* 기존에는 SQL을 직접 작성해야 했지만, 이제는 AI 채팅으로 간단하게 리포트를 만들 수 있습니다.

#### 사용 방법 <a href="#how-to-use" id="how-to-use"></a>

1. `분석` > `커스텀 리포트`에서 `+새로 만들기`를 클릭하면 AI 어시스턴트 창이 열립니다.
2. 조회하고 싶은 데이터를 채팅창에 입력해 주세요. \
   구체적으로 입력할수록 AI가 더 정확한 결과를 보여줍니다.
3. 조회 결과가 실제 데이터와 맞는지 확인합니다.&#x20;
4. 반복해서 확인할 데이터라면 상단의 `저장` 버튼을 눌러주세요.

{% hint style="success" icon="circle-info" %}
커스텀 리포트에 대해 더 자세히 알아보고 싶다면 [사용가이드](/docs/ko/other-features/custom-analytics.md)를 확인해 주세요.
{% endhint %}
{% endupdate %}

{% update date="2026-04-28" tags="mobile" %}

## 모바일 재고조사 '내 작업 시트' 바로가기  <a href="#mobile-inventory-my-sheet" id="mobile-inventory-my-sheet"></a>

홈 화면에서 내 작업 시트로 바로 이동할 수 있도록 개선되었습니다.

#### 업데이트 내용 <a href="#update-details" id="update-details"></a>

* 재고조사 섹션에 `내 작업 시트` 메뉴가 추가되었습니다.&#x20;
* 기존에는 `재고 조사하기` → `재고 조사` → `내 시트 선택` 순서로 이동해야 했지만, 이제 홈 화면에서 바로 접근할 수 있습니다.
* 배정받은 시트가 없으면 `내 작업 시트` 메뉴가 표시되지 않습니다.
  {% endupdate %}

{% update date="2026-04-28" tags="mobile" %}

## 모바일 임시저장 위치 변경 <a href="#mobile-draft-location-change" id="mobile-draft-location-change"></a>

홈 화면에서 임시저장 내역을 바로 확인할 수 있게 개선되었습니다.

#### 업데이트 내용 <a href="#update-details" id="update-details"></a>

* 기존 `입고/출고` 탭 상단에 있던 임시저장 내역이 **홈 화면으로 이동**했습니다.
* 임시저장 내역이 있으면 **빨간색 숫자 배지**가 함께 표시됩니다. 배지는 다른 팀원이 작성한 내역도 포함됩니다.
* 임시저장 내역이 없으면 홈 화면에서 `임시저장` 메뉴가 표시되지 않습니다.
* 하단 탭 이름이 `입고/출고`에서 `히스토리`로 변경되었습니다.
  {% endupdate %}

{% update date="2026-04-20" tags="mobile" %}

## 모바일 제품 탭 개편 <a href="#mobile-items-tab-update" id="mobile-items-tab-update"></a>

박스히어로 모바일 앱의 `제품` 탭이 새롭게 개편되었습니다. 이제 더 직관적인 구조로 제품 목록과 상세 화면을 이용할 수 있습니다.

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

목록에서 아래 세 가지가 변경되었습니다.

{% tabs %}
{% tab title="1" %}
**위치 필터**

상단에 있던 `묶어보기` 필터가 `위치 선택` 필터로 바뀌었습니다.

<figure><img src="/files/mCQycbdTBcNXTiwVrFpw" alt="묶어보기 필터가 위치 선택으로 변경된 화면"><figcaption></figcaption></figure>
{% endtab %}

{% tab title="2" %}
**묶어보기, 재고보유, 정렬**

기능 버튼들이 모두 검색창 아래로 이동했습니다.

<figure><img src="/files/fgYFHmaaSQ9h9FfThPiL" alt="검색창 아래로 이동안 필터들"><figcaption></figcaption></figure>
{% endtab %}

{% tab title="3" %}
**제품 추가**

하단의 `+` 제품 추가 버튼은 우측 상단으로 이동했습니다.

<figure><img src="/files/j8IhwJfB90ZuFtR1zXTn" alt="제품 추가버튼이 바뀐 모습"><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

#### 제품 정보 <a href="#item-information" id="item-information"></a>

<figure><img src="/files/AuVGmxebLJVj7SgR8Ffu" alt="제품 정보 상세화면의 전후 UI"><figcaption></figcaption></figure>

제품 정보 화면이 두 개의 탭으로 나뉩니다.&#x20;

* **제품 정보 :** 제품의 기본 정보를 한눈에 확인할 수 있습니다.
* **재고 현황 :** 기존처럼 위치별 재고 수량을 확인할 수 있습니다.

#### 입출고 방법 <a href="#recording-inventory-transactions" id="recording-inventory-transactions"></a>

<figure><img src="/files/oOKI3XkfY2HcPpV7J73b" alt="변경 후 입출고 방법 튜토리얼 이미지"><figcaption></figcaption></figure>

위치가 여러 개인 경우, 입출고 시 위치를 선택하는 순서가 달라졌습니다.

* **변경 전 :** `위치` 선택 > `작업 유형` 선택 (입고/출고/이동/조정)
* **변경 후 :** `입/출고` 버튼 > `작업 유형` 선택 (입고/출고/이동/조정) > `위치` 선택

{% hint style="warning" icon="lightbulb" %}
제품 목록에서 위치를 미리 선택했다면 위치 선택 화면은 나타나지 않습니다.
{% endhint %}

#### 재고 변동 내역 확인 <a href="#viewing-transaction-history" id="viewing-transaction-history"></a>

<figure><img src="/files/sxRi3VtIb6sYrl1iDFHZ" alt="재고 변동 내역 확인 방법 변경 전과 후 비교 UI"><figcaption></figcaption></figure>

* **변경 전 :** 제품 정보에서 `재고 변동 내역` 버튼을 선택
* **변경 후 :** 하단의 수량을 선택

{% hint style="warning" icon="lightbulb" %}
특정 위치의 히스토리를 바로 확인하려면 `재고 현황` 탭에서 해당 위치를 선택합니다.
{% endhint %}
{% endupdate %}

{% update date="2026-04-20" tags="web,mobile" %}

## 베트남어, 러시아어 지원 <a href="#new-languages-vietnamese-and-russian" id="new-languages-vietnamese-and-russian"></a>

PC Web과 Mobile App에 베트남어와 러시아어 언어 옵션이 추가되었습니다. 사용가이드도 [**베트남어**](https://www.boxhero.io/docs/documentation/vi)와 [**러시아어**](https://www.boxhero.io/docs/documentation/ru)로 제공됩니다.&#x20;

#### **언어 변경 방법** <a href="#how-to-switch-languages" id="how-to-switch-languages"></a>

* **PC :** `우측 상단 프로필 아이콘` > `언어`
* **Mobile :** `설정` > `우측 상단 프로필 아이콘` > `언어 설정`

{% hint style="success" icon="globe" %}
**박스히어로가 현재 지원하는 언어 목록**

한국어 · 영어 · 스페인어 · 프랑스어 · 독일어 · 일본어 · 인도네시아어 · 포르투갈어(브라질) · 중국어 간체 · 중국어 번체 · 베트남어 · 러시아어
{% endhint %}
{% endupdate %}

{% update date="2026-04-03" %}

## 업데이트 노트 개편 <a href="#new-changelog" id="new-changelog"></a>

기능 추가와 개선 사항은 앞으로 이 페이지에서 공유합니다.&#x20;

이전 업데이트 내역은 [**블로그**](https://www.boxhero.io/ko/blog/tag/eobdeiteu)에서 확인할 수 있습니다.
{% endupdate %}
{% endupdates %}


---

# 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://www.boxhero.io/docs/changelog/ko/readme.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.