# 주문 조회

<mark style="color:blue;">`GET`</mark> `https://api.imweb.me/v2/shop/orders`

<mark style="color:blue;">`GET`</mark> `https://api.imweb.me/v2/shop/orders/{주문번호}`

## **목록 요청 데이터**

{% hint style="info" %}
주문서 목록 조회 시 검색 조건을 전달할 수 있습니다.&#x20;

주문서 상태에 관련된 필터는 1개만 사용 가능합니다. (status, claim\_type, claim\_status)

주문관리 v2는 기간 정보를 입력하지 않으면 현재 날짜 기준 3달 전 데이터가 조회됩니다.
{% endhint %}

<table><thead><tr><th width="150">항목</th><th width="150">타입<select><option value="c68c1b3ba66047ddb3f894c522344dd9" label="String" color="blue"></option><option value="ae66905fb4d043f08048bd0e3e875b36" label="Integer" color="blue"></option><option value="8e89f7fab0774326b1a949bf03d33371" label="Array" color="blue"></option><option value="69695b1ee5e44f05a84f1ac2394bd65f" label="Boolean" color="blue"></option></select></th><th>설명</th></tr></thead><tbody><tr><td>type</td><td><span data-option="c68c1b3ba66047ddb3f894c522344dd9">String</span></td><td><p>주문 매체</p><ul><li>normal: 아임웹 주문</li><li>npay: 네이버 주문</li><li>talkpay: 카카오톡 주문</li></ul></td></tr><tr><td>order_date_from</td><td><span data-option="ae66905fb4d043f08048bd0e3e875b36">Integer</span></td><td><p>주문일(시작일)</p><p>Timestamp</p></td></tr><tr><td>order_date_to</td><td><span data-option="ae66905fb4d043f08048bd0e3e875b36">Integer</span></td><td><p>주문일(종료일)</p><p>Timestamp</p></td></tr><tr><td>status</td><td><span data-option="c68c1b3ba66047ddb3f894c522344dd9">String</span></td><td><p>주문서 상태</p><ul><li>PAY_WAIT: 입금대기</li><li>PAY_COMPLETE: 결제완료</li><li>STANDBY: 배송준비중/배송대기</li><li>DELIVERING: 배송중</li><li>COMPLETE: 배송완료</li><li>CANCEL: 취소완료</li><li>RETURN: 반품완료</li><li>EXCHANGE: 교환완료</li><li>PURCHASE_CONFIRMATION: 구매확정 (주문관리 v2 전용)</li></ul></td></tr><tr><td>claim_type</td><td><span data-option="c68c1b3ba66047ddb3f894c522344dd9">String</span></td><td><p>주문서 클레임 타입</p><ul><li>CANCEL: 취소</li><li>RETURN: 반품</li><li>EXCHANGE: 교환</li></ul></td></tr><tr><td>claim_status</td><td><span data-option="c68c1b3ba66047ddb3f894c522344dd9">String</span></td><td><p>주문서 클레임 상태</p><ul><li>CANCEL_REQUEST: 취소요청</li><li>CANCELING: 취소요청중</li><li>CANCEL_FAILED: 취소 실패</li><li>RETURN_REQUEST: 반품요청</li><li>RETURN_COLLECTING: 반품수거중</li><li>RETURN_COLLECT_DONE: 반품수거완료</li><li>RETURN_REFUNDING: 반품환불진행중</li><li>RETURN_REFUND_FAILED: 반품환불실패</li><li>EXCHANGE_REQUEST: 교환요청</li><li>EXCHANGE_COLLECTING: 교환수거중</li><li>EXCHANGE_COLLECT_DONE: 교환수거완료</li><li>REDELIVERING: 교환재배송중</li></ul></td></tr><tr><td>member</td><td><span data-option="c68c1b3ba66047ddb3f894c522344dd9">String</span></td><td>회원코드</td></tr><tr><td>orderer_call</td><td><span data-option="c68c1b3ba66047ddb3f894c522344dd9">String</span></td><td>주문자 전화번호</td></tr><tr><td>order_version</td><td><span data-option="c68c1b3ba66047ddb3f894c522344dd9">String</span></td><td><p>조회할 주문 버전</p><ul><li>v1 (기존 주문)</li><li>v2 (신규 주문 시스템)</li></ul></td></tr></tbody></table>

## **응답 데이**터

<table><thead><tr><th width="242.4">항목</th><th width="150">타입<select><option value="c68c1b3ba66047ddb3f894c522344dd9" label="String" color="blue"></option><option value="ae66905fb4d043f08048bd0e3e875b36" label="Integer" color="blue"></option><option value="8e89f7fab0774326b1a949bf03d33371" label="Array" color="blue"></option><option value="69695b1ee5e44f05a84f1ac2394bd65f" label="Boolean" color="blue"></option></select></th><th>설명</th></tr></thead><tbody><tr><td>order_no</td><td><span data-option="c68c1b3ba66047ddb3f894c522344dd9">String</span></td><td>주문번호</td></tr><tr><td>is_gift</td><td><span data-option="c68c1b3ba66047ddb3f894c522344dd9">String</span></td><td><p>선물하기 주문 여부</p><ul><li>Y : 선물하기 주문</li><li>N : 일반 주문</li></ul></td></tr><tr><td>device</td><td><span data-option="8e89f7fab0774326b1a949bf03d33371">Array</span></td><td><p>주문기기 정보</p><p><a href="#orderdevice-data">OrderDeviceData</a></p></td></tr><tr><td>order_time</td><td><span data-option="ae66905fb4d043f08048bd0e3e875b36">Integer</span></td><td><p>주문 시각</p><p>Timestamp</p></td></tr><tr><td>complete_time</td><td><span data-option="ae66905fb4d043f08048bd0e3e875b36">Integer</span></td><td><p>전체 상품 배송완료 시각</p><p>Timestamp</p></td></tr><tr><td>orderer</td><td><span data-option="8e89f7fab0774326b1a949bf03d33371">Array</span></td><td><p>주문자 정보</p><p><a href="#orderdevice-data-1">OrderOrdererData</a></p></td></tr><tr><td>delivery</td><td><span data-option="8e89f7fab0774326b1a949bf03d33371">Array</span></td><td><p>배송지 정보</p><p><a href="#orderdelivery-data">OrderDeliveryData</a></p></td></tr><tr><td>payment</td><td><span data-option="8e89f7fab0774326b1a949bf03d33371">Array</span></td><td><p>결제 정보</p><p><a href="#orderpayment-data">OrderPaymentData</a></p></td></tr><tr><td>cash_receipt</td><td><span data-option="8e89f7fab0774326b1a949bf03d33371">Array</span></td><td><p>현금영수증 정보</p><p><a href="#orderreceipt-data">OrderReceiptData</a></p></td></tr><tr><td>form</td><td><span data-option="8e89f7fab0774326b1a949bf03d33371">Array</span></td><td><p>결제입력폼 정보</p><p><a href="#orderform-data">OrderFormData</a></p></td></tr><tr><td>use_issue_coupon_codes</td><td><span data-option="8e89f7fab0774326b1a949bf03d33371">Array</span></td><td>주문에 사용된 발행쿠폰코드 목록</td></tr><tr><td>app</td><td><span data-option="c68c1b3ba66047ddb3f894c522344dd9">String</span></td><td><p></p><p>앱 정보</p><ul><li>android: 안드로이드</li><li>ios: 아이폰</li></ul></td></tr><tr><td>device_code</td><td><span data-option="c68c1b3ba66047ddb3f894c522344dd9">String</span></td><td>디바이스 코드</td></tr></tbody></table>

### OrderDevice Data

<table><thead><tr><th width="150">항목</th><th width="150">타입<select><option value="c68c1b3ba66047ddb3f894c522344dd9" label="String" color="blue"></option><option value="ae66905fb4d043f08048bd0e3e875b36" label="Integer" color="blue"></option><option value="8e89f7fab0774326b1a949bf03d33371" label="Array" color="blue"></option><option value="69695b1ee5e44f05a84f1ac2394bd65f" label="Boolean" color="blue"></option></select></th><th>설명</th></tr></thead><tbody><tr><td>type</td><td><span data-option="c68c1b3ba66047ddb3f894c522344dd9">String</span></td><td><p>주문 기기 타입</p><ul><li>pc: PC</li><li>mobile: Mobile</li></ul></td></tr></tbody></table>

### OrderOrderer Data

<table><thead><tr><th width="150">항목</th><th width="150">타입<select><option value="c68c1b3ba66047ddb3f894c522344dd9" label="String" color="blue"></option><option value="ae66905fb4d043f08048bd0e3e875b36" label="Integer" color="blue"></option><option value="8e89f7fab0774326b1a949bf03d33371" label="Array" color="blue"></option><option value="69695b1ee5e44f05a84f1ac2394bd65f" label="Boolean" color="blue"></option></select></th><th>설명</th></tr></thead><tbody><tr><td>member_code</td><td><span data-option="c68c1b3ba66047ddb3f894c522344dd9">String</span></td><td>회원 코드</td></tr><tr><td>name</td><td><span data-option="c68c1b3ba66047ddb3f894c522344dd9">String</span></td><td>주문자명</td></tr><tr><td>email</td><td><span data-option="c68c1b3ba66047ddb3f894c522344dd9">String</span></td><td>주문자 메일주소</td></tr><tr><td>call</td><td><span data-option="c68c1b3ba66047ddb3f894c522344dd9">String</span></td><td>주문자 연락처1</td></tr><tr><td>call2</td><td><span data-option="c68c1b3ba66047ddb3f894c522344dd9">String</span></td><td>주문자 연락처2</td></tr></tbody></table>

### OrderDelivery Data

<table><thead><tr><th width="150">항목</th><th width="150">타입<select><option value="c68c1b3ba66047ddb3f894c522344dd9" label="String" color="blue"></option><option value="ae66905fb4d043f08048bd0e3e875b36" label="Integer" color="blue"></option><option value="8e89f7fab0774326b1a949bf03d33371" label="Array" color="blue"></option><option value="69695b1ee5e44f05a84f1ac2394bd65f" label="Boolean" color="blue"></option></select></th><th>설명</th></tr></thead><tbody><tr><td>country</td><td><span data-option="c68c1b3ba66047ddb3f894c522344dd9">String</span></td><td>배송국가</td></tr><tr><td>country_text</td><td><span data-option="c68c1b3ba66047ddb3f894c522344dd9">String</span></td><td>배송국가 한글명</td></tr><tr><td>address</td><td><span data-option="8e89f7fab0774326b1a949bf03d33371">Array</span></td><td><p>배송지 정보</p><p><a href="#orderdelivery-data-1">OrderAddressData</a></p></td></tr><tr><td>memo</td><td><span data-option="c68c1b3ba66047ddb3f894c522344dd9">String</span></td><td>배송 메모</td></tr><tr><td>unipass_number</td><td><span data-option="c68c1b3ba66047ddb3f894c522344dd9">String</span></td><td>개인통관고유부호</td></tr></tbody></table>

### OrderAddress Data

<table><thead><tr><th width="150">항목</th><th width="150">타입<select><option value="c68c1b3ba66047ddb3f894c522344dd9" label="String" color="blue"></option><option value="ae66905fb4d043f08048bd0e3e875b36" label="Integer" color="blue"></option><option value="8e89f7fab0774326b1a949bf03d33371" label="Array" color="blue"></option><option value="69695b1ee5e44f05a84f1ac2394bd65f" label="Boolean" color="blue"></option></select></th><th>설명</th></tr></thead><tbody><tr><td>name</td><td><span data-option="c68c1b3ba66047ddb3f894c522344dd9">String</span></td><td>수령인명</td></tr><tr><td>phone</td><td><span data-option="c68c1b3ba66047ddb3f894c522344dd9">String</span></td><td>수령인 연락처1</td></tr><tr><td>phone2</td><td><span data-option="c68c1b3ba66047ddb3f894c522344dd9">String</span></td><td>수령인 연락처2</td></tr><tr><td>postcode</td><td><span data-option="c68c1b3ba66047ddb3f894c522344dd9">String</span></td><td>우편번호</td></tr><tr><td>address</td><td><span data-option="c68c1b3ba66047ddb3f894c522344dd9">String</span></td><td>주소</td></tr><tr><td>address_detail</td><td><span data-option="c68c1b3ba66047ddb3f894c522344dd9">String</span></td><td>상세주소</td></tr><tr><td>address_street</td><td><span data-option="c68c1b3ba66047ddb3f894c522344dd9">String</span></td><td>영문주소 - 거리주소</td></tr><tr><td>address_building</td><td><span data-option="c68c1b3ba66047ddb3f894c522344dd9">String</span></td><td>영문주소 - 건물명</td></tr><tr><td>address_city</td><td><span data-option="c68c1b3ba66047ddb3f894c522344dd9">String</span></td><td>영문주소 - 도시명</td></tr><tr><td>address_state</td><td><span data-option="c68c1b3ba66047ddb3f894c522344dd9">String</span></td><td>영문주소 - 도시군</td></tr></tbody></table>

### OrderPayment Data

<table><thead><tr><th width="150">항목</th><th width="150">타입<select><option value="c68c1b3ba66047ddb3f894c522344dd9" label="String" color="blue"></option><option value="ae66905fb4d043f08048bd0e3e875b36" label="Integer" color="blue"></option><option value="8e89f7fab0774326b1a949bf03d33371" label="Array" color="blue"></option><option value="69695b1ee5e44f05a84f1ac2394bd65f" label="Boolean" color="blue"></option><option value="333060e9e6504c44ba6e760cae49fa00" label="Float" color="blue"></option></select></th><th>설명</th></tr></thead><tbody><tr><td>pay_type</td><td><span data-option="c68c1b3ba66047ddb3f894c522344dd9">String</span></td><td><p>결제 수단</p><ul><li>free: 무료결제</li><li>card: 신용카드</li><li>iche: 실시간 계좌이체</li><li>virtual: 가상계좌</li><li>cash: 무통장입금</li><li>phone: 핸드폰 결제</li><li>payco: 페이코</li><li>kakaopay: 카카오페이</li><li>paypal: 페이팔</li><li>eximbay: 엑심베이</li><li>eb_atrpay: 알리페이</li><li>eb_molpay: 몰페이</li><li>eb_wechatpay: 위쳇페이</li><li>eb_econtext: 편의점결제</li><li>easy_payment_card: 신용카드 간편결제 </li><li>easy_payment_virtual: 계좌 간편결제</li><li>easy_payment_phone: 휴대폰 간편결제</li><li>npay: 네이버페이</li><li>talkcheckout: 톡체크아웃</li><li>samsungpay: 삼성페이</li><li>toss: 토스페이</li><li>ssgpay: 신세계페이</li><li>lpay: L페이</li><li>kbpay: KB앱페이</li><li>chipay: 차이페이</li><li>tmoneypay: 티머니페이</li><li>pinpay: 핀페이</li><li>applepay: 애플페이</li><li>japanese_convenience_store: 일본 편의점 결제</li><li>payverse: 페이버</li><li>kakaopay_direct: 카카오페이(직연동)</li><li>etc: 그 외 결제수단</li></ul></td></tr><tr><td>pg_type</td><td><span data-option="c68c1b3ba66047ddb3f894c522344dd9">String</span></td><td><p>PG 타입</p><ul><li>kcp: NHN KCP</li><li>inicis: KG 이니시스</li><li>nicepay: 나이스페이</li><li>paynuri: 페이누리</li><li>paypal: 페이팔</li><li>eximbay: 엑심베이</li><li>allatpay: 올앳페이</li><li>ags: 올더게이트</li><li>uplus: LG유플러스</li><li>ksnet: KSNet</li><li>kicc : 이지페이</li><li>tosspayments : 토스페이먼츠</li><li>danal : 다날</li><li>payverse : 페이버스</li></ul></td></tr><tr><td>deliv_type</td><td><span data-option="c68c1b3ba66047ddb3f894c522344dd9">String</span></td><td><p>배송방법</p><ul><li>parcel: 택배</li><li>direct: 직접배송</li><li>quick: 퀵배송</li><li>visit: 방문수령</li><li>no_deliv: 배송없음</li><li>download: 디지털 컨텐츠</li><li>subscribe: 회원그룹 이용권</li></ul></td></tr><tr><td>deliv_pay_type</td><td><span data-option="c68c1b3ba66047ddb3f894c522344dd9">String</span></td><td><p>배송비 결제방식</p><ul><li>price: 선결제</li><li>deliv_price_after: 착불</li></ul></td></tr><tr><td>price_currency</td><td><span data-option="c68c1b3ba66047ddb3f894c522344dd9">String</span></td><td>통화</td></tr><tr><td>total_price</td><td><span data-option="333060e9e6504c44ba6e760cae49fa00">Float</span></td><td>총 결제금액</td></tr><tr><td>price_tax_free</td><td><span data-option="333060e9e6504c44ba6e760cae49fa00">Float</span></td><td>면세 금액</td></tr><tr><td>price_sale</td><td><span data-option="333060e9e6504c44ba6e760cae49fa00">Float</span></td><td>상품 자체 할인 금액</td></tr><tr><td>deliv_price</td><td><span data-option="333060e9e6504c44ba6e760cae49fa00">Float</span></td><td>배송비</td></tr><tr><td>point</td><td><span data-option="333060e9e6504c44ba6e760cae49fa00">Float</span></td><td>사용 적립금</td></tr><tr><td>coupon</td><td><span data-option="333060e9e6504c44ba6e760cae49fa00">Float</span></td><td>쿠폰 할인액</td></tr><tr><td>membership_discount</td><td><span data-option="333060e9e6504c44ba6e760cae49fa00">Float</span></td><td>회원 그룹 할인액</td></tr><tr><td>period_discount</td><td><span data-option="333060e9e6504c44ba6e760cae49fa00">Float</span></td><td>즉시/기간 할인액</td></tr><tr><td>payment_amount</td><td><span data-option="333060e9e6504c44ba6e760cae49fa00">Float</span></td><td>실제 결제 금액</td></tr></tbody></table>

### OrderReceipt Data

<table><thead><tr><th width="150">항목</th><th width="150">타입<select><option value="c68c1b3ba66047ddb3f894c522344dd9" label="String" color="blue"></option><option value="ae66905fb4d043f08048bd0e3e875b36" label="Integer" color="blue"></option><option value="8e89f7fab0774326b1a949bf03d33371" label="Array" color="blue"></option><option value="69695b1ee5e44f05a84f1ac2394bd65f" label="Boolean" color="blue"></option></select></th><th>설명</th></tr></thead><tbody><tr><td>request</td><td><span data-option="c68c1b3ba66047ddb3f894c522344dd9">String</span></td><td><p>현금영수증 신청 여부</p><ul><li>AUTO: 자동 발행</li><li>Y: 신청</li><li>N: 미신청</li></ul></td></tr><tr><td>type</td><td><span data-option="c68c1b3ba66047ddb3f894c522344dd9">String</span></td><td><p>현금영수증 종류</p><ul><li>deducation: 소득공제용</li><li>proof: 지출증빙용</li></ul></td></tr><tr><td>value</td><td><span data-option="c68c1b3ba66047ddb3f894c522344dd9">String</span></td><td>현금영수증 신청 정보</td></tr><tr><td>status</td><td><span data-option="c68c1b3ba66047ddb3f894c522344dd9">String</span></td><td><p>현금영수증 처리 상태</p><ul><li>WAIT: 처리 대기</li><li>COMPLETE: 처리 완료</li></ul></td></tr><tr><td>complete_date</td><td><span data-option="c68c1b3ba66047ddb3f894c522344dd9">String</span></td><td><p>현금영수증 발행일</p><p>Timestamp</p></td></tr></tbody></table>

### **OrderForm Data**

<table><thead><tr><th width="150">항목</th><th width="150">타입<select multiple><option value="c68c1b3ba66047ddb3f894c522344dd9" label="String" color="blue"></option><option value="ae66905fb4d043f08048bd0e3e875b36" label="Integer" color="blue"></option><option value="8e89f7fab0774326b1a949bf03d33371" label="Array" color="blue"></option><option value="69695b1ee5e44f05a84f1ac2394bd65f" label="Boolean" color="blue"></option></select></th><th>설명</th></tr></thead><tbody><tr><td>type</td><td><span data-option="c68c1b3ba66047ddb3f894c522344dd9">String</span></td><td><p>입력폼 타입</p><ul><li>text: 한 줄 텍스트</li><li>textarea: 여러 줄 텍스트</li><li>radio: 단일선택</li><li>select: 목록선택</li><li>checkbox: 복수선택</li><li>date: 날짜형식</li><li>time: 시간형식</li><li>file: 파일 업로드</li></ul></td></tr><tr><td>title</td><td><span data-option="c68c1b3ba66047ddb3f894c522344dd9">String</span></td><td>입력폼 항목 제목</td></tr><tr><td>desc</td><td><span data-option="c68c1b3ba66047ddb3f894c522344dd9">String</span></td><td>입력폼 항목 설명</td></tr><tr><td>value</td><td><span data-option="c68c1b3ba66047ddb3f894c522344dd9">String</span></td><td><p>입력폼 항목 사용자 입력값</p><p><a href="#undefined-2">입력폼 항목 사용자 입력값 예시</a> 참고</p></td></tr></tbody></table>

### 입력폼 항목 사용자 입력값 예시

**text, textarea, radio, select, date, time** (string)

```
[value] => 홍길동
```

**checkboxarray** (string)

```
[value] => Array
(
	[0] => 농구
	[1] => 배구
)
```

file (array)

{% hint style="danger" %}
file 타입에서 URL은 주문서 조회 API를 호출한 IP에서만 접근 가능합니다.
{% endhint %}

```
[value] => Array
(
	[name] => 파일명
	[url] => /shop_form_file_download.cm?secret={secret}
	[size] => 파일용량
)
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://old-developers.imweb.me/orders/get.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.