통합상담관리

처리내역 등록/수정

post

기능설명

• 통합상담관리 처리내역을 등록/수정 합니다.

---

상세 설명

• 선택한 고객상담에 대해 처리내역을 등록/수정 합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

처리내역 등록/수정 요청 DTO

afterCallstringOptional

전화약속여부

Example: Y

ccnNostringOptional

상담번호

Example: 10004961

ccnPrgsStatCdstring · enumOptional

고객상담진행상태코드(CS005)

Example: 20Possible values:

cellNoYnstringOptional

휴대폰번호여부

Example: Y

telRgnNostringOptional

전화지역번호

Example: 010

telTxnoNostringOptional

전화국번번호

Example: 1111

telEndNostringOptional

전화끝번호

Example: 2222

cnslProcContstringOptional

상담처리내용

Example: 처리내용 영역

prmsDtmstringOptional

prmsDtm

Example: 2023-09-20 15:36

notiTmCdstring · enumOptional

알림시간코드(CS013)

Example: 15Possible values:

prmsMethCdstring · enumOptional

약속방식코드(CS008)

Example: 10Possible values:

cnslMemostringOptional

상담메모

Example: 전화요청 확인해 주세요.

Responses

200

성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

post

/v2/customerservice/integratedCounselMgmt/saveCustomerCounselProcessInfo

HTTPcURLJavaScriptPython

POST /api/bo/v2/customerservice/integratedCounselMgmt/saveCustomerCounselProcessInfo HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 261

{
  "afterCall": "Y",
  "ccnNo": 10004961,
  "ccnPrgsStatCd": 20,
  "cellNoYn": "Y",
  "telRgnNo": "010",
  "telTxnoNo": 1111,
  "telEndNo": 2222,
  "cnslProcCont": "처리내용 영역",
  "prmsDtm": "2023-09-20 15:36",
  "notiTmCd": 15,
  "prmsMethCd": 10,
  "cnslMemo": "전화요청 확인해 주세요."
}

{
  "timestamp": "2026-02-27T16:43:00.760Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

상담정보 등록

post

기능설명

• 통합상담관리 화면에서 산규 고객상담 정보를 등록 합니다.

---

상세 설명

• 일반콜, OB 상담만 등록 가능합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

상담정보 등록 요청 DTO

afterCallstringOptional

전화약속여부

Example: Y

custCnslGbCdstring · enumOptional

상담구분코드(CS001)

Example: 10Possible values:

accpMediaCdstring · enumOptional

접수매체코드(CS002)

Example: 10Possible values:

accpTypCdstring · enumOptional

접수유형코드(CS003)

Example: 10Possible values:

cnslSubCdstring · enumOptional

상담주체코드(CS004)

Example: 20Possible values:

ccnPrgsStatCdstring · enumOptional

고객상담진행상태코드(CS005)

Example: 20Possible values:

mbrNostringOptional

회원번호

Example: 100000513

inqmnNmstringOptional

문의자명

Example: 홍길동

cnslLrgTypNostringOptional

상담대유형번호

Example: 10160

cnslMidTypNostringOptional

상담중유형번호

Example: 10124

cnslTypNostringOptional

상담유형번호

Example: 10030

cellNoYnstringOptional

휴대폰번호여부

Example: Y

telRgnNostringOptional

전화지역번호

Example: 010

telTxnoNostringOptional

전화국번번호

Example: 1111

telEndNostringOptional

전화끝번호

Example: 2222

accpTitlestringOptional

접수제목

Example: 일반콜 상담 테스트

accpContstringOptional

접수내용

Example: 일반콜 상담 테스트 내용

cnslProcContstringOptional

상담처리내용

Example: 처리내용 영역

cnslindInfoMemostringOptional

개인정보메모

Example: 개인정보영역

ordNostringOptional

주문번호

Example: 20230718O002626

goodsNostringOptional

상품번호

Example: 10001891

goodsNmstringOptional

상품명

Example: 단품존재상품_일반상품7

itmNostringOptional

단품번호

Example: 003

itmNmstringOptional

단품명

Example: 다크브라운>1_명

entrNostringOptional

협력사번호

Example: 1000002

prmsDtmstringOptional

prmsDtm

Example: 2023-09-20 15:36

notiTmCdstring · enumOptional

알림시간코드(CS013)

Example: 15Possible values:

prmsMethCdstring · enumOptional

약속방식코드(CS008)

Example: 10Possible values:

cnslMemostringOptional

상담메모

Example: 전화요청 확인해 주세요.

obTypNostringOptional

OB유형번호

obProcTypCdstring · enumOptional

OB처리유형코드(CS014)

Possible values:

Responses

200

성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

post

/v2/customerservice/integratedCounselMgmt/saveCustomerCounselInfo

HTTPcURLJavaScriptPython

POST /api/bo/v2/customerservice/integratedCounselMgmt/saveCustomerCounselInfo HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 733

{
  "afterCall": "Y",
  "custCnslGbCd": 10,
  "accpMediaCd": 10,
  "accpTypCd": 10,
  "cnslSubCd": 20,
  "ccnPrgsStatCd": 20,
  "mbrNo": 100000513,
  "inqmnNm": "홍길동",
  "cnslLrgTypNo": 10160,
  "cnslMidTypNo": 10124,
  "cnslTypNo": 10030,
  "cellNoYn": "Y",
  "telRgnNo": "010",
  "telTxnoNo": 1111,
  "telEndNo": 2222,
  "accpTitle": "일반콜 상담 테스트",
  "accpCont": "일반콜 상담 테스트 내용",
  "cnslProcCont": "처리내용 영역",
  "cnslindInfoMemo": "개인정보영역",
  "ordNo": "20230718O002626",
  "goodsNo": 10001891,
  "goodsNm": "단품존재상품_일반상품7",
  "itmNo": "003",
  "itmNm": "다크브라운>1_명",
  "entrNo": 1000002,
  "prmsDtm": "2023-09-20 15:36",
  "notiTmCd": 15,
  "prmsMethCd": 10,
  "cnslMemo": "전화요청 확인해 주세요.",
  "obTypNo": "text",
  "obProcTypCd": "NOT_NUMBER"
}

{
  "timestamp": "2026-02-27T16:43:00.760Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

고객보상 접수

post

기능설명

• 고객보상 접수정보를 등록 합니다.

---

상세 설명

• 선택한 고객상담에 대해 고객보상 접수정보를 등록 합니다.

• 비회원 주문에 대한 상담은 고객보상 처리할 수 없습니다.

• 고객보상수단은 쿠폰, 현금, 마일리지 입니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

고객보상접수정보 요청 DTO

custCpnsAplyNostringOptional

10000911

Example: 고객보상신청번호

ccnNostringOptional

10004891

Example: 상담번호

cpnsTypNostringOptionalExample: 보상유형번호

cpnsMeanCdstringOptional

20

Example: 보상수단코드(CS019)

rspnGbCdstringOptionalExample: 귀책구분코드(CS020)

cpnsAprvStatCdstringOptional

30

Example: 보상승인상태코드(CS021)

cpnsPayStatCdstringOptionalExample: 보상지급상태코드(CS020)

mbrNostringOptional

100000513

Example: 회원번호

mbrNmstringOptionalExample: 회원명

loginIdstringOptional

kdh9110

Example: 회원ID

accpDtmstringOptional

승인 바랍니다.

Example: 접수일시

accpContstringOptionalExample: 접수내용

acptmnIdstringOptional

x2beecc

Example: 접수자ID

cpnsAmtNostringOptional

100000

Example: 보상금액번호

promoNmstringOptionalExample: 프로모션명(쿠폰명)

aprvDtmstringOptionalExample: 승인일시

aprmnIdstringOptionalExample: 승인자ID

payReqMemostringOptional

승인 요청합니다.

Example: 지급요청메모

retnDtmstringOptionalExample: 반려일시

retnProcmnIdstringOptionalExample: 반려처리자ID

payDtmstringOptionalExample: 지급일시

paymnIdstringOptionalExample: 지급자ID

payContstringOptionalExample: 지급내용

payReqDtmstringOptionalExample: 지급요청일시

payBankCdstringOptionalExample: 지급은행코드

payActnNostringOptional

110999988888

Example: 지급계좌번호

noEncryptPayActnNostringOptional

110999988888

Example: 지급계좌번호(복호화)

payDepositorNmstringOptional

홍길동

Example: 지급예금주명

ordNostringOptional

20230718O002626

Example: 주문번호

goodsNostringOptionalExample: 상품번호

retnCausContstringOptionalExample: 반려사유내용

couponNostringOptionalExample: 쿠폰번호

mileagestringOptionalExample: 마일리지

custCpnsAplyNoListstring[]OptionalExample: 고객보상신청번호 목록

Responses

200

성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

post

/v2/customerservice/integratedCounselMgmt/registCustomerCompens

HTTPcURLJavaScriptPython

POST /api/bo/v2/customerservice/integratedCounselMgmt/registCustomerCompens HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1138

{
  "custCpnsAplyNo": "고객보상신청번호",
  "ccnNo": "상담번호",
  "cpnsTypNo": "보상유형번호",
  "cpnsMeanCd": "보상수단코드(CS019)",
  "rspnGbCd": "귀책구분코드(CS020)",
  "cpnsAprvStatCd": "보상승인상태코드(CS021)",
  "cpnsPayStatCd": "보상지급상태코드(CS020)",
  "mbrNo": "회원번호",
  "mbrNm": "회원명",
  "loginId": "회원ID",
  "accpDtm": "접수일시",
  "accpCont": "접수내용",
  "acptmnId": "접수자ID",
  "cpnsAmtNo": "보상금액번호",
  "promoNm": "프로모션명(쿠폰명)",
  "aprvDtm": "승인일시",
  "aprmnId": "승인자ID",
  "payReqMemo": "지급요청메모",
  "retnDtm": "반려일시",
  "retnProcmnId": "반려처리자ID",
  "payDtm": "지급일시",
  "paymnId": "지급자ID",
  "payCont": "지급내용",
  "payReqDtm": "지급요청일시",
  "payBankCd": "지급은행코드",
  "payActnNo": "지급계좌번호",
  "noEncryptPayActnNo": "지급계좌번호(복호화)",
  "payDepositorNm": "지급예금주명",
  "ordNo": "주문번호",
  "goodsNo": "상품번호",
  "retnCausCont": "반려사유내용",
  "couponNo": "쿠폰번호",
  "mileage": "마일리지",
  "request": "고객보상접수정보 요청 DTO",
  "custCpnsAplyNoList": "고객보상신청번호 목록"
}

{
  "timestamp": "2026-02-27T16:43:00.760Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

1:1문의 답변 등록

post

기능설명

• 통합상담관리 1:1문의 답변을 등록 합니다.

---

상세 설명

• 답변 완료 처리시 고객에게 알림톡을 발송 합니다.

• 이메일수신여부가 Y 일 때 이메일을 발송 합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

1:1문의 답변등록 요청 DTO

ccnNostringOptional

상담번호

Example: 10004938

ccnPrgsStatCdstring · enumOptional

고객상담진행상태코드(CS005)

Example: 20Possible values:

telRgnNostringOptional

전화지역번호

Example: 010

telTxnoNostringOptional

전화국번번호

Example: 1111

telEndNostringOptional

전화끝번호

Example: 2222

ansContstringOptional

답변내용

Example: 문의내용답변

preProcYnstringOptional

기처리여부

Example: N

Responses

200

성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

post

/v2/customerservice/integratedCounselMgmt/postOneToOneInquiry

HTTPcURLJavaScriptPython

POST /api/bo/v2/customerservice/integratedCounselMgmt/postOneToOneInquiry HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 134

{
  "ccnNo": 10004938,
  "ccnPrgsStatCd": 20,
  "telRgnNo": "010",
  "telTxnoNo": 1111,
  "telEndNo": 2222,
  "ansCont": "문의내용답변",
  "preProcYn": "N"
}

{
  "timestamp": "2026-02-27T16:43:00.760Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

상담목록 상세 조회

get

기능설명

• 통합상담관리 상담목록 상세 정보를 조회 합니다.

---

상세 설명

• 선택한 고객상담 상세정보를 조회 합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

ccnNoStringRequired

상담번호

Example: 10004911

Responses

200

성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

get

/v2/customerservice/integratedCounselMgmt/integratedCounselDetail

HTTPcURLJavaScriptPython

GET /api/bo/v2/customerservice/integratedCounselMgmt/integratedCounselDetail?ccnNo=null HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-02-27T16:43:00.760Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "ccnNo": "text",
    "acpData": "text",
    "accpData": "text",
    "userNm": "text",
    "accpDtm": "2026-02-27T16:43:00.760Z",
    "userData": "text",
    "mbrNo": "text",
    "mbrNm": "text",
    "loginId": "text",
    "getEmailAddr": "text",
    "emailAddr": "text",
    "gbcdMedia": "text",
    "accpTypCd": "text",
    "accpTypNm": "text",
    "telNo": "text",
    "telRgnNo": "text",
    "telTxnoNo": "text",
    "telTxnoNos": "text",
    "telEndNo": "text",
    "telEndNos": "text",
    "custInqLrgTypNm": "text",
    "ccnPrgsStatCd": "text",
    "ccnPrgsStatNm": "text",
    "cnslTypText": "text",
    "cnslMidTypTextNm": "text",
    "obTypNm": "text",
    "accpTitle": "text",
    "accpCont": "text",
    "zipNo": "text",
    "zipAddr": "text",
    "dtlAddr": "text",
    "mvotCaus": "text",
    "smsAnsNtcYn": "text",
    "emailAnsNtcYn": "text",
    "preProcYn": "text",
    "ansCont": "text",
    "ansDtm": "text",
    "ansText": "text",
    "custCnslGbCd": "text",
    "procmnId": "text",
    "cellNoYn": "text",
    "integrateOrdAndGoodsInfo": [
      {
        "ccnNo": "text",
        "custCnslSeq": "text",
        "ordNo": "text",
        "goodsNo": "text",
        "csCcnGoodsResponse": {
          "goodsNo": "text",
          "goodsNm": "text",
          "entrNm": "text"
        },
        "csCcnOrdResponses": [
          {
            "ordNo": "text",
            "goodsNo": "text",
            "goodsNm": "text",
            "itmNo": "text",
            "itmNm": "text",
            "ordQty": "text",
            "salePrc": 1,
            "entrNo": "text",
            "entrNm": "text"
          }
        ],
        "langCd": "text"
      }
    ],
    "integrateProcInfo": [
      {
        "ccnNo": "text",
        "cnslProcSeq": "text",
        "obProcTypCd": "text",
        "cnslProcDtm": "text",
        "cnslProcCont": "text",
        "userNm": "text",
        "sysRegId": "text",
        "csTelPrmsResponses": [
          {
            "ccnNo": "text",
            "cnslProcSeq": "text",
            "telPrmsSeq": "text",
            "prmsDtm": "text",
            "notiTmCd": "text",
            "prmsMethCd": "text",
            "prmsStatCd": "text",
            "cnslMemo": "text",
            "aempId": "text",
            "userNm": "text",
            "aempConfDtm": "text",
            "aempProcDtm": "text",
            "telTryCnt": "text",
            "procStat": "text"
          }
        ]
      }
    ],
    "fileList": [
      {
        "jobClbtBbcNo": "text",
        "fileSeq": "text",
        "atchFileRouteNm": "text",
        "atchFileNm": "text"
      }
    ],
    "telYn": "text",
    "cpnsPayYn": "text",
    "questNo": "text",
    "goodsNo": "text",
    "indInfoMemo": "text",
    "langCode": "text",
    "cnslTypNo": "text",
    "respBaseMemo": "text",
    "instMbrYn": "N",
    "ordLmtYn": "N",
    "ansSubNm": "고객센터"
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

관련상담 목록 조회

get

기능설명

• 통합상담관리 관련상담 목록을 조회 합니다.

---

상세 설명

• 동일 주문번호/상품문호에 매핑된 모든 상담건을 조회 합니다.

  • 주문기준: 회원+주문, 회원+주문+상품

  • 상품기준 : 회원+상품

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

ccnNostringOptional

상담번호

Example: 10004941

ordNostringOptional

주문번호

Example: 20230718O002626

Responses

200

성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

get

/v2/customerservice/integratedCounselMgmt/getRelatedConsultation

HTTPcURLJavaScriptPython

GET /api/bo/v2/customerservice/integratedCounselMgmt/getRelatedConsultation HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-02-27T16:43:00.760Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "ccnNo": "text",
    "custCnslSeq": "text",
    "otherCount": 1,
    "ordNo": "text",
    "goodsNo": "text",
    "goodsNm": "text",
    "entrNo": "text",
    "entrNm": "text",
    "mbrNo": "text",
    "mbrNm": "text",
    "noMaskingMbrNm": "text",
    "loginId": "text",
    "noMaskingLoginId": "text",
    "rfdBankCd": "text",
    "rfdActnNo": "text",
    "count": 1,
    "relatedConsultation": [
      {
        "ccnNo": "text",
        "acpData": "text",
        "accpData": "text",
        "userNm": "text",
        "accpDtm": "2026-02-27T16:43:00.760Z",
        "userData": "text",
        "mbrNo": "text",
        "mbrNm": "text",
        "loginId": "text",
        "getEmailAddr": "text",
        "emailAddr": "text",
        "gbcdMedia": "text",
        "accpTypCd": "text",
        "accpTypNm": "text",
        "telNo": "text",
        "telRgnNo": "text",
        "telTxnoNo": "text",
        "telTxnoNos": "text",
        "telEndNo": "text",
        "telEndNos": "text",
        "custInqLrgTypNm": "text",
        "ccnPrgsStatCd": "text",
        "ccnPrgsStatNm": "text",
        "cnslTypText": "text",
        "cnslMidTypTextNm": "text",
        "obTypNm": "text",
        "accpTitle": "text",
        "accpCont": "text",
        "zipNo": "text",
        "zipAddr": "text",
        "dtlAddr": "text",
        "mvotCaus": "text",
        "smsAnsNtcYn": "text",
        "emailAnsNtcYn": "text",
        "preProcYn": "text",
        "ansCont": "text",
        "ansDtm": "text",
        "ansText": "text",
        "custCnslGbCd": "text",
        "procmnId": "text",
        "cellNoYn": "text",
        "integrateOrdAndGoodsInfo": [
          {
            "ccnNo": "text",
            "custCnslSeq": "text",
            "ordNo": "text",
            "goodsNo": "text",
            "csCcnGoodsResponse": {
              "goodsNo": "text",
              "goodsNm": "text",
              "entrNm": "text"
            },
            "csCcnOrdResponses": [
              {
                "ordNo": "text",
                "goodsNo": "text",
                "goodsNm": "text",
                "itmNo": "text",
                "itmNm": "text",
                "ordQty": "text",
                "salePrc": 1,
                "entrNo": "text",
                "entrNm": "text"
              }
            ],
            "langCd": "text"
          }
        ],
        "integrateProcInfo": [
          {
            "ccnNo": "text",
            "cnslProcSeq": "text",
            "obProcTypCd": "text",
            "cnslProcDtm": "text",
            "cnslProcCont": "text",
            "userNm": "text",
            "sysRegId": "text",
            "csTelPrmsResponses": [
              {
                "ccnNo": "text",
                "cnslProcSeq": "text",
                "telPrmsSeq": "text",
                "prmsDtm": "text",
                "notiTmCd": "text",
                "prmsMethCd": "text",
                "prmsStatCd": "text",
                "cnslMemo": "text",
                "aempId": "text",
                "userNm": "text",
                "aempConfDtm": "text",
                "aempProcDtm": "text",
                "telTryCnt": "text",
                "procStat": "text"
              }
            ]
          }
        ],
        "fileList": [
          {
            "jobClbtBbcNo": "text",
            "fileSeq": "text",
            "atchFileRouteNm": "text",
            "atchFileNm": "text"
          }
        ],
        "telYn": "text",
        "cpnsPayYn": "text",
        "questNo": "text",
        "goodsNo": "text",
        "indInfoMemo": "text",
        "langCode": "text",
        "cnslTypNo": "text",
        "respBaseMemo": "text",
        "instMbrYn": "N",
        "ordLmtYn": "N",
        "ansSubNm": "고객센터"
      }
    ]
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

처리내역 등록 위한 기초데이터 조회

get

기능설명

• 통합상담관리 처리내역 등록을 위한 기초 데이터를 조회 합니다.

---

상세 설명

• 문의내역, 답변완료 처리내역을 조회 합니다.

• 고객전화약속정보를 조회 합니다.

• 아직 완료되지 않은 전화약속정보를 조회 합니다.

• 해당 상담의 고객보상정보를 조회 합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

ccnNoStringRequired

상담번호

Example: 10004911

Responses

200

성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

get

/v2/customerservice/integratedCounselMgmt/getProcessingDetails

HTTPcURLJavaScriptPython

GET /api/bo/v2/customerservice/integratedCounselMgmt/getProcessingDetails?ccnNo=null HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-02-27T16:43:00.760Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "ccnNo": "text",
    "acpData": "text",
    "accpData": "text",
    "userNm": "text",
    "accpDtm": "2026-02-27T16:43:00.760Z",
    "userData": "text",
    "mbrNo": "text",
    "mbrNm": "text",
    "loginId": "text",
    "getEmailAddr": "text",
    "emailAddr": "text",
    "gbcdMedia": "text",
    "accpTypCd": "text",
    "accpTypNm": "text",
    "telNo": "text",
    "telRgnNo": "text",
    "telTxnoNo": "text",
    "telTxnoNos": "text",
    "telEndNo": "text",
    "telEndNos": "text",
    "custInqLrgTypNm": "text",
    "ccnPrgsStatCd": "text",
    "ccnPrgsStatNm": "text",
    "cnslTypText": "text",
    "cnslMidTypTextNm": "text",
    "obTypNm": "text",
    "accpTitle": "text",
    "accpCont": "text",
    "zipNo": "text",
    "zipAddr": "text",
    "dtlAddr": "text",
    "mvotCaus": "text",
    "smsAnsNtcYn": "text",
    "emailAnsNtcYn": "text",
    "preProcYn": "text",
    "ansCont": "text",
    "ansDtm": "text",
    "ansText": "text",
    "custCnslGbCd": "text",
    "procmnId": "text",
    "cellNoYn": "text",
    "integrateOrdAndGoodsInfo": [
      {
        "ccnNo": "text",
        "custCnslSeq": "text",
        "ordNo": "text",
        "goodsNo": "text",
        "csCcnGoodsResponse": {
          "goodsNo": "text",
          "goodsNm": "text",
          "entrNm": "text"
        },
        "csCcnOrdResponses": [
          {
            "ordNo": "text",
            "goodsNo": "text",
            "goodsNm": "text",
            "itmNo": "text",
            "itmNm": "text",
            "ordQty": "text",
            "salePrc": 1,
            "entrNo": "text",
            "entrNm": "text"
          }
        ],
        "langCd": "text"
      }
    ],
    "integrateProcInfo": [
      {
        "ccnNo": "text",
        "cnslProcSeq": "text",
        "obProcTypCd": "text",
        "cnslProcDtm": "text",
        "cnslProcCont": "text",
        "userNm": "text",
        "sysRegId": "text",
        "csTelPrmsResponses": [
          {
            "ccnNo": "text",
            "cnslProcSeq": "text",
            "telPrmsSeq": "text",
            "prmsDtm": "text",
            "notiTmCd": "text",
            "prmsMethCd": "text",
            "prmsStatCd": "text",
            "cnslMemo": "text",
            "aempId": "text",
            "userNm": "text",
            "aempConfDtm": "text",
            "aempProcDtm": "text",
            "telTryCnt": "text",
            "procStat": "text"
          }
        ]
      }
    ],
    "fileList": [
      {
        "jobClbtBbcNo": "text",
        "fileSeq": "text",
        "atchFileRouteNm": "text",
        "atchFileNm": "text"
      }
    ],
    "telYn": "text",
    "cpnsPayYn": "text",
    "questNo": "text",
    "goodsNo": "text",
    "indInfoMemo": "text",
    "langCode": "text",
    "cnslTypNo": "text",
    "respBaseMemo": "text",
    "instMbrYn": "N",
    "ordLmtYn": "N",
    "ansSubNm": "고객센터"
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

통합상담관리 페이지 진입에 필요한 정보 조회

get

기능설명

• 통합상담관리 페이지 진입에 필요한 정보를 조회한다.

---

상세 설명

• 통합상담관리 페이지 진입에 필요한 정보를 조회한다.

---

코드정리

• 연결페이지구분(pageGub):

  • 단순 페이지 링크(dbLink)

  • 고객센터 대시보드 1:1문의(oneCnt)

  • 고객센터 대시보드 전체(totCnt)

  • 고객센터 대시보드 상품Q&A(pdQna)

  • 고객센터 대시보드 일반콜(call)

  • 고객센터 대시보드 OB(ob)

  • 고객센터 대시보드 접수(receipt)

  • 고객센터 대시보드 진행(inProgress)

  • 고객센터 대시보드 완료(complete)

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

pageGubStringOptional

연결페이지구분

Example: dbLink

ccnNoStringOptional

상담번호

Example: 10004561

accpDtmStringOptional

접수일시

Example: 2023-09-07

Responses

200

성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

get

/v2/customerservice/integratedCounselMgmt/getIntegratedCounselMgmtView

HTTPcURLJavaScriptPython

GET /api/bo/v2/customerservice/integratedCounselMgmt/getIntegratedCounselMgmtView HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-02-27T16:43:00.760Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "linkCcnNo": "text",
    "linkAccpDtm": "text",
    "linkPageGub": "text",
    "codeList": {
      "ANY_ADDITIONAL_PROPERTY": [
        {
          "grpCd": "ME001",
          "cd": 11,
          "cdNm": "상품즉시할인",
          "cdDesc": "다국어 코드설명",
          "useYn": "Y",
          "sortSeq": 1,
          "ref1Val": "기준코드 참조1값에 대한 설명",
          "ref2Val": "기준코드 참조2값에 대한 설명",
          "ref3Val": "기준코드 참조3값에 대한 설명",
          "ref4Val": "기준코드 참조4값에 대한 설명",
          "ref5Val": "기준코드 참조5값에 대한 설명",
          "ref6Val": "기준코드 참조6값에 대한 설명",
          "ref7Val": "기준코드 참조7값에 대한 설명"
        }
      ]
    }
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

통합상담관리 상담목록 조회

get

기능설명

• 통합상담관리 상담목록을 조회 합니다.

---

상세 설명

• 선택된 조건에 해당하는 상담목록을 조회 합니다.

---

수정 번호

• Release v2.00_240613: 기간 검색 조건 개선

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

dateSelectstringOptional

조회기간

Example: all_day

periodTypestringOptional

기간검색종류(0:할당일자, 1:접수일자, 2:완료일자)

Example: 1

startDatestring · dateOptional

검색 시작기간

Example: 2023-09-15

endDatestring · dateOptional

검색 종료기간

Example: 2023-09-18

custCnslGbCdstringOptional

상담구분

Example: 10

accpTypCdstringOptional

접수유형

Example: 10

cnslLrgTypNostringOptional

상담유형(대)

Example: 10340

cnslMidTypNostringOptional

상담유형(중)

Example: 10101

cnslTypNostringOptional

상담유형(소)

Example: 10114

ccnPrgsStatCdstringOptional

처리상태코드

Example: 10,20,40

ccnPrgsStatCdListstring[]Optional

처리상태코드(복수선택)

goodsNostringOptional

상품번호

Example: 10001891

noSelectTypestringOptional

조회구분타입(0: 회원ID, 1: 휴대폰번호, 2: 주문번호, 3: 회원명, 4: 회원번호)

Example: 0

noTextstringOptional

조회구분에 따른 입력값(0: 회원ID, 1: 휴대폰번호, 2: 주문번호, 3: 회원명, 4: 회원번호)

Example: kdh

idSelectTypestringOptional

담당자구분(0: 접수자, 1: 처리자)

Example: 0

userIdstringOptional

담당자ID

Example: x2beecc

accpTitlestringOptional

1:1문의 제목

Example: 전화약속

nafrGbCdstringOptional

내외국인구분코드

Example: 10

onOffGbstringOptional

상담형구분(N:일반상담유형, Y:1:1문의유형)

Example: N

ccnNoOnlystringOptional

상담번호로만 검색여부

Example: on

ccnNostringOptional

상담번호

siteNostringOptional

사이트번호

Example: 1

Responses

200

성공

*/*

totalCountinteger · int32Optional

900

업무처리 오류 내용

*/*

get

/v2/customerservice/integratedCounselMgmt/getIntegratedCounselList

HTTPcURLJavaScriptPython

GET /api/bo/v2/customerservice/integratedCounselMgmt/getIntegratedCounselList HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "ccnNo": "text",
      "accpDtm": "2026-02-27T16:43:00.760Z",
      "ccnPrgsStatCd": "text",
      "custCnslGbCd": "text",
      "accpTypCd": "text",
      "cnslTypNo": "text",
      "cnslTypText": "text",
      "accpTitle": "text",
      "accpMediaCd": "text",
      "mbrNo": "text",
      "mbrId": "text",
      "mbrNm": "text",
      "acptmnNm": "text",
      "procmnNm": "text",
      "quotDtm": "2026-02-27T16:43:00.760Z",
      "fnshmnNm": "text",
      "fnshDtm": "2026-02-27T16:43:00.760Z",
      "ordNo": "text",
      "nafrGbCd": "text",
      "mbrGradeCd": "text",
      "acptmnId": "text",
      "procmnId": "text",
      "fnshmnId": "text",
      "siteNm": "x2bee"
    }
  ]
}

고객보상 페이지 진입에 필요한 정보 조회

get

기능설명

• 통합상담관리 고객보상 상세 페이지 진입에 필요한 정보를 조회 합니다.

---

상세 설명

• 고객보상 상세 페이지 노출에 필요한 정보를 조회 합니다.

  • 고객보상정보를 조회 합니다.

  • 고객보상이 등록된 상담 정보를 조회 합니다.

  • 화면에서 사용되는 공통코드를 조회 합니다.

  • 로그인한 사용자의 권한을 조회 합니다.

  • 권한별 승인가능한 금액을 조회 합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

ccnNostringRequired

Responses

200

성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

get

/v2/customerservice/integratedCounselMgmt/getCustomerCompensSaveView

HTTPcURLJavaScriptPython

GET /api/bo/v2/customerservice/integratedCounselMgmt/getCustomerCompensSaveView?ccnNo=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-02-27T16:43:00.760Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "cccai": {
      "custCpnsAplyNo": "text",
      "ccnNo": "text",
      "cpnsTypNo": "text",
      "cpnsTypNm": "text",
      "cpnsTypLrgNm": "text",
      "standard": "text",
      "maxPayLim": "text",
      "cpnsMeanCd": "text",
      "rspnGbCd": "text",
      "cpnsAprvStatCd": "text",
      "cpnsPayStatCd": "text",
      "mbrNo": "text",
      "accpDtm": "text",
      "accpCont": "text",
      "acptmnId": "text",
      "cpnsAmtNo": "text",
      "aprvDtm": "text",
      "aprmnId": "text",
      "payReqMemo": "text",
      "retnDtm": "text",
      "retnProcmnId": "text",
      "payDtm": "text",
      "paymnId": "text",
      "payCont": "text",
      "payReqDtm": "text",
      "payBankCd": "text",
      "payActnNo": "text",
      "payDepositorNm": "text",
      "ordNo": "text",
      "goodsNo": "text",
      "retnCausCont": "text",
      "goodsNm": "text",
      "rcvmnNm": "text",
      "zipNo": "text",
      "zipAddr": "text",
      "dtlAddr": "text",
      "cell": "text",
      "promoNm": "text",
      "dcRateAmt": 1,
      "cpnsConts": "text"
    },
    "ccnData": {
      "ccnNo": "text",
      "custCnslSeq": "text",
      "otherCount": 1,
      "ordNo": "text",
      "goodsNo": "text",
      "goodsNm": "text",
      "entrNo": "text",
      "entrNm": "text",
      "mbrNo": "text",
      "mbrNm": "text",
      "noMaskingMbrNm": "text",
      "loginId": "text",
      "noMaskingLoginId": "text",
      "rfdBankCd": "text",
      "rfdActnNo": "text",
      "count": 1,
      "relatedConsultation": [
        {
          "ccnNo": "text",
          "acpData": "text",
          "accpData": "text",
          "userNm": "text",
          "accpDtm": "2026-02-27T16:43:00.760Z",
          "userData": "text",
          "mbrNo": "text",
          "mbrNm": "text",
          "loginId": "text",
          "getEmailAddr": "text",
          "emailAddr": "text",
          "gbcdMedia": "text",
          "accpTypCd": "text",
          "accpTypNm": "text",
          "telNo": "text",
          "telRgnNo": "text",
          "telTxnoNo": "text",
          "telTxnoNos": "text",
          "telEndNo": "text",
          "telEndNos": "text",
          "custInqLrgTypNm": "text",
          "ccnPrgsStatCd": "text",
          "ccnPrgsStatNm": "text",
          "cnslTypText": "text",
          "cnslMidTypTextNm": "text",
          "obTypNm": "text",
          "accpTitle": "text",
          "accpCont": "text",
          "zipNo": "text",
          "zipAddr": "text",
          "dtlAddr": "text",
          "mvotCaus": "text",
          "smsAnsNtcYn": "text",
          "emailAnsNtcYn": "text",
          "preProcYn": "text",
          "ansCont": "text",
          "ansDtm": "text",
          "ansText": "text",
          "custCnslGbCd": "text",
          "procmnId": "text",
          "cellNoYn": "text",
          "integrateOrdAndGoodsInfo": [
            {
              "ccnNo": "text",
              "custCnslSeq": "text",
              "ordNo": "text",
              "goodsNo": "text",
              "csCcnGoodsResponse": {
                "goodsNo": "text",
                "goodsNm": "text",
                "entrNm": "text"
              },
              "csCcnOrdResponses": [
                {
                  "ordNo": "text",
                  "goodsNo": "text",
                  "goodsNm": "text",
                  "itmNo": "text",
                  "itmNm": "text",
                  "ordQty": "text",
                  "salePrc": 1,
                  "entrNo": "text",
                  "entrNm": "text"
                }
              ],
              "langCd": "text"
            }
          ],
          "integrateProcInfo": [
            {
              "ccnNo": "text",
              "cnslProcSeq": "text",
              "obProcTypCd": "text",
              "cnslProcDtm": "text",
              "cnslProcCont": "text",
              "userNm": "text",
              "sysRegId": "text",
              "csTelPrmsResponses": [
                {
                  "ccnNo": "text",
                  "cnslProcSeq": "text",
                  "telPrmsSeq": "text",
                  "prmsDtm": "text",
                  "notiTmCd": "text",
                  "prmsMethCd": "text",
                  "prmsStatCd": "text",
                  "cnslMemo": "text",
                  "aempId": "text",
                  "userNm": "text",
                  "aempConfDtm": "text",
                  "aempProcDtm": "text",
                  "telTryCnt": "text",
                  "procStat": "text"
                }
              ]
            }
          ],
          "fileList": [
            {
              "jobClbtBbcNo": "text",
              "fileSeq": "text",
              "atchFileRouteNm": "text",
              "atchFileNm": "text"
            }
          ],
          "telYn": "text",
          "cpnsPayYn": "text",
          "questNo": "text",
          "goodsNo": "text",
          "indInfoMemo": "text",
          "langCode": "text",
          "cnslTypNo": "text",
          "respBaseMemo": "text",
          "instMbrYn": "N",
          "ordLmtYn": "N",
          "ansSubNm": "고객센터"
        }
      ]
    },
    "codeList": {
      "ANY_ADDITIONAL_PROPERTY": [
        {
          "grpCd": "ME001",
          "cd": 11,
          "cdNm": "상품즉시할인",
          "cdDesc": "다국어 코드설명",
          "useYn": "Y",
          "sortSeq": 1,
          "ref1Val": "기준코드 참조1값에 대한 설명",
          "ref2Val": "기준코드 참조2값에 대한 설명",
          "ref3Val": "기준코드 참조3값에 대한 설명",
          "ref4Val": "기준코드 참조4값에 대한 설명",
          "ref5Val": "기준코드 참조5값에 대한 설명",
          "ref6Val": "기준코드 참조6값에 대한 설명",
          "ref7Val": "기준코드 참조7값에 대한 설명"
        }
      ]
    },
    "csCpGradeAmtCode": {
      "ANY_ADDITIONAL_PROPERTY": [
        {
          "grpCd": "ME001",
          "cd": 11,
          "cdNm": "상품즉시할인",
          "cdDesc": "다국어 코드설명",
          "useYn": "Y",
          "sortSeq": 1,
          "ref1Val": "기준코드 참조1값에 대한 설명",
          "ref2Val": "기준코드 참조2값에 대한 설명",
          "ref3Val": "기준코드 참조3값에 대한 설명",
          "ref4Val": "기준코드 참조4값에 대한 설명",
          "ref5Val": "기준코드 참조5값에 대한 설명",
          "ref6Val": "기준코드 참조6값에 대한 설명",
          "ref7Val": "기준코드 참조7값에 대한 설명"
        }
      ]
    },
    "csCpUserGrade": "text"
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

고객상담(고객/주문/상품 정보 조회

get

기능설명

• 통합상담관리 고객상담(고객/주문/상품) 정보를 조회 합니다.

---

상세 설명

• 등록된 고객상담(고객/주문/상품) 정보를 조회 합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

ccnNoStringRequired

상담번호

Example: 10004911

Responses

200

성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

get

/v2/customerservice/integratedCounselMgmt/getCsOrderGoodsData

HTTPcURLJavaScriptPython

GET /api/bo/v2/customerservice/integratedCounselMgmt/getCsOrderGoodsData?ccnNo=null HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-02-27T16:43:00.760Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "ccnNo": "text",
    "custCnslSeq": "text",
    "otherCount": 1,
    "ordNo": "text",
    "goodsNo": "text",
    "goodsNm": "text",
    "entrNo": "text",
    "entrNm": "text",
    "mbrNo": "text",
    "mbrNm": "text",
    "noMaskingMbrNm": "text",
    "loginId": "text",
    "noMaskingLoginId": "text",
    "rfdBankCd": "text",
    "rfdActnNo": "text",
    "count": 1,
    "relatedConsultation": [
      {
        "ccnNo": "text",
        "acpData": "text",
        "accpData": "text",
        "userNm": "text",
        "accpDtm": "2026-02-27T16:43:00.760Z",
        "userData": "text",
        "mbrNo": "text",
        "mbrNm": "text",
        "loginId": "text",
        "getEmailAddr": "text",
        "emailAddr": "text",
        "gbcdMedia": "text",
        "accpTypCd": "text",
        "accpTypNm": "text",
        "telNo": "text",
        "telRgnNo": "text",
        "telTxnoNo": "text",
        "telTxnoNos": "text",
        "telEndNo": "text",
        "telEndNos": "text",
        "custInqLrgTypNm": "text",
        "ccnPrgsStatCd": "text",
        "ccnPrgsStatNm": "text",
        "cnslTypText": "text",
        "cnslMidTypTextNm": "text",
        "obTypNm": "text",
        "accpTitle": "text",
        "accpCont": "text",
        "zipNo": "text",
        "zipAddr": "text",
        "dtlAddr": "text",
        "mvotCaus": "text",
        "smsAnsNtcYn": "text",
        "emailAnsNtcYn": "text",
        "preProcYn": "text",
        "ansCont": "text",
        "ansDtm": "text",
        "ansText": "text",
        "custCnslGbCd": "text",
        "procmnId": "text",
        "cellNoYn": "text",
        "integrateOrdAndGoodsInfo": [
          {
            "ccnNo": "text",
            "custCnslSeq": "text",
            "ordNo": "text",
            "goodsNo": "text",
            "csCcnGoodsResponse": {
              "goodsNo": "text",
              "goodsNm": "text",
              "entrNm": "text"
            },
            "csCcnOrdResponses": [
              {
                "ordNo": "text",
                "goodsNo": "text",
                "goodsNm": "text",
                "itmNo": "text",
                "itmNm": "text",
                "ordQty": "text",
                "salePrc": 1,
                "entrNo": "text",
                "entrNm": "text"
              }
            ],
            "langCd": "text"
          }
        ],
        "integrateProcInfo": [
          {
            "ccnNo": "text",
            "cnslProcSeq": "text",
            "obProcTypCd": "text",
            "cnslProcDtm": "text",
            "cnslProcCont": "text",
            "userNm": "text",
            "sysRegId": "text",
            "csTelPrmsResponses": [
              {
                "ccnNo": "text",
                "cnslProcSeq": "text",
                "telPrmsSeq": "text",
                "prmsDtm": "text",
                "notiTmCd": "text",
                "prmsMethCd": "text",
                "prmsStatCd": "text",
                "cnslMemo": "text",
                "aempId": "text",
                "userNm": "text",
                "aempConfDtm": "text",
                "aempProcDtm": "text",
                "telTryCnt": "text",
                "procStat": "text"
              }
            ]
          }
        ],
        "fileList": [
          {
            "jobClbtBbcNo": "text",
            "fileSeq": "text",
            "atchFileRouteNm": "text",
            "atchFileNm": "text"
          }
        ],
        "telYn": "text",
        "cpnsPayYn": "text",
        "questNo": "text",
        "goodsNo": "text",
        "indInfoMemo": "text",
        "langCode": "text",
        "cnslTypNo": "text",
        "respBaseMemo": "text",
        "instMbrYn": "N",
        "ordLmtYn": "N",
        "ansSubNm": "고객센터"
      }
    ]
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

고객보상 정보 조회

get

기능설명

• 통합상담관리 고객보상 정보를 조회 합니다.

---

상세 설명

• 통합상담관리에서 등록한 고객보상 정보를 조회 합니다.

• 비회원 상담은 조회 할 수 없습니다.

---

수정번호

• Release v2.00_250905: 대분류 조회 추가

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

ccnNostringRequired

Responses

200

성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

get

/v2/customerservice/integratedCounselMgmt/getCsCustCpnsAccpInfo

HTTPcURLJavaScriptPython

GET /api/bo/v2/customerservice/integratedCounselMgmt/getCsCustCpnsAccpInfo?ccnNo=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-02-27T16:43:00.760Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "custCpnsAplyNo": "text",
    "ccnNo": "text",
    "cpnsTypNo": "text",
    "cpnsTypNm": "text",
    "cpnsTypLrgNm": "text",
    "standard": "text",
    "maxPayLim": "text",
    "cpnsMeanCd": "text",
    "rspnGbCd": "text",
    "cpnsAprvStatCd": "text",
    "cpnsPayStatCd": "text",
    "mbrNo": "text",
    "accpDtm": "text",
    "accpCont": "text",
    "acptmnId": "text",
    "cpnsAmtNo": "text",
    "aprvDtm": "text",
    "aprmnId": "text",
    "payReqMemo": "text",
    "retnDtm": "text",
    "retnProcmnId": "text",
    "payDtm": "text",
    "paymnId": "text",
    "payCont": "text",
    "payReqDtm": "text",
    "payBankCd": "text",
    "payActnNo": "text",
    "payDepositorNm": "text",
    "ordNo": "text",
    "goodsNo": "text",
    "retnCausCont": "text",
    "goodsNm": "text",
    "rcvmnNm": "text",
    "zipNo": "text",
    "zipAddr": "text",
    "dtlAddr": "text",
    "cell": "text",
    "promoNm": "text",
    "dcRateAmt": 1,
    "cpnsConts": "text"
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

상담템플릿 목록을 조회 합니다.

get

기능설명

• 통합상담관리 1:1문의 답변에 사용되는 상담템플릿 목록을 조회 합니다.

---

상세 설명

• 1:1문의 상담 답변 등록시에만 사용할 수 있습니다.

• 상담템플릿은 공통/개인으로 구분됩니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

argSelectTypestringOptional

argInsertUpdatestringOptional

저장/수정 구분값

typeCodestringOptional

탭 구분(공통:common, 개인:alone)

Example: common

cnslAempIdstringOptional

등록자ID

Example: x2beecc

cnslAempNmstringOptional

cnslTmplNostringOptional

cnslGbCdstringOptional

cnslTypCdstringOptional

tmplNmstringOptional

tmplContstringOptional

userIdstringOptional

callGubstringOptional

useYnstringOptional

handlerGbstringOptional

Responses

200

성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

get

/v2/customerservice/integratedCounselMgmt/getCsCounselTemplateInfo

HTTPcURLJavaScriptPython

GET /api/bo/v2/customerservice/integratedCounselMgmt/getCsCounselTemplateInfo HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-02-27T16:43:00.760Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": [
    {
      "argInsertUpdate": "text",
      "typeCode": "common",
      "cnslAempId": "text",
      "cnslAempNm": "text",
      "cnslTmplNo": "text",
      "cnslGbCd": 30,
      "cnslTypCd": "01",
      "tmplNm": "테스트기타",
      "tmplCont": "테스트기타",
      "userId": "x2beecc",
      "callGub": "csTemplateMain",
      "useYn": "Y"
    }
  ],
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

통합상담관리 상담 등록 페이지 진입에 필요한 정보 조회

get

기능설명

• 통합상담관리 상담 등록 페이지 진입에 필요한 정보를 조회한다.

---

상세 설명

• 공통코드, 회원정보를 조회 합니다.

• 공통코드 : CS001,CS003,CS005,CS008,CS013,CM013

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

get

/v2/customerservice/integratedCounselMgmt/getCounselRegistView

HTTPcURLJavaScriptPython

GET /api/bo/v2/customerservice/integratedCounselMgmt/getCounselRegistView HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-02-27T16:43:00.760Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "userIndInfo": "text",
    "codeList": {
      "ANY_ADDITIONAL_PROPERTY": [
        {
          "grpCd": "ME001",
          "cd": 11,
          "cdNm": "상품즉시할인",
          "cdDesc": "다국어 코드설명",
          "useYn": "Y",
          "sortSeq": 1,
          "ref1Val": "기준코드 참조1값에 대한 설명",
          "ref2Val": "기준코드 참조2값에 대한 설명",
          "ref3Val": "기준코드 참조3값에 대한 설명",
          "ref4Val": "기준코드 참조4값에 대한 설명",
          "ref5Val": "기준코드 참조5값에 대한 설명",
          "ref6Val": "기준코드 참조6값에 대한 설명",
          "ref7Val": "기준코드 참조7값에 대한 설명"
        }
      ]
    }
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

고객상담 처리내역 조회

get

기능 설명

고객 상담 처리 내역을 조회합니다.

상세 내용

• 선택한 고객상담의 처리 내역을 조회합니다.

• 고객 상담 처리 내역별 고객전화약속정보를 조회합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

ccnNoStringRequired

상담번호

Example: 10004911

Responses

200

OK

*/*

totalCountinteger · int32Optional

get

/v2/customerservice/integratedCounselMgmt/getCounselProcessHistory

HTTPcURLJavaScriptPython

GET /api/bo/v2/customerservice/integratedCounselMgmt/getCounselProcessHistory?ccnNo=null HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

OK

{
  "totalCount": 1,
  "payloads": [
    {
      "ccnNo": "text",
      "cnslProcSeq": "text",
      "obProcTypCd": "text",
      "cnslProcDtm": "text",
      "cnslProcCont": "text",
      "userNm": "text",
      "sysRegId": "text",
      "csTelPrmsResponses": [
        {
          "ccnNo": "text",
          "cnslProcSeq": "text",
          "telPrmsSeq": "text",
          "prmsDtm": "text",
          "notiTmCd": "text",
          "prmsMethCd": "text",
          "prmsStatCd": "text",
          "cnslMemo": "text",
          "aempId": "text",
          "userNm": "text",
          "aempConfDtm": "text",
          "aempProcDtm": "text",
          "telTryCnt": "text",
          "procStat": "text"
        }
      ]
    }
  ]
}