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)

[신규 추가]

NORMAL 일반 배송
NO_DELIVERY 배송 없음
DIRECT_DELIVERY 직접 배송

✅ deliveryDeadline

String

△

[변경]

오늘 출발 배송 설정 시 필수 당일 발송 마감 시간 (입력 포맷 변경 : "HH:mm",30분 단위, 10:00~23:00 설정 가능/ 예: "15:00")

✅ preparationDays

Integer

△

[변경]

오늘 출고 미적용 시(= 일반 배송 설정 시) 필수

기등록된 상품의 경우, default값 3 적용, 최대 14일)

deliveryCompanyId