> For the complete documentation index, see [llms.txt](https://shopping-docs.toss.im/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://shopping-docs.toss.im/products/add/bulk_upload.md).

# 상품 일괄 등록하기

{% stepper %}
{% step %}

### 카테고리 선택

등록하고자 하는 상품의 카테고리를 선택해주세요. 다양한 상품을 등록할 때는 **카테고리를 복수 선택해주세요**.

<figure><img src="/files/8uHj3AsVY2UeykKU6wdt" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### 이미지 업로드

상품 이미지는 아래 두 가지 방법을 지원해요. 원하는 방법을 사용해주세요.

**파일 형식**의 이미지

* **이미지 업로드** 버튼을 눌러주세요.
* 이미지 업로드 페이지에서 필요한 상품 이미지 파일을 모두 등록해주세요.&#x20;
* 업로드한 이미지의 파일명을 일괄 등록 양식에 입력하면 됩니다.

**HTML 링크 형식**의 이미지

* 일괄 등록 양식에 직접 이미지 HTML 링크를 입력하면 됩니다.&#x20;

<figure><img src="/files/e9n2OyejnLqflC0UJQq9" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### 양식 다운로드

이미지 업로드를 완료했다면, 일괄등록 페이지로 돌아가주세요. 오른쪽에 보이는 **양식 다운로드** 버튼을 눌러주세요. 상품 일괄 등록 양식이 적용된 엑셀 파일이 다운로드됩니다.

<figure><img src="/files/CTg0wglZL3Lx9j0nqlXA" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### 양식 안내사항 읽기

엑셀 파일을 열어주세요. 첫 번째 시트에는 주요 안내사항이 있습니다. 양식을 채우기 전에 반드시 읽어보세요.

<details>

<summary>하나의 상품으로 묶이는 조건은 뭔가요?</summary>

상품명 + 카테고리가 완전히 같으면, 해당 항목들은 하나의 상품으로 묶이며,  옵션 상품처럼 하나의 상품 상세페이지에 여러 옵션이 노출됩니다.

</details>

<details>

<summary>꼭 지켜야 할 조건이 있나요?</summary>

* **배송 템플릿**과 **교환/반품 템플릿**도 **옵션 간 동일해야 등록 가능**합니다.
* **상품명은 같지만, 카테고리가 다르면** 오류가 발생합니다.

  → **카테고리를 통일하거나, 서로 다른 상품명으로 나누어 작성**해 주셔야 합니다.

</details>

<details>

<summary>최저가 옵션이란?</summary>

최저가 옵션은 하나의 상품(옵션 묶음) 안에서 **가장 저렴한 가격을 가진 옵션 1개**입니다.

* 동일한 가격이 여러 개라면? → **자동으로 랜덤 1개 선택됩니다.**
* 이 최저가 옵션의 값이, **상품 단위로 적용되는 정보에 대표로 사용**됩니다.

</details>
{% endstep %}

{% step %}

### 양식 채우기

주의사항을 모두 숙지했다면, 아래 내용을 참고해서 두 번째 시트에 일괄 등록하고 싶은 상품 정보를 채워주세요.&#x20;

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

{% hint style="success" %}
✔️ 카테고리, 상품명, 브랜드, 코드, 옵션 값을 작성해주세요.

✔️ 옵션 유형은 각 카테고리에 맞춰서 고정되어 있어요.

✔️ 상품 관리 코드는 상품 단위로 작성해야 해요.
{% endhint %}

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

{% hint style="success" %}
✔️ 옵션 단위로 판매가, 정상가, 재고수량, 옵션 관리 코드, 모델 번호를 작성해주세요.
{% endhint %}

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

{% hint style="success" %}
✔️ 옵션 썸네일 : HTML 링크 혹은 업로드한 이미지의 파일명을 작성해주세요. **옵션 단위**로 작성할 수 있어요.

✔️ 상품 대표 썸네일은 옵션이 묶인 상품의 썸네일이에요. 같은 상품 내 **최저가 옵션 기준**으로 적용돼요.
{% endhint %}

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

{% hint style="success" %}
✔️ 카테고리 별로 내려진 검색 키워드 유형도 옵션 단위로 채워주세요.
{% endhint %}

<figure><img src="/files/Eyi8ooWpdqXpbY0Dr5Uj" alt="" width="289"><figcaption></figcaption></figure>

{% hint style="success" %}
✔️ 토스쇼핑 파트너스에 등록되어있는 배송 템플릿 명과 교환/반품 템플릿명을 작성해주세요. 없으시다면, 토스쇼핑 파트너스에 돌아가서 템플릿을 추가하신 후 작성해주세요.
{% endhint %}

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

{% hint style="success" %}
✔️ 면세 여부, 문화비소득공제가능여부, 성인상품 여부, 병행수입여부, 해외구매대행 여부를 체크해주세요
{% endhint %}

<figure><img src="/files/7rp6WyqKEOzykfKm4Auz" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
✔️ 상품 고시 정보 카테고리에 맞춰 고시 정보를 기입해주세요.
{% endhint %}
{% endstep %}

{% step %}

### 양식 업로드

토스쇼핑 파트너스에 돌아와서 양식 파일을 업로드 해주세요.

<figure><img src="/files/gQAm8gA1lljeUmffI6jg" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### 검수 요청 및 결과 확인

등록 내역에 들어가서, 업로드된 양식 파일 기준으로 **검수 요청**을 해주세요.

상품 등록에 실패한 건들은 **내역 다운로드**를 통해 확인할 수 있어요. **실패 사유 내역을 다운로드** 받고 상품 정보 수정 후 파일을 다시 업로드할 수 있어요(등록 내역 탭에서 새로운 행으로 보여요).

<figure><img src="/files/VLHG188wiYHNZj662eUX" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}


---

# 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://shopping-docs.toss.im/products/add/bulk_upload.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.
