도매꾹 Open API

구매 주문서 상세 조회

특정 주문서에 대해 주문서 상태/ 상품 정보/ 결제 정보 등을 확인할 수 있는 API입니다

특정 주문서에 대해 주문서 상태/ 상품 정보/ 결제 정보 등을 확인할 수 있는 API입니다.


ver: 4.0

Mode: getOrderView

Method: GET

Endpoint: https://domeggook.com/ssl/api/

Request Example:

https://domeggook.com/ssl/api/?ver=4.0&mode=getOrderView&aid={API_KEY}&id={USER_ID}&sId={SESSION_ID}&for=buy&no={itemno}&om=json

순서

항목(자료형, 필수여부)

설명

1

ver (string,Y) 

API Version : 4.0

2

mode (string,Y) 

API 호출 모드값 : getOrderView

3

aid (string,Y) 

API KEY

4

id (string,Y) 

회원 아이디

5

sId (string,Y) 

로그인 API 호출로 발급되는 sId

6

for (string,Y) 

구매관리 주문서 상세 조회 시 "buy" 입력

7

no (int,C) 

*조건부 필수

주문서 번호(OR을 제외한 숫자만 입력)

  • no와 uid중 하나는 입력 필요

8

uid (string,C) 

*조건부 필수

주문서 uid

  • no와 uid중 하나는 입력 필요

9

oe (string,N) 

출력 인코딩 (utf-8, euc-kr)

10

om (string,Y) 

출력형식 : xml / json

순서

항목

자료형

설명

1

items.device

string

구매 디바이스 정보

2

items.orderNo

int

주문번호

3

items.orderUid

string

주문 uid

4

items.orderQty

int

주문수량

5

items.orderAmtPay

int

주문금액

6

items.orderAmount

int

상품금액 (배송비 제외)

7

items.supplyAmount

int

공급가 금액 (위탁판매 주문서에서만 표시)

8

items.ceilAmount

int

단수조정 금액 (위탁판매 주문서에서만 표시)

9

items.status

string

주문상태 (한글이름)입금예정 / 승인대기 / 선물수락대기 / 결제완료 /배송준비중 / 배송준비중취소 / 배송중 /배송완료 / 구매종료 /승인취소 / 구매취소 / 판매취소 / 반품중

10

items.statusMode

string

주문상태 (영어이름)WAITPAY : 입금예정WAITCONFIRM : 승인대기WAITCHK : 결제완료WAITDELI : 배송준비중WAITDENY : 배송준비중취소WAITOK : 배송중WAITRCPT : 배송완료WAITSERV : 구매종료DONE : 구매종료DENYCONFIRM : 승인취소DENYBUY : 구매취소DENYSELL : 판매취소BACK : 반품중

11

items.orderMemo

string

공급사전달사항

12

items.item.no

int

상품번호

13

items.item.title

string

상품제목

14

items.item.section

string

SELL : 일반판매SHOP : 위탁판매

15

items.item.market

string

상품유형

16

items.item.img150

string

썸네일 URL (가로세로 150픽셀)

17

items.item.img075

string

썸네일 URL (가로세로 75픽셀)

18

items.item.img150png

string

썸네일 PNG URL (가로세로 150픽셀)

19

items.item.img075png

string

썸네일 PNG URL (가로세로 75픽셀)

20

items.item.itemCustomCode

string

공급사 상품코드

21

items.pay.payAmount

string

총결제금액

22

items.pay.method

string

결제방법

23

items.pay.bankInfo

string

입금정보 (가상계좌 결제시)

24

items.pay.bankBene

string

예금주 (가상계좌 결제시)

25

items.pay.cardInfo

string

카드정보 (카드결제시)

26

items.pay.cardInstallment

int

할부기간 (카드결제시)

27

items.pay.datePay

string

결제일시

28

items.pay.payInfo.payMethodAmount

string

실결제금액

29

items.pay.payInfo.pg

string

실결제금액 중 이머니 결제금액

30

items.pay.payInfo.point

string

실결제금액 중 포인트 결제금액

31

items.sellerInfo.sellerId

string

판매자 ID

32

items.sellerInfo.sellerName

string

판매자 이름

33

items.sellerInfo.sellerMail

string

판매자 메일

34

items.sellerInfo.sellerPhone

string

판매자 전화번호

35

items.sellerInfo.sellerNick

string

판매자 닉네임

36

items.sellerInfo.sellerMobile

string

판매자 휴대전화

37

items.sellerInfo.authorId

string

실판매자 ID (위탁판매 주문서에서만 표시)

38

items.buyerInfo.buyerId

string

구매자 ID

39

items.buyerInfo.buyerName

string

구매자 이름

40

items.buyerInfo.buyerBuyRank

int

구매자 구매등급 (1~9)

41

items.buyerInfo.buyerBuyScore

int

구매자 구매점수

42

items.buyerInfo.buyerMail

string

구매자 메일

43

items.buyerInfo.buyerZipcode

string

구매자 우편번호

44

items.buyerInfo.buyerAddress

string

구매자 주소

45

items.buyerInfo.buyerPhone

string

구매자 전화번호

46

items.buyerInfo.buyerMobile

string

구매자 휴대전화

47

items.buyerInfo.ccnoType

string

ind : 개인 com : 사업자 // 통관고유번호유형

48

items.buyerInfo.ccno

string

통관고유번호

49

items.buyerInfo.buyerDeliReq

string

도매꾹 배송요청사항 (도매꾹 주문인 경우에만 표시)

50

items.consumer

-

소비자정보(도매매 주문인 경우에만 표시)

51

items.consumer.name

string

소비자 이름

52

items.consumer.email

string

소비자 이메일 주소

53

items.consumer.phone

string

소비자 유선전화번호

54

items.consumer.mobile

string

소비자 휴대폰번호

55

items.consumer.zipcode

string

소비자 우편번호

56

items.consumer.address

string

소비자 주소

57

items.consumer.deliReq

string

소비자 배송요청사항

58

items.delivery.method

string

배송방법 (택배, 소포등기, 퀵서비스, 화물배달, 일반우편, 방문수령/직접배송)

59

items.delivery.who

string

배송비 부담 (무료배송, 선결제, 착불)

60

items.delivery.fee

int

배송비금액

61

items.delivery.company

string

배송사 코드

62

items.delivery.companyName

string

배송사 이름

63

items.delivery.code

string

송장번호

64

items.delivery.date

int

발송예정 상태변경일자 (Unix Timestamp)

65

items.delivery.dateOver

int

배송기한일자 (Unix Timestamp)

66

items.delivery.dateStart

int

배송시작일자 (Unix Timestamp)

67

items.delivery.dateSellerChk

int

공급사 발주확인일자 (Unix Timestamp)

68

items.delivery.dateDeliArrive

int

배송도착일자 (Unix Timestamp)

69

items.delivery.itemPeriodDeli

int

배송준비기간

70

items.delivery.fromOversea

string

해외직배송여부

71

items.delivery.reqCcno

string

통관번호입력여부

72

items.delivery.hardshipDeliAmt

int

도서산간배송비

73

items.delivery.deliMerge.basis

int

묶음배송비 기준 주문서

74

items.delivery.deliMerge.method

string

묶음배송비 부담주체 (S:무료배송, P:선결제, B:착불)

75

items.delivery.deliMerge.amount

int

묶음배송비 금액

76

items.delivery.deliMerge.items.item

int

묶음배송된 상품번호

77

items.selectOpt

-

주문옵션

78

items.selectOpt.opt

-

주문옵션 1항목

79

items.selectOpt.opt.name

string

주문옵션명

80

items.selectOpt.opt.add

int

주문옵션 추가금액

81

items.selectOpt.opt.price

int

주문옵션 추가금액 반영 후의 단가

82

items.selectOpt.opt.amt

int

주문옵션 주문금액

83

items.selectOpt.opt.qty

int

주문옵션 주문개수

84

items.selectOpt.opt.code

string

주문옵션 코드

85

items.isBack

string

반품중 여부 (true, false)

86

items.denyDate

int

취소일자 (Unix Timestamp)(판매취소 혹은 구매취소의 경우에만 사용)

87

items.denyMemo

string

취소사유(판매취소 혹은 구매취소의 경우에만 사용)

88

items.serv

-

정산정보

89

items.serv.fee

int

수수료 금액

90

items.serv.per

double

수수료율

91

items.serv.amt

int

적립예정금액

92

items.coupon

-

할인쿠폰 정보 (할인쿠폰은 결제방법을 가상계좌로 선택했을 때에만 사용가능)

93

items.coupon.no

int

사용한 할인쿠폰 번호

94

items.coupon.amt

int

사용한 할인쿠폰 금액

95

items.insuFee

int

보증보험료 (보증보험은 결제방법을 가상계좌로 선택했을 때에만 가입가능)

96

items.sellerPoint

-

판매자적립포인트 정보 (지급된 포인트가 없는 경우 생략)

97

items.sellerPoint.point

int

지급된 판매자적립포인트 액수

98

items.sellerPoint.type

int

판매자적립포인트 지급유형fix : 정액(구매수량에 비례하여 지급)rate : 정률(구매액에 비례하여 지급)

99

items.sellerPoint.limitAmt

int

판매자적립포인트가 지급되는 최저구매액지급유형이 정률일 때만 사용하며, 정액인 경우에는 공란으로 비워둠

100

items.sellerPoint.basePoint

int

판매자적립포인트 단위지급액정액 : 구매개수 1개당 지급되는 포인트 액수정률 : limitAmt로 입력된 금액당 지급되는 포인트 액수

101

items.log

string

주문상태기록

102

items.chatList

-

판매자-구매자간 대화목록

103

items.chatList.list

-

판매자-구매자간 대화 1건에 대한 정보

104

items.chatList.list.no

int

대화번호

105

items.chatList.list.type

int

대화 작성자 유형 (판매자, 구매자)

106

items.chatList.list.id

int

대화 작성자 아이디

107

items.chatList.list.memo

int

대화 내용

108

items.chatList.list.date

int

대화 작성일시 (Unix Timestamp)

109

items.date

string

주문일시 (yyyy-mm-dd hh:ii:ss)

JSON