2026.03.03 배송 정책 변경 Phase 1

2026.03.03 대고객 배포되는 배송 정책 변경에 따른 API 변경 사항입니다.

최초 공지 시 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

구분	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
택배사 조회 (신규)	GET, request parameter 없음 하단에 응답 json 첨부	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 하위)

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

✅ 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)

---

✅ [신규] 택배사 목록 조회

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