> 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/api-en/back-office-api-reference/cs-bo-api/consultation-type-management.md).
# Consultation Type Management
## Register/Modify Consultation Type in Consultation Type Management
> \## Function Description\
> \* Registers a new consultation type or modifies an existing consultation type from the Consultation Type Management screen.\
> \---\
> \## Detailed Description\
> \* This function is called when registering a new consultation type or modifying an existing consultation type under \[BO/CC] Customer Service > Center Management > Consultation Type Management.\
> \* New registration data is passed in the create array.\
> \* Modification data is passed in the update array.
```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":{"RealGridCUDRequestConsultTypeCuRequest":{"type":"object","properties":{"all":{"type":"array","items":{"$ref":"#/components/schemas/ConsultTypeCuRequest"}},"create":{"type":"array","items":{"$ref":"#/components/schemas/ConsultTypeCuRequest"}},"update":{"type":"array","items":{"$ref":"#/components/schemas/ConsultTypeCuRequest"}},"delete":{"type":"array","items":{"$ref":"#/components/schemas/ConsultTypeCuRequest"}}}},"ConsultTypeCuRequest":{"type":"object","description":"Consultation Type Register/Modify Request DTO","properties":{"cnslTypNo":{"type":"string","description":"Consultation Type"},"cnslTypNm":{"type":"string","description":"Consultation Type Name"},"useYn":{"type":"string","description":"Usage Status"},"level":{"type":"integer","format":"int32","description":"Level"},"sortSeq":{"type":"integer","format":"int32","description":"Sort Order"},"custCnslGbCd":{"type":"string","description":"Consultation Classification Code"},"goodsSelMdtyYn":{"type":"string","description":"Product Selection Required Status"},"respBaseMemo":{"type":"string","description":"Default Response Memo"},"cnslLrgTypNo":{"type":"string","description":"Consultation Major Type No."},"cnslMidTypNo":{"type":"string","description":"Consultation Middle Type No."},"cnslSmlTypNo":{"type":"string","description":"Consultation Source Type No."},"uprCnslTypNo":{"type":"string","description":"Parent Consultation Type No."},"respBaseMemoData":{"type":"string","description":"Default Response Memo Content"}}},"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":{"/v2/customerservice/counselingTypeMgmt/saveCounselingType":{"post":{"tags":["Consultation Type Management"],"summary":"Register/Modify Consultation Type in Consultation Type Management","description":"## Function Description\n* Registers a new consultation type or modifies an existing consultation type from the Consultation Type Management screen.\n---\n## Detailed Description\n* This function is called when registering a new consultation type or modifying an existing consultation type under [BO/CC] Customer Service > Center Management > Consultation Type Management.\n* New registration data is passed in the create array.\n* Modification data is passed in the update array.\n","operationId":"saveCounselingType","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RealGridCUDRequestConsultTypeCuRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## Retrieve Consultation Type Management 1-Depth Sub-List
> \## Function Description\
> \* Retrieves the 1-depth sub-list of a consultation type from the Consultation Type Management screen.\
> \---\
> \## Detailed Description\
> \* This function is called to retrieve the sub-list when a consultation type is selected under \[BO/CC] Customer Service > Center Management > Consultation Type Management.\
> \* Retrieves all sub-consultation types belonging to the selected consultation type.\
> \* The retrieved data is displayed in array form.
```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":{"GetLowerCounselingTypeListRequest":{"type":"object","description":"Consultation Type Management Sub-Depth Inquiry Request DTO","properties":{"uprCnslTypNo":{"type":"string","description":"Parent Consultation Type No."}}},"RealGridListResponseCounselingTypeResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/CounselingTypeResponse"}}}},"CounselingTypeResponse":{"type":"object","properties":{"level":{"type":"integer","format":"int32","description":"level"},"cnslTypNo":{"type":"string","description":"Consultation Type No."},"cnslTypNm":{"type":"string","description":"Consultation Type Name"},"useYn":{"type":"string","description":"Usage Status"},"sortSeq":{"type":"string","description":"Sort Order"},"custCnslGbCd":{"type":"string","description":"Consultation Type Code (CS001)"},"goodsSelMdtyYn":{"type":"string","description":"Product Selection Required Status"},"respBaseMemo":{"type":"string","description":"Default Response Memo"},"cnslLrgTypNo":{"type":"string","description":"Consultation Major Type No."},"cnslLrgTypNm":{"type":"string","description":"Consultation Major Type Name"},"cnslMidTypNo":{"type":"string","description":"Consultation Middle Type No."},"cnslMidTypNm":{"type":"string","description":"Consultation Middle Type Name"},"cnslSmlTypNo":{"type":"string","description":"Consultation Source Type No."},"cnslSmlTypNm":{"type":"string","description":"Consultation Minor Type Name"},"uprCnslTypNo":{"type":"string","description":"Parent Consultation Type No."},"hierarchy":{"type":"string","description":"Hierarchy Structure"},"hierarchyText":{"type":"string","description":"Hierarchy Structure Name"},"respBaseMemoData":{"type":"string","description":"Default Response Memo Content"},"useCnt":{"type":"integer","format":"int32","description":"Number of Uses"}}},"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":{"/v2/customerservice/counselingTypeMgmt/getLowerCounselingTypeList":{"get":{"tags":["Consultation Type Management"],"summary":"Retrieve Consultation Type Management 1-Depth Sub-List","description":"## Function Description\n* Retrieves the 1-depth sub-list of a consultation type from the Consultation Type Management screen.\n---\n## Detailed Description\n* This function is called to retrieve the sub-list when a consultation type is selected under [BO/CC] Customer Service > Center Management > Consultation Type Management.\n* Retrieves all sub-consultation types belonging to the selected consultation type.\n* The retrieved data is displayed in array form.\n","operationId":"getLowerCounselingTypeList","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/GetLowerCounselingTypeListRequest"}},{"name":"uprCnslTypNo","in":"query","description":"Parent Consultation Type No.","schema":{"type":"String"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseCounselingTypeResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## Retrieve Major/Middle/Minor Type of Selected Consultation Type No.
> \## Function Description\
> \* Retrieves the major/middle/minor type corresponding to the selected consultation type number.\
> \---\
> \## Detailed Description\
> \* This function is called to retrieve the major/middle/minor type corresponding to the selected consultation type.
```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":{"ResponseListCounselingTypeResponse":{"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":"array","description":"payload","items":{"$ref":"#/components/schemas/CounselingTypeResponse"}},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"CounselingTypeResponse":{"type":"object","properties":{"level":{"type":"integer","format":"int32","description":"level"},"cnslTypNo":{"type":"string","description":"Consultation Type No."},"cnslTypNm":{"type":"string","description":"Consultation Type Name"},"useYn":{"type":"string","description":"Usage Status"},"sortSeq":{"type":"string","description":"Sort Order"},"custCnslGbCd":{"type":"string","description":"Consultation Type Code (CS001)"},"goodsSelMdtyYn":{"type":"string","description":"Product Selection Required Status"},"respBaseMemo":{"type":"string","description":"Default Response Memo"},"cnslLrgTypNo":{"type":"string","description":"Consultation Major Type No."},"cnslLrgTypNm":{"type":"string","description":"Consultation Major Type Name"},"cnslMidTypNo":{"type":"string","description":"Consultation Middle Type No."},"cnslMidTypNm":{"type":"string","description":"Consultation Middle Type Name"},"cnslSmlTypNo":{"type":"string","description":"Consultation Source Type No."},"cnslSmlTypNm":{"type":"string","description":"Consultation Minor Type Name"},"uprCnslTypNo":{"type":"string","description":"Parent Consultation Type No."},"hierarchy":{"type":"string","description":"Hierarchy Structure"},"hierarchyText":{"type":"string","description":"Hierarchy Structure Name"},"respBaseMemoData":{"type":"string","description":"Default Response Memo Content"},"useCnt":{"type":"integer","format":"int32","description":"Number of Uses"}}},"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":{"/v2/customerservice/counselingTypeMgmt/getCounselingTypeNoList":{"get":{"tags":["Consultation Type Management"],"summary":"Retrieve Major/Middle/Minor Type of Selected Consultation Type No.","description":"## Function Description\n* Retrieves the major/middle/minor type corresponding to the selected consultation type number.\n---\n## Detailed Description\n* This function is called to retrieve the major/middle/minor type corresponding to the selected consultation type.\n","operationId":"getCounselingTypeNoList","parameters":[{"name":"cnslTypNo","in":"query","description":"Consultation Type No.","required":false,"schema":{"type":"String"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListCounselingTypeResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## Retrieve Consultation Type Management List (Tree)
> \## Function Description\
> \* Retrieves the consultation type list in a tree structure from the Consultation Type Management screen.\
> \---\
> \## Detailed Description\
> \* This function is called upon entering the screen that retrieves the consultation type list under \[BO/CC] Customer Service > Center Management > Consultation Type Management.\
> \* Retrieves all registered consultation types.\
> \* The retrieved consultation types are displayed in a hierarchical tree structure in the consultation type list layout.
```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":{"ResponseListCounselingTypeResponse":{"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":"array","description":"payload","items":{"$ref":"#/components/schemas/CounselingTypeResponse"}},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"CounselingTypeResponse":{"type":"object","properties":{"level":{"type":"integer","format":"int32","description":"level"},"cnslTypNo":{"type":"string","description":"Consultation Type No."},"cnslTypNm":{"type":"string","description":"Consultation Type Name"},"useYn":{"type":"string","description":"Usage Status"},"sortSeq":{"type":"string","description":"Sort Order"},"custCnslGbCd":{"type":"string","description":"Consultation Type Code (CS001)"},"goodsSelMdtyYn":{"type":"string","description":"Product Selection Required Status"},"respBaseMemo":{"type":"string","description":"Default Response Memo"},"cnslLrgTypNo":{"type":"string","description":"Consultation Major Type No."},"cnslLrgTypNm":{"type":"string","description":"Consultation Major Type Name"},"cnslMidTypNo":{"type":"string","description":"Consultation Middle Type No."},"cnslMidTypNm":{"type":"string","description":"Consultation Middle Type Name"},"cnslSmlTypNo":{"type":"string","description":"Consultation Source Type No."},"cnslSmlTypNm":{"type":"string","description":"Consultation Minor Type Name"},"uprCnslTypNo":{"type":"string","description":"Parent Consultation Type No."},"hierarchy":{"type":"string","description":"Hierarchy Structure"},"hierarchyText":{"type":"string","description":"Hierarchy Structure Name"},"respBaseMemoData":{"type":"string","description":"Default Response Memo Content"},"useCnt":{"type":"integer","format":"int32","description":"Number of Uses"}}},"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":{"/v2/customerservice/counselingTypeMgmt/getCounselingTypeList":{"get":{"tags":["Consultation Type Management"],"summary":"Retrieve Consultation Type Management List (Tree)","description":"## Function Description\n* Retrieves the consultation type list in a tree structure from the Consultation Type Management screen.\n---\n## Detailed Description\n* This function is called upon entering the screen that retrieves the consultation type list under [BO/CC] Customer Service > Center Management > Consultation Type Management.\n* Retrieves all registered consultation types.\n* The retrieved consultation types are displayed in a hierarchical tree structure in the consultation type list layout.\n","operationId":"getCounselingTypeList","responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListCounselingTypeResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## Retrieve Consultation Type
> \## Function Description\
> \* Retrieves the consultation type used in the common consultation type inquiry popup.\
> \---\
> \## Detailed Description\
> \* Used to retrieve the consultation type in the common consultation type inquiry popup.
```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":{"CounselingTypePopupRequest":{"type":"object","description":"Consultation Type Inquiry Request DTO","properties":{"cnslTypNm":{"type":"string","description":"Consultation Type Name"},"custCnslGbCd":{"type":"string","description":"Consultation Type Code (CS001)"},"cnslLrgTypNo":{"type":"string","description":"Consultation Major Type No."},"cnslMidTypNo":{"type":"string","description":"Consultation Middle Type No."},"cnslSmlTypNo":{"type":"string","description":"Consultation Source Type No."},"rootCnslTypNo":{"type":"string","description":"Top-Level Consultation Type"}}},"RealGridListResponseCounselingTypeResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/CounselingTypeResponse"}}}},"CounselingTypeResponse":{"type":"object","properties":{"level":{"type":"integer","format":"int32","description":"level"},"cnslTypNo":{"type":"string","description":"Consultation Type No."},"cnslTypNm":{"type":"string","description":"Consultation Type Name"},"useYn":{"type":"string","description":"Usage Status"},"sortSeq":{"type":"string","description":"Sort Order"},"custCnslGbCd":{"type":"string","description":"Consultation Type Code (CS001)"},"goodsSelMdtyYn":{"type":"string","description":"Product Selection Required Status"},"respBaseMemo":{"type":"string","description":"Default Response Memo"},"cnslLrgTypNo":{"type":"string","description":"Consultation Major Type No."},"cnslLrgTypNm":{"type":"string","description":"Consultation Major Type Name"},"cnslMidTypNo":{"type":"string","description":"Consultation Middle Type No."},"cnslMidTypNm":{"type":"string","description":"Consultation Middle Type Name"},"cnslSmlTypNo":{"type":"string","description":"Consultation Source Type No."},"cnslSmlTypNm":{"type":"string","description":"Consultation Minor Type Name"},"uprCnslTypNo":{"type":"string","description":"Parent Consultation Type No."},"hierarchy":{"type":"string","description":"Hierarchy Structure"},"hierarchyText":{"type":"string","description":"Hierarchy Structure Name"},"respBaseMemoData":{"type":"string","description":"Default Response Memo Content"},"useCnt":{"type":"integer","format":"int32","description":"Number of Uses"}}},"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":{"/v2/customerservice/counselingTypeMgmt/getCounselingTypeListPopup":{"get":{"tags":["Consultation Type Management"],"summary":"Retrieve Consultation Type","description":"## Function Description\n* Retrieves the consultation type used in the common consultation type inquiry popup.\n---\n## Detailed Description\n* Used to retrieve the consultation type in the common consultation type inquiry popup.\n","operationId":"getCounselingTypeListPopup","parameters":[{"name":"counselingTypePopupRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/CounselingTypePopupRequest"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseCounselingTypeResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```