> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api/back-office-api/popup-bo-api/undefined-4.md).
# 프로모션 관리
## 프로모션 다국어 등록
> \## 기능설명\
> \* 프로모션의 다국어 정보를 등록합니다.\
> \---\
> \## 상세설명\
> \* 프로모션 다국어 유형 코드와 언어코드에 맞게 아래의 다국어 정보를 등록합니다.\
> \* 프로모션/사은행사명\
> \* 프로모션/사은행사설명\
> \* 쿠폰, 할인/마일리지, 사은행사에서 사용합니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"PromotionMultillingualRequest":{"type":"object","properties":{"promoKey":{"type":"string","description":"프로모션키(promoNo, aeNo)"},"promoCallTyp":{"type":"string","description":"프로모션 다국어 유형 코드(PromotionType) 10 : 쿠폰, 20 : 할인/마일리지, 30 : 사은행사"},"dataLangCd":{"type":"string","description":"언어코드(CM009) ko: 한국어, en: 영어"},"nm":{"type":"string","description":"프로모션/사은행사명"},"desc":{"type":"string","description":"프로모션/사은행사설명"}},"required":["promoCallTyp","promoKey"]},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"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"}}}}},"paths":{"/v1/marketing/prmMltLngMgmt/saveMultilingualInfo":{"post":{"tags":["프로모션 관리"],"summary":"프로모션 다국어 등록","description":"## 기능설명\n* 프로모션의 다국어 정보를 등록합니다.\n---\n## 상세설명\n* 프로모션 다국어 유형 코드와 언어코드에 맞게 아래의 다국어 정보를 등록합니다.\n * 프로모션/사은행사명\n * 프로모션/사은행사설명\n* 쿠폰, 할인/마일리지, 사은행사에서 사용합니다.\n","operationId":"saveMultilingualInfo","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PromotionMultillingualRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 쿠폰 목록, 개수 조회
> \## 기능설명\
> \* 쿠폰의 목록과 개수를 조회 합니다.\
> \---\
> \## 상세설명\
> \* 검색조건에 맞는 쿠폰 목록과 개수를 조회합니다. 검색조건은 아래와 같습니다.\
> \* 쿠폰 유효기간\
> \* 쿠폰유형\
> \* 사용여부\
> \* 기간만료 여부
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"RealGridListResponseOrderClaimCoupon":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/OrderClaimCoupon"}}}},"OrderClaimCoupon":{"type":"object","properties":{"cpnIsuNo":{"type":"string","description":"쿠폰발급번호","minLength":1},"mbrNo":{"type":"string","description":"회원번호","minLength":1},"useYn":{"type":"string","description":"사용여부"},"ordNo":{"type":"string","description":"주문번호"},"ordSeq":{"type":"string","description":"주문순번"},"promoNo":{"type":"string","description":"쿠폰번호"},"promoNm":{"type":"string","description":"쿠폰명"},"promoTypCd":{"type":"string","description":"쿠폰유형","enum":["11","12","13","14","15","20","21","40"]},"promoTypNm":{"type":"string","description":"쿠폰유형명"},"validDtm":{"type":"string","description":"유효기간"},"useDtm":{"type":"string","format":"date-time","description":"사용일시"},"useGbCd":{"type":"string","description":"사용구분코드"},"useGbNm":{"type":"string","description":"사용구분명"},"dcRateAmt":{"type":"number","description":"할인금액"},"fixamtFxrtGbCd":{"type":"string","description":"할인(정액/정율)구분 코드","enum":["01","02"]},"fixamtFxrtGbNm":{"type":"string","description":"할인(정액/정율)구분 코드명"},"expiredYn":{"type":"string","description":"기간만료 여부"}},"required":["cpnIsuNo","mbrNo"]},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"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"}}}}},"paths":{"/v1/member/memberMgmt/getCustomerCouponGrid":{"get":{"tags":["프로모션 관리"],"summary":"쿠폰 목록, 개수 조회","description":"## 기능설명\n* 쿠폰의 목록과 개수를 조회 합니다.\n---\n## 상세설명\n* 검색조건에 맞는 쿠폰 목록과 개수를 조회합니다. 검색조건은 아래와 같습니다.\n * 쿠폰 유효기간\n * 쿠폰유형\n * 사용여부\n * 기간만료 여부\n","operationId":"getCustomerCouponGrid","parameters":[{"name":"argSelectType","in":"query","description":"선택구분 1: 단일, N: 다중","required":true,"schema":{"type":"string","description":"선택구분 1: 단일, N: 다중","minLength":1}},{"name":"mbrNo","in":"query","description":"회원번호","required":true,"schema":{"type":"string","description":"회원번호"}},{"name":"promoTypCd","in":"query","required":false,"schema":{"type":"array","items":{"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"]}}},{"name":"startDate","in":"query","description":"시작일자","required":true,"schema":{"type":"string","format":"date-time","description":"시작일자"}},{"name":"endDate","in":"query","description":"종료일자","required":true,"schema":{"type":"string","format":"date-time","description":"종료일자"}},{"name":"useYN","in":"query","description":"사용여부 Y: 사용, N: 미사용","required":false,"schema":{"type":"string","description":"사용여부 Y: 사용, N: 미사용"}},{"name":"promoDiv","in":"query","description":"쿠폰조회 구분코드 Y: 무료배송/반품쿠폰, N: 쿠폰","required":true,"schema":{"type":"string","description":"쿠폰조회 구분코드 Y: 무료배송/반품쿠폰, N: 쿠폰"}},{"name":"expiredCd","in":"query","description":"기간만료조회코드 10: 기간유효, 20: 기간만료","required":false,"schema":{"type":"string","description":"기간만료조회코드 10: 기간유효, 20: 기간만료"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseOrderClaimCoupon"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 프로모션 다국어 정보 조회
> \## 기능설명\
> \* 프로모션의 다국어 정보를 조회합니다.\
> \---\
> \## 상세설명\
> \* 프로모션 다국어 유형 코드와 언어코드로 프로모션의 다국어 정보를 조회합니다.\
> \* 쿠폰, 할인/마일리지, 사은행사에서 사용합니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"PromotionMultillingualResponse":{"type":"object","properties":{"promoKey":{"type":"string","description":"프로모션키(promoNo, aeNo)"},"promoCallTyp":{"type":"string","description":"프로모션 다국어 유형 코드 10 : 쿠폰, 20 : 할인/마일리지, 30 : 사은행사"},"dataLangCd":{"type":"string","description":"언어코드(CM009) ko: 한국어, en: 영어"},"defaultNm":{"type":"string","description":"기본 프로모션/사은행사명"},"langNm":{"type":"string","description":"다국어 프로모션/사은행사명"},"defaultDesc":{"type":"string","description":"기본 프로모션/사은행사설명"},"langDesc":{"type":"string","description":"다국어 프로모션/사은행사설명"},"changePosible":{"type":"boolean","description":"변경가능여부"}},"required":["promoCallTyp","promoKey"]},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"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"}}}}},"paths":{"/v1/marketing/prmMltLngMgmt/getMultilingualInfo":{"get":{"tags":["프로모션 관리"],"summary":"프로모션 다국어 정보 조회","description":"## 기능설명\n* 프로모션의 다국어 정보를 조회합니다.\n---\n## 상세설명\n* 프로모션 다국어 유형 코드와 언어코드로 프로모션의 다국어 정보를 조회합니다.\n* 쿠폰, 할인/마일리지, 사은행사에서 사용합니다.\n","operationId":"getMultilingualInfo","parameters":[{"name":"promoKey","in":"query","description":"프로모션키(promoNo, aeNo)","required":true,"schema":{"type":"string","description":"프로모션키(promoNo, aeNo)"}},{"name":"promoCallTyp","in":"query","description":"프로모션 다국어 유형 코드(PromotionType) 10 : 쿠폰, 20 : 할인/마일리지, 30 : 사은행사","required":true,"schema":{"type":"string","description":"프로모션 다국어 유형 코드(PromotionType) 10 : 쿠폰, 20 : 할인/마일리지, 30 : 사은행사"}},{"name":"dataLangCd","in":"query","description":"언어코드(CM009) ko: 한국어, en: 영어","required":false,"schema":{"type":"string","description":"언어코드(CM009) ko: 한국어, en: 영어"}},{"name":"nm","in":"query","description":"프로모션/사은행사명","required":false,"schema":{"type":"string","description":"프로모션/사은행사명"}},{"name":"desc","in":"query","description":"프로모션/사은행사설명","required":false,"schema":{"type":"string","description":"프로모션/사은행사설명"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PromotionMultillingualResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```