입금확인중 주문조회 API

Description

[POST] https://sa2.esmplus.com/shipping/v1/Order/PreRequestOrders

고객이 무통장 입금으로 결제한 주문 조회하는 API입니다. 무통장 입금 완료 시에는 주문조회 API에서 신규주문 상태로 조회됩니다. 입금되지 않아 취소된 주문은 클레임API > 취소조회 API에서 조회됩니다.

 

Request Description

항목	항목명	필수여부	Type	Description
siteType	사이트 구분	Y	int	1 : 옥션 2 : G마켓
requestDateFrom	조회기준 시작일	Y	date	- 오늘 날짜 조회시 오늘 ~ 내일 기간 조회 - YYYY-MM-DD hh:mm 로 분단위 조회 가능 - 31일 이내 조회 가능
requestDateTo	조회기준 종료일	Y	date	- 오늘 날짜 조회시 오늘 ~ 내일 기간 조회 - YYYY-MM-DD hh:mm 로 분단위 조회 가능 - 31일 이내 조회 가능
orderNo	주문번호		long	주문번호로 조회 시 필수
branchCode	지점코드		int	당일배송 경우 지점별 주문 조회시 필수
pageIndex	Response PageNo		int
pageSize	Response PageSize		int

JSON
    {
      "siteType": int,
      "requestDateFrom":"string",
      "requestDateTo":"string",
      "branchCode": int,
      "pageIndex": int,
      "pageSize": int
    }

 

Response Description

항목	항목명	Type	Description
ResultCode	결과코드	int	성공 : 0 실패 : Error Massage 참고
Message	메시지	string
data > SiteType	사이트구분	int	1 : 옥션 2 : G마켓
data > PageIndex	Response PageNo	int	조회시 입력한 PageNo
data > PageSize	Response PageSize	int	조회시 입력한 PageSize
data > TotalCount	전체대상건수	int	조회 조건 전체 건수
data > SellerId	판매자ID	string
data > RequestOrders > PayNo	장바구니번호	int	장바구니번호(결제번호)
data > RequestOrders > GroupNo	묶음배송비정책번호	bigint	- 묶음배송비 정책번호(배송번호) - 옥션만 확인 가능, 지마켓은 결제 이후 확인 가능
data > RequestOrders > OrderNo	주문번호	int
data > RequestOrders > BranchCode	지점코드	int
data > RequestOrders > OrderDate	주문일자	date	주문일자 (결제 전)
data > RequestOrders > GoodsNo	ESM상품번호	string	(추후 적용예정) 현재 null 로만 확인 가능
data > RequestOrders > SiteGoodsNo	사이트상품번호	string	G마켓 or 옥션 상품번호
data > RequestOrders > OutGoodsNo	판매자관리코드	string	판매자관리코드(판매자상품번호) 해당 주문 상품 등록 시 판매자가 입력했던 관리코드
data > RequestOrders > GoodsName	상품명	string
data > RequestOrders > SalePrice	판매단가	string	주문 시점 연동된 판매가
data > RequestOrders > ContrAmount	주문수량	int
data > RequestOrders > OrderAmount	판매금액	string	- G마켓 : (판매단가 * 수량) - 옥션 : (판매단가 * 수량) - 사이트 할인금액
data > RequestOrders > AcntMoney	결제예정금액	string	- (판매단가 * 수량) + 옵션가 - 판매자 할인금액 총액 - 판매자 지급 스마일캐시 - 사이트 할인금액 + 배송비 - G마켓은 장바구니 내 1개의 주문번호에만 배송비 Sum 내려감 - 옥션은 장바구니 내 모든 주문번호에 배송비 Sum으로 내려감
data > RequestOrders > SellerDiscountPrice1	판매자할인금액1	string	판매자할인금액 1과 2로 나누어서 연동한 1번 적용된 할인금액
data > RequestOrders > SellerDiscountPrice2	판매자할인금액2	string	판매자할인금액 1과 2로 나누어서 연동한 2번 적용된 할인금액
data > RequestOrders > SellerDiscountPrice	판매자할인금액총액	string	판매자할인금액 1+2로 적용된 최종 금액
data > RequestOrders > DirectDiscountPrice	사이트별 할인금액총액	string	사이트에서 할인 지원하는 금액
data > RequestOrders > ShippingFee	배송비	string
data > RequestOrders > OptSelPrice	옵션추가금액	string	옵션단가 * 수량
data > RequestOrders > OptAddPrice	추가구성추가금액	string	옵션단가 * 수량
data > RequestOrders > BuyerName	구매자명	string
data > RequestOrders > BuyerId	구매자ID	string	앞 3자리 외 마스킹처리
data > RequestOrders > BuyerMobileTel	구매자휴대폰번호	string	안심번호 설정 구매 경우 안심번호 생성 때 까지 내려가지 않음 ※ G마켓은 결제 완료 후 안심번호 생성되어 무통장입금 주문 경우 고객의 연락처는 null 로만 확인가능
data > RequestOrders > BuyerTel	구매자전화번호	string	안심번호 설정 구매 경우 안심번호 생성 때 까지 내려가지 않음 ※ G마켓은 결제 완료 후 안심번호 생성되어 무통장입금 주문 경우 고객의 연락처는 null 로만 확인가능
data > RequestOrders > ReceiverName	수령인명	string
data > RequestOrders > HpNo	수령인휴대폰번호	string	안심번호 설정 구매 경우 안심번호 생성 때 까지 내려가지 않음 ※ G마켓은 결제 완료 후 안심번호 생성되어 무통장입금 주문 경우 고객의 연락처는 null 로만 확인가능
data > RequestOrders > TelNo	수령인전화번호	string	안심번호 설정 구매 경우 안심번호 생성 때 까지 내려가지 않음 ※ G마켓은 결제 완료 후 안심번호 생성되어 무통장입금 주문 경우 고객의 연락처는 null 로만 확인가능
data > RequestOrders > ZipCode	우편번호	string
data > RequestOrders > DelFrontAddress	수령인주소1	string	우편 번호 기준주소
data > RequestOrders > DelBackAddress	수령인주소2	string	상세주소(고객입력)
data > RequestOrders > DelFullAddress	수령인주소1+2	string
data > RequestOrders > DelMemo	배송시요구사항	string
data > RequestOrders > ItemOptionSelectList > ItemOptionValue	주문옵션	string	선택옵션값으로 옵션명:옵션값 (ex-77:파랑, 용량:0.5kg)
data > RequestOrders > ItemOptionSelectList > ItemOptionOrderCnt	주문옵션개수	int
data > RequestOrders > ItemOptionSelectList > ItemOptionCode	주문옵션코드	string
data > RequestOrders > ItemOptionAdditionList > ItemOptionValue	추천구성옵션	string
data > RequestOrders > ItemOptionAdditionList > ItemOptionOrderCnt	추천구성개수	int
data > RequestOrders > ItemOptionAdditionList > ItemOptionCode	추천구성코드	string
data > RequestOrders > DepositDueDate	결제기한	date	주문일 +1일

 JSON_Success

{
  "ResultCode":0,
  "Message":"string",
  "Data":{
    "SiteType":0,
    "PageIndex":0,
    "PageSize":0,
    "TotalCount":0,
    "SellerId":"string",
    "RequestOrders":[
       {
       "PayNo":0,
       "BranchCode":0,
       "GroupNo":0,
       "OrderNo":0,
       "OrderDate":"2019-04-10T04:49:27.144Z",
       "GoodsNo":"string",
       "SiteGoodsNo":"string",
       "OutGoodsNo":"string",
       "GoodsName":"string",
       "SalePrice":"string",
       "ContrAmount":0,
       "OrderAmount":"string",
       "AcntMoney":"string",
       "SellerDiscountPrice1":"string",
       "SellerDiscountPrice2":"string",
       "SellerDiscountPrice":"string",
       "DirectDiscountPrice":"string",
       "ShippingFee":"string",
       "OptSelPrice":"string",
       "OptAddPrice":"string",
       "BuyerName":"string",
       "BuyerId":"string",
       "BuyerMobileTel":"string",
       "BuyerTel":"string",
       "ReceiverName":"string",
       "HpNo":"string",
       "TelNo":"string",
       "ZipCode":"string",
       "DelFrontAddress":"string",
       "DelBackAddress":"string",
       "DelFullAddress":"string",
       "DelMemo":"string",
       "ItemOptionSelectList":[
           {
          "ItemOptionValue":"string",
          "ItemOptionOrderCnt":0,
          "ItemOptionCode":"string"
           }
          ],
       "ItemOptionAdditionList":[
           {
          "ItemOptionValue":"string",
          "ItemOptionOrderCnt":0,
          "ItemOptionCode":"string"
           }
         ],
      "DepositDueDate":"2019-04-10T04:49:27.145Z"
         }
       ]
    }
}

JSON_Fail

{
    "ResultCode": int,
    "Message": "string",
    "Data": null
}

Sample Code_Success

지마켓
{
  "ResultCode":0,
  "Message":"",
  "Data":{
  "SiteType":3,
  "PageIndex":1,
  "PageSize":1000,
  "TotalCount":1,
  "SellerId":"selleridtest",
  "RequestOrders":[
     {
     "PayNo":4453961444,
     "BranchCode":0,
     "GroupNo":766939624,
     "OrderNo":2945838617,
     "OrderDate":"2019-04-10T07:32:31.143",
     "GoodsNo":null,
     "SiteGoodsNo":"1574185776",
     "OutGoodsNo":"20105838",
     "GoodsName":"[전구성 무료체험] 리빙박스 6종 + 정리함 2종",
     "SalePrice":"58800.0000",
     "ContrAmount":1,
     "OrderAmount":"58800.0000",
     "AcntMoney":"51690.0000",
     "SellerDiscountPrice1":"0.0000",
     "SellerDiscountPrice2":"0.0000",
     "SellerDiscountPrice":"0.0000",
     "DirectDiscountPrice":"7110.0000",
     "ShippingFee":"0.0000",
     "OptSelPrice":"0.0000",
     "OptAddPrice":"0.0000",
     "BuyerName":"테스터",
     "BuyerId":"tes***",
     "BuyerMobileTel":"010-1234-5678",
     "BuyerTel":"",
     "ReceiverName":"테스터",
     "HpNo":"010-1234-5670",
     "TelNo":"010-1234-5670",
     "ZipCode":"25929",
     "DelFrontAddress":"강원도 삼척시 남양길 63-24",
     "DelBackAddress":"111호",
     "DelFullAddress":"강원도 삼척시 남양길 63-24",
     "DelMemo":"부재시 문 앞에 놓아주세요 감사합니다",
     "ItemOptionSelectList":[
          {
         "ItemOptionValue":"단일상품;단일상품",
         "ItemOptionOrderCnt":1,
         "ItemOptionCode":"20105838001"
          }
         ],
     "ItemOptionAdditionList":[
         ],
     "DepositDueDate":"2019-04-17T07:32:31.143"
          }
       ]
    }
}

옥션
{
  "ResultCode":0,
  "Message":"",
  "Data":{
  "SiteType":1,
  "PageIndex":1,
  "PageSize":1000,
  "TotalCount":1,
  "SellerId":"selleridtest",
  "RequestOrders":[
    {
     "PayNo":1192866095,
     "GroupNo":915391003,
     "OrderNo":1589713677,
     "BranchCode":null,
     "OrderDate":"2019-04-10T14:36:00",
     "GoodsNo":"",
     "SiteGoodsNo":"B653458847",
     "OutGoodsNo":"",
     "GoodsName":"[전구성 무료체험] 리빙박스 6종 + 정리함 2종",
     "SalePrice":"1000.0000",
     "ContrAmount":1,
     "OrderAmount":"1000.0000",
     "AcntMoney":"1000.0000",
     "SellerDiscountPrice1":"0.0000",
     "SellerDiscountPrice2":"0.0000",
     "SellerDiscountPrice":"0.0000",
     "DirectDiscountPrice":"0.0000",
     "ShippingFee":"0.0000",
     "OptSelPrice":null,
     "OptAddPrice":null,
     "BuyerName":"테스터",
     "BuyerId":"abc********",
     "BuyerMobileTel":"010-1234-5678",
     "BuyerTel":"031-123-4567",
     "ReceiverName":"테스터",
     "HpNo":"010-1234-5678",
     "TelNo":"010-1234-5678",
     "ZipCode":"04728",
     "DelFrontAddress":"서울특별시 성동구 금호동2가 1215",
     "DelBackAddress":"1001호",
     "DelFullAddress":"서울특별시 성동구 금호동2가 1215",
     "DelMemo":"",
     "ItemOptionSelectList":[
        ],
     "ItemOptionAdditionList":[
        ],
     "DepositDueDate":"2019-04-17T23:59:59"
         }
      ]
   }
}

Sample Code_Fail

{
    "ResultCode": 3000,
    "Message": "조회 시작일이 종료일보다 과거여야 합니다.",
    "Data": null
}

 

Error Code

결과코드	메시지	원인
3000	조회 시작일이 종료일보다 과거여야 합니다.	requestDateFrom~requestDateTo 조회기간 오류
3000	매개변수 값을 Int64에서 Int32로 변환하지 못했습니다.	OrderNo 자릿수 오류
3000	메서드 또는 연산이 구현되지 않았습니다.	조회조건 오류(SiteType오류 등)
3000	(옥션)180일 이하의 범위만 조회 할 수 있습니다.	requestDateFrom~requestDateTo 조회기간 초과