특정 주문서에 대해 주문서 상태/ 상품 정보/ 결제 정보 등을 확인할 수 있는 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=sell&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) | 로그인 세션 아이디 |
6 | for (string,Y) | 판매관리 주문서 상세 조회 시: "sell" 입력 |
7 | no (int,C) *조건부 필수 | 주문서 번호(OR을 제외한 숫자만 입력)
|
8 | uid (string,C) *조건부 필수 | 주문서 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 | 상품유형 (판매채널)dome : 도매꾹supply : 도매매 |
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 | 배송비금액- 착불일 경우 0원으로 노출되며, 착불 배송비 금액은 items.itemDeliInfo.deliAmt 항목 참조 |
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.itemDeliInfo.who | string | 착불 |
74 | items.delivery.itemDeliInfo.deliAmt | string | 착불일 경우 상품의 배송비 |
75 | items.delivery.deliMerge.basis | int | 묶음배송비 기준 주문서 |
76 | items.delivery.deliMerge.method | string | 묶음배송비 부담주체 (S:무료배송, P:선결제, B:착불) |
77 | items.delivery.deliMerge.amount | int | 묶음배송비 금액 |
78 | items.delivery.deliMerge.items.item | int | 묶음배송된 상품번호 |
79 | items.selectOpt | - | 주문옵션 |
80 | items.selectOpt.opt | - | 주문옵션 1항목 |
81 | items.selectOpt.opt.name | string | 주문옵션명 |
82 | items.selectOpt.opt.add | int | 주문옵션 추가금액 |
83 | items.selectOpt.opt.price | int | 주문옵션 추가금액 반영 후의 단가 |
84 | items.selectOpt.opt.amt | int | 주문옵션 주문금액 |
85 | items.selectOpt.opt.qty | int | 주문옵션 주문개수 |
86 | items.selectOpt.opt.code | string | 주문옵션 코드 |
87 | items.isBack | string | 반품중 여부 (true, false) |
88 | items.denyDate | int | 취소일자 (Unix Timestamp)(판매취소 혹은 구매취소의 경우에만 사용) |
89 | items.denyMemo | string | 취소사유(판매취소 혹은 구매취소의 경우에만 사용) |
90 | items.serv | - | 정산정보 |
91 | items.serv.fee | int | 수수료 금액 |
92 | items.serv.per | double | 수수료율 |
93 | items.serv.amt | int | 적립예정금액 |
94 | items.coupon | - | 할인쿠폰 정보 (할인쿠폰은 결제방법을 가상계좌로 선택했을 때에만 사용가능) |
95 | items.coupon.no | int | 사용한 할인쿠폰 번호 |
96 | items.coupon.amt | int | 사용한 할인쿠폰 금액 |
97 | items.insuFee | int | 보증보험료 (보증보험은 결제방법을 가상계좌로 선택했을 때에만 가입가능) |
98 | items.sellerPoint | - | 판매자적립포인트 정보 (지급된 포인트가 없는 경우 생략) |
99 | items.sellerPoint.point | int | 지급된 판매자적립포인트 액수 |
100 | items.sellerPoint.type | int | 판매자적립포인트 지급유형fix : 정액(구매수량에 비례하여 지급)rate : 정률(구매액에 비례하여 지급) |
101 | items.sellerPoint.limitAmt | int | 판매자적립포인트가 지급되는 최저구매액지급유형이 정률일 때만 사용하며, 정액인 경우에는 공란으로 비워둠 |
102 | items.sellerPoint.basePoint | int | 판매자적립포인트 단위지급액정액 : 구매개수 1개당 지급되는 포인트 액수정률 : limitAmt로 입력된 금액당 지급되는 포인트 액수 |
103 | items.log | string | 주문상태기록 |
104 | items.chatList | - | 판매자-구매자간 대화목록 |
105 | items.chatList.list | - | 판매자-구매자간 대화 1건에 대한 정보 |
106 | items.chatList.list.no | int | 대화번호 |
107 | items.chatList.list.type | int | 대화 작성자 유형 (판매자, 구매자) |
108 | items.chatList.list.id | int | 대화 작성자 아이디 |
109 | items.chatList.list.memo | int | 대화 내용 |
110 | items.chatList.list.date | int | 대화 작성일시 (Unix Timestamp) |
111 | items.date | string | 주문일시 (yyyy-mm-dd hh:ii:ss) |