프로모션 관리

프로모션 다국어 등록

post

기능설명

• 프로모션의 다국어 정보를 등록합니다.

---

상세설명

• 프로모션 다국어 유형 코드와 언어코드에 맞게 아래의 다국어 정보를 등록합니다.

  • 프로모션/사은행사명

  • 프로모션/사은행사설명

• 쿠폰, 할인/마일리지, 사은행사에서 사용합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

promoKeystringRequired

프로모션키(promoNo, aeNo)

Example: C1004061

promoCallTypstringRequired

프로모션 다국어 유형 코드(PromotionType) 10 : 쿠폰, 20 : 할인/마일리지, 30 : 사은행사

Example: 10

dataLangCdstringOptional

언어코드(CM009) ko: 한국어, en: 영어

Example: ko

nmstringOptional

프로모션/사은행사명

Example: 프로모션/사은행사명

descstringOptional

프로모션/사은행사설명

Example: 프로모션/사은행사설명

Responses

200

성공

*/*

stringOptional

900

업무처리 오류 내용

*/*

post

/v1/marketing/prmMltLngMgmt/saveMultilingualInfo

HTTPcURLJavaScriptPython

POST /api/bo/v1/marketing/prmMltLngMgmt/saveMultilingualInfo HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 136

{
  "promoKey": "C1004061",
  "promoCallTyp": 10,
  "dataLangCd": "ko",
  "nm": "프로모션/사은행사명",
  "desc": "프로모션/사은행사설명"
}

text

쿠폰 목록, 개수 조회

get

기능설명

• 쿠폰의 목록과 개수를 조회 합니다.

---

상세설명

• 검색조건에 맞는 쿠폰 목록과 개수를 조회합니다. 검색조건은 아래와 같습니다.

  • 쿠폰 유효기간

  • 쿠폰유형

  • 사용여부

  • 기간만료 여부

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

argSelectTypestring · min: 1Required

선택구분 1: 단일, N: 다중

Example: 1

mbrNostringRequired

회원번호

Example: 10000001

startDatestring · date-timeRequired

시작일자

endDatestring · date-timeRequired

종료일자

useYNstringOptional

사용여부 Y: 사용, N: 미사용

Example: Y

promoDivstringRequired

쿠폰조회 구분코드 Y: 무료배송/반품쿠폰, N: 쿠폰

Example: Y

expiredCdstringOptional

기간만료조회코드 10: 기간유효, 20: 기간만료

Example: 10

Responses

200

성공

*/*

totalCountinteger · int32Optional

900

업무처리 오류 내용

*/*

get

/v1/member/memberMgmt/getCustomerCouponGrid

HTTPcURLJavaScriptPython

GET /api/bo/v1/member/memberMgmt/getCustomerCouponGrid?argSelectType=1&mbrNo=10000001&startDate=2026-02-27T20%3A07%3A44.431Z&endDate=2026-02-27T20%3A07%3A44.431Z&promoDiv=Y HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "cpnIsuNo": "0000001",
      "mbrNo": 10000001,
      "useYn": "Y",
      "ordNo": "20230808O007404",
      "ordSeq": 1,
      "promoNo": "C1000001",
      "promoNm": "쿠폰명",
      "promoTypCd": 11,
      "promoTypNm": "상품할인쿠폰",
      "validDtm": "text",
      "useDtm": "2026-02-27T20:07:44.431Z",
      "useGbCd": "01",
      "useGbNm": "주문사용",
      "dcRateAmt": 1000,
      "fixamtFxrtGbCd": "01",
      "fixamtFxrtGbNm": "정액",
      "expiredYn": "Y"
    }
  ]
}

프로모션 다국어 정보 조회

get

기능설명

• 프로모션의 다국어 정보를 조회합니다.

---

상세설명

• 프로모션 다국어 유형 코드와 언어코드로 프로모션의 다국어 정보를 조회합니다.

• 쿠폰, 할인/마일리지, 사은행사에서 사용합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

promoKeystringRequired

프로모션키(promoNo, aeNo)

Example: C1004061

promoCallTypstringRequired

프로모션 다국어 유형 코드(PromotionType) 10 : 쿠폰, 20 : 할인/마일리지, 30 : 사은행사

Example: 10

dataLangCdstringOptional

언어코드(CM009) ko: 한국어, en: 영어

Example: ko

nmstringOptional

프로모션/사은행사명

Example: 프로모션/사은행사명

descstringOptional

프로모션/사은행사설명

Example: 프로모션/사은행사설명

Responses

200

성공

*/*

promoKeystringRequired

프로모션키(promoNo, aeNo)

Example: C1004061

promoCallTypstringRequired

프로모션 다국어 유형 코드 10 : 쿠폰, 20 : 할인/마일리지, 30 : 사은행사

Example: 10

dataLangCdstringOptional

언어코드(CM009) ko: 한국어, en: 영어

Example: en

defaultNmstringOptional

기본 프로모션/사은행사명

Example: 프로모션/사은행사명

langNmstringOptional

다국어 프로모션/사은행사명

Example: name

defaultDescstringOptional

기본 프로모션/사은행사설명

Example: 프로모션/사은행사설명

langDescstringOptional

다국어 프로모션/사은행사설명

Example: description

changePosiblebooleanOptional

변경가능여부

Example: true

900

업무처리 오류 내용

*/*

get

/v1/marketing/prmMltLngMgmt/getMultilingualInfo

HTTPcURLJavaScriptPython

GET /api/bo/v1/marketing/prmMltLngMgmt/getMultilingualInfo?promoKey=C1004061&promoCallTyp=10 HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "promoKey": "C1004061",
  "promoCallTyp": 10,
  "dataLangCd": "en",
  "defaultNm": "프로모션/사은행사명",
  "langNm": "name",
  "defaultDesc": "프로모션/사은행사설명",
  "langDesc": "description",
  "changePosible": true
}