주문조회

비회원 로그인

post

기능 설명

비회원 주문조회시 주문 유효성 검사 후 비회원 쿠키 정보 생성

상세 설명

해당 주문이 존재하는지 해당 주문 비회원 비밀번호가 유효한지 체크
유효성 검사 성공 후 주문번호, 비회원 비밀번호 쿠키 정보 세팅

Header parameters

AuthorizationanyOptional

Access Token

Body

ordNostringRequired

주문번호

nonMemberPwdstringRequired

비회원 비밀번호

systemTypestring · enumRequired

SYSTEM(시스템유형) * 10 : FO * 20 : BO

Example: 10Possible values:

Responses

200

비회원 로그인 처리 성공

application/json

900

업무처리 오류 내용

application/json

post/v1/order/nonMember/loginProcess

POST /api/order/v1/order/nonMember/loginProcess HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 56

{
  "ordNo": "text",
  "nonMemberPwd": "text",
  "systemType": "10"
}

주문내역 조회

post

기능 설명

주문 내역 목록을 조회합니다.

상세 설명

회원번호에 해당하는 주문 목록을 조회합니다.
비회원은 주문 내역 리스트 조회 불가능합니다.
조회시작일시, 조회종료일시 사이에 포함된 주문 목록만 조회합니다.
주문현황구분코드는 마이페이지 > 주문 현황 > 주문/배송 클릭시 'O', 취소/교환/반품 클릭시 'C' 로 데이터를 넘겨받습니다.
- 주문/배송으로 넘어왔을 경우 모든 주문에 대한 목록 조회이며, 취소/교환/반품으로 넘어왔을 경우는 취소/교환/반품에 대한 목록만 조회합니다.
주문상품 단위로 FO 시스템 클레임처리 가능상태(ST007) 그룹코드의 주문내역상태코드(ref_1_val)과 주문내역구분코드(ref_2_val)에 해당하는 각 코드를 가져와 화면단에서 버튼을 노출합니다.(orderButtonList)

수정번호

release_231220 : 배송지 컬럼 추가
Release v2.00_240401:
- 단일상품여부 추가
- 본품주문순번 추가(해당 상품에 대한 사은품 매칭을 위한 값)
- 예약상품 출고예정일 추가
- orderClassificationCode값이 'O'일 경우 전체 조회에서 주문/배송만 조회로 변경
Release v2.00_240729 : 취소 가능 여부(ordCnclPsbYn) 추가, 상품 필터링 시 상품유형코드(goodsTypCd) e-쿠폰상품 추가

Header parameters

AuthorizationanyOptional

Access Token

Body

주문 목록 조회 DTO

rowsPerPageinteger · int32Optional

화면당노출수량

Example: 10

pageIdxinteger · int32Optional

페이지번호

Example: 1

stdDtstring · dateOptional

조회시작일

Example: 2023-08-02

endDtstring · dateOptional

조회종료일

Example: 2023-08-09

orderClassificationCodestringOptional

주문현황구분코드값(모든주문조회: O / 클레임조회 : C / 선물함조회 : G)

Example: C

pagingYnstringOptional

페이징처리여부

Example: Y

Responses

200

성공

*/*

주문 목록 DTO

totCntinteger · int32Optional

주문건수

Example: 10

rowsPerPageinteger · int32Optional

화면당노출수량

Example: 10

pageIdxinteger · int32Optional

페이지번호

Example: 1

900

업무처리 오류 내용

*/*

post/v1/mypage/order/orderInfoList

POST /api/order/v1/mypage/order/orderInfoList HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 117

{
  "rowsPerPage": 10,
  "pageIdx": 1,
  "stdDt": "2023-08-02",
  "endDt": "2023-08-09",
  "orderClassificationCode": "C",
  "pagingYn": "Y"
}

{
  "totCnt": 10,
  "rowsPerPage": 10,
  "pageIdx": 1,
  "ordList": [
    {
      "ordNo": "20230809O007943",
      "ordAccpDtm": "2026-01-01T00:00:00.000Z",
      "deliMethodCd": "10",
      "deliMethodNm": "10",
      "ordManNm": "홍길동",
      "ordManCellNo": "Y",
      "mbrNo": "100001452",
      "ordGbCd": "10",
      "rcvmnNm": "홍길동",
      "rcvmnCellNo": "Y",
      "prdList": [
        {
          "system": "10",
          "dlvpSeq": "1",
          "ordNo": "20230809O007943",
          "ordDtlGbCd": "10",
          "ordDtlGbCdNm": "주문완료",
          "ordGbCd": "10",
          "ordGbCdNm": "일반주문",
          "ordSeq": "1",
          "ordProcSeq": "1",
          "claimNo": "20230725C006642",
          "aeOrdSeq": "1",
          "goodsNo": "10002042",
          "goodsNm": "P직매입20",
          "itmNo": "001",
          "itmNm": "레드>190x190",
          "sngGoodsYn": "Y",
          "goodsTypCd": "10",
          "goodsTypCdNm": "일반상품",
          "brandNo": "100002",
          "brandNm": "멀버리",
          "ordDtlStatCd": "12",
          "ordDtlStatCdNm": "주문완료",
          "prestNm": "증정품",
          "norPrc": 1000,
          "salePrc": 1000,
          "dcAmt": 0,
          "ordQty": 1,
          "cnclQty": 1,
          "rtnQty": 1,
          "ordAmt": 1000,
          "deliNo": "1",
          "deliKindCd": "10",
          "deliKindCdNm": "일반배송",
          "shipWaitCaus": "10",
          "shipWaitCausNm": "재고부족",
          "deliTypCd": "01",
          "deliTypCdNm": "일반상품",
          "deliGbCd": "10",
          "deliPolcNo": "10000431",
          "rcvmnNm": "홍길동",
          "zipNo": "05837",
          "zipAddr": "서울 송파구 법원로9길 26",
          "dtlAddr": "비즈니스파크",
          "deliAddr": "서울 송파구 법원로9길 26 비즈니스파크",
          "deliMethodCd": "10",
          "deliMethodCdNm": "택배배송",
          "ordAccpDtm": "2026-01-01T00:00:00.000Z",
          "ordFnshDtm": "2026-01-01T00:00:00.000Z",
          "goodsRevWrtYn": "N",
          "deliFnshDtm": "2026-01-01T00:00:00.000Z",
          "goodsImg": "/url",
          "rtnPsbYn": "N",
          "prstStatCd": "10",
          "claimMgrpCd": "100",
          "claimCauseFaultType": "10",
          "wthdFnshGbCd": "10",
          "exchPsbYn": "N",
          "ordCnclPsbYn": "Y",
          "wthdYn": "Y",
          "ecpnNo": "ORD0001",
          "etcktNo": "ORD0001",
          "saleMethCd": "20",
          "deliIndiRsvDtm": "2026-01-01T00:00:00.000Z",
          "frgnDirPurGoodsYn": "text",
          "taxGbCd": "text"
        }
      ],
      "aeEvtList": [
        {
          "system": "10",
          "dlvpSeq": "1",
          "ordNo": "20230809O007943",
          "ordDtlGbCd": "10",
          "ordDtlGbCdNm": "주문완료",
          "ordGbCd": "10",
          "ordGbCdNm": "일반주문",
          "ordSeq": "1",
          "ordProcSeq": "1",
          "claimNo": "20230725C006642",
          "aeOrdSeq": "1",
          "goodsNo": "10002042",
          "goodsNm": "P직매입20",
          "itmNo": "001",
          "itmNm": "레드>190x190",
          "sngGoodsYn": "Y",
          "goodsTypCd": "10",
          "goodsTypCdNm": "일반상품",
          "brandNo": "100002",
          "brandNm": "멀버리",
          "ordDtlStatCd": "12",
          "ordDtlStatCdNm": "주문완료",
          "prestNm": "증정품",
          "norPrc": 1000,
          "salePrc": 1000,
          "dcAmt": 0,
          "ordQty": 1,
          "cnclQty": 1,
          "rtnQty": 1,
          "ordAmt": 1000,
          "deliNo": "1",
          "deliKindCd": "10",
          "deliKindCdNm": "일반배송",
          "shipWaitCaus": "10",
          "shipWaitCausNm": "재고부족",
          "deliTypCd": "01",
          "deliTypCdNm": "일반상품",
          "deliGbCd": "10",
          "deliPolcNo": "10000431",
          "rcvmnNm": "홍길동",
          "zipNo": "05837",
          "zipAddr": "서울 송파구 법원로9길 26",
          "dtlAddr": "비즈니스파크",
          "deliAddr": "서울 송파구 법원로9길 26 비즈니스파크",
          "deliMethodCd": "10",
          "deliMethodCdNm": "택배배송",
          "ordAccpDtm": "2026-01-01T00:00:00.000Z",
          "ordFnshDtm": "2026-01-01T00:00:00.000Z",
          "goodsRevWrtYn": "N",
          "deliFnshDtm": "2026-01-01T00:00:00.000Z",
          "goodsImg": "/url",
          "rtnPsbYn": "N",
          "prstStatCd": "10",
          "claimMgrpCd": "100",
          "claimCauseFaultType": "10",
          "wthdFnshGbCd": "10",
          "exchPsbYn": "N",
          "ordCnclPsbYn": "Y",
          "wthdYn": "Y",
          "ecpnNo": "ORD0001",
          "etcktNo": "ORD0001",
          "saleMethCd": "20",
          "deliIndiRsvDtm": "2026-01-01T00:00:00.000Z",
          "frgnDirPurGoodsYn": "text",
          "taxGbCd": "text"
        }
      ],
      "dlvpInfo": [
        {
          "dlvpSeq": "1",
          "rcvmnNm": "홍길동",
          "zipNo": "05837",
          "zipAddr": "서울 송파구 법원로9길",
          "dtlAddr": "에이치비지니스파크 D동 6층23",
          "deliAddr": "서울 송파구 법원로9길 에이치비지니스파크 D동 6층23",
          "rcvmnEmailAddr": "test@plateer.com",
          "rcvmnCellSctNo": "010",
          "rcvmnCellTxnoNo": "1234",
          "rcvmnCellEndNo": "5678",
          "deliMsg": "문 앞에 두고 가주세요.",
          "deliMsgCd": "10",
          "deliMsgCdNm": "배송 전 연락바랍니다.",
          "comnFrdrEtcMethod": "자유출입가능",
          "comnFrdrPwd": "1234",
          "comnFrdrCogoMethodCd": "10",
          "persCstmCd": "text",
          "deliNo": "101016693",
          "deliInfoGroupList": [
            {
              "deliNo": "1",
              "prdList": [
                {
                  "system": "10",
                  "dlvpSeq": "1",
                  "ordNo": "20230809O007943",
                  "ordDtlGbCd": "10",
                  "ordDtlGbCdNm": "주문완료",
                  "ordGbCd": "10",
                  "ordGbCdNm": "일반주문",
                  "ordSeq": "1",
                  "ordProcSeq": "1",
                  "claimNo": "20230725C006642",
                  "aeOrdSeq": "1",
                  "goodsNo": "10002042",
                  "goodsNm": "P직매입20",
                  "itmNo": "001",
                  "itmNm": "레드>190x190",
                  "sngGoodsYn": "Y",
                  "goodsTypCd": "10",
                  "goodsTypCdNm": "일반상품",
                  "brandNo": "100002",
                  "brandNm": "멀버리",
                  "ordDtlStatCd": "12",
                  "ordDtlStatCdNm": "주문완료",
                  "prestNm": "증정품",
                  "norPrc": 1000,
                  "salePrc": 1000,
                  "dcAmt": 0,
                  "ordQty": 1,
                  "cnclQty": 1,
                  "rtnQty": 1,
                  "ordAmt": 1000,
                  "deliNo": "1",
                  "deliKindCd": "10",
                  "deliKindCdNm": "일반배송",
                  "shipWaitCaus": "10",
                  "shipWaitCausNm": "재고부족",
                  "deliTypCd": "01",
                  "deliTypCdNm": "일반상품",
                  "deliGbCd": "10",
                  "deliPolcNo": "10000431",
                  "rcvmnNm": "홍길동",
                  "zipNo": "05837",
                  "zipAddr": "서울 송파구 법원로9길 26",
                  "dtlAddr": "비즈니스파크",
                  "deliAddr": "서울 송파구 법원로9길 26 비즈니스파크",
                  "deliMethodCd": "10",
                  "deliMethodCdNm": "택배배송",
                  "ordAccpDtm": "2026-01-01T00:00:00.000Z",
                  "ordFnshDtm": "2026-01-01T00:00:00.000Z",
                  "goodsRevWrtYn": "N",
                  "deliFnshDtm": "2026-01-01T00:00:00.000Z",
                  "goodsImg": "/url",
                  "rtnPsbYn": "N",
                  "prstStatCd": "10",
                  "claimMgrpCd": "100",
                  "claimCauseFaultType": "10",
                  "wthdFnshGbCd": "10",
                  "exchPsbYn": "N",
                  "ordCnclPsbYn": "Y",
                  "wthdYn": "Y",
                  "ecpnNo": "ORD0001",
                  "etcktNo": "ORD0001",
                  "saleMethCd": "20",
                  "deliIndiRsvDtm": "2026-01-01T00:00:00.000Z",
                  "frgnDirPurGoodsYn": "text",
                  "taxGbCd": "text"
                }
              ],
              "aeEvtList": [
                {
                  "system": "10",
                  "dlvpSeq": "1",
                  "ordNo": "20230809O007943",
                  "ordDtlGbCd": "10",
                  "ordDtlGbCdNm": "주문완료",
                  "ordGbCd": "10",
                  "ordGbCdNm": "일반주문",
                  "ordSeq": "1",
                  "ordProcSeq": "1",
                  "claimNo": "20230725C006642",
                  "aeOrdSeq": "1",
                  "goodsNo": "10002042",
                  "goodsNm": "P직매입20",
                  "itmNo": "001",
                  "itmNm": "레드>190x190",
                  "sngGoodsYn": "Y",
                  "goodsTypCd": "10",
                  "goodsTypCdNm": "일반상품",
                  "brandNo": "100002",
                  "brandNm": "멀버리",
                  "ordDtlStatCd": "12",
                  "ordDtlStatCdNm": "주문완료",
                  "prestNm": "증정품",
                  "norPrc": 1000,
                  "salePrc": 1000,
                  "dcAmt": 0,
                  "ordQty": 1,
                  "cnclQty": 1,
                  "rtnQty": 1,
                  "ordAmt": 1000,
                  "deliNo": "1",
                  "deliKindCd": "10",
                  "deliKindCdNm": "일반배송",
                  "shipWaitCaus": "10",
                  "shipWaitCausNm": "재고부족",
                  "deliTypCd": "01",
                  "deliTypCdNm": "일반상품",
                  "deliGbCd": "10",
                  "deliPolcNo": "10000431",
                  "rcvmnNm": "홍길동",
                  "zipNo": "05837",
                  "zipAddr": "서울 송파구 법원로9길 26",
                  "dtlAddr": "비즈니스파크",
                  "deliAddr": "서울 송파구 법원로9길 26 비즈니스파크",
                  "deliMethodCd": "10",
                  "deliMethodCdNm": "택배배송",
                  "ordAccpDtm": "2026-01-01T00:00:00.000Z",
                  "ordFnshDtm": "2026-01-01T00:00:00.000Z",
                  "goodsRevWrtYn": "N",
                  "deliFnshDtm": "2026-01-01T00:00:00.000Z",
                  "goodsImg": "/url",
                  "rtnPsbYn": "N",
                  "prstStatCd": "10",
                  "claimMgrpCd": "100",
                  "claimCauseFaultType": "10",
                  "wthdFnshGbCd": "10",
                  "exchPsbYn": "N",
                  "ordCnclPsbYn": "Y",
                  "wthdYn": "Y",
                  "ecpnNo": "ORD0001",
                  "etcktNo": "ORD0001",
                  "saleMethCd": "20",
                  "deliIndiRsvDtm": "2026-01-01T00:00:00.000Z",
                  "frgnDirPurGoodsYn": "text",
                  "taxGbCd": "text"
                }
              ]
            }
          ]
        }
      ],
      "payInfo": [
        {
          "type": "R",
          "ordNo": "20230809O007943",
          "totOrdPrc": 1000,
          "totAplyAdtnAmt": 1000,
          "totDcAmt": 1000,
          "saveMileageAmt": 10,
          "addPayAmt": 1000,
          "totPayAmt": 0,
          "mileagePayAmt": 1000,
          "pgGbCd": "1000",
          "payMethodResponses": [
            {
              "payWayCd": "11",
              "payWayCdNm": "신용카드",
              "payReqCardcoCd": "201",
              "payReqCardcoCdNm": "현대카드",
              "acqrCd": "201",
              "acqrCdNm": "현대카드",
              "bankCd": "10",
              "bankCdNm": "우리은행",
              "actnNo": "계좌번호 암호화",
              "dpmnNm": "김플래티어",
              "dptFcstDt": "20990101",
              "dlvMonCnt": 6,
              "nintDivYn": "Y",
              "payAmt": 1000
            }
          ],
          "accumulatedMileageResponses": [
            {
              "type": "FRS",
              "adtnDtlGbCd": "41",
              "adtnDtlGbCdNm": "기본적립",
              "aplyAdtnAmt": 1000
            }
          ]
        }
      ]
    }
  ]
}

주문내역 상세 조회

post

기능 설명

주문 내역 상세를 조회합니다.

상세 설명

주문번호에 해당하는 주문 상세(주문상품정보, 최초결제정보, 최초적립마일리지, 최종환불정보 등)를 조회합니다.
비회원일 경우, 비회원 비밀번호와 주문번호가 일치하는 주문이 존재하면 주문 상세를 조회합니다.
주문상품 단위로 FO 시스템 클레임처리 가능상태(ST007) 그룹코드의 주문내역상태코드(ref_1_val)과 주문내역구분코드(ref_2_val)에 해당하는 각 코드를 가져와 화면단에서 버튼을 노출합니다.(orderButtonList)

수정번호

release_231206 : Response DTO 배송지정보목록 하위에 배송그룹목록(deliInfoGroupList) 추가 세팅(UI 노출 구조 변경 : 배송지 > 배송그룹 > 상품/사은품목록)
Release v2.00_240425 : 멀티 사이트 확장에 따른 사이트 번호(site_no) 추가
Release v2.00_240711 : 추가 배송비 개선에 따른 배송정책번호(deli_polc_no) 조회 추가
Release v2.00_240729 : 취소 가능 여부(ordCnclPsbYn) 추가, 상품 필터링 시 상품유형코드(goodsTypCd) e-쿠폰상품 추가

Header parameters

AuthorizationanyOptional

Access Token

Body

주문 상세 조회 DTO

ordNostringRequired

주문번호

Example: 20230809O007943

systemTypestring · enumOptional

SYSTEM(시스템유형) * 10 : FO * 20 : BO

Example: 10Possible values:

pagingYnstring · enumOptional

페이징여부

Example: YPossible values:

Responses

200

성공

*/*

주문 내역 상세 정보 DTO

ordNostringOptional

주문번호

Example: 20230809O007943

ordAccpDtmstring · date-timeOptional

주문접수일시

deliMethodCdstringOptional

배송방법코드(LO010)

Example: 10

deliMethodNmstringOptional

배송방법코드명

Example: 10

ordManNmstringOptional

주문자명

Example: 홍길동

ordManCellNostringOptional

주문자 휴대폰번호

Example: Y

mbrNostringOptional

회원번호

Example: 100001452

ordGbCdstringOptional

주문구분코드(OM002)

Example: 10

rcvmnNmstringOptional

수취인명

Example: 홍길동

rcvmnCellNostringOptional

수취인 휴대폰번호

Example: Y

giftAcceptanceDeadlineAndDateinteger · int32Write-onlyOptional

additionalInfointeger · int32Write-onlyOptional

900

업무처리 오류 내용

*/*

post/v1/mypage/order/orderDetailInfo

POST /api/order/v1/mypage/order/orderDetailInfo HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 60

{
  "ordNo": "20230809O007943",
  "systemType": "10",
  "pagingYn": "Y"
}

{
  "ordNo": "20230809O007943",
  "ordAccpDtm": "2026-01-01T00:00:00.000Z",
  "deliMethodCd": "10",
  "deliMethodNm": "10",
  "ordManNm": "홍길동",
  "ordManCellNo": "Y",
  "mbrNo": "100001452",
  "ordGbCd": "10",
  "rcvmnNm": "홍길동",
  "rcvmnCellNo": "Y",
  "prdList": [
    {
      "system": "10",
      "dlvpSeq": "1",
      "ordNo": "20230809O007943",
      "ordDtlGbCd": "10",
      "ordDtlGbCdNm": "주문완료",
      "ordGbCd": "10",
      "ordGbCdNm": "일반주문",
      "ordSeq": "1",
      "ordProcSeq": "1",
      "claimNo": "20230725C006642",
      "aeOrdSeq": "1",
      "goodsNo": "10002042",
      "goodsNm": "P직매입20",
      "itmNo": "001",
      "itmNm": "레드>190x190",
      "sngGoodsYn": "Y",
      "goodsTypCd": "10",
      "goodsTypCdNm": "일반상품",
      "brandNo": "100002",
      "brandNm": "멀버리",
      "ordDtlStatCd": "12",
      "ordDtlStatCdNm": "주문완료",
      "prestNm": "증정품",
      "norPrc": 1000,
      "salePrc": 1000,
      "dcAmt": 0,
      "ordQty": 1,
      "cnclQty": 1,
      "rtnQty": 1,
      "ordAmt": 1000,
      "deliNo": "1",
      "deliKindCd": "10",
      "deliKindCdNm": "일반배송",
      "shipWaitCaus": "10",
      "shipWaitCausNm": "재고부족",
      "deliTypCd": "01",
      "deliTypCdNm": "일반상품",
      "deliGbCd": "10",
      "deliPolcNo": "10000431",
      "rcvmnNm": "홍길동",
      "zipNo": "05837",
      "zipAddr": "서울 송파구 법원로9길 26",
      "dtlAddr": "비즈니스파크",
      "deliAddr": "서울 송파구 법원로9길 26 비즈니스파크",
      "deliMethodCd": "10",
      "deliMethodCdNm": "택배배송",
      "ordAccpDtm": "2026-01-01T00:00:00.000Z",
      "ordFnshDtm": "2026-01-01T00:00:00.000Z",
      "goodsRevWrtYn": "N",
      "deliFnshDtm": "2026-01-01T00:00:00.000Z",
      "goodsImg": "/url",
      "rtnPsbYn": "N",
      "prstStatCd": "10",
      "claimMgrpCd": "100",
      "claimCauseFaultType": "10",
      "wthdFnshGbCd": "10",
      "exchPsbYn": "N",
      "ordCnclPsbYn": "Y",
      "wthdYn": "Y",
      "ecpnNo": "ORD0001",
      "etcktNo": "ORD0001",
      "saleMethCd": "20",
      "deliIndiRsvDtm": "2026-01-01T00:00:00.000Z",
      "frgnDirPurGoodsYn": "text",
      "taxGbCd": "text"
    }
  ],
  "aeEvtList": [
    {
      "system": "10",
      "dlvpSeq": "1",
      "ordNo": "20230809O007943",
      "ordDtlGbCd": "10",
      "ordDtlGbCdNm": "주문완료",
      "ordGbCd": "10",
      "ordGbCdNm": "일반주문",
      "ordSeq": "1",
      "ordProcSeq": "1",
      "claimNo": "20230725C006642",
      "aeOrdSeq": "1",
      "goodsNo": "10002042",
      "goodsNm": "P직매입20",
      "itmNo": "001",
      "itmNm": "레드>190x190",
      "sngGoodsYn": "Y",
      "goodsTypCd": "10",
      "goodsTypCdNm": "일반상품",
      "brandNo": "100002",
      "brandNm": "멀버리",
      "ordDtlStatCd": "12",
      "ordDtlStatCdNm": "주문완료",
      "prestNm": "증정품",
      "norPrc": 1000,
      "salePrc": 1000,
      "dcAmt": 0,
      "ordQty": 1,
      "cnclQty": 1,
      "rtnQty": 1,
      "ordAmt": 1000,
      "deliNo": "1",
      "deliKindCd": "10",
      "deliKindCdNm": "일반배송",
      "shipWaitCaus": "10",
      "shipWaitCausNm": "재고부족",
      "deliTypCd": "01",
      "deliTypCdNm": "일반상품",
      "deliGbCd": "10",
      "deliPolcNo": "10000431",
      "rcvmnNm": "홍길동",
      "zipNo": "05837",
      "zipAddr": "서울 송파구 법원로9길 26",
      "dtlAddr": "비즈니스파크",
      "deliAddr": "서울 송파구 법원로9길 26 비즈니스파크",
      "deliMethodCd": "10",
      "deliMethodCdNm": "택배배송",
      "ordAccpDtm": "2026-01-01T00:00:00.000Z",
      "ordFnshDtm": "2026-01-01T00:00:00.000Z",
      "goodsRevWrtYn": "N",
      "deliFnshDtm": "2026-01-01T00:00:00.000Z",
      "goodsImg": "/url",
      "rtnPsbYn": "N",
      "prstStatCd": "10",
      "claimMgrpCd": "100",
      "claimCauseFaultType": "10",
      "wthdFnshGbCd": "10",
      "exchPsbYn": "N",
      "ordCnclPsbYn": "Y",
      "wthdYn": "Y",
      "ecpnNo": "ORD0001",
      "etcktNo": "ORD0001",
      "saleMethCd": "20",
      "deliIndiRsvDtm": "2026-01-01T00:00:00.000Z",
      "frgnDirPurGoodsYn": "text",
      "taxGbCd": "text"
    }
  ],
  "dlvpInfo": [
    {
      "dlvpSeq": "1",
      "rcvmnNm": "홍길동",
      "zipNo": "05837",
      "zipAddr": "서울 송파구 법원로9길",
      "dtlAddr": "에이치비지니스파크 D동 6층23",
      "deliAddr": "서울 송파구 법원로9길 에이치비지니스파크 D동 6층23",
      "rcvmnEmailAddr": "test@plateer.com",
      "rcvmnCellSctNo": "010",
      "rcvmnCellTxnoNo": "1234",
      "rcvmnCellEndNo": "5678",
      "deliMsg": "문 앞에 두고 가주세요.",
      "deliMsgCd": "10",
      "deliMsgCdNm": "배송 전 연락바랍니다.",
      "comnFrdrEtcMethod": "자유출입가능",
      "comnFrdrPwd": "1234",
      "comnFrdrCogoMethodCd": "10",
      "persCstmCd": "text",
      "deliNo": "101016693",
      "deliInfoGroupList": [
        {
          "deliNo": "1",
          "prdList": [
            {
              "system": "10",
              "dlvpSeq": "1",
              "ordNo": "20230809O007943",
              "ordDtlGbCd": "10",
              "ordDtlGbCdNm": "주문완료",
              "ordGbCd": "10",
              "ordGbCdNm": "일반주문",
              "ordSeq": "1",
              "ordProcSeq": "1",
              "claimNo": "20230725C006642",
              "aeOrdSeq": "1",
              "goodsNo": "10002042",
              "goodsNm": "P직매입20",
              "itmNo": "001",
              "itmNm": "레드>190x190",
              "sngGoodsYn": "Y",
              "goodsTypCd": "10",
              "goodsTypCdNm": "일반상품",
              "brandNo": "100002",
              "brandNm": "멀버리",
              "ordDtlStatCd": "12",
              "ordDtlStatCdNm": "주문완료",
              "prestNm": "증정품",
              "norPrc": 1000,
              "salePrc": 1000,
              "dcAmt": 0,
              "ordQty": 1,
              "cnclQty": 1,
              "rtnQty": 1,
              "ordAmt": 1000,
              "deliNo": "1",
              "deliKindCd": "10",
              "deliKindCdNm": "일반배송",
              "shipWaitCaus": "10",
              "shipWaitCausNm": "재고부족",
              "deliTypCd": "01",
              "deliTypCdNm": "일반상품",
              "deliGbCd": "10",
              "deliPolcNo": "10000431",
              "rcvmnNm": "홍길동",
              "zipNo": "05837",
              "zipAddr": "서울 송파구 법원로9길 26",
              "dtlAddr": "비즈니스파크",
              "deliAddr": "서울 송파구 법원로9길 26 비즈니스파크",
              "deliMethodCd": "10",
              "deliMethodCdNm": "택배배송",
              "ordAccpDtm": "2026-01-01T00:00:00.000Z",
              "ordFnshDtm": "2026-01-01T00:00:00.000Z",
              "goodsRevWrtYn": "N",
              "deliFnshDtm": "2026-01-01T00:00:00.000Z",
              "goodsImg": "/url",
              "rtnPsbYn": "N",
              "prstStatCd": "10",
              "claimMgrpCd": "100",
              "claimCauseFaultType": "10",
              "wthdFnshGbCd": "10",
              "exchPsbYn": "N",
              "ordCnclPsbYn": "Y",
              "wthdYn": "Y",
              "ecpnNo": "ORD0001",
              "etcktNo": "ORD0001",
              "saleMethCd": "20",
              "deliIndiRsvDtm": "2026-01-01T00:00:00.000Z",
              "frgnDirPurGoodsYn": "text",
              "taxGbCd": "text"
            }
          ],
          "aeEvtList": [
            {
              "system": "10",
              "dlvpSeq": "1",
              "ordNo": "20230809O007943",
              "ordDtlGbCd": "10",
              "ordDtlGbCdNm": "주문완료",
              "ordGbCd": "10",
              "ordGbCdNm": "일반주문",
              "ordSeq": "1",
              "ordProcSeq": "1",
              "claimNo": "20230725C006642",
              "aeOrdSeq": "1",
              "goodsNo": "10002042",
              "goodsNm": "P직매입20",
              "itmNo": "001",
              "itmNm": "레드>190x190",
              "sngGoodsYn": "Y",
              "goodsTypCd": "10",
              "goodsTypCdNm": "일반상품",
              "brandNo": "100002",
              "brandNm": "멀버리",
              "ordDtlStatCd": "12",
              "ordDtlStatCdNm": "주문완료",
              "prestNm": "증정품",
              "norPrc": 1000,
              "salePrc": 1000,
              "dcAmt": 0,
              "ordQty": 1,
              "cnclQty": 1,
              "rtnQty": 1,
              "ordAmt": 1000,
              "deliNo": "1",
              "deliKindCd": "10",
              "deliKindCdNm": "일반배송",
              "shipWaitCaus": "10",
              "shipWaitCausNm": "재고부족",
              "deliTypCd": "01",
              "deliTypCdNm": "일반상품",
              "deliGbCd": "10",
              "deliPolcNo": "10000431",
              "rcvmnNm": "홍길동",
              "zipNo": "05837",
              "zipAddr": "서울 송파구 법원로9길 26",
              "dtlAddr": "비즈니스파크",
              "deliAddr": "서울 송파구 법원로9길 26 비즈니스파크",
              "deliMethodCd": "10",
              "deliMethodCdNm": "택배배송",
              "ordAccpDtm": "2026-01-01T00:00:00.000Z",
              "ordFnshDtm": "2026-01-01T00:00:00.000Z",
              "goodsRevWrtYn": "N",
              "deliFnshDtm": "2026-01-01T00:00:00.000Z",
              "goodsImg": "/url",
              "rtnPsbYn": "N",
              "prstStatCd": "10",
              "claimMgrpCd": "100",
              "claimCauseFaultType": "10",
              "wthdFnshGbCd": "10",
              "exchPsbYn": "N",
              "ordCnclPsbYn": "Y",
              "wthdYn": "Y",
              "ecpnNo": "ORD0001",
              "etcktNo": "ORD0001",
              "saleMethCd": "20",
              "deliIndiRsvDtm": "2026-01-01T00:00:00.000Z",
              "frgnDirPurGoodsYn": "text",
              "taxGbCd": "text"
            }
          ]
        }
      ]
    }
  ],
  "payInfo": [
    {
      "type": "R",
      "ordNo": "20230809O007943",
      "totOrdPrc": 1000,
      "totAplyAdtnAmt": 1000,
      "totDcAmt": 1000,
      "saveMileageAmt": 10,
      "addPayAmt": 1000,
      "totPayAmt": 0,
      "mileagePayAmt": 1000,
      "pgGbCd": "1000",
      "payMethodResponses": [
        {
          "payWayCd": "11",
          "payWayCdNm": "신용카드",
          "payReqCardcoCd": "201",
          "payReqCardcoCdNm": "현대카드",
          "acqrCd": "201",
          "acqrCdNm": "현대카드",
          "bankCd": "10",
          "bankCdNm": "우리은행",
          "actnNo": "계좌번호 암호화",
          "dpmnNm": "김플래티어",
          "dptFcstDt": "20990101",
          "dlvMonCnt": 6,
          "nintDivYn": "Y",
          "payAmt": 1000
        }
      ],
      "accumulatedMileageResponses": [
        {
          "type": "FRS",
          "adtnDtlGbCd": "41",
          "adtnDtlGbCdNm": "기본적립",
          "aplyAdtnAmt": 1000
        }
      ]
    }
  ]
}

클레임 처리가능 버튼 조회 (BO)

post

기능 설명

[BO 전용] BO 주문클레임 처리 주문상품내역의 노출해야 할 버튼 목록만을 조회합니다.

상세 설명

BO에서 하나의 주문에 해당하는 주문상품 목록 조회 후 파라미터로 전달해 줍니다.
BO 시스템 클레임처리 가능상태(ST008) 그룹코드의 주문내역상태코드(ref_1_val)과 주문내역구분코드(ref_2_val)에 해당하는 각 코드를 조회 후 화면단에서 버튼을 노출합니다.

수정 번호

Release v2.00_240729 : 취소 가능 여부(ordCnclPsbYn), 회수여부(wthdYn), e쿠폰번호(ecpnNo), e티켓번호(etcktNo) 추가 / 상품 유형별 버튼 필터링 추가

Header parameters

AuthorizationanyOptional

Access Token

Bodyobject · OrderDetailGoodsInfoResponse[]

주문 상품 정보 목록 DTO

systemstring · enumOptional

SYSTEM(시스템유형) * 10 : FO * 20 : BO

Example: 10Possible values:

dlvpSeqstringOptional

배송순번

Example: 1

ordNostringOptional

주문번호

Example: 20230809O007943

ordDtlGbCdstringOptional

주문내역구분코드(OM003)

Example: 10

ordDtlGbCdNmstringOptional

주문내역구분코드명

Example: 주문완료

ordGbCdstringOptional

주문구분코드(OM002)

Example: 10

ordGbCdNmstringOptional

주문구분코드명

Example: 일반주문

ordSeqstringOptional

주문순번

Example: 1

ordProcSeqstringOptional

주문처리순번

Example: 1

claimNostringOptional

클레임번호

Example: 20230725C006642

aeOrdSeqstringOptional

본품주문순번

Example: 1

goodsNostringOptional

상품번호

Example: 10002042

goodsNmstringOptional

상품명

Example: P직매입20

itmNostringOptional

단품번호

Example: 001

itmNmstringOptional

단품명

Example: 레드>190x190

sngGoodsYnstringOptional

단일상품여부

Example: Y

goodsTypCdstringOptional

상품유형코드(PR002)

Example: 10

goodsTypCdNmstringOptional

상품유형코드명

Example: 일반상품

brandNostringOptional

브랜드번호

Example: 100002

brandNmstringOptional

브랜드명

Example: 멀버리

ordDtlStatCdstringOptional

주문내역상세구분코드(OM005)

Example: 12

ordDtlStatCdNmstringOptional

주문내역상세구분코드명

Example: 주문완료

prestNmstringOptional

증정품명

Example: 증정품

norPrcinteger · int32Optional

정상가

Example: 1000

salePrcinteger · int32Optional

판매가

Example: 1000

dcAmtinteger · int32Optional

할인금액

Example: 0

ordQtyinteger · int32Optional

주문수량

Example: 1

cnclQtyinteger · int32Optional

취소수량

Example: 1

rtnQtyinteger · int32Optional

반품수량

Example: 1

ordAmtinteger · int32Optional

주문금액

Example: 1000

deliNostringOptional

배송번호

Example: 1

deliKindCdstringOptional

배송종류코드(LO009)

Example: 10

deliKindCdNmstringOptional

배송종류코드명

Example: 일반배송

shipWaitCausstringOptional

출고대기사유코드(LO007)

Example: 10

shipWaitCausNmstringOptional

출고대기사유코드명

Example: 재고부족

deliTypCdstringOptional

배송상품구분코드(PR010)

Example: 01

deliTypCdNmstringOptional

배송상품구분코드명

Example: 일반상품

deliGbCdstringOptional

배송구분코드(LO001)

Example: 10

deliPolcNostringOptional

배송정책번호

Example: 10000431

rcvmnNmstringOptional

수취인명

Example: 홍길동

zipNostringOptional

우편번호

Example: 05837

zipAddrstringOptional

우편주소

Example: 서울 송파구 법원로9길 26

dtlAddrstringOptional

상세주소

Example: 비즈니스파크

deliAddrstringOptional

배송지

Example: 서울 송파구 법원로9길 26 비즈니스파크

deliMethodCdstringOptional

배송방법코드(LO010)

Example: 10

deliMethodCdNmstringOptional

배송방법코드명

Example: 택배배송

ordAccpDtmstring · date-timeOptional

주문접수일

ordFnshDtmstring · date-timeOptional

주문완료일

goodsRevWrtYnstringOptional

상품리뷰작성여부

Example: N

deliFnshDtmstring · date-timeOptional

배송완료일시

goodsImgstringOptional

상품이미지

Example: /url

rtnPsbYnstringOptional

반품가능여부

Example: N

prstStatCdstringOptional

선물상태코드(OM044)

Example: 10

claimMgrpCdstringOptional

클레임중분류코드(OM006)

Example: 100

claimCauseFaultTypestringOptional

클레임귀책유형(10: 고객귀책 / 20: 당사귀책)

Example: 10

wthdFnshGbCdstringOptional

회수완료구분코드(LO011)

Example: 10

exchPsbYnstringOptional

교환가능여부

Example: N

ordCnclPsbYnstringOptional

취소가능여부

Example: Y

wthdYnstringOptional

회수여부

Example: Y

ecpnNostringOptional

e쿠폰번호

Example: ORD0001

etcktNostringOptional

e티켓번호

Example: ORD0001

saleMethCdstringOptional

판매방식코드(PR003)

Example: 20

deliIndiRsvDtmstring · date-timeOptional

배송지시예약일시

frgnDirPurGoodsYnstringOptional

해외직구상품여부

taxGbCdstringOptional

과면세구분코드(PR007)

Responses

200

성공

*/*

string[]Optional

900

업무처리 오류 내용

*/*

post/v1/mypage/order/getAvailableBOButtonList

POST /api/order/v1/mypage/order/getAvailableBOButtonList HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 1456

[
  {
    "system": "10",
    "dlvpSeq": "1",
    "ordNo": "20230809O007943",
    "ordDtlGbCd": "10",
    "ordDtlGbCdNm": "주문완료",
    "ordGbCd": "10",
    "ordGbCdNm": "일반주문",
    "ordSeq": "1",
    "ordProcSeq": "1",
    "claimNo": "20230725C006642",
    "aeOrdSeq": "1",
    "goodsNo": "10002042",
    "goodsNm": "P직매입20",
    "itmNo": "001",
    "itmNm": "레드>190x190",
    "sngGoodsYn": "Y",
    "goodsTypCd": "10",
    "goodsTypCdNm": "일반상품",
    "brandNo": "100002",
    "brandNm": "멀버리",
    "ordDtlStatCd": "12",
    "ordDtlStatCdNm": "주문완료",
    "prestNm": "증정품",
    "norPrc": 1000,
    "salePrc": 1000,
    "dcAmt": 0,
    "ordQty": 1,
    "cnclQty": 1,
    "rtnQty": 1,
    "ordAmt": 1000,
    "deliNo": "1",
    "deliKindCd": "10",
    "deliKindCdNm": "일반배송",
    "shipWaitCaus": "10",
    "shipWaitCausNm": "재고부족",
    "deliTypCd": "01",
    "deliTypCdNm": "일반상품",
    "deliGbCd": "10",
    "deliPolcNo": "10000431",
    "rcvmnNm": "홍길동",
    "zipNo": "05837",
    "zipAddr": "서울 송파구 법원로9길 26",
    "dtlAddr": "비즈니스파크",
    "deliAddr": "서울 송파구 법원로9길 26 비즈니스파크",
    "deliMethodCd": "10",
    "deliMethodCdNm": "택배배송",
    "ordAccpDtm": "2026-01-01T00:00:00.000Z",
    "ordFnshDtm": "2026-01-01T00:00:00.000Z",
    "goodsRevWrtYn": "N",
    "deliFnshDtm": "2026-01-01T00:00:00.000Z",
    "goodsImg": "/url",
    "rtnPsbYn": "N",
    "prstStatCd": "10",
    "claimMgrpCd": "100",
    "claimCauseFaultType": "10",
    "wthdFnshGbCd": "10",
    "exchPsbYn": "N",
    "ordCnclPsbYn": "Y",
    "wthdYn": "Y",
    "ecpnNo": "ORD0001",
    "etcktNo": "ORD0001",
    "saleMethCd": "20",
    "deliIndiRsvDtm": "2026-01-01T00:00:00.000Z",
    "frgnDirPurGoodsYn": "text",
    "taxGbCd": "text"
  }
]

[
  "text"
]

이전주문서

다음회원제공

마지막 업데이트 2개월 전