# 상품 일괄 수정하기

상품 목록을 엑셀로 다운로드 받은 뒤, 수정하여 업로드하면 한번에 반영됩니다.

### 전체 흐름

> **상품 목록 다운로드** → **엑셀 파일 수정** → **수정된 파일 업로드** → **수정 결과 확인**

***

### 1. 상품 목록 다운로드

상품 목록 페이지에서 **"상품 목록 다운로드"** 버튼을 클릭하면 엑셀 파일 생성이 시작됩니다.

{% hint style="info" %}
다운로드가 오래 걸리면 예상 소요시간 안내 배너가 뜹니다. **화면을 나가 있어도** 파일 생성은 계속 진행됩니다. 예상 소요시간은 정확하지 않을 수 있습니다.
{% endhint %}

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

다운로드가 완료되면 **"이곳"** 을 클릭하여 파일을 받을 수 있습니다.

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

#### 다운로드 파일 안내

| 항목     | 내용                                                                         |
| ------ | -------------------------------------------------------------------------- |
| 파일 형식  | xlsx (엑셀) 파일. 상품 수가 많으면 **zip** 파일로 여러 개가 나뉘어 다운로드됩니다.                     |
| 파일명 규칙 | `날짜시간_상점ID_일괄수정_상품목록_1.xlsx` (예: 202604071440\_209073\_일괄수정\_상품목록\_1.xlsx) |
| 재다운로드  | 다운로드 팝업에서 **1주일간** 재다운로드 가능합니다.                                            |

#### 다운로드 상태 안내

| 상태   |                                     |
| ---- | ----------------------------------- |
| 생성 중 | 서버에서 엑셀 파일을 생성하고 있습니다. 화면을 나가도 됩니다. |
| 완료   | "여기" 링크를 클릭하면 다운로드됩니다.              |
| 실패   | 재시도 버튼을 눌러 다시 시도해 주세요.              |

{% hint style="danger" %}
**주의사항**

* zip 파일인 경우: 압축 해제 후 **모든 파일을 수정하여 전부 업로드**해야 합니다.
* 엑셀의 **행(row)을 임의로 추가/삭제하지 마세요.**
* 다운로드된 파일은 **다운로드 시점의 상품 정보**입니다. 한 번 수정 후에는 반드시 **새로 다운로드** 받아 사용하세요.&#x20;
  {% endhint %}

***

### 2. 엑셀 파일 수정

다운로드한 엑셀 파일에서 수정이 필요한 항목의 값을 변경합니다.

{% hint style="info" %}
**주의사항**

* 수정하지 않을 항목은 **그대로 두면** 됩니다. (변경된 항목만 반영)
* 첫 번째 행(헤더)은 **수정하지 마세요.**
* 행을 **추가하거나 삭제하지 마세요.**&#x20;
  {% endhint %}

***

### 3. 파일 업로드

수정한 엑셀 파일을 업로드 영역에 **드래그 앤 드롭** 하거나 **파일 선택** 으로 업로드합니다.

파일 여러 개를 한 번에 업로드할 수 있습니다.

> 수정이 오래 걸리면 예상 소요시간이 표시됩니다. **화면을 나가도** 처리는 계속 진행됩니다. 예상 소요시간은 정확하지 않을 수 있습니다.

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

#### 업로드 결과 확인

수정이 완료되면 등록내역 탭에서 결과를 확인할 수 있습니다.

| 결과    | 표시 내용                       |
| ----- | --------------------------- |
| 성공    | "수정 완료 : nn건"               |
| 일부 실패 | "수정 완료 : nn건 / 수정 실패 : mm건" |

{% hint style="warning" %}
수정 실패한 건이 있는 경우, 실패 사유를 확인하고 해당 항목만 수정하여 다시 업로드해 주세요.
{% endhint %}

***

### 4. 자주 묻는 질문

* **다운로드 중 페이지를 닫아도 되나요?**

  네, 화면을 닫거나 다른 페이지로 이동해도 됩니다. 다시 돌아오면 자동으로 진행 상태가 복구됩니다.
* **zip 파일이 다운로드되었는데, 일부 파일만 수정해서 올려도 되나요?**

  아니요. 모든 파일을 수정하여 전부 업로드해야 합니다.
* **다운로드 링크가 만료되었다고 나옵니다.**

  다운로드 파일은 1주일간만 유효합니다. 만료된 경우 새로 "상품 목록 다운로드"를 해주세요.
* **업로드 후 바로 반영되나요?**

  업로드 후 서버에서 처리하는 시간이 필요합니다. 등록내역 탭에서 처리 상태(진행 중 / 완료 / 실패)를 확인할 수 있습니다.


---

# Agent Instructions: 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/edit/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.