# 2026.04.04 희망일 배송/착불 배송 추가 4월 20일부터 상품 등록·수정·조회 API에 희망일 배송 및 착불배송 관련 필드가 추가됩니다. 희망일 배송은 구매자가 원하는 날짜에 배송받을 수 있도록 배송 가능 기간을 설정하는 기능이며, 착불배송은 배송비를 구매자가 수령 시 직접 결제하는 배송 방식입니다. ## 1. 희망일 배송 ### 변경되는 API 다음 세 가지 API에 배송 타입, 희망일배송방법, 배송 가능 일자 필드가 추가됩니다. * 상품 등록: `POST /api/v3/shopping-fep/products/v2` * 상품 수정: `PUT /api/v3/shopping-fep/products/{productId}/v2` * 상품 조회: `GET /api/v3/shopping-fep/products/{productId}/v2` 희망일 배송을 사용하려면 `deliveryType`을 `PREFERRED_DATE`로 설정해주시기 바랍니다. ### 희망일 배송 기간 설정 방식 두 가지 방식 중 하나를 선택할 수 있습니다. 방식별로 사용하는 필드가 배타적이므로, 해당하지 않는 필드를 함께 보내면 오류가 발생합니다. 하기 필수 값들은 `deliveryType` 이 `PREFERRED_DATE` 일 때 필수로 들어갑니다. #### 방식 1. 주문일 기준 (`preferredDateType: ORDER_DATE`) 주문한 날로부터 N일 뒤 \~ M일까지 선택 가능한 기간을 지정합니다. | 필드 | 타입 | 필수 | 설명 | 제약 | | --------------------- | ------ | -- | --------------- | ------------------- | | preferredDateType | String | O | ORDER\_DATE 고정 | | | preferredDateFromDays | Int | O | 선택 시작일 (주문일+N일) | 1\~30 | | preferredDateToDays | Int | O | 선택 종료일 (주문일+M일) | 30\~90, fromDays 이상 | | preferredDateFromDate | - | X | 사용 불가 (입력 시 에러) | | | preferredDateToDate | - | X | 사용 불가 (입력 시 에러) | | 예시: `fromDays: 3`, `toDays: 30` → 주문일로부터 3일 뒤 \~ 30일까지 선택 가능 #### 방식 2. 캘린더 기준 (`preferredDateType: CALENDAR`) 절대 날짜로 선택 가능 기간을 고정합니다. | 필드 | 타입 | 필수 | 설명 | 제약 | | --------------------- | --------- | -- | --------------- | ---------------------- | | preferredDateType | String | O | CALENDAR 고정 | | | preferredDateFromDate | LocalDate | O | 선택 시작 날짜 | 오늘 이후, 오늘+30일 이내 | | preferredDateToDate | LocalDate | O | 선택 종료 날짜 | 오늘+90일 이내, fromDate 이후 | | preferredDateFromDays | - | X | 사용 불가 (입력 시 에러) | | | preferredDateToDays | - | X | 사용 불가 (입력 시 에러) | | 예시: `fromDate: 2026-04-20`, `toDate: 2026-05-20` → 4/20\~5/20 중 선택 가능 ### 알아두실 점 * 희망일 배송 상품은 배송비 묶음이 불가합니다. 상품 등록·수정 시 묶음배송으로 설정하면 오류가 발생합니다. * 희망일 배송만 별도로 설정하는 API는 없습니다. 상품 수정 API를 통해 함께 전달해주시기 바랍니다. * 캘린더 기준으로 기간을 설정한 경우, 기간이 만료되면 상품이 자동 미노출 처리되고 상태가 \[확인필요]로 바뀝니다. 기간을 다시 설정하면 \[판매중]으로 복귀됩니다. *** ## 2. 착불 배송 같은 날짜에 착불배송 관련 필드도 함께 추가됩니다. 착불배송은 배송비를 구매자가 수령 시 직접 결제하는 방식으로, 배송 템플릿의 배송비 타입을 착불로 설정하면 사용할 수 있습니다. ### 변경되는 API 희망일 배송과 동일한 세 가지 API에 착불배송 관련 필드가 추가됩니다. * 상품 등록: `POST /api/v3/shopping-fep/products/v2` * 상품 수정: `PUT /api/v3/shopping-fep/products/{productId}/v2` * 상품 조회: `GET /api/v3/shopping-fep/products/{productId}/v2` 착불배송을 사용하려면 배송 템플릿의 배송비 타입을 착불로 설정해주시기 바랍니다. ### 착불배송 관련 필드 | 필드 | 타입 | 필수 | 설명 | 비고 | | ----------------------- | ------- | -- | --------------------- | ----------------------------------- | | deliveryFeeType | String | O | 배송비 타입, 기존에 존재하던 필드 | 착불배송 시 `COLLECT_ON_DELIVERY`로 설정 | | canLongDistanceDelivery | Boolean | X | 제주 및 도서산간 지역 배송 가능 여부 | true: 추가 배송비 받고 배송 가능, false: 배송 불가 | ### 알아두실 점 * 착불배송 상품은 묶음배송이 불가합니다. 상품 등록·수정 시 묶음배송으로 설정하면 오류가 발생합니다. * 착불배송에서는 기본 배송비 기준 금액만 구매자에게 노출됩니다. 지역별 배송비가 따로 존재하는 경우, 상세페이지에 안내 문구를 통해 고지됩니다. * 배송 환경에 따라 추가 요금이 발생할 수 있습니다 (사다리차 여부, 철거 및 설치 등). 문의가 있으면 토스쇼핑 파트너스 고객센터로 연락해주세요. 감사합니다. --- # Agent Instructions: 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: ``` GET https://shopping-docs.toss.im/dev/api-1/2026.04.04.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.