발송 정책 관리 API

Description

등록 : [POST] https://sa2.esmplus.com/item/v1/shipping/dispatch-policies 기본 정책 설정 : [POST] https://sa2.esmplus.com/item/v1/shipping/dispatch-policies/{dispatchPolicyNo}/default 정책번호별 별 조회 : [GET] https://sa2.esmplus.com/item/v1/shipping/dispatch-policies/{dispatchPolicyNo} 전체 조회 : [GET] https://sa2.esmplus.com/item/v1/shipping/dispatch-policies

발송 정책은 G마켓/옥션 각각 사이트별로 설정 필요합니다. 발송정책 등록/수정시에는 양사이트 ID 입력된 토큰 아닌 사이트별 ID 만 들어간 토큰으로 호출되어야 합니다. 동시 등록/수정시 사이트별로 동일 정책번호를 상품 등록/수정시 입력되어야 합니다. 발송정책 가이드 보기

Request Description

항목	항목명	필수여부	Type	Description
dispatchPolicyNo	발송타입정책 조회	Y	Path	기본 정책 설정 및 정책별 조회시 필수
dispatchType	발송정책타입	Y	string	A : 당일배송 B : 순차발송 C : 해외발송 D : 요청일 발송 E : 주문제작 발송 F : 발송일 미정
readyDurationDay	배송준비소요일	Y	int	- 타입 : B 경우 2 ~ 4 입력 가능 - 타입 : E 경우 10 입력 가능 - 타입 : C 경우 2 입력 가능
dispatchCloseTime	발송마감시간	Y	string	- 00:00 (시:분) 형태로 연동 - 타입 : A 경우 11 ~ 18시 연동 가능 - 타입 : B, E 경우 00:00 고정

JSON
등록/수정
{
  "dispatchType": "string",
  "readyDurationDay": 0,
  "dispatchCloseTime": "string"
}

기본설정 - URL만 호출 / Request Body 없음
https://sa2.esmplus.com/item/v1/shipping/dispatch-policies/291734/default

조회 - URL만 호출 / Request Body 없음
https://sa2.esmplus.com/item/v1/shipping/dispatch-policies/291734

dispatchType	발송정책명	노출문구	등록 규칙
A	당일배송	OO시 OO분 이전 주문 시 오늘 출발 예정	dispatchCloseTime (발송마감 시간) 필수 입력 11:00 ~ 18:00 시간 단위 입력 가능
B	순차발송	OO 출발 예정	readyDurationDay (배송준비소요일) 필수 입력 2 ~ 4 사이 입력 가능
C	해외발송	해외배송 상품	readyDurationDay (배송준비소요일) 필수 입력 2 입력 가능
D	요청일발송	수령일 선택	필수 설정 값 없음
E	주문제작발송	주문제작 상품	- readyDurationDay (배송준비소요일) 필수 입력 - 10 입력 가능
F	발송일미정	출발일 확인 불가	- 필수 설정 값 없음 - 발송마감일 +30일로 자동 계산

 

Response Description

항목	항목명	Type	Description
resultCode	결과코드	int	실패 시 내려가는 정보
message	메시지	string	실패 시 내려가는 정보
dispatchPolicyNo	발송정책번호	int	조회 시 내려가는 정보

JSON_Success

등록/수정
{
  "dispatchPolicyNo":0
}

조회
{
  "dispatchPolicies": [
    {
      "dispatchPolicyNo": 0,
      "dispatchPolicyName": "string",
      "dispatchType": "string",
      "readyDurationDay": 0,
      "dispatchCloseTime": "string",
      "isDefault": true
    }
  ]
}

JSON_Fail

{
   "resultCode": int,
   "message": "string"
}

Sample Code_Success

등록/수정
{
  "dispatchPolicyNo":910
}

조회
{
   "dispatchPolicies":
  [
    {
      "dispatchPolicyNo":910,
      "dispatchPolicyName":"당일발송",
      "dispatchType":"A",
      "readyDurationDay":0,
      "dispatchCloseTime":"23:30",
      "isDefault":true
    }
   ]
}

Sample Code_Fail

{
    "resultCode": 1000,
    "message": "[001000] [F001000]동일한 발송 정책이 있습니다."
}

Error Code

결과코드	메시지	원인
3000	요청 중 에러가 발생했습니다.\r\n동일한 발송정책이 있습니다	동일한 발송정책이 있을 경우
1000	순차발송은 발송마감시간 설정이 불가능합니다.	B Type인데 발송마감시간 설정했을 경우
1000	[001000] [A001000]정책코드를 확인해 주세요	발송정책번호 오류이거나 없는 번호일 경우
1000	정책코드를 확인해 주세요	등록되지 않은 정책코드를 조회하려는 경우
1000	순차발송은 발송마감시간 설정이 불가능합니다.	순차 발송인데 마감시간을 설정하려는 경우
1000	[001000] [Z001000]저장에 실패하였습니다. 9999 IAC 코어 미등록	dispatchCloseTime을 ""값을 넣었을 때 발생