반품/교환 신청내역을 조회할 수 있는 API입니다 (구매 및 판매 공통)
권장 ver: 1.0
Mode: getOrderReturn
Method: GET
Endpoint: https://domeggook.com/ssl/api/
Request Example:
https://domeggook.com/ssl/api/?ver=1.0&mode=getOrderReturn&aid={API_KEY}&id={user_id}&sId={session}&orderNo={order_no}&om=json
순서 | 항목(자료형, 필수여부) | 설명 |
1 | ver (string,Y) | API 버전: 1.0 입력 |
2 | mode (string,Y) | API 모드: getOrderReturn |
3 | aid (string,Y) | API KEY |
4 | id (string,Y) | 회원 아이디 |
5 | sId (string,Y) | 로그인 세션 아이디 |
6 | orderNo (int,Y) | 주문서 번호 |
7 | om (string,N) | 출력형식 : xml / json |
순서 | 항목 | 자료형 | 설명 |
|---|---|---|---|
1 | domeggook.order | - | --- 주문서 정보 --- |
2 | domeggook.order.no | int | 주문서 번호 |
3 | domeggook.order.status | string | 주문서 상태 코드 |
4 | domeggook.order.statusName | string | 주문서 상태 텍스트 |
5 | domeggook.order.sellId | string | 판매자 아이디 |
6 | domeggook.order.orderAmount | string | 전체 주문 금액 |
7 | domeggook.order.orderQty | string | 주문 수량 |
8 | domeggook.order.unitAmt | string | 주문 객단가 |
9 | domeggook.order.paidDeli | string | 결제한 배송비 |
10 | domeggook.order.sellDeliFee | string | 예상 반품배송비 |
11 | domeggook.order.returnShippingArea | string | 반품/교환 주소지 번호 |
12 | domeggook.order.returnDeliAmt | string | 반품배송비 (판매자가 설정) |
13 | domeggook.order.returnDeliAmtDouble | string | 무료 주문시 반품배송비 2배 부과 여부 (판매자가 설정) |
14 | domeggook.order.returnSellAddress | string | 반품/교환 주소지 텍스트 |
15 | domeggook.order.returnSellPhone | string | 반품/교환 주소지 연락처 |
16 | domeggook.item | - | 상품 정보 |
17 | domeggook.item.no | int | 상품 번호 |
18 | domeggook.item.id | string | 판매자 아이디 |
19 | domeggook.item.itemTitle | string | 상품 제목 |
20 | domeggook.item.itemImage | string | 상품 이미지 URL |
21 | domeggook.item.qty | string | 상품 재고수량 |
22 | domeggook.item.unitQty | string | 판매수량단위 |
23 | domeggook.item.amt | string | 샘플가격 |
24 | domeggook.item.amt1 | string | 판매단가 |
25 | domeggook.return | - | --- 반품/교환 정보 --- |
26 | domeggook.return.no | string | 반품/교환 번호 |
27 | domeggook.return.division | string | RETURN (반품)CHANGE (교환) |
28 | domeggook.return.divisionName | string | 반품 | 교환 |
29 | domeggook.return.status | string | 반품/교환 상태* 교환교환접수 APPLY교환재배송중 SHIPPING교환완료 SUCCESS교환보류 CHANGE교환취소 CANCEL* 반품반품접수 APPLY환불대기 WAIT반품완료 SUCCESS반품보류 DELAY반품취소 CANCEL |
30 | domeggook.return.statusName | string | 반품/교환 상태 텍스트* 반품 상태에 대한 내용은 domeggook.return.status 항목 참조 |
31 | domeggook.return.buyReason | string | 반품/교환 사유 |
32 | domeggook.return.buyReasonText | string | 반품/교환 사유 텍스트 |
33 | domeggook.return.buyDeliInfoYn | string | 배송정보 기재 여부1: 기재0: 미기재 |
34 | domeggook.return.buyDeliCompany | string | 택배사 |
35 | domeggook.return.buyDeliCompanyName | string | 택바사명 |
36 | domeggook.return.buyDeliCode | string | 운송장 |
37 | domeggook.return.sellDeliCode | string | 교환시 판매자 운송장 번호 |
38 | domeggook.return.sellDeliFee | int | 예상 반품 배송비 |
39 | domeggook.return.sellPredict | int | 환불예상금액 |
40 | domeggook.return.sellPrice | int | 최종 환불금액 |
41 | domeggook.return.sellQtyCd | string | 반품/교환 전체 선택 여부1: 전체0: 부분 |
42 | domeggook.return.sellQtyOpt | - | 반품/교환 선택 수량 |
43 | domeggook.return.sellQtyOpt.code | string | 옵션 코드 |
44 | domeggook.return.sellQtyOpt.name | string | 옵션명 |
45 | domeggook.return.sellQtyOpt.add | int | 옵션추가금 |
46 | domeggook.return.sellQtyOpt.price | int | 옵션단가(추가금 포함) |
47 | domeggook.return.sellQtyOpt.amt | int | |
48 | domeggook.return.sellQtyOpt.qty | int | 옵션별 주문수량 |
49 | domeggook.return.sellQtyOpt.selectedQty | int | 옵션별 반품/교환 선택수량 |
50 | domeggook.return.sellQtyOpt.totalAmt | int | 옵션별로 선택한 총 반품환불 금액 |
51 | domeggook.return.totalSelectedQty | string | 선택 수량 합계 |
52 | domeggook.return.totalSelectedAmt | string | 선택 금액 합계 |
53 | domeggook.return.dateApply | string | 접수일 |
54 | domeggook.return.dateWait | string | 수령확인일 |
55 | domeggook.return.dateRefund | string | 환불발생일 |
56 | domeggook.return.dateDelay | string | 보류신청일 |
57 | domeggook.return.dateCancel | string | 취소일 |
58 | domeggook.return.memoDelay | string | 반품/교환 신청시 추가 요청 사항 |
59 | domeggook.return.memoCancel | string | 반품/교환 취소사유 |
60 | domeggook.return.attachFiles | - | 첨부파일(첨부파일이 없으면 보이지 않음) |
61 | domeggook.return.attachFiles.file.no | int | 첨부파일 pk no |
62 | domeggook.return.attachFiles.file.fileName | string | 첨부파일명 |
63 | domeggook.return.attachFiles.file.url | string | 첨부파일 이미지 URL |
64 | domeggook.return.attachFiles.file.userReg | string | 첨부파일 업로드 회원 아이디 |
65 | domeggook.return.attachFiles.file.dateReg | int | 첨부파일 업로드 날짜 (Unix Timestamp 형식) |