# 쿠폰 코드 API 에러메시지 안내

업데이트 일자: 2023. 1.25

```
[FAQ] 샵바이프리미엄 1:1문의를 통해 문의가 자주 들어오는 공통질문을 모아서 답변하는 콘텐츠입니다.  
```

❓질문

쿠폰 코드 관련 API 요청 시, 응답될 수 있는 에러코드 및 메시지가 궁금합니다.

❗답변

아래 쿠폰 코드 관련 API의 에러 코드/메시지 참고 부탁드립니다.\
상황에 따라 아래 에러 코드 외에 다른 에러도 발생할 수 있으며, 모든 에러에 대한 코드 정보를 다 취합할 수 없는 부분 참고 부탁드립니다.

```java
// 쿠폰 코드
CODE_GENERATE_FAIL("C0001", "coupon.couponCodeErrorCode.codeGenerateFail"),
NOT_RANDOM_CODE_ISSUE_TYPE("C0002", "coupon.couponCodeErrorCode.notRandomCodeIssueType"),
INVALID_COUPON_CODE("C1016", "coupon.couponCodeErrorCode.invalidCouponCode"),
ALREADY_USED_COUPON_CODE("C1011", "coupon.couponCodeErrorCode.alreadyUsedCouponCode"),
FOUND_MORE_THAN_ONE_COUPON("C1012", "coupon.couponCodeErrorCode.foundMoreThanOneCoupon"),
LIMIT_ISSUE_PER_PERSON_CNT("C1013", "coupon.couponCodeErrorCode.limitIssuePerPersonCnt"),
LIMIT_DAILY_ISSUE_PER_PERSON_CNT("C1014", "coupon.couponCodeErrorCode.limitDailyIssuePerPersonCnt"),
GENERATE_MORE_THAN_MAX_COUNT("C1015", "coupon.couponCodeErrorCode.generateMoreThanMaxCount"),


//기타
NOT_FOUND_COUPON("C0021", "coupon.couponErrorCode.notFoundCoupon"),
INVALID_PROMOTION_CODE("C0022", "coupon.couponErrorCode.invalidPromotionCode"),
INVALID_CHANNEL_TYPE("C0025", "coupon.couponErrorCode.invalidChannelType"),
NOT_DOWNLOAD_PERIOD("C1002", "coupon.couponErrorCode.notDownloadPeriod"),
NOT_DOWNLOAD_HOUR("C1003", "coupon.couponErrorCode.notDownloadHour"),
NOT_PERMITTED_PLATFORM("C1008", "coupon.couponErrorCode.notPermittedPlatform"),
NOT_ISSUEABLE_DAY_OF_WEEK("C1009", "coupon.couponErrorCode.notIssueableDayOfWeek"),
ISSUE_STOP("C1014", "coupon.couponErrorCode.issueStop"),
ISSUE_END("C1015", "coupon.couponErrorCode.issueEnd"),
NOT_PERMITTED_MEMBERGRADE("C1018", "coupon.couponErrorCode.notPermittedMembergrade"),
NOT_PERMITTED_MEMBERGROUP("C1026", "coupon.couponErrorCode.notPermittedMembergroup"),

LIMIT_REGISTER_PER_PERSON_CNT("C1012", "coupon.couponErrorCode.limitRegisterPerPersonCnt"),
LIMIT_DAILY_REGISTER_PER_PERSON_CNT("C1013", "coupon.couponErrorCode.limitDailyRegisterPerPersonCnt"),
LIMIT_ISSUE_CNT("C1004", "coupon.couponErrorCode.limitIssueCnt"),
LIMIT_DAILY_ISSUE_CNT("C1005", "coupon.couponErrorCode.limitDailyIssueCnt"),
LIMIT_ISSUE_PER_PERSON_CNT("C1006", "coupon.couponErrorCode.limitIssuePerPersonCnt"),
LIMIT_DAILY_ISSUE_PER_PERSON_CNT("C1007", "coupon.couponErrorCode.limitDailyIssuePerPersonCnt"),
```

```java
// 쿠폰 코드
coupon.couponCodeErrorCode.codeGenerateFail=쿠폰코드생성에 실패하였습니다.
coupon.couponCodeErrorCode.notRandomCodeIssueType=난수코드 발행유형이 아닙니다.
coupon.couponCodeErrorCode.alreadyUsedCouponCode=이미 발급이 완료된 프로모션 코드입니다.
coupon.couponCodeErrorCode.foundMoreThanOneCoupon=해당 쿠폰은 발급이 불가합니다. 상세 내용은 운영자에게 문의하세요.
coupon.couponCodeErrorCode.invalidCouponCode=올바르지 않은 쿠폰 코드입니다.
coupon.couponCodeErrorCode.limitIssuePerPersonCnt=최대 {0}개까지 등록할 수 있습니다.
coupon.couponCodeErrorCode.limitDailyIssuePerPersonCnt=1일 최대 {0}개까지 등록할 수 있습니다.
coupon.couponCodeErrorCode.generateMoreThanMaxCount=쿠폰은 최대 100,000개까지 발급할 수 있습니다.
```

```javascript
// 기타
coupon.couponErrorCode.notFoundCoupon=쿠폰 데이터가 존재하지 않습니다.
coupon.couponErrorCode.invalidPromotionCode=잘못된 프로모션 코드 입니다.(이모지 는 입력 하실 수 없습니다.)
coupon.couponErrorCode.invalidChannelType=발급/사용 채널이 올바르지 않습니다.
coupon.couponErrorCode.notDownloadPeriod=할인쿠폰 발급기간이 아닙니다.
coupon.couponErrorCode.notDownloadHour={0}시~{1}시에만 발급 가능한 할인 쿠폰 입니다.
coupon.couponErrorCode.notPermittedPlatform={0}에서 발급 가능한 할인쿠폰입니다.
coupon.couponErrorCode.notIssueableDayOfWeek={0}에 발급 가능한 쿠폰입니다.
coupon.couponErrorCode.issueStop=할인쿠폰 발급이 일시중지 되었습니다.
coupon.couponErrorCode.issueEnd=할인쿠폰 발급이 종료되었습니다.
coupon.couponErrorCode.notPermittedMembergrade={0} 회원등급만 발급 가능한 할인쿠폰 입니다.
coupon.couponErrorCode.notPermittedMembergroup={0} 회원그룹만 발급 가능한 할인쿠폰 입니다.

coupon.couponErrorCode.limitRegisterPerPersonCnt=같은 종류의 쿠폰은 {0}번만 등록하실 수 있습니다.
coupon.couponErrorCode.limitDailyRegisterPerPersonCnt=같은 종류의 쿠폰은 하루에 {0}번만 등록하실 수 있습니다.
coupon.couponErrorCode.limitIssueCnt=할인쿠폰이 모두 매진 되었습니다.
coupon.couponErrorCode.limitDailyIssueCnt=오늘의 할인쿠폰 발급이 매진되었습니다. 내일 또 방문 해 주세요.
coupon.couponErrorCode.limitIssuePerPersonCnt=고객님께서는 할인쿠폰을 모두 발급 받으셨습니다.
coupon.couponErrorCode.limitDailyIssuePerPersonCnt=고객님께서는 할인쿠폰을 모두 발급 받으셨습니다. 내일 또 방문 해 주세요.
```


---

# 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://workspace-help.nhn-commerce.com/contents/faq/error_coupon.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.