For the complete documentation index, see llms.txt. This page is also available as Markdown.

프로모션 관리

프로모션 다국어 등록

post

기능설명

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


상세설명

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

    • 프로모션/사은행사명

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

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

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
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
post/v1/marketing/prmMltLngMgmt/saveMultilingualInfo
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
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
get/v1/member/memberMgmt/getCustomerCouponGrid
GET /api/bo/v1/member/memberMgmt/getCustomerCouponGrid?argSelectType=1&mbrNo=10000001&startDate=2026-01-01T00%3A00%3A00.000Z&endDate=2026-01-01T00%3A00%3A00.000Z&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-01-01T00:00:00.000Z",
      "useGbCd": "01",
      "useGbNm": "주문사용",
      "dcRateAmt": 1000,
      "fixamtFxrtGbCd": "01",
      "fixamtFxrtGbNm": "정액",
      "expiredYn": "Y"
    }
  ]
}

프로모션 다국어 정보 조회

get

기능설명

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


상세설명

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

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

Authorizations
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
get/v1/marketing/prmMltLngMgmt/getMultilingualInfo
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
}

마지막 업데이트