안녕하세요. 카카오톡 스토어입니다.
톡스토어에서 오늘출발 상품 관련 내용을 등록, 확인할 수 있는 기능을 제공하게 되어 안내드립니다.
적용 예정일 : 2026년 1월 12일 (월)
적용 내용 : 하단 영역별 상세 기술
적용 대상 :
- 오늘출발 상품 등록/수정 기능 : 톡스토어 Only
- 출고 마감시간 등록/수정/조회: 톡스토어, 선물하기 공통
- 판매자 휴무일 조회/등록/삭제 : 톡스토어, 선물하기 공통
- 주문정보 조회 시 발송예정일 타입/날짜 조회 : 톡스토어, 선물하기 공통
톡스토어 상품 등록/수정
- 상품 등록/수정 시, 오늘출발 설정을 위한 ‘배송유형’ 관련 정보가 추가되었습니다.
- 오늘출발 설정을 위해서는 상품의 출고지 기준의 출고 마감시간이 사전에 입력되어 있어야 합니다.
1) 대상 API
- 상품등록/수정 API : POST /v1/store/product/register?product={}, POST /v1/store/product/update?product={}
- 상품조회 API : GET /v1/store/product?productId={productId}
2) 상품 Delivery 정보로 ‘배송유형’ 추가
- Delivery > 'scheduleType' 컬럼 추가
- ‘필수 배송방법=택배배송 or 직접배송’인 경우에 한하여, 배송유형 설정이 필수입니다.
| 키 | 타입 | 필수여부 | 설명 |
|---|---|---|---|
| scheduleType | DeliveryScheduleType | 필수 | 일반배송인 경우 "NORMAL", 오늘출발인 경우 "TODAY_DEPARTURE" |
3) Option 정보로 '오늘출발 가능 일부옵션 설정' 추가
- Option > 'deliveryScheduledPerOption' 컬럼 추가
- 위의 ‘1) 배송유형(scheduleType)을 오늘출발(TODAY_DEPARTURE)로 설정한 경우에 한하여 조합형 옵션이고 & 일부 옵션만 오늘출발이 가능한 경우에만 “true”로 설정해 주시고, 모든 옵션이 오늘출발 가능한 경우에는 “false”로 설정해 주세요.
| 키 | 타입 | 필수여부 | 설명 |
|---|---|---|---|
| deliveryScheduledPerOption | Boolean | 필수 |
조합형 옵션이면서 일부 옵션만 오늘출발 가능여부 설정이 필요한 경우 “true”, 그 외 “false” |
4) Combination 정보로 '오늘출발 가능옵션' 설정 추가
- Combination > 'deliveryScheduleType' 컬럼 추가
- 위의 ‘3) 오늘출발 가능 일부옵션 설정(deliveryScheduledPerOption)’ 값을 설정한 경우에 한하여, 개별 옵션별로 오늘출발 가능옵션 여부를 설정할 수 있습니다.
| 키 | 타입 | 필수여부 | 설명 |
|---|---|---|---|
| deliveryScheduleType | DeliveryScheduleType | 선택 | 일반배송인 경우, "NORMAL", 오늘출발인 경우 "TODAY_DEPARTURE" |
출고마감시간 조회/등록/수정
- 국내 주소록 내 출고마감시간 “cutoffTime” 필드가 추가 되었습니다.
- 국내 주소록 등록 및 수정 시, 출고마감시간을 조회/등록/수정할 수 있습니다.
1) 대상 API
- 국내주소록 조회 API : GET /v1/shopping/bizseller/seller-addresses/search
- 국내주소록 등록 API : POST /v1/shopping/bizseller/seller-addresses/register
-
국내주소록 수정 API : PUT /v1/shopping/bizseller/seller-addresses/modify
2) ‘출고마감시간’ 추가
| 구분 | 필드명 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|---|
| 조회 | cutoffTime | String | 비필수 | 국내 주소록 조회 API 응답값 추가. (예시 : "cutoffTime":"13:00") |
| 등록 | 출고마감시간 "13:00" 와 같은 값으로 설정. (00분 or 30분 단위만 설정 가능) |
|||
| 수정 |
[신규 API] 판매자 휴무일 조회/등록/삭제
- 판매자 휴무일 API 가 신규 추가되었습니다.
- 판매채널 별로 판매자 휴무일을 조회/등록/삭제할 수 있습니다.
1) 대상 API
- 판매자 휴무일 조회 API : GET /v1/shopping/bizseller/seller-shipping/off-days/list
- 판매자 휴무일 등록 API : POST /v1/shopping/bizseller/seller-shipping/off-days
- 판매자 휴무일 삭제 API : DELETE /v1/shopping/bizseller/seller-shipping/off-days
- 판매자 휴무일 전체삭제 API : DELETE /v1/shopping/bizseller/seller-shipping/off-days/all
2) 요청 (파라미터)
| 구분 | 필드명 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|---|
|
조회 |
from | String | 필수 | 휴무일 조회 시작일 (과거 1년까지 조회 가능) |
| to | String | 필수 | 휴무일 조회 종료일 (최대 1년 범위로 조회 가능) | |
| page | int | 필수 | 페이지 번호 (기본값: 0), 페이지당 100건 리턴 | |
| 등록 | offDays | Set<String> | 필수 | 등록할 배송 휴무일을 SET, yyyyMMdd 포맷으로 입력. (예시 : "20251028") |
| 삭제 | offDays | Set<String> | 필수 | 삭제할 배송 휴무일을 SET, yyyyMMdd 포맷으로 입력. (예시 : "20251028") |
3) 응답
| 구분 | 필드명 | 타입 | 설명 |
|---|---|---|---|
|
조회 |
contents | List<Content> | 판매자 휴무일 목록 |
| last | boolean | 마지막 페이지 여부 (true/false) | |
| totalCount | long | 총 페이지 수 | |
| 등록 | - | - | 없음 (성공 시 HttpStatus 200 응답) |
| 삭제 | - | - | 없음 (성공 시 HttpStatus 200 응답) |
주문정보 조회
- ‘발송예정일’ 유형(예약상품, 발송일옵션, 오늘출발) 과 날짜를 조회할 수 있습니다.
- 톡스토어 : 예약상품, 발송일옵션, 오늘출발 주문인 경우 / 선물하기 : 예약상품 주문인 경우 확인하실 수 있습니다.
1) 대상 API
- 주문 정보 조회 API : GET /v1/shopping/order?order_id={order_id}
- 주문 정보 복수 조회 API : GET /v1/shopping/orders/bulk?order_ids={order_ids}
2) 배송정보(OrderDelivery)에 ‘발송예정일 타입’, ‘발송예정일 날짜’ 추가
- 202 배송요청 이후 주문에 대한 발송예정일 타입/ 발송예정일 날짜 값입니다.
- 발송예정일 타입 3개 중 한 개가 scheduledType 으로 리턴됩니다. 일반 배송 상품인 경우 scheduledType 과 scheduledAt 값이 없을 수 있습니다.
- 예약일이 설정되지 않은 예약상품인 경우 scheduledType 값만 있고, scheduledAt 값은 존재하지 않을 수 있습니다.
| 필드명 | 타입 | 설명 |
|---|---|---|
| scheduledType | string | 발송예정일 타입 : 예약상품, 발송일옵션, 오늘출발 중 1 |
| scheduledAt | DateTime | 발송예정일 날짜: yyyyMMddHHmmss |
관련하여 더 궁금하신 점이 있을 경우, http://kko.to/G5xpSFS4j 을 통해 문의 부탁드립니다.
감사합니다.