# 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
    }
  ]
}
```