# 쿠폰 발급
## 상품상세 다운로드가능 쿠폰 조회
> \## 기능설명\
> \* 상품에 다운로드가능/사용가능한 쿠폰을 조회합니다\
> \---\
> \## 상세설명\
> \* \*\*비회원은 해당 API를 사용할 수 없는 회원 전용 API입니다.\*\*\
> \* 상품에 다운로드가능/사용가능한 쿠폰을 조회합니다.\
> \* 사용가능 쿠폰 조회(쿠폰타입 = 10)\
> \* 조회 조건\
> \* \*\*프로모션유형\*\*: 상품할인쿠폰, 장바구니쿠폰, 중복할인쿠폰, 무료배송쿠폰, 무료반품쿠폰\
> \* \*\*쿠폰발급주체\*\*: 전부\
> \* \*\*쿠폰발급방식\*\*: 전부\
> \* 다운로드가능 쿠폰 조회(쿠폰타입 = 20)\
> \* 조회 조건\
> \* \*\*프로모션유형\*\*: 상품할인쿠폰, 장바구니쿠폰, 중복할인쿠폰, 무료배송쿠폰, 무료반품쿠폰\
> \* \*\*쿠폰발급주체\*\*: 고정판촉쿠폰\
> \* \*\*쿠폰발급방식\*\*: 고객다운로드발급, 할인쿠폰코드발급\
> \---\
> \## 수정번호\
> \* Release v2.00\_240425: 최소 구매금액, 최대할인금액 데이터 추가\
> \* Release v2.00\_240509: 적용대상 - 기획전 정보 조회 추가
```json
{"openapi":"3.0.1","info":{"title":"X2BEE Order API","version":"v1"},"servers":[{"url":"https://api-order.x2bee.com/api/order/","description":"prd"}],"paths":{"/v1/marketing/goodsDetailCpnList":{"post":{"tags":["쿠폰 발급"],"summary":"상품상세 다운로드가능 쿠폰 조회","description":"## 기능설명\n* 상품에 다운로드가능/사용가능한 쿠폰을 조회합니다\n---\n## 상세설명\n* **비회원은 해당 API를 사용할 수 없는 회원 전용 API입니다.**\n* 상품에 다운로드가능/사용가능한 쿠폰을 조회합니다.\n* 사용가능 쿠폰 조회(쿠폰타입 = 10)\n * 조회 조건\n * **프로모션유형**: 상품할인쿠폰, 장바구니쿠폰, 중복할인쿠폰, 무료배송쿠폰, 무료반품쿠폰\n * **쿠폰발급주체**: 전부\n * **쿠폰발급방식**: 전부\n* 다운로드가능 쿠폰 조회(쿠폰타입 = 20)\n * 조회 조건\n * **프로모션유형**: 상품할인쿠폰, 장바구니쿠폰, 중복할인쿠폰, 무료배송쿠폰, 무료반품쿠폰\n * **쿠폰발급주체**: 고정판촉쿠폰\n * **쿠폰발급방식**: 고객다운로드발급, 할인쿠폰코드발급\n---\n## 수정번호\n* Release v2.00_240425: 최소 구매금액, 최대할인금액 데이터 추가\n* Release v2.00_240509: 적용대상 - 기획전 정보 조회 추가\n","operationId":"getCpnListForGoodsDetail","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoodsDetailCpnListRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/GoodsDetailCpnListResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"GoodsDetailCpnListRequest":{"required":["cpnType","goodsList","ordMediaCd","pageIdx","rowsPerPage","sortGb"],"type":"object","properties":{"ordMediaCd":{"type":"string","description":"주문매체 코드(OM007)\n 10 : 전화상담(CC)\n, 20 : PC\n, 30 : 모바일웹\n, 40 : 안드로이드앱\n, 50 : IOS앱\n, 60 : 정기주문\n","enum":["10","20","30","40","50","60"]},"cpnType":{"type":"string","description":"상품상세쿠폰조회조건\n 10 : 사용가능쿠폰\n , 20 : 다운로드가능쿠폰\n","enum":["10","20"]},"sortGb":{"type":"string","description":"쿠폰정렬순서\n 10 : 최근등록순\n , 20 : 마감임박순\n","enum":["10","20"]},"rowsPerPage":{"type":"integer","description":"화면당노출수량","format":"int32"},"pageIdx":{"type":"integer","description":"페이지번호","format":"int32"},"goodsList":{"type":"array","description":"상품 리스트","items":{"$ref":"#/components/schemas/GoodsDetailGoodsInfo"}}}},"GoodsDetailGoodsInfo":{"required":["brandNo","chlNo","cnt","dispCtgNo","entrNo","goodsNo","infDispCtgNo","infDispCtgNoGbCd","itmNo","norPrc","salePrc","stdCtgNo","supPcost"],"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"supPcost":{"type":"integer","description":"공급원가","format":"int64"},"norPrc":{"type":"integer","description":"정상가","format":"int64"},"salePrc":{"type":"integer","description":"판매가","format":"int64"},"cnt":{"type":"integer","description":"수량","format":"int32"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"dispCtgNo":{"type":"string","description":"전시카테고리번호"},"brandNo":{"type":"string","description":"브랜드번호"},"entrNo":{"type":"string","description":"협력사번호"},"chlNo":{"type":"string","description":"채널번호"},"infDispCtgNoGbCd":{"type":"string","description":"유입전시카테고리번호구분코드"},"infDispCtgNo":{"type":"string","description":"유입전시카테고리번호"},"marketingDisplayNo":{"type":"string","description":"기획전번호"}},"description":"상품 리스트"},"GoodsDetailCpnListResponse":{"required":["cpnIssuList","pageIdx","promoCnt","rowsPerPage"],"type":"object","properties":{"promoCnt":{"type":"integer","description":"쿠폰발급수량","format":"int32"},"rowsPerPage":{"type":"integer","description":"화면당노출수량","format":"int32"},"pageIdx":{"type":"integer","description":"페이지번호","format":"int32"},"cpnIssuList":{"type":"array","description":"발급쿠폰리스트","items":{"$ref":"#/components/schemas/GoodsDetailCpnInfo"}}}},"GoodsDetailCpnInfo":{"required":["dcRateAmt","fixamtFxrtGbCd","maxDcAmt","minBuyAmt","promoNm","promoNo","promoTypCd"],"type":"object","properties":{"promoNo":{"type":"string","description":"프로모션번호"},"promoNm":{"type":"string","description":"프로모션명"},"promoTypCd":{"type":"string","description":"프로모션 유형 코드(MK002)\n 11 : 상품할인쿠폰\n , 12 : 장바구니쿠폰\n , 13 : 중복할인쿠폰\n , 14 : 무료배송쿠폰\n , 15 : 무료반품쿠폰\n , 20 : 임직원할인\n , 21 : 상품즉시할인\n , 40 : 상품마일리지\n","enum":["11","12","13","14","15","20","21","40"]},"promoDesc":{"type":"string","description":"프로모션설명"},"cpnIsuNo":{"type":"string","description":"쿠폰발급번호"},"valiStrtDtm":{"type":"string","description":"유효시작일시","format":"date-time"},"valiEndDtm":{"type":"string","description":"유효종료일시","format":"date-time"},"fixamtFxrtGbCd":{"type":"string","description":"정액정율구분 코드(MK005)\n 01 : 정액\n , 02 : 정률\n","enum":["01","02"]},"dcRateAmt":{"type":"integer","description":"할인율금액","format":"int64"},"dcCpnCd":{"type":"string","description":"할인쿠폰코드"},"minBuyAmt":{"type":"integer","description":"최소구매금액","format":"int64"},"maxDcAmt":{"type":"integer","description":"최대할인금액","format":"int64"}},"description":"발급쿠폰리스트"},"Response":{"type":"object","properties":{"timestamp":{"type":"string","description":"result time","format":"date-time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}},"description":"validation error list"}}}}
```
## 쿠폰 다운로드(FO)
> \## 기능설명\
> \* FO에서 쿠폰을 다운로드할 때 사용하는 API입니다.\
> \---\
> \## 상세설명\
> \* \*\*비회원은 해당 API를 사용할 수 없는 회원 전용 API입니다.\*\*\
> \* 프로모션 번호\
> \* 발급방식코드가 03(고객다운로드발급) 인 쿠폰만 다운로드 가능합니다.\
> \* 같은 쿠폰을 여러장 받으려면, 프로모션 번호를 원하는 개수 만큼 넣어야합니다.\
> \* 할인쿠폰코드\
> \* 발급방식코드가 04(할인쿠폰코드발급) 인 쿠폰만 다운로드 가능합니다.
```json
{"openapi":"3.0.1","info":{"title":"X2BEE Order API","version":"v1"},"servers":[{"url":"https://api-order.x2bee.com/api/order/","description":"prd"}],"paths":{"/v1/marketing/cpnDown":{"post":{"tags":["쿠폰 발급"],"summary":"쿠폰 다운로드(FO)","description":"## 기능설명\n* FO에서 쿠폰을 다운로드할 때 사용하는 API입니다.\n---\n## 상세설명\n* **비회원은 해당 API를 사용할 수 없는 회원 전용 API입니다.**\n* 프로모션 번호\n * 발급방식코드가 03(고객다운로드발급) 인 쿠폰만 다운로드 가능합니다.\n * 같은 쿠폰을 여러장 받으려면, 프로모션 번호를 원하는 개수 만큼 넣어야합니다.\n* 할인쿠폰코드\n * 발급방식코드가 04(할인쿠폰코드발급) 인 쿠폰만 다운로드 가능합니다.\n","operationId":"cpnDownFo","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CpnDownFoRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CpnDownResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"CpnDownFoRequest":{"type":"object","properties":{"promoNoList":{"type":"array","description":"프로모션번호(cpnNo)","items":{"type":"string","description":"프로모션번호(cpnNo)"}},"dcCpnCd":{"type":"string","description":"할인쿠폰코드"},"downloadByPromoNo":{"type":"boolean"}}},"CpnDownResponse":{"required":["cpnIssuList"],"type":"object","properties":{"cpnIssuList":{"type":"array","description":"쿠폰발급정보","items":{"$ref":"#/components/schemas/CpnIsuInfo"}}}},"CpnIsuInfo":{"required":["cpnIsuNo","promoNm","promoNo"],"type":"object","properties":{"promoNo":{"type":"string","description":"프로모션번호"},"promoNm":{"type":"string","description":"프로모션명"},"cpnIsuNo":{"type":"string","description":"쿠폰발급번호"}},"description":"쿠폰발급정보"},"Response":{"type":"object","properties":{"timestamp":{"type":"string","description":"result time","format":"date-time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}},"description":"validation error list"}}}}
```
## 쿠폰 다운로드(BO)
> \## 기능설명\
> \* 배치, BO에서 쿠폰 다운로드를 할 때 사용하는 API입니다.\
> \---\
> \## 상세설명\
> \* 발급방식코드가 조건부자동발급쿠폰인 경우 자동발급수량만큼 발급됩니다.\
> \* 시스템사용자번호\
> \* 배치: BATCH\
> \* BO: 시스템 사용자의 ID
```json
{"openapi":"3.0.1","info":{"title":"X2BEE Order API","version":"v1"},"servers":[{"url":"https://api-order.x2bee.com/api/order/","description":"prd"}],"paths":{"/v1/marketing/cpnDownBo":{"post":{"tags":["쿠폰 발급"],"summary":"쿠폰 다운로드(BO)","description":"## 기능설명\n* 배치, BO에서 쿠폰 다운로드를 할 때 사용하는 API입니다.\n---\n## 상세설명\n* 발급방식코드가 조건부자동발급쿠폰인 경우 자동발급수량만큼 발급됩니다.\n* 시스템사용자번호\n * 배치: BATCH\n * BO: 시스템 사용자의 ID\n","operationId":"cpnDownBo","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CpnDownBoRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CpnDownResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"CpnDownBoRequest":{"required":["autoIssuOdr","mbrNo","promoNoList","systemUserNo"],"type":"object","properties":{"promoNoList":{"type":"array","description":"프로모션번호(cpnNo)","items":{"type":"string","description":"프로모션번호(cpnNo)"}},"mbrNo":{"type":"string","description":"회원번호"},"csCpnPayCausCd":{"type":"string","description":"쿠폰발급사유코드(MK021)\n 01 : 상품불량\n, 02 : 배송지연\n, 03 : 상품 오배송\n, 04 : 상품품절\n, 05 : 결품취소\n, 06 : 상품누락\n, 07 : 이벤트 불만\n, 08 : 사이트 오류\n, 09 : 재주문으로 인한 쿠폰 재발급\n, 10 : 교환으로 인한 쿠폰 재발급\n, 11 : 강성고객 클레임\n, 12 : 기타\n","enum":["01","02","03","04","05","06","07","08","09","10","11","12"]},"systemUserNo":{"type":"string","description":"시스템사용자번호"},"autoIssuOdr":{"type":"string","description":"자동발급차수"},"downloadByPromoNo":{"type":"boolean"},"dcCpnCd":{"type":"string"}}},"CpnDownResponse":{"required":["cpnIssuList"],"type":"object","properties":{"cpnIssuList":{"type":"array","description":"쿠폰발급정보","items":{"$ref":"#/components/schemas/CpnIsuInfo"}}}},"CpnIsuInfo":{"required":["cpnIsuNo","promoNm","promoNo"],"type":"object","properties":{"promoNo":{"type":"string","description":"프로모션번호"},"promoNm":{"type":"string","description":"프로모션명"},"cpnIsuNo":{"type":"string","description":"쿠폰발급번호"}},"description":"쿠폰발급정보"},"Response":{"type":"object","properties":{"timestamp":{"type":"string","description":"result time","format":"date-time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}},"description":"validation error list"}}}}
```
## 자동발급유형별 쿠폰 조회
> \## 기능설명\
> \* 자동발급유형코드에 맞는 쿠폰정보를 조회합니다.\
> \---\
> \## 상세설명\
> \* 배치 또는 프로그램에서 동일한 자동발급유형에 맞는 쿠폰을 발급시키고자 하는 경우에 사용 가능합니다.\
> \* 예를 들어, 생일축하 쿠폰을 발급하고자 하면 MK008에 해당 코드를 추가하고,\
> \* 쿠폰 등록 화면에서 자동발급유형을 해당 코드로 선택하여 등록합니다.\
> \* 이후 현재 API의 request를 추가한 코드로 설정하면, 해당 코드로 등록된 쿠폰 리스트를 반환합니다.
```json
{"openapi":"3.0.1","info":{"title":"X2BEE Order API","version":"v1"},"servers":[{"url":"https://api-order.x2bee.com/api/order/","description":"prd"}],"paths":{"/v1/marketing/getCouponListByAutoIssuTypCd":{"get":{"tags":["쿠폰 발급"],"summary":"자동발급유형별 쿠폰 조회","description":"## 기능설명\n* 자동발급유형코드에 맞는 쿠폰정보를 조회합니다.\n---\n## 상세설명\n* 배치 또는 프로그램에서 동일한 자동발급유형에 맞는 쿠폰을 발급시키고자 하는 경우에 사용 가능합니다.\n* 예를 들어, 생일축하 쿠폰을 발급하고자 하면 MK008에 해당 코드를 추가하고,\n* 쿠폰 등록 화면에서 자동발급유형을 해당 코드로 선택하여 등록합니다.\n* 이후 현재 API의 request를 추가한 코드로 설정하면, 해당 코드로 등록된 쿠폰 리스트를 반환합니다.\n","operationId":"getCouponListByAutoIssuTypCd","parameters":[{"name":"autoIssuTypCd","in":"query","description":"자동발급유형코드(MK008)","required":true,"schema":{"type":"string"}},{"name":"gradeCd","in":"query","description":"회원등급코드(ME008)","required":false,"schema":{"type":"string","description":"회원등급코드(ME008)\n 10 : GREEN\n, 20 : FAMILY\n, 30 : GOLD\n, 40 : VIP\n, 50 : VVIP\n","enum":["10","20","30","40","50"]}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CouponByAutoIssuTypInfo"}}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"CouponByAutoIssuTypInfo":{"type":"object","properties":{"promoNo":{"type":"string"},"promoNm":{"type":"string"},"promoTypCd":{"type":"string"},"ourChrgRate":{"type":"integer","format":"int32"},"entrChrgRate":{"type":"integer","format":"int32"},"fixAmtFxrtGbCd":{"type":"string"},"dcRateAmt":{"type":"integer","format":"int64"},"minBuyAmt":{"type":"integer","format":"int64"},"maxDcAmt":{"type":"integer","format":"int64"},"autoIssuPotmCd":{"type":"string"},"anvyPreIsuDds":{"type":"integer","format":"int32"}},"description":"프로모션 정보"},"Response":{"type":"object","properties":{"timestamp":{"type":"string","description":"result time","format":"date-time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}},"description":"validation error list"}}}}
```
## 회원별 쿠폰 조회
> \## 기능설명\
> \* 마이페이지 쿠폰함에서 사용자가 보유한 쿠폰 정보를 조회합니다.\
> \---\
> \## 상세설명\
> \* \*\*비회원은 해당 API를 사용할 수 없는 회원 전용 API입니다.\*\*\
> \* 사용자가 보유한 쿠폰 정보들을 조회합니다.\
> \* 단, 관리자가 회수한 쿠폰은 노출되지 않습니다.\
> \## 수정번호\
> \* Release v2.00\_240401: 마이페이지 쿠폰정보 최소구매수량, 최소구매금액, 최대적용금액, 적용가능매체 추가\
> \* Release v2.00\_240425: 사이트 검색조건 추가
```json
{"openapi":"3.0.1","info":{"title":"X2BEE Order API","version":"v1"},"servers":[{"url":"https://api-order.x2bee.com/api/order/","description":"prd"}],"paths":{"/v1/marketing/cpnIssuList":{"get":{"tags":["쿠폰 발급"],"summary":"회원별 쿠폰 조회","description":"## 기능설명\n* 마이페이지 쿠폰함에서 사용자가 보유한 쿠폰 정보를 조회합니다.\n---\n## 상세설명\n* **비회원은 해당 API를 사용할 수 없는 회원 전용 API입니다.**\n* 사용자가 보유한 쿠폰 정보들을 조회합니다.\n* 단, 관리자가 회수한 쿠폰은 노출되지 않습니다.\n## 수정번호\n* Release v2.00_240401: 마이페이지 쿠폰정보 최소구매수량, 최소구매금액, 최대적용금액, 적용가능매체 추가\n* Release v2.00_240425: 사이트 검색조건 추가\n","operationId":"getCpnIssuList","parameters":[{"name":"sortGb","in":"query","description":"쿠폰정렬순서 10: 최근등록순, 20: 마감임박순","required":true,"schema":{"type":"string","description":"쿠폰정렬순서\n 10 : 최근등록순\n , 20 : 마감임박순\n","enum":["10","20"]}},{"name":"rowsPerPage","in":"query","description":"화면당노출수량","required":true,"schema":{"type":"integer","description":"화면당노출수량"}},{"name":"pageIdx","in":"query","description":"페이지번호","required":true,"schema":{"type":"integer","description":"페이지번호"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/MypageResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"MypageResponse":{"required":["promoCnt","totPromoCnt"],"type":"object","properties":{"promoCnt":{"type":"integer","description":"사용가능한 전체 쿠폰수량","format":"int32"},"totPromoCnt":{"type":"integer","description":"발급된 전체 쿠폰수량","format":"int32"},"rowsPerPage":{"type":"integer","description":"화면당노출수량","format":"int32"},"pageIdx":{"type":"integer","description":"페이지번호","format":"int32"},"cpnIssuList":{"type":"array","description":"발급쿠폰리스트","items":{"$ref":"#/components/schemas/MypageCpnInfo"}}}},"MypageCpnInfo":{"required":["cpnIsuNo","dcRateAmt","fixamtFxrtGbCd","promoNm","promoNo","promoStat","promoTypCd","remainingDay","valiEndDtm","valiStrtDtm"],"type":"object","properties":{"promoNo":{"type":"string","description":"프로모션번호(cpnNo)"},"promoNm":{"type":"string","description":"프로모션명(쿠폰명)"},"promoTypCd":{"type":"string","description":"프로모션 유형 코드(MK002)\n 11 : 상품할인쿠폰\n , 12 : 장바구니쿠폰\n , 13 : 중복할인쿠폰\n , 14 : 무료배송쿠폰\n , 15 : 무료반품쿠폰\n , 20 : 임직원할인\n , 21 : 상품즉시할인\n , 40 : 상품마일리지\n","enum":["11","12","13","14","15","20","21","40"]},"promoDesc":{"type":"string","description":"프로모션설명"},"cpnIsuNo":{"type":"string","description":"쿠폰발급번호"},"valiStrtDtm":{"type":"string","description":"유효시작일시","format":"date-time"},"valiEndDtm":{"type":"string","description":"유효종료일시","format":"date-time"},"remainingDay":{"type":"string","description":"잔여일수"},"promoStat":{"type":"string","description":"쿠폰사용상태\n 10 : 사용가능\n, 20 : 사용\n, 30 : 기간만료\n","enum":["10","20","30"]},"fixamtFxrtGbCd":{"type":"string","description":"정액정율구분 코드(MK005)\n 01 : 정액\n , 02 : 정률\n","enum":["01","02"]},"dcRateAmt":{"type":"integer","description":"할인율금액","format":"int64"},"dcCpnCd":{"type":"string","description":"할인쿠폰코드"},"minBuyQty":{"type":"integer","description":"최소구매수량","format":"int32"},"minBuyAmt":{"type":"integer","description":"최소구매금액","format":"int64"},"maxDcAmt":{"type":"integer","description":"최대적용금액","format":"int64"},"mediaCdNmArray":{"type":"string","description":"적용가능매체"}},"description":"발급쿠폰리스트"},"Response":{"type":"object","properties":{"timestamp":{"type":"string","description":"result time","format":"date-time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}},"description":"validation error list"}}}}
```
---
# 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://tech.x2bee.com/api/store-front-api/order-api/undefined-15.md?ask=
```
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.