배송비 정산조회 API

Description

[POST] https://sa2.esmplus.com/account/v1/settle/getsettledeliveryfee

배송비 정산데이터를 조회합니다.

Request Description

항목	항목명	필수여부	Type	Description
SiteType	사이트구분	Y	string	처리하려는 주문번호 사이트구분 선택 A : 옥션 G : G마켓
PackNo	장바구니번호		long	SiteType > "G마켓"일 경우는 장바구니번호 입력 후 조회
DeliveryGroupNo	묶음배송번호		bigint	SiteType > "옥션"일 경우는 묶음배송번호, 장바구니번호 모두 입력 후 조회
SrchType	기간검색 구분	Y	string	D1 : 입금확인일 -정상 D3 : 매출마감일(일반적으로는 배송완료일 익일, 환불건일 경우 차이발생 가능) D6 : 송금일(당일데이터는 영업일 기준 D+1일로 조회가능함) D7 : 환불일 -환불 D8 : 입금확인일(옥션은 입금확인되었으면서 실제 송금이 발생된 주문건 기준)+환불일
SrchStartDate	조회기준 시작일	Y	date	YYYY-MM-DD형태
SrchEndDate	조회기준 종료일	Y	date	YYYY-MM-DD형태
PageNo	페이지번호	Y	int
PageRowCnt	1Page Max	Y	int

JSON
{
  "SiteType": "string",
  "SrchType": "string",
  "SrchStartDate": "2019-04-12T06:56:52.596Z",
  "SrchEndDate": "2019-04-12T06:56:52.596Z",
  "DeliveryGroupNo": 0,
  "PackNo": 0,
  "PageNo": 0,
  "PageRowCnt": 0
}

 

Response Description

항목	항목명	Type	Description
ResultCode	결과	int	성공 : Success 실패 : Error Massage 참고
Message	메시지	stirng
SiteType	사이트구분	string	A : 옥션 G : G마켓
TotalCount	총건수	int	조회된 총 건수
PageSize	페이지사이즈	int
PageNo	페이지번호	int
Data > PackNo	장바구니번호	int	정산데이터에서 장바구니 번호는 PackNo
Data > PayDate	입금확인일	Date	옥션 주문 경우 DelFeeType > 30이면 데이터 내려가지 않고 Default 값 내려감 (0001-01-01T00:00:00) G마켓 주문일 경우 DelFeeType > 70이면 데이터 내려가지 않고 Default 값 내려감 (0001-01-01T00:00:00)
Data > RefundDate	배송비환불일	Date
Data > RemitDate	배송비송금일	Date
Data > RevenueDate	매출마감일	Date
Data > DelFeeAmt	배송비금액	Number
Data > DelFeeCommission	배송비이용료금액	Number
Data > DelFeeNo	배송비결제번호	int
Data > DelFeePayWay	배송비지급수단	string	A : 계좌송금 B : 판매자예치금 S : 스마일캐시
Data > Kind	주문구분	string	1 : 원주문 2 : 환불
Data > DeliveryGroupNo	배송비그룹번호	bigint
Data > DelFeeType	배송비구분	string	10 : 원배송비 20 : 추가배송비 30 : (G)사용한원배송비환불금차감 (A)원배송비(최초배송비)외 추가배송비 등 환불금 금액과 거래완료 후 환불에 따른 배송비 집계 40 : 반품배송비 50 : 추가반품배송비 60 : 무료반품배송비 70 : 교환배송비
Data > RefContrNo	대표주문번호	int	- (G마켓만 제공) 해당 배송비의 대표주문번호 값 내려감 - 배송비 유형에 따라 대표 주문번호가 있는 경우 내려가고 송금일/환불일 기준으로만 조회됨

JSON_Success

{
  "TotalCount": 0,
  "PageSize": 0,
  "PageNo": 0,
  "Data": [
    {
      "PackNo": 0,
      "PayDate": "2019-04-12T06:56:53.160Z",
      "RefundDate": "2019-04-12T06:56:53.160Z",
      "RemitDate": "2019-04-12T06:56:53.161Z",
      "RevenueDate": "2019-04-12T06:56:53.161Z",
      "DelFeeAmt": 0,
      "DelFeeCommission": 0,
      "DelFeeNo": 0,
      "DelFeePayWay": "string",
      "Kind": "string",
      "DeliveryGroupNo": 0,
      "DelFeeType": "string"
      "RefContrNo": 0
    }
  ],
  "SiteType": "string",
  "ResultCode": 0,
  "Message": "string",
  "Details": {}
}

JSON_Fail

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

Sample Code_Success

지마켓
{
   "TotalCount":754,
   "PageSize":0,
   "PageNo":1,
   "Data":[
    {
     "PackNo":4447237256,
     "PayDate":"2019-03-26T12:15:49.18",
     "RefundDate":"0001-01-01T00:00:00",
     "RemitDate":"2019-04-01T00:00:00",
     "RevenueDate": "2019-04-01T06:56:53.161Z",
     "DelFeeAmt":3000.0000,
     "DelFeeCommission": 99.0,
     "DelFeeNo":637928656,
     "DelFeePayWay":"A",
     "Kind":"1",
     "DeliveryGroupNo":731875814,
     "DelFeeType":"10"
     "RefContrNo": 2394099137
    }
  ],
   "SiteType":"G",
   "ResultCode":0,
   "Message":""
}

옥션
{
   "TotalCount":833,
   "PageSize":0,
   "PageNo":4,
   "Data":[
    {
     "PackNo":1184259980,
     "PayDate":"2019-03-09T22:28:00",
     "RefundDate":"2019-04-08T10:04:11",
     "RemitDate":"2019-04-08T10:02:00",
     "RevenueDate": "2019-04-08T06:56:53.161Z",
     "DelFeeAmt":-3000.0,
     "DelFeeCommission": -99.0,
     "DelFeeNo":319392026,
     "DelFeePayWay":"B",
     "Kind":"2",
     "DeliveryGroupNo":905520647,
     "DelFeeType":"10"
     "RefContrNo": 0
    }
],
  "SiteType":"A",
  "ResultCode":0,
  "Message":""
}

Sample Code_Fail

{
  "ResultCode":414,
  "Message":"The request failed bacause code could not be found.",
  "Details":"실행 제한 시간을 초과했습니다. 작업이 완료되기 전에 실행 제한 시간이 지났거나 서버가 응답하지 않습니다."
}

 

Error Code

결과코드	메시지	원인
414	The request failed bacause code could not be found.	당일날짜 또는 미래날짜로 조회 시