truck-moving2026.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. 대상 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

[신규 추가]

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)


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

마지막 업데이트

도움이 되었나요?