> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api-guide/back-office/goods-bo/undefined-2.md).

# 상품 일괄등록

상품을 대량으로 등록하고 필요한 정보를 저장하며, 등록된 상품을 효과적으로 조회하는 기능을 제공합니다.

***

## 주요 기능

* **일괄 등록, 저장, 조회 기능**
  * 대량의 상품을 일괄 등록하고 필요한 정보를 저장하며, 등록된 상품 정보를 효율적으로 조회할 수 있는 기능을 제공합니다.
* **엑셀 버전 일치 확인**
  * 다운로드한 엑셀 파일의 버전이 실제 엑셀 양식의 버전과 일치하는지 확인하여 사용자의 오류를 방지합니다.
* **중복 키 체크**
  * 상품명, 협력사, 표준분류코드, 자체상품번호를 중복 키로 사용하여 중복된 상품을 체크하고 등록을 방지합니다.
* **상세 오류 메시지 제공**
  * 각 행과 컬럼에 대한 오류를 명시하여 사용자가 잘못된 상품 정보를 쉽게 수정할 수 있도록 합니다.

## 프로세스 정의

<figure><img src="/files/9cewFpWa8xTtdFgIrDWu" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### 상품일괄등록 데이터 유효성 확인에 필요한 기본데이터 조회

사용자가 업로드 양식 다운로드를 클릭하는 경우 양식의 참조시트에 필요한 공통코드, 협력사, 브랜드, 리프표준카테고리, 상품고시항목 리스트 목록을 각 DB에서 조회합니다.

사용자가 일괄등록 파일 선택을 클릭하는 경우 입력한 데이터의 데이터 유효성 확인에 필요한 중복확인 상품, 공통코드, 협력사, 브랜드, 리프표준카테고리, 상품고시항목 리스트 목록을 각 DB에서 조회합니다.
{% endstep %}

{% step %}

### 상품일괄등록 엑셀 파일 및 엑셀업로드 에러저장

사용자가 일괄등록 파일 선택을 클릭하는 경우, 해당 파일을 상품엑셀업로드이력 DB에 저장합니다.

해당 파일에서 확인된 에러 메시지들은 엑셀업로드에러정보 DB에 저장됩니다.
{% endstep %}

{% step %}

### 상품일괄등록 엑셀 상품등록

데이터 유효성 확인이 끝나 오류가 없는 상품들은 상품정보의 각 DB에 저장됩니다.
{% endstep %}

{% step %}

### 상품일괄등록 상품 엑셀 업로드 이력 목록 조회

업로드 되었던 상품 엑셀업로드 파일 리스트를 상품엑셀업로드이력 DB에서 조회합니다.
{% endstep %}
{% endstepper %}

## API 기능 목록

<table><thead><tr><th width="131.2220458984375">API</th><th width="394">설명</th><th width="93.5555419921875">Server</th><th width="89.111083984375">메소드</th><th>비고</th></tr></thead><tbody><tr><td>상품일괄등록 엑셀 파일 및 엑셀업로드 <br>에러 저장</td><td>•상품일괄등록에서 엑셀 파일 및 엑셀업로드 에러를 저장합니다. <br>•PO인 경우 엑셀 파일 저장 시, 로그인한 사용자의 협력사 데이터로 저장됩니다. <br>•엑셀업로드 에러에서 상품중복의 에러의 경우 셀은 0으로 저장됩니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=goods&#x26;depth=%EC%83%81%ED%92%88%20%EC%9D%BC%EA%B4%84%20%EB%93%B1%EB%A1%9D&#x26;path=saveExcelUploadFile">🔗API 확인하기 ></a></td></tr><tr><td>상품일괄등록 엑셀 상품<br>등록</td><td><p>•상품일괄등록에서 업로드한 엑셀 파일의 상품 <br>데이터를 저장합니다. </p><p>•데이터 검증이 완료된 정상상품목록을 받아서 저장합니다. </p><p>•저장 언어는 디폴트 언어코드인 ko 기준으로 저장합니다. </p><p>•결제가능수단은 전체로 초기값 셋팅됩니다.</p></td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=goods&#x26;depth=%EC%83%81%ED%92%88%20%EC%9D%BC%EA%B4%84%20%EB%93%B1%EB%A1%9D&#x26;path=saveExcelUploadFile">🔗API 확인하기 ></a></td></tr><tr><td>상품일괄등록 데이터 유효성 확인에 필요한 기본데이터 <br>조회</td><td><p>•상품일괄등록 데이터 유효성 확인에 필요한 기본 데이터를 조회합니다. </p><p>•BO인 경우 모든 협력사 목록을 조회합니다. </p><p>•PO인 경우 로그인한 사용자의 협력사를 조회합니다.</p></td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=goods&#x26;depth=%EC%83%81%ED%92%88%20%EC%9D%BC%EA%B4%84%20%EB%93%B1%EB%A1%9D&#x26;path=excelUploadBasicData">🔗API 확인하기 ></a></td></tr><tr><td>상품일괄등록 상품엑셀<br>업로드이력 <br>목록 조회</td><td>•상품일괄등록 페이지에서 상품엑셀업로드이력 <br>목록을 조회합니다.<br>•PO인 경우, 로그인한 사용자의 협력사와 일치하는 엑셀파일만 조회 가능합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=goods&#x26;depth=%EC%83%81%ED%92%88%20%EC%9D%BC%EA%B4%84%20%EB%93%B1%EB%A1%9D&#x26;path=getGoodsUploadHistoryList">🔗API 확인하기 ></a></td></tr></tbody></table>

## 용어 정의

<table><thead><tr><th width="242.888916015625">명칭</th><th>설명</th><th data-hidden></th></tr></thead><tbody><tr><td>엑셀업로드 에러</td><td><p>•엑셀 업로드 에러는 각 컬럼의 필수여부, 포맷, byte, 로직 순으로 오류를 확인합니다. </p><p>•한 컬럼에 여러 오류가 있는 경우 위의 순서 중 가장 앞순서에 있는 오류를 인식합니다.</p></td><td></td></tr><tr><td>데이터 유효성 확인에 필요한 기본데이터</td><td>•데이터 유효성 확인에 필요한 기본데이터는 공통코드, 협력사, 브랜드, 리프표준카테고리, 상품고시항목의 목록입니다.</td><td></td></tr></tbody></table>

## 기타 참고사항

* 상품일괄등록 데이터 유효성 확인에 필요한 기본데이터 조회 API
  * BO인 경우 모든 협력사 목록을 조회합니다.
  * PO인 경우 로그인한 사용자의 협력사를 조회합니다.
* 상품일괄등록 엑셀 파일 및 엑셀업로드 에러 저장 API
  * PO인 경우 엑셀 파일 저장 시, 로그인한 사용자의 협력사 데이터로 저장됩니다.
  * 엑셀업로드 에러에서 상품중복의 에러의 경우 셀은 0으로 저장됩니다.
* 상품일괄등록 엑셀 상품등록 API
  * 데이터 검증이 완료된 정상상품목록을 받아서 저장합니다.
  * 저장 언어는 디폴트 언어 코드인 ko 기준으로 저장합니다.
  * 결제가능수단은 전체로 초기값 셋팅 됩니다.
  * 표준분류에 매핑 된 전시 카테고리 리스트가 초기값으로 저장됩니다.
* 상품일괄등록 상품엑셀업로드이력 목록 조회 API
  * PO인 경우, 로그인한 사용자의 협력사와 일치하는 엑셀파일만 조회 가능합니다.