판매자 스타배송 출하지 스케쥴 관리 API

Description

수정 [PUT] https://sa2.esmplus.com/item/v1/starship/places/{placeNo}/custom-schedule 조회 [GET] https://sa2.esmplus.com/item/v1/starship/places/{placeNo}/custom-schedule/{month}

판매자 스타배송 출하지 스케쥴 관리하는 API 입니다. 출하지 기준 일별 마감시간, 휴일 여부를 설정 및 조회 가능 합니다. 기본 설정이 아닌 일별 변경 필요한 경우 최대 2개월 (수정일 기준 +1개월 말일) 까지 스케쥴을 설정할 수 있습니다. (2025년 11월 12일 부터 사용 가능)

Request Description

항목	항목명	필수여부	Type	Description
placeNo	출하지번호	Y	path
month	월		path	조회 [GET] 경우 필수
customSchedules	[]
customSchedules  > date	일자	Y	string	YYYY-MM-DD 형태로 입력 가능 수정일 기준 다음달말까지 입력 가능
customSchedules  > dayOrderClosingTime	주문 마감 시간	Y	string	- hh:mm 형식으로 입력 가능 - 분은 30분 단위로 입력 가능
customSchedules  > isHoliday	휴일여부	Y	boolean

JSON
수정
{
  "customSchedules": [
    {
      "date": "string",
      "dayOrderClosingTime": "string",
      "isHoliday": boolean
    }
  ]
}

조회
- 조회시 해당 월 내 수정한 일자만 조회 됩니다.
- 기본 설정값은 출하지 기준으로 확인 가능 합니다.
[GET] https://sa2.esmplus.com/item/v1/starship/places/194411/custom-schedule/11

Response Description

항목	항목명	필수여부	Type	Description
placeNo	출하지번호		int
customSchedules	[]
customSchedules  > date	일자		string
customSchedules  > dayOrderClosingTime	주문 마감 시간		string
customSchedules  > isHoliday	휴일여부		boolean

JSON_Success

수정
{
  "placeNo": int
}

조회
{
  "customSchedules": [
    {
      "date": "string",
      "dayOrderClosingTime": "string",
      "isHoliday": boolean
    }
  ]
}

JSON_Fail

{
  "ResultCode": 0,
  "Message": "string",
  "Data": {}
}

Sample Code_Success

수정
{
    "placeNo": 194412
}

조회
{
    "customSchedules": [
        {
            "date": "2025-09-22",
            "dayOrderClosingTime": "20:00",
            "isHoliday": false
        },
        {
            "date": "2025-09-23",
            "dayOrderClosingTime": "20:00",
            "isHoliday": true
        }
    ]
}

조회 - 수정된 스케쥴이 없는 경우
{
    "customSchedules": []
}

Sample Code_Fail

{
    "resultCode": 1000,
    "message": "출하지 번호 19441는 스타배송 전용이 아닙니다.",
    "data": null
}