> 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/dev/api-1/2026.03.03-phase-1.md).

# 2026.03.03 배송 정책 변경 Phase 1

최초 공지 시 2/23까지 대응 요청드렸으나, 대고객 오픈되는 3/3 전까지 적용해주시면 됩니다.

## \[정책 변경] 토스쇼핑파트너스 상품 배송 설정 변경 및 정책 안내

#### 1. 배송 유형별 설정 및 페널티 정책 안내

배송 정보 입력 시 **\[오늘출고]** 적용 여부에 따라 입력 값과 준수 사항이 달라집니다.

**A. '오늘출고' 설정 시**

구매자에게 "오늘 출발"을 약속합니다.

* **마감시간 선택:** **10:00 \~ 23:00** 사이에서 **30분 단위**로 자유롭게 설정 가능 (예: 15:30, 20:00)
* 설정한 마감시간 이전에 들어온 주문은 반드시 당일 발송해야 합니다.

**B. '오늘출고' 미적용 시 (일반 출고)**

당일 발송이 힘든 경우, 상품 준비에 걸리는 기간(상품 출고 소요일)을 정확히 입력해야 합니다.

* **입력 값:** 결제일 기준 며칠 내 출고 가능한지 숫자 입력 (예: 1일⇒1, 3일⇒3)
* **⚠️ 주의사항:** 입력하신 **상품 출고 소요 일을 초과하여 발송할 경우 페널티가 부과**됩니다.

> **📢 관련 정책 필독** 변경된 배송 설정을 정확히 입력하지 않거나 출고 기한을 어길 시 불이익이 발생할 수 있습니다. 아래 공지를 꼭 참고해주세요.
>
> * **\[필독1] 토스쇼핑파트너스 페널티 정책 공지** 👉 <https://shopping-seller.toss.im/docs/44863>
> * **\[필독2] 배송 품질 개선 정책 변경안** 👉 <https://shopping-seller.toss.im/docs/44895>

***

## \[개발 가이드] 배송 정보 필드 변경 상세

#### 1. 대상 API&#x20;

| 구분              | Method                                                          | Endpoint (현행 유지)                                                                               |
| --------------- | --------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| **상품 등록**       | `POST`                                                          | `https://shopping-fep.toss.im/api/v3/shopping-fep/products/v2`                                 |
| **상품 수정**       | `PUT`                                                           | `https://shopping-fep.toss.im/api/v3/shopping-fep/products/{productId}/v2`                     |
| **상품 조회**       | `GET`                                                           | `https://shopping-fep.toss.im/api-public/v3/shopping-fep/{sellerType}/products/{productId}/v2` |
| **택배사 조회 (신규)** | <p><code>GET</code>, request parameter 없음<br>하단에 응답 json 첨부</p> | `https://shopping-fep.toss.im/api-public/v3/shopping-fep/{sellerType}/delivery-companies`      |

***

#### 2. 필드(Parameter) 변경 상세

#### 2-1.  `product` 레벨의 `deliveryPolicy` 내 필드 추가/변경

* `deliveryCompanyId` : 택배사 ID 추가 (택배사 조회 API 통해 입력)
* `deliveryDeadline` : 당일 발송 마감 시간 (입력 포맷 변경 : `"HH:mm"`,30분 단위 / 예: `"15:00"`)
  * deliveryMethod \[TODAY\_DELIVERY]일 때 필수
* `preparationDays` : 발송 준비 기간 추가 (입력 포맷: Integer, 예: `3`)
  * deliveryMethod  \[NOMARL]일 때 필수

#### 2-2. 주요 필드 스펙 (dedeliveryPolicy 하위)

<table><thead><tr><th width="213.02734375">필드명</th><th width="114.50390625">타입</th><th width="72.19921875">필수</th><th>설명 및 변경점</th></tr></thead><tbody><tr><td><strong>deliveryType</strong></td><td><code>String</code> (Enum)</td><td>O</td><td><p><strong>[신규 추가]</strong> </p><pre><code>NORMAL 일반 배송
NO_DELIVERY 배송 없음
DIRECT_DELIVERY 직접 배송
</code></pre></td></tr><tr><td> ✅ <strong>deliveryDeadline</strong></td><td><code>String</code></td><td>△</td><td><p><strong>[변경]</strong> </p><p><strong>오늘 출발 배송 설정 시 필수</strong><br>당일 발송 마감 시간 (입력 포맷 변경 : <code>"HH:mm"</code>,30분 단위, 10:00~23:00 설정 가능/ 예: <code>"15:00"</code>)</p></td></tr><tr><td>✅ <strong>preparationDays</strong></td><td><code>Integer</code></td><td>△</td><td><p></p><p><strong>[변경]</strong> </p><p><strong>오늘 출고 미적용 시(</strong>= <strong>일반 배송 설정 시) 필수</strong></p><p><strong>기등록된 상품의 경우, default값 3 적용, 최대 14일)</strong></p><p></p></td></tr><tr><td><strong>deliveryCompanyId</strong></td><td><code>Integer</code></td><td>O</td><td><strong>[신규 추가]</strong> 택배사 조회 API 결과 사용</td></tr></tbody></table>

✅ **deliveryDeadline**

* 조건: 오늘 출 설정 시, deliveryCutoffTime 필수
* 포맷: **`HH:mm`** (24시간제, 30분 단위)
* 범위: `10:00` \~ `23:00`
* *예: "15:30", "23:00" (기존 "12시" 불가)*

✅ **preparationDays**

* 조건: 오늘 출고 미적용 시, preparationDays 필수, (`NORMAL`) 입력
* 포맷 : `Integer`
* 내용: 출고 소요 영업일 (예: `1`, `3`)
  * 기존 등록된 상품,옵션은 default 3일(=이용 약관 상 페널티 받지 않는 최대 기한)로 마이그레이션 완료
* *주의: 설정일 초과 시 페널티 부과* |

#### 2-3. 택배사 정보 (신규 필수)

* **deliveryCompanyId** (Integer): 상품 등록/수정 시 사용할 택배사 ID를 필수로 입력해야 합니다. (별도 조회 API 제공 `/api-public/v3/shopping-fep/{sellerType}/delivery-companies`)

***

#### ✅ \[신규] 택배사 목록 조회&#x20;

```json
{
  "resultType": "SUCCESS",
  "error": {
    "errorType": 0,
    "errorCode": "string",
    "reason": "string",
    "data": {
      "additionalProp1": {},
      "additionalProp2": {},
      "additionalProp3": {}
    },
    "title": "string"
  },
  "success": [
    {
      "id": 1,
      "name": "CJ대한통운",
      "code": "04",
      "isEnabled": true
    }
  ]
}
```


---

# 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, and the optional `goal` query parameter:

```
GET https://shopping-docs.toss.im/dev/api-1/2026.03.03-phase-1.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.