> For the complete documentation index, see [llms.txt](https://docs.smply.one/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.smply.one/it-device/code.md).

# 기기 관리번호 채번하기

## 기기 관리번호 채번하기

관리번호는 조직이 기기를 식별하기 위해 직접 부여하는 번호입니다. 제조사 일련번호와는 별개이며, 등록 방식에 따라 입력 방법이 다릅니다. 이 문서는 단건 등록과 일괄 업로드 각각에서 관리번호를 어떻게 채번하는지 안내합니다.

{% hint style="info" %}
**관리번호 ≠ 일련번호** 관리번호는 조직 내부에서 정한 식별 번호이고, 일련번호는 제조사가 부여한 번호입니다. 일련번호는 에이전트 자동 연결에 사용되며, 관리번호와 별개로 관리됩니다.
{% endhint %}

***

### 1. 단건 등록 — 관리번호 자동 추천

기기를 하나씩 등록할 때, 선택한 카테고리에 이미 등록된 기기가 있으면 다음 관리번호를 자동으로 추천합니다.

**단계 1: 기기 추가 화면 진입**

1. **기기 > 목록**으로 이동합니다.
2. **`기기 추가하기`** 버튼을 클릭합니다.

**단계 2: 카테고리 선택 후 추천 확인**

1. **카테고리**를 선택합니다.
2. 해당 카테고리에 등록된 가장 최근 기기의 관리번호를 기준으로, 끝 숫자를 1 증가시킨 번호를 추천합니다.
3. 추천 번호를 그대로 사용하거나, 관리번호 칸에 직접 다른 값을 입력할 수 있습니다.

예를 들어 카테고리의 최근 관리번호가 `LPTP-24-012`라면 `LPTP-24-013`을 추천합니다.

{% hint style="info" %}
**추천이 안 뜨는 경우** 선택한 카테고리에 등록된 기기가 아직 없으면 추천할 기준이 없어 추천 번호가 표시되지 않습니다. 이때는 관리번호를 직접 입력하세요. 추천된 번호가 이미 다른 기기에 쓰이고 있으면 중복되지 않는 다음 번호를 자동으로 찾아 추천합니다.
{% endhint %}

{% hint style="warning" %}
**여러 패턴이 섞인 카테고리는 주의** 추천은 카테고리의 가장 최근 기기 1건만 보고 끝 숫자를 올립니다. 한 카테고리 안에 서로 다른 관리번호 체계가 섞여 있으면(예: `MKT-NB-001`과 `DEV-NB-001`) 의도와 다른 번호를 추천할 수 있으니, 추천 번호를 확인한 뒤 필요하면 직접 수정하세요.
{% endhint %}

***

### 2. 일괄 업로드 — 관리번호는 필수 입력 항목

엑셀/CSV 파일로 기기를 일괄 등록할 때, **관리번호는 파일에 직접 입력하는 필수 항목**입니다. 카테고리·모델명과 함께 반드시 채워야 합니다.

일괄 업로드는 다음 4단계로 진행합니다.

| 단계           | 화면     | 하는 일                                                  |
| ------------ | ------ | ----------------------------------------------------- |
| **1. 파일 선택** | 파일 업로드 | 엑셀/CSV 파일을 끌어다 놓거나 선택합니다. 템플릿도 이 화면에서 내려받습니다.         |
| **2. 컬럼 매핑** | 컬럼 매핑  | 파일의 각 컬럼을 기기 필드(관리번호·카테고리·모델명 등)에 연결합니다.              |
| **3. 검증**    | 검증 결과  | 입력값의 형식·중복·필수 누락을 확인합니다. 오류가 있는 셀은 직접 고쳐 재검증할 수 있습니다. |
| **4. 등록**    | 등록     | 검증을 통과한 기기를 한 번에 등록합니다.                               |

{% hint style="info" %}
**관리번호는 파일에서 가져옵니다** 일괄 업로드에서는 시스템이 관리번호를 자동으로 만들어 주지 않습니다. 파일의 관리번호 컬럼에 미리 채워 넣은 값을 그대로 등록합니다. 한 파일 안에서 중복되거나 이미 등록된 관리번호는 검증 단계에서 오류로 표시됩니다.
{% endhint %}

파일에 채워야 하는 필드별 입력 형식은 [엑셀 파일 업로드하기](/it-device/register_device_purchased/upload.md) 문서를 참고하세요.

***

### 3. 카테고리별 관리번호 규칙 (준비 중)

카테고리마다 관리번호 체계(접두사 + 자동 증가 시퀀스)를 미리 정의해 두고, 기기 등록 시 규칙에 따라 번호를 자동으로 발급하거나 추천하는 기능을 준비하고 있습니다. 출시되면 카테고리 설정에서 규칙을 정의하고, 단건·일괄 등록 모두에서 규칙 기반으로 채번할 수 있습니다.

***

### 4. 문제 해결

#### Q: 단건 등록 시 관리번호 추천이 뜨지 않아요

**원인**: 선택한 카테고리에 등록된 기기가 아직 없어 추천할 기준 번호가 없는 경우입니다.

**해결 방법**: 첫 기기는 관리번호를 직접 입력하세요. 한 건이라도 등록되면 다음 기기부터 그 번호를 기준으로 추천이 표시됩니다.

#### Q: 추천된 번호 대신 다른 번호를 쓰고 싶어요

관리번호 칸에 원하는 값을 직접 입력하면 됩니다. 추천은 안내일 뿐 강제되지 않습니다.

#### Q: 일괄 업로드에서 *"중복되는 관리번호가 있습니다"* / *"이미 등록된 관리번호입니다"* 오류가 떠요

**원인**: 업로드 파일 안에서 같은 관리번호가 두 번 이상 쓰였거나, 이미 등록된 기기의 관리번호와 겹치는 경우입니다.

**해결 방법**:

1. 검증 단계에서 표시된 해당 셀의 관리번호를 겹치지 않는 값으로 수정합니다.
2. 다시 검증한 뒤 등록을 진행합니다.

#### Q: 이 외의 문제

채널톡으로 문의해 주세요.