> 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/system-bo-api/undefined-26.md).

# 공통코드 조회

## 공통코드 타입별 조회

> \## 기능설명\
> \* 공통코드를 조회 타입별로 조회합니다.\
> \---\
> \## 상세설명\
> \* 공통코드를 넘어온 조회 타입(type) 기준으로 조회합니다.\
> \* 조회타입 별 조회 방식\
> &#x20;  \* T(테이블 조회), code, 'SITE', referCode : CC\_SITE\_BASE : 사이트번호, 사이트명 조회\
> &#x20;  \* NC(노멀 타입 조회) : 일반 공통코드 순차조회\
> &#x20;  \* NMC(노멀 멀티 조회) : 일반 공통코드 순차조회\
> &#x20;  \* RC(참조값 기준 조회) : 참조1값 기준 공통코드 조회\
> \* 그룹코드, 공통코드 목록 리스트 의 형태인 Map 으로 반환합니다.\
> \* 조회언어 기준은 기본 세팅된 언어코드인 쿠키의 langCd 기준으로 조회합니다.\
> \---\
> \### 코드정리\
> \* \`\`\` 조회타입 \`\`\` : T(테이블 조회), NC(노멀 타입 조회), NMC(노멀 멀티 조회), RC(참조값 기준 조회)<br>

````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":{"CodeReqDto":{"type":"object","description":"공통코드 조회 요청 DTO","properties":{"code":{"type":"string","description":"그룹코드"},"referCode":{"type":"string","description":"참조코드"},"type":{"type":"string","description":"조회타입"},"grpCds":{"type":"string","description":"그룹코드"},"langCd":{"type":"string","description":"언어코드"}}},"ResponseMapStringListCodeResDto":{"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":{"type":"object","additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/CodeResDto"}},"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"CodeResDto":{"type":"object","description":"공통코드 조회 응답 DTO","properties":{"key":{"type":"string","description":"map의 키"},"cd":{"type":"string","description":"그룹코드"},"cdNm":{"type":"string","description":"코드명"},"ref1Val":{"type":"string","description":"참조1값"},"ref2Val":{"type":"string","description":"참조2값"},"ref3Val":{"type":"string","description":"참조3값"},"ref4Val":{"type":"string","description":"참조4값"},"ref5Val":{"type":"string","description":"참조5값"}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"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"}}}}}},"paths":{"/v1/common/code/getForwardCdCdNmByMixedCode":{"post":{"tags":["공통코드 조회"],"summary":"공통코드 타입별 조회","description":"## 기능설명\n* 공통코드를 조회 타입별로 조회합니다.\n---\n## 상세설명\n* 공통코드를 넘어온 조회 타입(type) 기준으로 조회합니다.\n* 조회타입 별 조회 방식\n   * T(테이블 조회), code, 'SITE', referCode : CC_SITE_BASE : 사이트번호, 사이트명 조회\n   * NC(노멀 타입 조회) : 일반 공통코드 순차조회\n   * NMC(노멀 멀티 조회) : 일반 공통코드 순차조회\n   * RC(참조값 기준 조회) : 참조1값 기준 공통코드 조회\n* 그룹코드, 공통코드 목록 리스트 의 형태인 Map 으로 반환합니다.\n* 조회언어 기준은 기본 세팅된 언어코드인 쿠키의 langCd 기준으로 조회합니다.\n---\n### 코드정리\n* ``` 조회타입 ``` : T(테이블 조회), NC(노멀 타입 조회), NMC(노멀 멀티 조회), RC(참조값 기준 조회)\n","operationId":"getForwardCdCdNmByMixedCode","requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CodeReqDto"}}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseMapStringListCodeResDto"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
````

## 권한 존재 버튼 조회

> \## 기능설명\
> \* 화면에 대한 권한을 가진 버튼 ID를 조회합니다.\
> \---\
> \## 상세설명\
> \* 호출URL과 시스템구분코드에 맞는 권한정보에 대해 접근이 가능한 버튼ID를 반환합니다.\
> \* '버튼ID,버튼ID' 형태로 반환합니다.\
> \* 개별 권한을 그룹 권한보다 우선하여 조회합니다.(예: 개별권한 'N', 그룹권한 'Y'시 접근권한으로 'N' 반환\
> \---\
> \## 수정번호\
> \* Release v1.00\_250320: 권한 존재 버튼 목록 화이트리스트로 변경<br>

```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":{"LoginRequest":{"type":"object","properties":{"seq":{"type":"integer","format":"int64"},"loginId":{"type":"string","minLength":1},"password":{"type":"string"},"remoteAddr":{"type":"string"},"lastAccessTime":{"type":"integer","format":"int64"},"userGbCd":{"type":"string"},"rtGrpNo":{"type":"string"},"jobGrpCd":{"type":"string"},"ocpCd":{"type":"string"},"caloUrl":{"type":"string"},"sysGbCd":{"type":"string"},"userId":{"type":"string"},"pwd":{"type":"string"},"userNm":{"type":"string"},"cellSctNo":{"type":"string"},"cellTxnoNo":{"type":"string"},"cellEndNo":{"type":"string"},"pwdIniYn":{"type":"string"},"sessId":{"type":"string"},"tpCd":{"type":"string"},"entrNo":{"type":"string"},"entrNm":{"type":"string"},"applicationName":{"type":"string"},"privacyPolicyInfoList":{"type":"array","items":{"$ref":"#/components/schemas/PrivacyPolicyInfo"}},"accountNonExpired":{"type":"boolean"},"accountNonLocked":{"type":"boolean"},"credentialsNonExpired":{"type":"boolean"},"username":{"type":"string"},"permissionToViewPersonalInfo":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"enabled":{"type":"boolean"}},"required":["loginId"]},"PrivacyPolicyInfo":{"type":"object","description":"개인정보취급권한 DTO","properties":{"userId":{"type":"string","description":"사용자 아이디"},"indInfoGbCd":{"type":"string","description":"개인정보구분코드(UR008)"},"useYn":{"type":"string","description":"사용여부"}}},"ResponseString":{"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":{"type":"string","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"}}},"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"}}}}}},"paths":{"/v1/common/code/getEnabledButtonByPageRoleList":{"post":{"tags":["공통코드 조회"],"summary":"권한 존재 버튼 조회","description":"## 기능설명\n* 화면에 대한 권한을 가진 버튼 ID를 조회합니다.\n---\n## 상세설명\n* 호출URL과 시스템구분코드에 맞는 권한정보에 대해 접근이 가능한 버튼ID를 반환합니다.\n* '버튼ID,버튼ID' 형태로 반환합니다.\n* 개별 권한을 그룹 권한보다 우선하여 조회합니다.(예: 개별권한 'N', 그룹권한 'Y'시 접근권한으로 'N' 반환\n---\n## 수정번호\n* Release v1.00_250320: 권한 존재 버튼 목록 화이트리스트로 변경\n","operationId":"getEnabledButtonByPageRoleList","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 권한 없는 저장버튼 조회

> \## 기능설명\
> \* 화면에 대한 저장 권한이 없는 버튼 ID를 조회합니다.\
> \---\
> \## 상세설명\
> \* 호출URL과 시스템구분코드에 맞는 데이터 저장에 관한 권한정보에 대해 접근이 불가능한 버튼ID를 반환합니다.\
> \* '#버튼ID,#버튼ID' 형태로 반환합니다.<br>

```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":{"LoginRequest":{"type":"object","properties":{"seq":{"type":"integer","format":"int64"},"loginId":{"type":"string","minLength":1},"password":{"type":"string"},"remoteAddr":{"type":"string"},"lastAccessTime":{"type":"integer","format":"int64"},"userGbCd":{"type":"string"},"rtGrpNo":{"type":"string"},"jobGrpCd":{"type":"string"},"ocpCd":{"type":"string"},"caloUrl":{"type":"string"},"sysGbCd":{"type":"string"},"userId":{"type":"string"},"pwd":{"type":"string"},"userNm":{"type":"string"},"cellSctNo":{"type":"string"},"cellTxnoNo":{"type":"string"},"cellEndNo":{"type":"string"},"pwdIniYn":{"type":"string"},"sessId":{"type":"string"},"tpCd":{"type":"string"},"entrNo":{"type":"string"},"entrNm":{"type":"string"},"applicationName":{"type":"string"},"privacyPolicyInfoList":{"type":"array","items":{"$ref":"#/components/schemas/PrivacyPolicyInfo"}},"accountNonExpired":{"type":"boolean"},"accountNonLocked":{"type":"boolean"},"credentialsNonExpired":{"type":"boolean"},"username":{"type":"string"},"permissionToViewPersonalInfo":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"enabled":{"type":"boolean"}},"required":["loginId"]},"PrivacyPolicyInfo":{"type":"object","description":"개인정보취급권한 DTO","properties":{"userId":{"type":"string","description":"사용자 아이디"},"indInfoGbCd":{"type":"string","description":"개인정보구분코드(UR008)"},"useYn":{"type":"string","description":"사용여부"}}},"ResponseString":{"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":{"type":"string","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"}}},"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"}}}}}},"paths":{"/v1/common/code/getButtonByUserList":{"post":{"tags":["공통코드 조회"],"summary":"권한 없는 저장버튼 조회","description":"## 기능설명\n* 화면에 대한 저장 권한이 없는 버튼 ID를 조회합니다.\n---\n## 상세설명\n* 호출URL과 시스템구분코드에 맞는 데이터 저장에 관한 권한정보에 대해 접근이 불가능한 버튼ID를 반환합니다.\n* '#버튼ID,#버튼ID' 형태로 반환합니다.\n","operationId":"getButtonByUserList","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 권한 없는 버튼 조회

> \## 기능설명\
> \* 화면에 대한 권한이 없는 버튼 ID를 조회합니다.\
> \---\
> \## 상세설명\
> \* 호출URL과 시스템구분코드에 맞는 권한정보에 대해 접근이 불가능한 버튼ID를 반환합니다.\
> \* '#버튼ID,#버튼ID' 형태로 반환합니다.\
> \---\
> \## 수정번호\
> \* Release v2.00\_240711: 그룹 권한과 개별 권한이 모두 없는 버튼 ID만 조회하도록 변경\
> \* Release v2.01\_250314: 개별 권한을 그룹 권한보다 우선하여 조회하도록 변경<br>

```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":{"LoginRequest":{"type":"object","properties":{"seq":{"type":"integer","format":"int64"},"loginId":{"type":"string","minLength":1},"password":{"type":"string"},"remoteAddr":{"type":"string"},"lastAccessTime":{"type":"integer","format":"int64"},"userGbCd":{"type":"string"},"rtGrpNo":{"type":"string"},"jobGrpCd":{"type":"string"},"ocpCd":{"type":"string"},"caloUrl":{"type":"string"},"sysGbCd":{"type":"string"},"userId":{"type":"string"},"pwd":{"type":"string"},"userNm":{"type":"string"},"cellSctNo":{"type":"string"},"cellTxnoNo":{"type":"string"},"cellEndNo":{"type":"string"},"pwdIniYn":{"type":"string"},"sessId":{"type":"string"},"tpCd":{"type":"string"},"entrNo":{"type":"string"},"entrNm":{"type":"string"},"applicationName":{"type":"string"},"privacyPolicyInfoList":{"type":"array","items":{"$ref":"#/components/schemas/PrivacyPolicyInfo"}},"accountNonExpired":{"type":"boolean"},"accountNonLocked":{"type":"boolean"},"credentialsNonExpired":{"type":"boolean"},"username":{"type":"string"},"permissionToViewPersonalInfo":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"enabled":{"type":"boolean"}},"required":["loginId"]},"PrivacyPolicyInfo":{"type":"object","description":"개인정보취급권한 DTO","properties":{"userId":{"type":"string","description":"사용자 아이디"},"indInfoGbCd":{"type":"string","description":"개인정보구분코드(UR008)"},"useYn":{"type":"string","description":"사용여부"}}},"ResponseString":{"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":{"type":"string","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"}}},"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"}}}}}},"paths":{"/v1/common/code/getButtonByPageRoleList":{"post":{"tags":["공통코드 조회"],"summary":"권한 없는 버튼 조회","description":"## 기능설명\n* 화면에 대한 권한이 없는 버튼 ID를 조회합니다.\n---\n## 상세설명\n* 호출URL과 시스템구분코드에 맞는 권한정보에 대해 접근이 불가능한 버튼ID를 반환합니다.\n* '#버튼ID,#버튼ID' 형태로 반환합니다.\n---\n## 수정번호\n* Release v2.00_240711: 그룹 권한과 개별 권한이 모두 없는 버튼 ID만 조회하도록 변경\n* Release v2.01_250314: 개별 권한을 그룹 권한보다 우선하여 조회하도록 변경\n","operationId":"getButtonByPageRoleList","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 공통코드 조회

> \## 기능설명\
> \* 공통코드를 조회합니다.\
> \---\
> \## 상세설명\
> \* 넘어온 파라미터를 ',' 기준으로 잘라 해당 그룹코드에 대한 공통코드 목록을 조회합니다.\
> \* 사용여부가 \*\*Y\*\*인 공통코드 목록을 조회합니다.\
> \* 코드의 정렬순서 기준 순차적으로 조회합니다.\
> \* 그룹코드, 공통코드 목록 리스트 의 형태인 Map 으로 반환합니다.\
> \* 조회언어 기준은 기본 세팅된 언어코드인 쿠키의 langCd 기준으로 조회합니다.<br>

```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":{"ResponseMapStringListStStdCd":{"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":{"type":"object","additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/StStdCd"}},"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"StStdCd":{"type":"object","description":"그룹코드 조회/등록/수정 Request","properties":{"grpCd":{"type":"string","description":"그룹코드"},"cd":{"type":"string","description":"코드"},"cdNm":{"type":"string","description":"코드명"},"cdDesc":{"type":"string","description":"코드설명"},"useYn":{"type":"string","description":"사용여부"},"sortSeq":{"type":"integer","format":"int32","description":"정렬순서"},"ref1Val":{"type":"string","description":"참조1값 설명"},"ref2Val":{"type":"string","description":"참조2값 설명"},"ref3Val":{"type":"string","description":"참조3값 설명"},"ref4Val":{"type":"string","description":"참조4값 설명"},"ref5Val":{"type":"string","description":"참조5값 설명"},"ref6Val":{"type":"string","description":"참조6값 설명"},"ref7Val":{"type":"string","description":"참조7값 설명"}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"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"}}}}}},"paths":{"/v1/common/code/getStStdCd":{"get":{"tags":["공통코드 조회"],"summary":"공통코드 조회","description":"## 기능설명\n* 공통코드를 조회합니다.\n---\n## 상세설명\n* 넘어온 파라미터를 ',' 기준으로 잘라 해당 그룹코드에 대한 공통코드 목록을 조회합니다.\n* 사용여부가 **Y**인 공통코드 목록을 조회합니다.\n* 코드의 정렬순서 기준 순차적으로 조회합니다.\n* 그룹코드, 공통코드 목록 리스트 의 형태인 Map 으로 반환합니다.\n* 조회언어 기준은 기본 세팅된 언어코드인 쿠키의 langCd 기준으로 조회합니다.\n","operationId":"getStStdCd","parameters":[{"name":"grpCds","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseMapStringListStStdCd"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## GNB 언어기준 공통코드 조회

> \## 기능설명\
> \* 공통코드를 조회합니다.\
> \---\
> \## 상세설명\
> \* 넘어온 파라미터를 ',' 기준으로 잘라 해당 그룹코드에 대한 공통코드 목록을 조회합니다.\
> \* 사용여부가 \*\*Y\*\*인 공통코드 목록을 조회합니다.\
> \* 코드의 정렬순서 기준 순차적으로 조회합니다.\
> \* 그룹코드, 공통코드 목록 리스트 의 형태인 Map 으로 반환합니다.\
> \* 조회언어 기준은 기본 세팅된 언어코드인 쿠키의 dataLangCd 기준으로 조회합니다.<br>

```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":{"ResponseMapStringListStStdCd":{"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":{"type":"object","additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/StStdCd"}},"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"StStdCd":{"type":"object","description":"그룹코드 조회/등록/수정 Request","properties":{"grpCd":{"type":"string","description":"그룹코드"},"cd":{"type":"string","description":"코드"},"cdNm":{"type":"string","description":"코드명"},"cdDesc":{"type":"string","description":"코드설명"},"useYn":{"type":"string","description":"사용여부"},"sortSeq":{"type":"integer","format":"int32","description":"정렬순서"},"ref1Val":{"type":"string","description":"참조1값 설명"},"ref2Val":{"type":"string","description":"참조2값 설명"},"ref3Val":{"type":"string","description":"참조3값 설명"},"ref4Val":{"type":"string","description":"참조4값 설명"},"ref5Val":{"type":"string","description":"참조5값 설명"},"ref6Val":{"type":"string","description":"참조6값 설명"},"ref7Val":{"type":"string","description":"참조7값 설명"}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"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"}}}}}},"paths":{"/v1/common/code/getStStdCdByDataLangCd":{"get":{"tags":["공통코드 조회"],"summary":"GNB 언어기준 공통코드 조회","description":"## 기능설명\n* 공통코드를 조회합니다.\n---\n## 상세설명\n* 넘어온 파라미터를 ',' 기준으로 잘라 해당 그룹코드에 대한 공통코드 목록을 조회합니다.\n* 사용여부가 **Y**인 공통코드 목록을 조회합니다.\n* 코드의 정렬순서 기준 순차적으로 조회합니다.\n* 그룹코드, 공통코드 목록 리스트 의 형태인 Map 으로 반환합니다.\n* 조회언어 기준은 기본 세팅된 언어코드인 쿠키의 dataLangCd 기준으로 조회합니다.\n","operationId":"getStStdCdByDataLangCd","parameters":[{"name":"grpCds","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseMapStringListStStdCd"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 공통코드 역순 조회

> \## 기능설명\
> \* 공통코드를 역순으로 조회합니다.\
> \---\
> \## 상세설명\
> \* 넘어온 파라미터를 ',' 기준으로 잘라 해당 그룹코드에 대한 공통코드 목록을 조회합니다.\
> \* 사용여부가 \*\*Y\*\*인 공통코드 목록을 조회합니다.\
> \* 코드의 정렬순서 기준 역순으로 조회합니다.\
> \* 그룹코드, 공통코드 목록 리스트 의 형태인 Map 으로 반환합니다.\
> \* 조회언어 기준은 기본 세팅된 언어코드인 쿠키의 langCd 기준으로 조회합니다.<br>

```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":{"ResponseMapStringListStStdCd":{"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":{"type":"object","additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/StStdCd"}},"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"StStdCd":{"type":"object","description":"그룹코드 조회/등록/수정 Request","properties":{"grpCd":{"type":"string","description":"그룹코드"},"cd":{"type":"string","description":"코드"},"cdNm":{"type":"string","description":"코드명"},"cdDesc":{"type":"string","description":"코드설명"},"useYn":{"type":"string","description":"사용여부"},"sortSeq":{"type":"integer","format":"int32","description":"정렬순서"},"ref1Val":{"type":"string","description":"참조1값 설명"},"ref2Val":{"type":"string","description":"참조2값 설명"},"ref3Val":{"type":"string","description":"참조3값 설명"},"ref4Val":{"type":"string","description":"참조4값 설명"},"ref5Val":{"type":"string","description":"참조5값 설명"},"ref6Val":{"type":"string","description":"참조6값 설명"},"ref7Val":{"type":"string","description":"참조7값 설명"}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"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"}}}}}},"paths":{"/v1/common/code/getReverseStStdCd":{"get":{"tags":["공통코드 조회"],"summary":"공통코드 역순 조회","description":"## 기능설명\n* 공통코드를 역순으로 조회합니다.\n---\n## 상세설명\n* 넘어온 파라미터를 ',' 기준으로 잘라 해당 그룹코드에 대한 공통코드 목록을 조회합니다.\n* 사용여부가 **Y**인 공통코드 목록을 조회합니다.\n* 코드의 정렬순서 기준 역순으로 조회합니다.\n* 그룹코드, 공통코드 목록 리스트 의 형태인 Map 으로 반환합니다.\n* 조회언어 기준은 기본 세팅된 언어코드인 쿠키의 langCd 기준으로 조회합니다.\n","operationId":"getReverseStStdCd","parameters":[{"name":"grpCds","in":"query","description":"그룹코드문자열","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseMapStringListStStdCd"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 참조1값 기준 공통코드 조회

> \## 기능설명\
> \* 참조1값 기준으로 공통코드 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 코드가 가진 참조1값을 기준으로 공통코드 목록을 조회합니다.\
> \* 사용여부가 \*\*Y\*\*인 공통코드 목록을 조회합니다.\
> \* 참조코드(referCode), 코드(code)는 필수입니다.<br>

```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":{"CodeReqDto":{"type":"object","description":"공통코드 조회 요청 DTO","properties":{"code":{"type":"string","description":"그룹코드"},"referCode":{"type":"string","description":"참조코드"},"type":{"type":"string","description":"조회타입"},"grpCds":{"type":"string","description":"그룹코드"},"langCd":{"type":"string","description":"언어코드"}}},"ResponseMapStringListCodeResDto":{"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":{"type":"object","additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/CodeResDto"}},"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"CodeResDto":{"type":"object","description":"공통코드 조회 응답 DTO","properties":{"key":{"type":"string","description":"map의 키"},"cd":{"type":"string","description":"그룹코드"},"cdNm":{"type":"string","description":"코드명"},"ref1Val":{"type":"string","description":"참조1값"},"ref2Val":{"type":"string","description":"참조2값"},"ref3Val":{"type":"string","description":"참조3값"},"ref4Val":{"type":"string","description":"참조4값"},"ref5Val":{"type":"string","description":"참조5값"}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"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"}}}}}},"paths":{"/v1/common/code/getForwardCdCdNmFromStStdCdByGrpCdRef1Val":{"get":{"tags":["공통코드 조회"],"summary":"참조1값 기준 공통코드 조회","description":"## 기능설명\n* 참조1값 기준으로 공통코드 목록을 조회합니다.\n---\n## 상세설명\n* 코드가 가진 참조1값을 기준으로 공통코드 목록을 조회합니다.\n* 사용여부가 **Y**인 공통코드 목록을 조회합니다.\n* 참조코드(referCode), 코드(code)는 필수입니다.\n","operationId":"getForwardCdCdNmFromStStdCdByGrpCdRef1Val","parameters":[{"name":"params","in":"query","required":true,"schema":{"$ref":"#/components/schemas/CodeReqDto"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseMapStringListCodeResDto"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 참조3값 기준 공통코드 조회

> \## 기능설명\
> \* 참조3값 기준으로 공통코드 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 코드가 가진 참조3값을 기준으로 공통코드 목록을 조회합니다.\
> \* 사용여부가 \*\*Y\*\*인 공통코드 목록을 조회합니다.\
> \* 참조코드(referCode), 코드(code)는 필수입니다.<br>

```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":{"CodeReqDto":{"type":"object","description":"공통코드 조회 요청 DTO","properties":{"code":{"type":"string","description":"그룹코드"},"referCode":{"type":"string","description":"참조코드"},"type":{"type":"string","description":"조회타입"},"grpCds":{"type":"string","description":"그룹코드"},"langCd":{"type":"string","description":"언어코드"}}},"ResponseMapStringListCodeResDto":{"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":{"type":"object","additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/CodeResDto"}},"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"CodeResDto":{"type":"object","description":"공통코드 조회 응답 DTO","properties":{"key":{"type":"string","description":"map의 키"},"cd":{"type":"string","description":"그룹코드"},"cdNm":{"type":"string","description":"코드명"},"ref1Val":{"type":"string","description":"참조1값"},"ref2Val":{"type":"string","description":"참조2값"},"ref3Val":{"type":"string","description":"참조3값"},"ref4Val":{"type":"string","description":"참조4값"},"ref5Val":{"type":"string","description":"참조5값"}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"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"}}}}}},"paths":{"/v1/common/code/getCdCdNmFromStStdCdByGrpCdOrderRef3Val":{"get":{"tags":["공통코드 조회"],"summary":"참조3값 기준 공통코드 조회","description":"## 기능설명\n* 참조3값 기준으로 공통코드 목록을 조회합니다.\n---\n## 상세설명\n* 코드가 가진 참조3값을 기준으로 공통코드 목록을 조회합니다.\n* 사용여부가 **Y**인 공통코드 목록을 조회합니다.\n* 참조코드(referCode), 코드(code)는 필수입니다.\n","operationId":"getCdCdNmFromStStdCdByGrpCdOrderRef3Val","parameters":[{"name":"params","in":"query","required":true,"schema":{"$ref":"#/components/schemas/CodeReqDto"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseMapStringListCodeResDto"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
