# 주문취소

## 선물하기 주문 취소(BATCH)

> \## 기능설명\
> \* 주문취소를 진행합니다.\
> \---\
> \## 상세설명\
> \* 주문취소 처리 API 호출 시점의 주문 상태를 확인, 접수 가능 여부를 확인합니다.\
> \* 주문취소 요청 데이터의 유효성 검증은 다음의 항목에 대해 진행합니다.\
>     \* 접수 상품 배송번호 일치 여부 체크(-> \*클레임 불가\*)\
>     \* 접수 상품 사은품 유무 체크(-> \*부분 수량 클레임 불가\*)\
>     \* 부분취소불가 결제수단 사용 여부 체크(-> \*부분 클레임 불가\*)\
>     \* 추가결제금액이 여부 체크(-> \*BO에서 클레임 불가\*)\
> \* 주문 취소 데이터 생성 및 업데이트합니다.\
> \* 주문 취소 시 발생하는 환불/결제 금액에 대해 검증을 수행합니다.\
> \* 복원 쿠폰이 있을 경우 쿠폰 복원이 일어납니다.\
> \* 주문 취소 상품에 대한 재고 복원이 일어납니다.\
> \* 환불/결제 처리됩니다.\
> \* 주문 취소 고객에게 알림을 발송합니다.(이메일/알림톡/알림함)<br>

```json
{"openapi":"3.0.1","info":{"title":"X2BEE Order API","version":"v1"},"servers":[{"url":"https://api-order.x2bee.com/api/order/","description":"prd"}],"paths":{"/v1/claim/orderCancel/giftOrderCancelBatch":{"post":{"tags":["주문취소"],"summary":"선물하기 주문 취소(BATCH)","description":"## 기능설명\n* 주문취소를 진행합니다.\n---\n## 상세설명\n* 주문취소 처리 API 호출 시점의 주문 상태를 확인, 접수 가능 여부를 확인합니다.\n* 주문취소 요청 데이터의 유효성 검증은 다음의 항목에 대해 진행합니다.\n    * 접수 상품 배송번호 일치 여부 체크(-> *클레임 불가*)\n    * 접수 상품 사은품 유무 체크(-> *부분 수량 클레임 불가*)\n    * 부분취소불가 결제수단 사용 여부 체크(-> *부분 클레임 불가*)\n    * 추가결제금액이 여부 체크(-> *BO에서 클레임 불가*)\n* 주문 취소 데이터 생성 및 업데이트합니다.\n* 주문 취소 시 발생하는 환불/결제 금액에 대해 검증을 수행합니다.\n* 복원 쿠폰이 있을 경우 쿠폰 복원이 일어납니다.\n* 주문 취소 상품에 대한 재고 복원이 일어납니다.\n* 환불/결제 처리됩니다.\n* 주문 취소 고객에게 알림을 발송합니다.(이메일/알림톡/알림함)\n","operationId":"giftOrderCancelBatch","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ClaimRequest"}}}},"required":true},"responses":{"200":{"description":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"ClaimRequest":{"required":["claimBusinessType","claimDlvp","claimGoodsList","claimNo","claimReturnDlvp","ordMediaCd","ordNo","systemType","wthdFnshWaitProcCaus"],"type":"object","properties":{"systemType":{"type":"string","description":"        SYSTEM(시스템유형)\n        * 10 : FO\n        * 20 : BO\n","enum":["FO","BO"]},"claimBusinessType":{"type":"string","description":"        ClaimBusiness(클레임업무유형)\n        * 11 : 주문취소\n        * 20 : 반품접수\n        * 21 : 반품취소\n        * 30 : 교환접수\n        * 31 : 교환취소\n        * 22 : 반품완료\n        * 23 : 반품불가\n        * 24 : 교환반품\n        * 25 : 반품보류\n","enum":["ORDER_CANCEL","RETURN_ACCEPT","RETURN_WITHDRAWAL","EXCHANGE_ACCEPT","EXCHANGE_WITHDRAWAL","RETURN_COMPLETE","RETURN_REJECT","RETURN_TRANSFORM","RETURN_PENDING","DELIVERY_FEE_PAYMENT"]},"ordMediaCd":{"type":"string","description":"주문매체 코드(OM007)\n 10 : 전화상담(CC)\n, 20 : PC\n, 30 : 모바일웹\n, 40 : 안드로이드앱\n, 50 : IOS앱\n, 60 : 정기주문\n","enum":["10","20","30","40","50","60"]},"ordNo":{"type":"string","description":"주문번호"},"mbrNo":{"type":"string","description":"회원번호"},"claimNo":{"type":"string","description":"클레임번호"},"claimGoodsList":{"type":"array","description":"클레임 대상 상품정보 리스트","items":{"$ref":"#/components/schemas/ClaimGoodsRequest"}},"paymentRequest":{"$ref":"#/components/schemas/PaymentRequestPaymentInfo"},"claimCpnInfoList":{"type":"array","description":"쿠폰 리스트","items":{"$ref":"#/components/schemas/ClaimCpnInfo"}},"claimReturnDlvp":{"$ref":"#/components/schemas/ClaimDlvp"},"claimDlvp":{"$ref":"#/components/schemas/ClaimDlvp"},"claimFinalAmtInfo":{"$ref":"#/components/schemas/ClaimFinalAmtInfo"},"wthdFnshWaitProcCaus":{"type":"string","description":"회수완료 대기처리 사유"},"occurPayment":{"type":"boolean"},"existAddtionPayAmt":{"type":"boolean"},"claimBusiness":{"type":"string","description":"        ClaimBusiness(클레임업무유형)\n        * 11 : 주문취소\n        * 20 : 반품접수\n        * 21 : 반품취소\n        * 30 : 교환접수\n        * 31 : 교환취소\n        * 22 : 반품완료\n        * 23 : 반품불가\n        * 24 : 교환반품\n        * 25 : 반품보류\n","enum":["ORDER_CANCEL","RETURN_ACCEPT","RETURN_WITHDRAWAL","EXCHANGE_ACCEPT","EXCHANGE_WITHDRAWAL","RETURN_COMPLETE","RETURN_REJECT","RETURN_TRANSFORM","RETURN_PENDING","DELIVERY_FEE_PAYMENT"]}},"description":"클레임 처리 요청 DTO"},"ClaimGoodsRequest":{"required":["claimLgrpCd","claimMgrpCd","claimQty","exchangeGoodsNo","exchangeItmNm","exchangeItmNo"],"type":"object","properties":{"ordSeq":{"type":"integer","description":"주문순번","format":"int32"},"ordProcSeq":{"type":"integer","description":"주문처리순번","format":"int32"},"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"exchangeGoodsNo":{"type":"string","description":"교환 상품 번호"},"exchangeItmNo":{"type":"string","description":"교환 단품 번호"},"exchangeItmNm":{"type":"string","description":"교환 단품명"},"claimQty":{"type":"integer","description":"클레임 수량","format":"int32"},"claimLgrpCd":{"type":"string","description":"OM047(클레임대분류코드)\n 10: 단순변심\n , 20: 상품불량\n , 30: 배송불만\n , 40: 상품정보오류\n , 50: 재결제주문\n","enum":["SIMPLE_CHANGE","GOODS_BAD","DELIVERY_CLAIM","GOODS_INFOMATION_ERROR","REPAYMENT_ORDER"]},"claimMgrpCd":{"type":"string","description":"OM006(클레임중분류코드)\n 100: 배송이 늦어짐\n , 101: 상품이 품절됨\n , 102: 옵션/사이즈 변경/취소\n , 103: 다른 곳보다 비쌈\n , 104: 쿠폰/할인혜택 변경\n , 105: 구매의사 없어짐\n , 106: 사은품 변경/취소\n , 107: 결제수단 변경(구매사은 적용/카드변경 등)\n , 108: 유사상품 구매\n , 109: 상품정보 미흡\n , 110: 판매자 취소(판매자)\n , 111: 직권 취소(상담사)\n , 112: 자동 취소(결제부족)\n , 113: 자동 취소(결품취소)\n , 300: 사이즈가 큼\n , 301: 사이즈가 작음\n , 302: 단순변심 색상변경\n , 303: 오염\n , 304: 파손(울트임 등)\n , 305: 구성품 누락(목걸이, 벨트 등)\n , 306: 내용물 불량(화장품 등)\n , 307: 상품 오배송\n , 308: 기타\n , 200: 다른상품 주문\n , 201: 사이즈가 큼\n , 203: 사이즈가 작음\n , 204: 상품이미지 상이(컬러, 디자인, 핏)\n , 205: 구매의사가 사라짐\n , 206: 색상 또는 사이즈 교환기능이 없어서\n , 207: 기타\n , 208: 오염\n , 209: 파손(울트임 등)\n , 210: 구성품 누락(목걸이, 벨트 등)\n , 211: 내용물 불량(화장품 등)\n , 212: 기타\n , 213: 사이즈 오배송\n , 214: 컬러 오배송\n , 215: 상품 오배송\n , 216: 배송지연\n , 217: 기타\n , 218: 실측 사이즈 오류\n , 219: 소재 오류\n , 220: 색상 오류\n , 221: 상품 설명과 다름(오표기)\n , 222: 기타\n , 223: 반품보류\n , 224: 반품불가\n","enum":["CLAIM_MGRP_CD_100","CLAIM_MGRP_CD_101","CLAIM_MGRP_CD_102","CLAIM_MGRP_CD_103","CLAIM_MGRP_CD_104","CLAIM_MGRP_CD_105","CLAIM_MGRP_CD_106","CLAIM_MGRP_CD_107","CLAIM_MGRP_CD_108","CLAIM_MGRP_CD_109","CLAIM_MGRP_CD_110","CLAIM_MGRP_CD_111","CLAIM_MGRP_CD_112","CLAIM_MGRP_CD_113","CLAIM_MGRP_CD_114","CLAIM_MGRP_CD_300","CLAIM_MGRP_CD_301","CLAIM_MGRP_CD_302","CLAIM_MGRP_CD_303","CLAIM_MGRP_CD_304","CLAIM_MGRP_CD_305","CLAIM_MGRP_CD_306","CLAIM_MGRP_CD_307","CLAIM_MGRP_CD_308","CLAIM_MGRP_CD_200","CLAIM_MGRP_CD_201","CLAIM_MGRP_CD_203","CLAIM_MGRP_CD_204","CLAIM_MGRP_CD_205","CLAIM_MGRP_CD_206","CLAIM_MGRP_CD_207","CLAIM_MGRP_CD_208","CLAIM_MGRP_CD_209","CLAIM_MGRP_CD_210","CLAIM_MGRP_CD_211","CLAIM_MGRP_CD_212","CLAIM_MGRP_CD_213","CLAIM_MGRP_CD_214","CLAIM_MGRP_CD_215","CLAIM_MGRP_CD_216","CLAIM_MGRP_CD_217","CLAIM_MGRP_CD_218","CLAIM_MGRP_CD_219","CLAIM_MGRP_CD_220","CLAIM_MGRP_CD_221","CLAIM_MGRP_CD_222","CLAIM_MGRP_CD_223","CLAIM_MGRP_CD_224"]},"claimCausEtcCont":{"type":"string","description":"클레임사유기타내용"},"withdrawalDeliNo":{"type":"string","description":"회수 배송번호"},"shipmentDeliNo":{"type":"string","description":"출하 배송번호"},"prOrdDtlAtchFileInfoList":{"type":"array","description":"첨부이미지목록","items":{"$ref":"#/components/schemas/PrOrdDtlAtchFileInfo"}},"ordSeqAndOrdProcSeq":{"type":"string"}},"description":"클레임 요청 상품 정보 DTO"},"PrOrdDtlAtchFileInfo":{"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"ordSeq":{"type":"integer","description":"주문순번","format":"int32"},"ordProcSeq":{"type":"integer","description":"주문처리순번","format":"int32"},"fileSeq":{"type":"string","description":"파일순번"},"filePathNm":{"type":"string","description":"파일경로"},"fileNm":{"type":"string","description":"파일명"}},"description":"주문상세첨부파일정보 DTO"},"PaymentRequestPaymentInfo":{"type":"object","properties":{"siteNo":{"type":"string","description":"사이트 번호"},"orderInfo":{"$ref":"#/components/schemas/PaymentOrderInfo"},"payInfoList":{"type":"array","description":"결제를 요청하는 주문/클레임 DTO","items":{"$ref":"#/components/schemas/PaymentInfo"}}},"description":"결제 및 결제 취소 DTO","nullable":true},"PaymentOrderInfo":{"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"claimNo":{"type":"string","description":"클레임번호"},"goodsNm":{"type":"string","description":"상품명"},"ordManNm":{"type":"string","description":"주문자명"},"ordmnCellNo":{"type":"string","description":"주문자휴대폰번호"},"ordmnEmailAddr":{"type":"string","description":"주문자이메일주소"},"crcUnitCd":{"type":"string","description":"통화단위코드"},"ordMediaCd":{"type":"string","description":"주문매체코드(OM007)"},"mbrNo":{"type":"string","description":"회원번호"},"ordDtlGbCd":{"type":"string","description":"주문내역상세구분코드(OM003)"},"clientIp":{"type":"string","description":"클라이언트IP"},"taxFreeAmt":{"type":"integer","description":"면세 금액","format":"int64"}},"description":"결제에 필요한 주문 DTO"},"PaymentInfo":{"type":"object","properties":{"payNo":{"type":"string","description":"결제번호"},"payWayCd":{"type":"string","description":"결제수단코드(OM013)"},"payAmt":{"type":"integer","description":"결제금액","format":"int64"},"mersNo":{"type":"string","description":"가맹점번호"},"pgGbCd":{"type":"string","description":"PG구분코드(OM030)"},"trdNo":{"type":"string","description":"거래번호(tid)"},"selectCardCd":{"type":"string","description":"결제요청카드사코드(OM057)"},"termlId":{"type":"string","description":"터미널ID(mid)"},"billKey":{"type":"string","description":"승인요청할 빌링키 값"},"authResultMap":{"type":"object","additionalProperties":{"type":"string","description":"인증결과정보"},"description":"인증결과정보"}},"description":"결제 DTO"},"ClaimCpnInfo":{"type":"object","properties":{"cpnNo":{"type":"string","description":"쿠폰발급번호"}},"description":"클레임 쿠폰 정보 DTO"},"ClaimDlvp":{"required":["dlvpNm","dtlAddr","rcvmnNm","zipAddr","zipNo"],"type":"object","properties":{"mbrOrdDlvpGb":{"type":"string","description":"        ClaimDlvpGbCd(클레임배송지유형)\n        * 10 : 회원배송지\n        * 20 : 주문배송지\n","enum":["MBR","ORD"]},"dlvpSeq":{"type":"string","description":"배송지순번"},"zipNoSeq":{"type":"integer","description":"우편번호 순번","format":"int64"},"dlvpNm":{"type":"string","description":"배송지명"},"rcvmnNm":{"type":"string","description":"수취인명"},"zipNo":{"type":"string","description":"우편번호"},"zipAddr":{"type":"string","description":"우편주소"},"dtlAddr":{"type":"string","description":"상세주소"},"rcvmnEmailAddr":{"type":"string","description":"수취인이메일주소"},"rcvmnCellSctNo":{"type":"string","description":"수취인휴대폰구분번호"},"rcvmnCellTxnoNo":{"type":"string","description":"수취인휴대폰국번번호"},"rcvmnCellEndNo":{"type":"string","description":"수취인휴대폰국번번호"},"rcvmnTelRgnNo":{"type":"string","description":"수취인전화지역번호"},"rcvmnTelTxnoNo":{"type":"string","description":"수취인전화국번번호"},"rcvmnTelEndNo":{"type":"string","description":"수취인전화끝번호"},"deliMsg":{"type":"string","description":"배송메시지"},"deliMsgCd":{"type":"string","description":"배송메시지코드(ME039) 20:배송 전 연락 바랍니다, 30:부재 시 문 앞에 놓아주세요, 40:부재 시 경비실에 맡겨주세요, 50:빠른 배송 부탁 드립니다, 60:부재 시 핸드폰으로 연락바랍니다, 70:직접입력"},"shopTrafMsg":{"type":"string","description":"매장전달메시지"},"comnFrdrCogoMethodCd":{"type":"string","description":"공동현관출입방법코드(ME040) 10:공동현관 출입번호, 20:자유 출입 가능, 30:기타","default":"20"},"comnFrdrEtcMethod":{"type":"string","description":"공동현관기타방법"},"comnFrdrPwd":{"type":"string","description":"공동현관비밀번호"}},"description":"클레임 배송 정보 DTO"},"ClaimFinalAmtInfo":{"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"totAplyAdtnAmt":{"type":"integer","description":"총발생배송비금액","format":"int64"},"totCnclAdtnAmt":{"type":"integer","description":"총취소배송비금액","format":"int64"},"totFvrAdtnAmt":{"type":"integer","description":"총혜택배송비금액","format":"int64"},"totOrdPrc":{"type":"integer","description":"클레임상품금액","format":"int64"},"totDcAmt":{"type":"integer","description":"클레임취소할인금액","format":"int64"},"expectedRefundAmt":{"type":"integer","description":"환불예정금액","format":"int64"},"addtionPayAmt":{"type":"integer","description":"추가결제금액","format":"int64"},"returnAcceptAmt":{"type":"integer","description":"반품접수금액","format":"int64"},"refundAdditionAmtInfoList":{"type":"array","description":"추가결제/환불정보 리스트","items":{"$ref":"#/components/schemas/RefundAdditionAmtInfo"}},"refundPaymentMethodList":{"type":"array","description":"환불결제정보 리스트","items":{"$ref":"#/components/schemas/PaymentClaimResponse"}},"paymentOrderInfo":{"$ref":"#/components/schemas/PaymentOrderInfo"},"rfdInfoResponse":{"$ref":"#/components/schemas/RfdInfoResponse"}},"description":"클레임 최종 결제/환불금액 정보 DTO"},"RefundAdditionAmtInfo":{"type":"object","properties":{"adtnOcurGbCd":{"type":"string","description":"OM017(부가비용발생구분코드)\n 10: 발생\n , 20: 취소\n","enum":["OCCURRNECE","CANCEL"]},"adtnOcurGbNm":{"type":"string","description":"부가비용발생구분명"},"type":{"type":"string","description":"        ClaimAmountType(클레임부가비용유형)\n        * 10 : 배송비\n        * 20 : 회수배송비\n        * 30 : 교환배송비\n        * 40 : 상품\n        * 50 : 추가배송비\n        * 60 : 사은품\n","enum":["DELIVERY_FEE","RETURN_FEE","EXCHANGE_FEE","GOODS","EXTRA_FEE","GIFTS"]},"typeNm":{"type":"string","description":"유형구분명"},"goodsNoItmNo":{"type":"string","description":"상품번호+단품번호"},"goodsNm":{"type":"string","description":"상품명"},"ordAmt":{"type":"integer","description":"결제금액","format":"int64"},"discountMethod":{"type":"string","description":"OM019(부가비용상세구분코드)\n 11: 상품할인쿠폰\n , 12: 장바구니쿠폰\n , 13: 중복할인쿠폰\n , 14: 무료배송쿠폰\n , 15: 무료반품쿠폰\n , 20: 임직원할인\n , 21: 상품즉시할인\n , 51: 상품사은품\n , 40: 프로모션적립\n , 41: 기본적립\n , 42: 회원등급추가적립\n","enum":["GOODS_DISCOUNT","SHOPPING_BASKET","REDUNDANT_DISCOUNT","FREE_DELIVERY","FREE_RETURN","EXECUTIVES","GOODS_DIRECT","GOODS_GIFTS","MILEAGE","BASIC_ACCUMULATION","MBR_GRADE_ACCUMULATION"]},"discountMethodNm":{"type":"string","description":"혜택상세정보명"},"cnclDcAmt":{"type":"integer","description":"취소혜택금액","format":"int64"},"rtnDlvBenefitInfoList":{"type":"array","description":"반품쿠폰정보 리스트","items":{"$ref":"#/components/schemas/ClaimDlvBenefitInfo"}},"reCalAdtnOcurGbCdAdtnAmt":{"type":"integer","format":"int64"}},"description":"추가결제/환불정보 DTO"},"ClaimDlvBenefitInfo":{"type":"object","properties":{"promoNo":{"type":"string","description":"쿠폰번호"},"promoNm":{"type":"string","description":"쿠폰명"},"promoTypCd":{"type":"string","description":"프로모션 유형 코드(MK002)\n 11 : 상품할인쿠폰\n , 12 : 장바구니쿠폰\n , 13 : 중복할인쿠폰\n , 14 : 무료배송쿠폰\n , 15 : 무료반품쿠폰\n , 20 : 임직원할인\n , 21 : 상품즉시할인\n , 40 : 상품마일리지\n","enum":["11","12","13","14","15","20","21","40"]},"ourChrgRate":{"type":"integer","description":"당사분담율","format":"int32"},"entrChrgRate":{"type":"integer","description":"협력사분담율","format":"int32"},"cpnIsuNo":{"type":"string","description":"쿠폰발급번호"},"aplyYn":{"type":"string","description":"적용여부","enum":["Y","N"]}},"description":"반품쿠폰정보 리스트"},"PaymentClaimResponse":{"type":"object","properties":{"payNo":{"type":"string","description":"결제번호"},"mbrNo":{"type":"string","description":"회원번호"},"ordNo":{"type":"string","description":"주문번호"},"claimNo":{"type":"string","description":"클레임번호"},"uprPayNo":{"type":"string","description":"상위결제번호"},"payGbCd":{"type":"string","description":"결제구분코드(OM012)"},"payGbCdNm":{"type":"string","description":"결제구분코드명(OM012)"},"payWayCd":{"type":"string","description":"결제수단코드(OM013)"},"payWayCdNm":{"type":"string","description":"결제수단코드명(OM013)"},"payStatCd":{"type":"string","description":"결제상태코드(OM014)"},"payStatCdNm":{"type":"string","description":"결제상태코드명(OM014)"},"payAmt":{"type":"integer","description":"결제금액","format":"int64"},"taxFreeAmt":{"type":"integer","description":"면세가","format":"int64"},"rfdPsbAmt":{"type":"integer","description":"환불가능금액","format":"int64"},"rfdAmt":{"type":"integer","description":"환불금액","format":"int64"},"payFnshDtm":{"type":"string","description":"결제완료일시","format":"date-time"},"trdNo":{"type":"string","description":"거래번호(tid)"},"trdDtm":{"type":"string","description":"거래일시","format":"date-time"},"iscmCd":{"type":"string","description":"발급사코드(OM027)"},"iscmCdNm":{"type":"string","description":"발급사코드명(OM027)"},"payReqCardcoCd":{"type":"string","description":"결제요청카드사코드(OM057)"},"payReqCardcoCdNm":{"type":"string","description":"결제요청카드사코드명(OM057)"},"cardNo":{"type":"string","description":"카드번호"},"cardNm":{"type":"string","description":"카드명"},"cardValiTerm":{"type":"string","description":"카드유효기간"},"nintDivYn":{"type":"string","description":"무이자할부여부"},"divMonCnt":{"type":"integer","description":"할부개월수","format":"int32"},"cardPointUseYn":{"type":"string","description":"카드포인트사용여부"},"mersNo":{"type":"string","description":"가맹점번호"},"acqrCd":{"type":"string","description":"매입사코드(OM028)"},"acqrCdNm":{"type":"string","description":"매입사코드명(OM028)"},"aprvNo":{"type":"string","description":"승인번호"},"aprvDtm":{"type":"string","description":"승인일시","format":"date-time"},"sctnCnclPsbYn":{"type":"string","description":"부분취소가능여부"},"bankCd":{"type":"string","description":"은행코드(OM026)"},"bankCdNm":{"type":"string","description":"은행코드명(OM026)"},"actnNo":{"type":"string","description":"계좌번호"},"dpmnNm":{"type":"string","description":"입금자명"},"dptFcstDt":{"type":"string","description":"입금예정일자"},"dptCnfmDtm":{"type":"string","description":"입금확인일시","format":"date-time"},"rfdBankCd":{"type":"string","description":"환불은행코드(OM026)"},"rfdBankCdNm":{"type":"string","description":"환불은행코드명(OM026)"},"rfdActnNo":{"type":"string","description":"환불계좌번호"},"rfdActnDepositorNm":{"type":"string","description":"환불계좌 예금주명"},"vbankPaymentPending":{"type":"boolean"},"vbankDptCnfm":{"type":"boolean"}},"description":"환불가능한 결제수단 DTO"},"RfdInfoResponse":{"type":"object","properties":{"rfdBankCd":{"type":"string","description":"은행코드 (OM026)"},"rfdBankNm":{"type":"string","description":"은행명"},"rfdActnNo":{"type":"string","description":"환불계좌번호"},"rfdActnDepositorNm":{"type":"string","description":"환불 계좌 예금주명"},"rfdActnCertiYn":{"type":"string","description":"환불 계좌 인증여부"}},"description":"환불 계좌정보 조회 Response"},"Response":{"type":"object","properties":{"timestamp":{"type":"string","description":"result time","format":"date-time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","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"}},"description":"validation error list"}}}}
```

## 입금기한 초과 가상계좌 주문 취소(BATCH)

> \## 기능설명\
> \* 입금기한 초과한 가상계좌 주문을 자동 취소 처리합니다.\
> \---\
> \## 상세설명\
> \* 입금기한 초과 가상계좌 주문에 대해 배치로 취소 처리를 진행합니다.\
> \* 주문취소 처리 API 호출 시점의 주문 상태를 확인, 접수 가능 여부를 확인합니다.\
> \* 주문취소 요청 데이터의 유효성 검증은 다음의 항목에 대해 진행합니다.\
> &#x20;   \* 접수 상품 사은품 유무 체크(-> \*부분 수량 클레임 불가\*)\
> &#x20;   \* 부분취소불가 결제수단 사용 여부 체크(-> \*부분 클레임 불가\*)\
> \* 주문 취소 데이터 생성 및 업데이트합니다.\
> \* 주문 취소 시 발생하는 환불/결제 금액에 대해 검증을 수행합니다.\
> \* 복원 쿠폰이 있을 경우 쿠폰 복원이 일어납니다.\
> \* 주문 취소 상품에 대한 재고 복원이 일어납니다.\
> \* 환불/결제 처리됩니다.\
> \* 주문 취소 고객에게 알림을 발송합니다.(이메일/알림톡/알림함)<br>

```json
{"openapi":"3.0.1","info":{"title":"X2BEE Order API","version":"v1"},"servers":[{"url":"https://api-order.x2bee.com/api/order/","description":"prd"}],"paths":{"/v1/claim/orderCancel/dptExpiredCancelBatch":{"post":{"tags":["주문취소"],"summary":"입금기한 초과 가상계좌 주문 취소(BATCH)","description":"## 기능설명\n* 입금기한 초과한 가상계좌 주문을 자동 취소 처리합니다.\n---\n## 상세설명\n* 입금기한 초과 가상계좌 주문에 대해 배치로 취소 처리를 진행합니다.\n* 주문취소 처리 API 호출 시점의 주문 상태를 확인, 접수 가능 여부를 확인합니다.\n* 주문취소 요청 데이터의 유효성 검증은 다음의 항목에 대해 진행합니다.\n    * 접수 상품 사은품 유무 체크(-> *부분 수량 클레임 불가*)\n    * 부분취소불가 결제수단 사용 여부 체크(-> *부분 클레임 불가*)\n* 주문 취소 데이터 생성 및 업데이트합니다.\n* 주문 취소 시 발생하는 환불/결제 금액에 대해 검증을 수행합니다.\n* 복원 쿠폰이 있을 경우 쿠폰 복원이 일어납니다.\n* 주문 취소 상품에 대한 재고 복원이 일어납니다.\n* 환불/결제 처리됩니다.\n* 주문 취소 고객에게 알림을 발송합니다.(이메일/알림톡/알림함)\n","operationId":"dptExpiredCancelBatch","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ClaimRequest"}}}},"required":true},"responses":{"200":{"description":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"ClaimRequest":{"required":["claimBusinessType","claimDlvp","claimGoodsList","claimNo","claimReturnDlvp","ordMediaCd","ordNo","systemType","wthdFnshWaitProcCaus"],"type":"object","properties":{"systemType":{"type":"string","description":"        SYSTEM(시스템유형)\n        * 10 : FO\n        * 20 : BO\n","enum":["FO","BO"]},"claimBusinessType":{"type":"string","description":"        ClaimBusiness(클레임업무유형)\n        * 11 : 주문취소\n        * 20 : 반품접수\n        * 21 : 반품취소\n        * 30 : 교환접수\n        * 31 : 교환취소\n        * 22 : 반품완료\n        * 23 : 반품불가\n        * 24 : 교환반품\n        * 25 : 반품보류\n","enum":["ORDER_CANCEL","RETURN_ACCEPT","RETURN_WITHDRAWAL","EXCHANGE_ACCEPT","EXCHANGE_WITHDRAWAL","RETURN_COMPLETE","RETURN_REJECT","RETURN_TRANSFORM","RETURN_PENDING","DELIVERY_FEE_PAYMENT"]},"ordMediaCd":{"type":"string","description":"주문매체 코드(OM007)\n 10 : 전화상담(CC)\n, 20 : PC\n, 30 : 모바일웹\n, 40 : 안드로이드앱\n, 50 : IOS앱\n, 60 : 정기주문\n","enum":["10","20","30","40","50","60"]},"ordNo":{"type":"string","description":"주문번호"},"mbrNo":{"type":"string","description":"회원번호"},"claimNo":{"type":"string","description":"클레임번호"},"claimGoodsList":{"type":"array","description":"클레임 대상 상품정보 리스트","items":{"$ref":"#/components/schemas/ClaimGoodsRequest"}},"paymentRequest":{"$ref":"#/components/schemas/PaymentRequestPaymentInfo"},"claimCpnInfoList":{"type":"array","description":"쿠폰 리스트","items":{"$ref":"#/components/schemas/ClaimCpnInfo"}},"claimReturnDlvp":{"$ref":"#/components/schemas/ClaimDlvp"},"claimDlvp":{"$ref":"#/components/schemas/ClaimDlvp"},"claimFinalAmtInfo":{"$ref":"#/components/schemas/ClaimFinalAmtInfo"},"wthdFnshWaitProcCaus":{"type":"string","description":"회수완료 대기처리 사유"},"occurPayment":{"type":"boolean"},"existAddtionPayAmt":{"type":"boolean"},"claimBusiness":{"type":"string","description":"        ClaimBusiness(클레임업무유형)\n        * 11 : 주문취소\n        * 20 : 반품접수\n        * 21 : 반품취소\n        * 30 : 교환접수\n        * 31 : 교환취소\n        * 22 : 반품완료\n        * 23 : 반품불가\n        * 24 : 교환반품\n        * 25 : 반품보류\n","enum":["ORDER_CANCEL","RETURN_ACCEPT","RETURN_WITHDRAWAL","EXCHANGE_ACCEPT","EXCHANGE_WITHDRAWAL","RETURN_COMPLETE","RETURN_REJECT","RETURN_TRANSFORM","RETURN_PENDING","DELIVERY_FEE_PAYMENT"]}},"description":"클레임 처리 요청 DTO"},"ClaimGoodsRequest":{"required":["claimLgrpCd","claimMgrpCd","claimQty","exchangeGoodsNo","exchangeItmNm","exchangeItmNo"],"type":"object","properties":{"ordSeq":{"type":"integer","description":"주문순번","format":"int32"},"ordProcSeq":{"type":"integer","description":"주문처리순번","format":"int32"},"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"exchangeGoodsNo":{"type":"string","description":"교환 상품 번호"},"exchangeItmNo":{"type":"string","description":"교환 단품 번호"},"exchangeItmNm":{"type":"string","description":"교환 단품명"},"claimQty":{"type":"integer","description":"클레임 수량","format":"int32"},"claimLgrpCd":{"type":"string","description":"OM047(클레임대분류코드)\n 10: 단순변심\n , 20: 상품불량\n , 30: 배송불만\n , 40: 상품정보오류\n , 50: 재결제주문\n","enum":["SIMPLE_CHANGE","GOODS_BAD","DELIVERY_CLAIM","GOODS_INFOMATION_ERROR","REPAYMENT_ORDER"]},"claimMgrpCd":{"type":"string","description":"OM006(클레임중분류코드)\n 100: 배송이 늦어짐\n , 101: 상품이 품절됨\n , 102: 옵션/사이즈 변경/취소\n , 103: 다른 곳보다 비쌈\n , 104: 쿠폰/할인혜택 변경\n , 105: 구매의사 없어짐\n , 106: 사은품 변경/취소\n , 107: 결제수단 변경(구매사은 적용/카드변경 등)\n , 108: 유사상품 구매\n , 109: 상품정보 미흡\n , 110: 판매자 취소(판매자)\n , 111: 직권 취소(상담사)\n , 112: 자동 취소(결제부족)\n , 113: 자동 취소(결품취소)\n , 300: 사이즈가 큼\n , 301: 사이즈가 작음\n , 302: 단순변심 색상변경\n , 303: 오염\n , 304: 파손(울트임 등)\n , 305: 구성품 누락(목걸이, 벨트 등)\n , 306: 내용물 불량(화장품 등)\n , 307: 상품 오배송\n , 308: 기타\n , 200: 다른상품 주문\n , 201: 사이즈가 큼\n , 203: 사이즈가 작음\n , 204: 상품이미지 상이(컬러, 디자인, 핏)\n , 205: 구매의사가 사라짐\n , 206: 색상 또는 사이즈 교환기능이 없어서\n , 207: 기타\n , 208: 오염\n , 209: 파손(울트임 등)\n , 210: 구성품 누락(목걸이, 벨트 등)\n , 211: 내용물 불량(화장품 등)\n , 212: 기타\n , 213: 사이즈 오배송\n , 214: 컬러 오배송\n , 215: 상품 오배송\n , 216: 배송지연\n , 217: 기타\n , 218: 실측 사이즈 오류\n , 219: 소재 오류\n , 220: 색상 오류\n , 221: 상품 설명과 다름(오표기)\n , 222: 기타\n , 223: 반품보류\n , 224: 반품불가\n","enum":["CLAIM_MGRP_CD_100","CLAIM_MGRP_CD_101","CLAIM_MGRP_CD_102","CLAIM_MGRP_CD_103","CLAIM_MGRP_CD_104","CLAIM_MGRP_CD_105","CLAIM_MGRP_CD_106","CLAIM_MGRP_CD_107","CLAIM_MGRP_CD_108","CLAIM_MGRP_CD_109","CLAIM_MGRP_CD_110","CLAIM_MGRP_CD_111","CLAIM_MGRP_CD_112","CLAIM_MGRP_CD_113","CLAIM_MGRP_CD_114","CLAIM_MGRP_CD_300","CLAIM_MGRP_CD_301","CLAIM_MGRP_CD_302","CLAIM_MGRP_CD_303","CLAIM_MGRP_CD_304","CLAIM_MGRP_CD_305","CLAIM_MGRP_CD_306","CLAIM_MGRP_CD_307","CLAIM_MGRP_CD_308","CLAIM_MGRP_CD_200","CLAIM_MGRP_CD_201","CLAIM_MGRP_CD_203","CLAIM_MGRP_CD_204","CLAIM_MGRP_CD_205","CLAIM_MGRP_CD_206","CLAIM_MGRP_CD_207","CLAIM_MGRP_CD_208","CLAIM_MGRP_CD_209","CLAIM_MGRP_CD_210","CLAIM_MGRP_CD_211","CLAIM_MGRP_CD_212","CLAIM_MGRP_CD_213","CLAIM_MGRP_CD_214","CLAIM_MGRP_CD_215","CLAIM_MGRP_CD_216","CLAIM_MGRP_CD_217","CLAIM_MGRP_CD_218","CLAIM_MGRP_CD_219","CLAIM_MGRP_CD_220","CLAIM_MGRP_CD_221","CLAIM_MGRP_CD_222","CLAIM_MGRP_CD_223","CLAIM_MGRP_CD_224"]},"claimCausEtcCont":{"type":"string","description":"클레임사유기타내용"},"withdrawalDeliNo":{"type":"string","description":"회수 배송번호"},"shipmentDeliNo":{"type":"string","description":"출하 배송번호"},"prOrdDtlAtchFileInfoList":{"type":"array","description":"첨부이미지목록","items":{"$ref":"#/components/schemas/PrOrdDtlAtchFileInfo"}},"ordSeqAndOrdProcSeq":{"type":"string"}},"description":"클레임 요청 상품 정보 DTO"},"PrOrdDtlAtchFileInfo":{"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"ordSeq":{"type":"integer","description":"주문순번","format":"int32"},"ordProcSeq":{"type":"integer","description":"주문처리순번","format":"int32"},"fileSeq":{"type":"string","description":"파일순번"},"filePathNm":{"type":"string","description":"파일경로"},"fileNm":{"type":"string","description":"파일명"}},"description":"주문상세첨부파일정보 DTO"},"PaymentRequestPaymentInfo":{"type":"object","properties":{"siteNo":{"type":"string","description":"사이트 번호"},"orderInfo":{"$ref":"#/components/schemas/PaymentOrderInfo"},"payInfoList":{"type":"array","description":"결제를 요청하는 주문/클레임 DTO","items":{"$ref":"#/components/schemas/PaymentInfo"}}},"description":"결제 및 결제 취소 DTO","nullable":true},"PaymentOrderInfo":{"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"claimNo":{"type":"string","description":"클레임번호"},"goodsNm":{"type":"string","description":"상품명"},"ordManNm":{"type":"string","description":"주문자명"},"ordmnCellNo":{"type":"string","description":"주문자휴대폰번호"},"ordmnEmailAddr":{"type":"string","description":"주문자이메일주소"},"crcUnitCd":{"type":"string","description":"통화단위코드"},"ordMediaCd":{"type":"string","description":"주문매체코드(OM007)"},"mbrNo":{"type":"string","description":"회원번호"},"ordDtlGbCd":{"type":"string","description":"주문내역상세구분코드(OM003)"},"clientIp":{"type":"string","description":"클라이언트IP"},"taxFreeAmt":{"type":"integer","description":"면세 금액","format":"int64"}},"description":"결제에 필요한 주문 DTO"},"PaymentInfo":{"type":"object","properties":{"payNo":{"type":"string","description":"결제번호"},"payWayCd":{"type":"string","description":"결제수단코드(OM013)"},"payAmt":{"type":"integer","description":"결제금액","format":"int64"},"mersNo":{"type":"string","description":"가맹점번호"},"pgGbCd":{"type":"string","description":"PG구분코드(OM030)"},"trdNo":{"type":"string","description":"거래번호(tid)"},"selectCardCd":{"type":"string","description":"결제요청카드사코드(OM057)"},"termlId":{"type":"string","description":"터미널ID(mid)"},"billKey":{"type":"string","description":"승인요청할 빌링키 값"},"authResultMap":{"type":"object","additionalProperties":{"type":"string","description":"인증결과정보"},"description":"인증결과정보"}},"description":"결제 DTO"},"ClaimCpnInfo":{"type":"object","properties":{"cpnNo":{"type":"string","description":"쿠폰발급번호"}},"description":"클레임 쿠폰 정보 DTO"},"ClaimDlvp":{"required":["dlvpNm","dtlAddr","rcvmnNm","zipAddr","zipNo"],"type":"object","properties":{"mbrOrdDlvpGb":{"type":"string","description":"        ClaimDlvpGbCd(클레임배송지유형)\n        * 10 : 회원배송지\n        * 20 : 주문배송지\n","enum":["MBR","ORD"]},"dlvpSeq":{"type":"string","description":"배송지순번"},"zipNoSeq":{"type":"integer","description":"우편번호 순번","format":"int64"},"dlvpNm":{"type":"string","description":"배송지명"},"rcvmnNm":{"type":"string","description":"수취인명"},"zipNo":{"type":"string","description":"우편번호"},"zipAddr":{"type":"string","description":"우편주소"},"dtlAddr":{"type":"string","description":"상세주소"},"rcvmnEmailAddr":{"type":"string","description":"수취인이메일주소"},"rcvmnCellSctNo":{"type":"string","description":"수취인휴대폰구분번호"},"rcvmnCellTxnoNo":{"type":"string","description":"수취인휴대폰국번번호"},"rcvmnCellEndNo":{"type":"string","description":"수취인휴대폰국번번호"},"rcvmnTelRgnNo":{"type":"string","description":"수취인전화지역번호"},"rcvmnTelTxnoNo":{"type":"string","description":"수취인전화국번번호"},"rcvmnTelEndNo":{"type":"string","description":"수취인전화끝번호"},"deliMsg":{"type":"string","description":"배송메시지"},"deliMsgCd":{"type":"string","description":"배송메시지코드(ME039) 20:배송 전 연락 바랍니다, 30:부재 시 문 앞에 놓아주세요, 40:부재 시 경비실에 맡겨주세요, 50:빠른 배송 부탁 드립니다, 60:부재 시 핸드폰으로 연락바랍니다, 70:직접입력"},"shopTrafMsg":{"type":"string","description":"매장전달메시지"},"comnFrdrCogoMethodCd":{"type":"string","description":"공동현관출입방법코드(ME040) 10:공동현관 출입번호, 20:자유 출입 가능, 30:기타","default":"20"},"comnFrdrEtcMethod":{"type":"string","description":"공동현관기타방법"},"comnFrdrPwd":{"type":"string","description":"공동현관비밀번호"}},"description":"클레임 배송 정보 DTO"},"ClaimFinalAmtInfo":{"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"totAplyAdtnAmt":{"type":"integer","description":"총발생배송비금액","format":"int64"},"totCnclAdtnAmt":{"type":"integer","description":"총취소배송비금액","format":"int64"},"totFvrAdtnAmt":{"type":"integer","description":"총혜택배송비금액","format":"int64"},"totOrdPrc":{"type":"integer","description":"클레임상품금액","format":"int64"},"totDcAmt":{"type":"integer","description":"클레임취소할인금액","format":"int64"},"expectedRefundAmt":{"type":"integer","description":"환불예정금액","format":"int64"},"addtionPayAmt":{"type":"integer","description":"추가결제금액","format":"int64"},"returnAcceptAmt":{"type":"integer","description":"반품접수금액","format":"int64"},"refundAdditionAmtInfoList":{"type":"array","description":"추가결제/환불정보 리스트","items":{"$ref":"#/components/schemas/RefundAdditionAmtInfo"}},"refundPaymentMethodList":{"type":"array","description":"환불결제정보 리스트","items":{"$ref":"#/components/schemas/PaymentClaimResponse"}},"paymentOrderInfo":{"$ref":"#/components/schemas/PaymentOrderInfo"},"rfdInfoResponse":{"$ref":"#/components/schemas/RfdInfoResponse"}},"description":"클레임 최종 결제/환불금액 정보 DTO"},"RefundAdditionAmtInfo":{"type":"object","properties":{"adtnOcurGbCd":{"type":"string","description":"OM017(부가비용발생구분코드)\n 10: 발생\n , 20: 취소\n","enum":["OCCURRNECE","CANCEL"]},"adtnOcurGbNm":{"type":"string","description":"부가비용발생구분명"},"type":{"type":"string","description":"        ClaimAmountType(클레임부가비용유형)\n        * 10 : 배송비\n        * 20 : 회수배송비\n        * 30 : 교환배송비\n        * 40 : 상품\n        * 50 : 추가배송비\n        * 60 : 사은품\n","enum":["DELIVERY_FEE","RETURN_FEE","EXCHANGE_FEE","GOODS","EXTRA_FEE","GIFTS"]},"typeNm":{"type":"string","description":"유형구분명"},"goodsNoItmNo":{"type":"string","description":"상품번호+단품번호"},"goodsNm":{"type":"string","description":"상품명"},"ordAmt":{"type":"integer","description":"결제금액","format":"int64"},"discountMethod":{"type":"string","description":"OM019(부가비용상세구분코드)\n 11: 상품할인쿠폰\n , 12: 장바구니쿠폰\n , 13: 중복할인쿠폰\n , 14: 무료배송쿠폰\n , 15: 무료반품쿠폰\n , 20: 임직원할인\n , 21: 상품즉시할인\n , 51: 상품사은품\n , 40: 프로모션적립\n , 41: 기본적립\n , 42: 회원등급추가적립\n","enum":["GOODS_DISCOUNT","SHOPPING_BASKET","REDUNDANT_DISCOUNT","FREE_DELIVERY","FREE_RETURN","EXECUTIVES","GOODS_DIRECT","GOODS_GIFTS","MILEAGE","BASIC_ACCUMULATION","MBR_GRADE_ACCUMULATION"]},"discountMethodNm":{"type":"string","description":"혜택상세정보명"},"cnclDcAmt":{"type":"integer","description":"취소혜택금액","format":"int64"},"rtnDlvBenefitInfoList":{"type":"array","description":"반품쿠폰정보 리스트","items":{"$ref":"#/components/schemas/ClaimDlvBenefitInfo"}},"reCalAdtnOcurGbCdAdtnAmt":{"type":"integer","format":"int64"}},"description":"추가결제/환불정보 DTO"},"ClaimDlvBenefitInfo":{"type":"object","properties":{"promoNo":{"type":"string","description":"쿠폰번호"},"promoNm":{"type":"string","description":"쿠폰명"},"promoTypCd":{"type":"string","description":"프로모션 유형 코드(MK002)\n 11 : 상품할인쿠폰\n , 12 : 장바구니쿠폰\n , 13 : 중복할인쿠폰\n , 14 : 무료배송쿠폰\n , 15 : 무료반품쿠폰\n , 20 : 임직원할인\n , 21 : 상품즉시할인\n , 40 : 상품마일리지\n","enum":["11","12","13","14","15","20","21","40"]},"ourChrgRate":{"type":"integer","description":"당사분담율","format":"int32"},"entrChrgRate":{"type":"integer","description":"협력사분담율","format":"int32"},"cpnIsuNo":{"type":"string","description":"쿠폰발급번호"},"aplyYn":{"type":"string","description":"적용여부","enum":["Y","N"]}},"description":"반품쿠폰정보 리스트"},"PaymentClaimResponse":{"type":"object","properties":{"payNo":{"type":"string","description":"결제번호"},"mbrNo":{"type":"string","description":"회원번호"},"ordNo":{"type":"string","description":"주문번호"},"claimNo":{"type":"string","description":"클레임번호"},"uprPayNo":{"type":"string","description":"상위결제번호"},"payGbCd":{"type":"string","description":"결제구분코드(OM012)"},"payGbCdNm":{"type":"string","description":"결제구분코드명(OM012)"},"payWayCd":{"type":"string","description":"결제수단코드(OM013)"},"payWayCdNm":{"type":"string","description":"결제수단코드명(OM013)"},"payStatCd":{"type":"string","description":"결제상태코드(OM014)"},"payStatCdNm":{"type":"string","description":"결제상태코드명(OM014)"},"payAmt":{"type":"integer","description":"결제금액","format":"int64"},"taxFreeAmt":{"type":"integer","description":"면세가","format":"int64"},"rfdPsbAmt":{"type":"integer","description":"환불가능금액","format":"int64"},"rfdAmt":{"type":"integer","description":"환불금액","format":"int64"},"payFnshDtm":{"type":"string","description":"결제완료일시","format":"date-time"},"trdNo":{"type":"string","description":"거래번호(tid)"},"trdDtm":{"type":"string","description":"거래일시","format":"date-time"},"iscmCd":{"type":"string","description":"발급사코드(OM027)"},"iscmCdNm":{"type":"string","description":"발급사코드명(OM027)"},"payReqCardcoCd":{"type":"string","description":"결제요청카드사코드(OM057)"},"payReqCardcoCdNm":{"type":"string","description":"결제요청카드사코드명(OM057)"},"cardNo":{"type":"string","description":"카드번호"},"cardNm":{"type":"string","description":"카드명"},"cardValiTerm":{"type":"string","description":"카드유효기간"},"nintDivYn":{"type":"string","description":"무이자할부여부"},"divMonCnt":{"type":"integer","description":"할부개월수","format":"int32"},"cardPointUseYn":{"type":"string","description":"카드포인트사용여부"},"mersNo":{"type":"string","description":"가맹점번호"},"acqrCd":{"type":"string","description":"매입사코드(OM028)"},"acqrCdNm":{"type":"string","description":"매입사코드명(OM028)"},"aprvNo":{"type":"string","description":"승인번호"},"aprvDtm":{"type":"string","description":"승인일시","format":"date-time"},"sctnCnclPsbYn":{"type":"string","description":"부분취소가능여부"},"bankCd":{"type":"string","description":"은행코드(OM026)"},"bankCdNm":{"type":"string","description":"은행코드명(OM026)"},"actnNo":{"type":"string","description":"계좌번호"},"dpmnNm":{"type":"string","description":"입금자명"},"dptFcstDt":{"type":"string","description":"입금예정일자"},"dptCnfmDtm":{"type":"string","description":"입금확인일시","format":"date-time"},"rfdBankCd":{"type":"string","description":"환불은행코드(OM026)"},"rfdBankCdNm":{"type":"string","description":"환불은행코드명(OM026)"},"rfdActnNo":{"type":"string","description":"환불계좌번호"},"rfdActnDepositorNm":{"type":"string","description":"환불계좌 예금주명"},"vbankPaymentPending":{"type":"boolean"},"vbankDptCnfm":{"type":"boolean"}},"description":"환불가능한 결제수단 DTO"},"RfdInfoResponse":{"type":"object","properties":{"rfdBankCd":{"type":"string","description":"은행코드 (OM026)"},"rfdBankNm":{"type":"string","description":"은행명"},"rfdActnNo":{"type":"string","description":"환불계좌번호"},"rfdActnDepositorNm":{"type":"string","description":"환불 계좌 예금주명"},"rfdActnCertiYn":{"type":"string","description":"환불 계좌 인증여부"}},"description":"환불 계좌정보 조회 Response"},"Response":{"type":"object","properties":{"timestamp":{"type":"string","description":"result time","format":"date-time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","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"}},"description":"validation error list"}}}}
```

## 주문 취소(BO)

> \## 기능설명\
> \* 주문취소를 진행합니다.\
> \---\
> \## 상세설명\
> \* 주문취소 처리 API 호출 시점의 주문 상태를 확인, 접수 가능 여부를 확인합니다.\
> \* 주문취소 요청 데이터의 유효성 검증은 다음의 항목에 대해 진행합니다.\
> &#x20;   \* 접수 상품 사은품 유무 체크(-> \*부분 수량 클레임 불가\*)\
> &#x20;   \* 부분취소불가 결제수단 사용 여부 체크(-> \*부분 클레임 불가\*)\
> &#x20;   \* 추가결제금액이 여부 체크(-> \*BO에서 클레임 불가\*)\
> \* 주문 취소 데이터 생성 및 업데이트합니다.\
> \* 주문 취소 시 발생하는 환불/결제 금액에 대해 검증을 수행합니다.\
> \* 복원 쿠폰이 있을 경우 쿠폰 복원이 일어납니다.\
> \* 주문 취소 상품에 대한 재고 복원이 일어납니다.\
> \* 환불/결제 처리됩니다.\
> \* 주문 취소 고객에게 알림을 발송합니다.(이메일/알림톡/알림함)\
> \---\
> \## 수정번호\
> \* release\_231009\_01 : 주문혜택관계테이블 주문수량, 취소수량 컬럼 추가\
> \* Release v2.00\_240627: 접수 상품 배송번호 일치 여부 체크 로직 제거 ( 전체 취소 기능 추가)<br>

```json
{"openapi":"3.0.1","info":{"title":"X2BEE Order API","version":"v1"},"servers":[{"url":"https://api-order.x2bee.com/api/order/","description":"prd"}],"paths":{"/v1/claim/orderCancel/cancel":{"post":{"tags":["주문취소"],"summary":"주문 취소(BO)","description":"## 기능설명\n* 주문취소를 진행합니다.\n---\n## 상세설명\n* 주문취소 처리 API 호출 시점의 주문 상태를 확인, 접수 가능 여부를 확인합니다.\n* 주문취소 요청 데이터의 유효성 검증은 다음의 항목에 대해 진행합니다.\n    * 접수 상품 사은품 유무 체크(-> *부분 수량 클레임 불가*)\n    * 부분취소불가 결제수단 사용 여부 체크(-> *부분 클레임 불가*)\n    * 추가결제금액이 여부 체크(-> *BO에서 클레임 불가*)\n* 주문 취소 데이터 생성 및 업데이트합니다.\n* 주문 취소 시 발생하는 환불/결제 금액에 대해 검증을 수행합니다.\n* 복원 쿠폰이 있을 경우 쿠폰 복원이 일어납니다.\n* 주문 취소 상품에 대한 재고 복원이 일어납니다.\n* 환불/결제 처리됩니다.\n* 주문 취소 고객에게 알림을 발송합니다.(이메일/알림톡/알림함)\n---\n## 수정번호\n* release_231009_01 : 주문혜택관계테이블 주문수량, 취소수량 컬럼 추가\n* Release v2.00_240627: 접수 상품 배송번호 일치 여부 체크 로직 제거 ( 전체 취소 기능 추가)\n","operationId":"cancelOrder","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ClaimProcessResultResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"ClaimRequest":{"required":["claimBusinessType","claimDlvp","claimGoodsList","claimNo","claimReturnDlvp","ordMediaCd","ordNo","systemType","wthdFnshWaitProcCaus"],"type":"object","properties":{"systemType":{"type":"string","description":"        SYSTEM(시스템유형)\n        * 10 : FO\n        * 20 : BO\n","enum":["FO","BO"]},"claimBusinessType":{"type":"string","description":"        ClaimBusiness(클레임업무유형)\n        * 11 : 주문취소\n        * 20 : 반품접수\n        * 21 : 반품취소\n        * 30 : 교환접수\n        * 31 : 교환취소\n        * 22 : 반품완료\n        * 23 : 반품불가\n        * 24 : 교환반품\n        * 25 : 반품보류\n","enum":["ORDER_CANCEL","RETURN_ACCEPT","RETURN_WITHDRAWAL","EXCHANGE_ACCEPT","EXCHANGE_WITHDRAWAL","RETURN_COMPLETE","RETURN_REJECT","RETURN_TRANSFORM","RETURN_PENDING","DELIVERY_FEE_PAYMENT"]},"ordMediaCd":{"type":"string","description":"주문매체 코드(OM007)\n 10 : 전화상담(CC)\n, 20 : PC\n, 30 : 모바일웹\n, 40 : 안드로이드앱\n, 50 : IOS앱\n, 60 : 정기주문\n","enum":["10","20","30","40","50","60"]},"ordNo":{"type":"string","description":"주문번호"},"mbrNo":{"type":"string","description":"회원번호"},"claimNo":{"type":"string","description":"클레임번호"},"claimGoodsList":{"type":"array","description":"클레임 대상 상품정보 리스트","items":{"$ref":"#/components/schemas/ClaimGoodsRequest"}},"paymentRequest":{"$ref":"#/components/schemas/PaymentRequestPaymentInfo"},"claimCpnInfoList":{"type":"array","description":"쿠폰 리스트","items":{"$ref":"#/components/schemas/ClaimCpnInfo"}},"claimReturnDlvp":{"$ref":"#/components/schemas/ClaimDlvp"},"claimDlvp":{"$ref":"#/components/schemas/ClaimDlvp"},"claimFinalAmtInfo":{"$ref":"#/components/schemas/ClaimFinalAmtInfo"},"wthdFnshWaitProcCaus":{"type":"string","description":"회수완료 대기처리 사유"},"occurPayment":{"type":"boolean"},"existAddtionPayAmt":{"type":"boolean"},"claimBusiness":{"type":"string","description":"        ClaimBusiness(클레임업무유형)\n        * 11 : 주문취소\n        * 20 : 반품접수\n        * 21 : 반품취소\n        * 30 : 교환접수\n        * 31 : 교환취소\n        * 22 : 반품완료\n        * 23 : 반품불가\n        * 24 : 교환반품\n        * 25 : 반품보류\n","enum":["ORDER_CANCEL","RETURN_ACCEPT","RETURN_WITHDRAWAL","EXCHANGE_ACCEPT","EXCHANGE_WITHDRAWAL","RETURN_COMPLETE","RETURN_REJECT","RETURN_TRANSFORM","RETURN_PENDING","DELIVERY_FEE_PAYMENT"]}},"description":"클레임 처리 요청 DTO"},"ClaimGoodsRequest":{"required":["claimLgrpCd","claimMgrpCd","claimQty","exchangeGoodsNo","exchangeItmNm","exchangeItmNo"],"type":"object","properties":{"ordSeq":{"type":"integer","description":"주문순번","format":"int32"},"ordProcSeq":{"type":"integer","description":"주문처리순번","format":"int32"},"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"exchangeGoodsNo":{"type":"string","description":"교환 상품 번호"},"exchangeItmNo":{"type":"string","description":"교환 단품 번호"},"exchangeItmNm":{"type":"string","description":"교환 단품명"},"claimQty":{"type":"integer","description":"클레임 수량","format":"int32"},"claimLgrpCd":{"type":"string","description":"OM047(클레임대분류코드)\n 10: 단순변심\n , 20: 상품불량\n , 30: 배송불만\n , 40: 상품정보오류\n , 50: 재결제주문\n","enum":["SIMPLE_CHANGE","GOODS_BAD","DELIVERY_CLAIM","GOODS_INFOMATION_ERROR","REPAYMENT_ORDER"]},"claimMgrpCd":{"type":"string","description":"OM006(클레임중분류코드)\n 100: 배송이 늦어짐\n , 101: 상품이 품절됨\n , 102: 옵션/사이즈 변경/취소\n , 103: 다른 곳보다 비쌈\n , 104: 쿠폰/할인혜택 변경\n , 105: 구매의사 없어짐\n , 106: 사은품 변경/취소\n , 107: 결제수단 변경(구매사은 적용/카드변경 등)\n , 108: 유사상품 구매\n , 109: 상품정보 미흡\n , 110: 판매자 취소(판매자)\n , 111: 직권 취소(상담사)\n , 112: 자동 취소(결제부족)\n , 113: 자동 취소(결품취소)\n , 300: 사이즈가 큼\n , 301: 사이즈가 작음\n , 302: 단순변심 색상변경\n , 303: 오염\n , 304: 파손(울트임 등)\n , 305: 구성품 누락(목걸이, 벨트 등)\n , 306: 내용물 불량(화장품 등)\n , 307: 상품 오배송\n , 308: 기타\n , 200: 다른상품 주문\n , 201: 사이즈가 큼\n , 203: 사이즈가 작음\n , 204: 상품이미지 상이(컬러, 디자인, 핏)\n , 205: 구매의사가 사라짐\n , 206: 색상 또는 사이즈 교환기능이 없어서\n , 207: 기타\n , 208: 오염\n , 209: 파손(울트임 등)\n , 210: 구성품 누락(목걸이, 벨트 등)\n , 211: 내용물 불량(화장품 등)\n , 212: 기타\n , 213: 사이즈 오배송\n , 214: 컬러 오배송\n , 215: 상품 오배송\n , 216: 배송지연\n , 217: 기타\n , 218: 실측 사이즈 오류\n , 219: 소재 오류\n , 220: 색상 오류\n , 221: 상품 설명과 다름(오표기)\n , 222: 기타\n , 223: 반품보류\n , 224: 반품불가\n","enum":["CLAIM_MGRP_CD_100","CLAIM_MGRP_CD_101","CLAIM_MGRP_CD_102","CLAIM_MGRP_CD_103","CLAIM_MGRP_CD_104","CLAIM_MGRP_CD_105","CLAIM_MGRP_CD_106","CLAIM_MGRP_CD_107","CLAIM_MGRP_CD_108","CLAIM_MGRP_CD_109","CLAIM_MGRP_CD_110","CLAIM_MGRP_CD_111","CLAIM_MGRP_CD_112","CLAIM_MGRP_CD_113","CLAIM_MGRP_CD_114","CLAIM_MGRP_CD_300","CLAIM_MGRP_CD_301","CLAIM_MGRP_CD_302","CLAIM_MGRP_CD_303","CLAIM_MGRP_CD_304","CLAIM_MGRP_CD_305","CLAIM_MGRP_CD_306","CLAIM_MGRP_CD_307","CLAIM_MGRP_CD_308","CLAIM_MGRP_CD_200","CLAIM_MGRP_CD_201","CLAIM_MGRP_CD_203","CLAIM_MGRP_CD_204","CLAIM_MGRP_CD_205","CLAIM_MGRP_CD_206","CLAIM_MGRP_CD_207","CLAIM_MGRP_CD_208","CLAIM_MGRP_CD_209","CLAIM_MGRP_CD_210","CLAIM_MGRP_CD_211","CLAIM_MGRP_CD_212","CLAIM_MGRP_CD_213","CLAIM_MGRP_CD_214","CLAIM_MGRP_CD_215","CLAIM_MGRP_CD_216","CLAIM_MGRP_CD_217","CLAIM_MGRP_CD_218","CLAIM_MGRP_CD_219","CLAIM_MGRP_CD_220","CLAIM_MGRP_CD_221","CLAIM_MGRP_CD_222","CLAIM_MGRP_CD_223","CLAIM_MGRP_CD_224"]},"claimCausEtcCont":{"type":"string","description":"클레임사유기타내용"},"withdrawalDeliNo":{"type":"string","description":"회수 배송번호"},"shipmentDeliNo":{"type":"string","description":"출하 배송번호"},"prOrdDtlAtchFileInfoList":{"type":"array","description":"첨부이미지목록","items":{"$ref":"#/components/schemas/PrOrdDtlAtchFileInfo"}},"ordSeqAndOrdProcSeq":{"type":"string"}},"description":"클레임 요청 상품 정보 DTO"},"PrOrdDtlAtchFileInfo":{"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"ordSeq":{"type":"integer","description":"주문순번","format":"int32"},"ordProcSeq":{"type":"integer","description":"주문처리순번","format":"int32"},"fileSeq":{"type":"string","description":"파일순번"},"filePathNm":{"type":"string","description":"파일경로"},"fileNm":{"type":"string","description":"파일명"}},"description":"주문상세첨부파일정보 DTO"},"PaymentRequestPaymentInfo":{"type":"object","properties":{"siteNo":{"type":"string","description":"사이트 번호"},"orderInfo":{"$ref":"#/components/schemas/PaymentOrderInfo"},"payInfoList":{"type":"array","description":"결제를 요청하는 주문/클레임 DTO","items":{"$ref":"#/components/schemas/PaymentInfo"}}},"description":"결제 및 결제 취소 DTO","nullable":true},"PaymentOrderInfo":{"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"claimNo":{"type":"string","description":"클레임번호"},"goodsNm":{"type":"string","description":"상품명"},"ordManNm":{"type":"string","description":"주문자명"},"ordmnCellNo":{"type":"string","description":"주문자휴대폰번호"},"ordmnEmailAddr":{"type":"string","description":"주문자이메일주소"},"crcUnitCd":{"type":"string","description":"통화단위코드"},"ordMediaCd":{"type":"string","description":"주문매체코드(OM007)"},"mbrNo":{"type":"string","description":"회원번호"},"ordDtlGbCd":{"type":"string","description":"주문내역상세구분코드(OM003)"},"clientIp":{"type":"string","description":"클라이언트IP"},"taxFreeAmt":{"type":"integer","description":"면세 금액","format":"int64"}},"description":"결제에 필요한 주문 DTO"},"PaymentInfo":{"type":"object","properties":{"payNo":{"type":"string","description":"결제번호"},"payWayCd":{"type":"string","description":"결제수단코드(OM013)"},"payAmt":{"type":"integer","description":"결제금액","format":"int64"},"mersNo":{"type":"string","description":"가맹점번호"},"pgGbCd":{"type":"string","description":"PG구분코드(OM030)"},"trdNo":{"type":"string","description":"거래번호(tid)"},"selectCardCd":{"type":"string","description":"결제요청카드사코드(OM057)"},"termlId":{"type":"string","description":"터미널ID(mid)"},"billKey":{"type":"string","description":"승인요청할 빌링키 값"},"authResultMap":{"type":"object","additionalProperties":{"type":"string","description":"인증결과정보"},"description":"인증결과정보"}},"description":"결제 DTO"},"ClaimCpnInfo":{"type":"object","properties":{"cpnNo":{"type":"string","description":"쿠폰발급번호"}},"description":"클레임 쿠폰 정보 DTO"},"ClaimDlvp":{"required":["dlvpNm","dtlAddr","rcvmnNm","zipAddr","zipNo"],"type":"object","properties":{"mbrOrdDlvpGb":{"type":"string","description":"        ClaimDlvpGbCd(클레임배송지유형)\n        * 10 : 회원배송지\n        * 20 : 주문배송지\n","enum":["MBR","ORD"]},"dlvpSeq":{"type":"string","description":"배송지순번"},"zipNoSeq":{"type":"integer","description":"우편번호 순번","format":"int64"},"dlvpNm":{"type":"string","description":"배송지명"},"rcvmnNm":{"type":"string","description":"수취인명"},"zipNo":{"type":"string","description":"우편번호"},"zipAddr":{"type":"string","description":"우편주소"},"dtlAddr":{"type":"string","description":"상세주소"},"rcvmnEmailAddr":{"type":"string","description":"수취인이메일주소"},"rcvmnCellSctNo":{"type":"string","description":"수취인휴대폰구분번호"},"rcvmnCellTxnoNo":{"type":"string","description":"수취인휴대폰국번번호"},"rcvmnCellEndNo":{"type":"string","description":"수취인휴대폰국번번호"},"rcvmnTelRgnNo":{"type":"string","description":"수취인전화지역번호"},"rcvmnTelTxnoNo":{"type":"string","description":"수취인전화국번번호"},"rcvmnTelEndNo":{"type":"string","description":"수취인전화끝번호"},"deliMsg":{"type":"string","description":"배송메시지"},"deliMsgCd":{"type":"string","description":"배송메시지코드(ME039) 20:배송 전 연락 바랍니다, 30:부재 시 문 앞에 놓아주세요, 40:부재 시 경비실에 맡겨주세요, 50:빠른 배송 부탁 드립니다, 60:부재 시 핸드폰으로 연락바랍니다, 70:직접입력"},"shopTrafMsg":{"type":"string","description":"매장전달메시지"},"comnFrdrCogoMethodCd":{"type":"string","description":"공동현관출입방법코드(ME040) 10:공동현관 출입번호, 20:자유 출입 가능, 30:기타","default":"20"},"comnFrdrEtcMethod":{"type":"string","description":"공동현관기타방법"},"comnFrdrPwd":{"type":"string","description":"공동현관비밀번호"}},"description":"클레임 배송 정보 DTO"},"ClaimFinalAmtInfo":{"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"totAplyAdtnAmt":{"type":"integer","description":"총발생배송비금액","format":"int64"},"totCnclAdtnAmt":{"type":"integer","description":"총취소배송비금액","format":"int64"},"totFvrAdtnAmt":{"type":"integer","description":"총혜택배송비금액","format":"int64"},"totOrdPrc":{"type":"integer","description":"클레임상품금액","format":"int64"},"totDcAmt":{"type":"integer","description":"클레임취소할인금액","format":"int64"},"expectedRefundAmt":{"type":"integer","description":"환불예정금액","format":"int64"},"addtionPayAmt":{"type":"integer","description":"추가결제금액","format":"int64"},"returnAcceptAmt":{"type":"integer","description":"반품접수금액","format":"int64"},"refundAdditionAmtInfoList":{"type":"array","description":"추가결제/환불정보 리스트","items":{"$ref":"#/components/schemas/RefundAdditionAmtInfo"}},"refundPaymentMethodList":{"type":"array","description":"환불결제정보 리스트","items":{"$ref":"#/components/schemas/PaymentClaimResponse"}},"paymentOrderInfo":{"$ref":"#/components/schemas/PaymentOrderInfo"},"rfdInfoResponse":{"$ref":"#/components/schemas/RfdInfoResponse"}},"description":"클레임 최종 결제/환불금액 정보 DTO"},"RefundAdditionAmtInfo":{"type":"object","properties":{"adtnOcurGbCd":{"type":"string","description":"OM017(부가비용발생구분코드)\n 10: 발생\n , 20: 취소\n","enum":["OCCURRNECE","CANCEL"]},"adtnOcurGbNm":{"type":"string","description":"부가비용발생구분명"},"type":{"type":"string","description":"        ClaimAmountType(클레임부가비용유형)\n        * 10 : 배송비\n        * 20 : 회수배송비\n        * 30 : 교환배송비\n        * 40 : 상품\n        * 50 : 추가배송비\n        * 60 : 사은품\n","enum":["DELIVERY_FEE","RETURN_FEE","EXCHANGE_FEE","GOODS","EXTRA_FEE","GIFTS"]},"typeNm":{"type":"string","description":"유형구분명"},"goodsNoItmNo":{"type":"string","description":"상품번호+단품번호"},"goodsNm":{"type":"string","description":"상품명"},"ordAmt":{"type":"integer","description":"결제금액","format":"int64"},"discountMethod":{"type":"string","description":"OM019(부가비용상세구분코드)\n 11: 상품할인쿠폰\n , 12: 장바구니쿠폰\n , 13: 중복할인쿠폰\n , 14: 무료배송쿠폰\n , 15: 무료반품쿠폰\n , 20: 임직원할인\n , 21: 상품즉시할인\n , 51: 상품사은품\n , 40: 프로모션적립\n , 41: 기본적립\n , 42: 회원등급추가적립\n","enum":["GOODS_DISCOUNT","SHOPPING_BASKET","REDUNDANT_DISCOUNT","FREE_DELIVERY","FREE_RETURN","EXECUTIVES","GOODS_DIRECT","GOODS_GIFTS","MILEAGE","BASIC_ACCUMULATION","MBR_GRADE_ACCUMULATION"]},"discountMethodNm":{"type":"string","description":"혜택상세정보명"},"cnclDcAmt":{"type":"integer","description":"취소혜택금액","format":"int64"},"rtnDlvBenefitInfoList":{"type":"array","description":"반품쿠폰정보 리스트","items":{"$ref":"#/components/schemas/ClaimDlvBenefitInfo"}},"reCalAdtnOcurGbCdAdtnAmt":{"type":"integer","format":"int64"}},"description":"추가결제/환불정보 DTO"},"ClaimDlvBenefitInfo":{"type":"object","properties":{"promoNo":{"type":"string","description":"쿠폰번호"},"promoNm":{"type":"string","description":"쿠폰명"},"promoTypCd":{"type":"string","description":"프로모션 유형 코드(MK002)\n 11 : 상품할인쿠폰\n , 12 : 장바구니쿠폰\n , 13 : 중복할인쿠폰\n , 14 : 무료배송쿠폰\n , 15 : 무료반품쿠폰\n , 20 : 임직원할인\n , 21 : 상품즉시할인\n , 40 : 상품마일리지\n","enum":["11","12","13","14","15","20","21","40"]},"ourChrgRate":{"type":"integer","description":"당사분담율","format":"int32"},"entrChrgRate":{"type":"integer","description":"협력사분담율","format":"int32"},"cpnIsuNo":{"type":"string","description":"쿠폰발급번호"},"aplyYn":{"type":"string","description":"적용여부","enum":["Y","N"]}},"description":"반품쿠폰정보 리스트"},"PaymentClaimResponse":{"type":"object","properties":{"payNo":{"type":"string","description":"결제번호"},"mbrNo":{"type":"string","description":"회원번호"},"ordNo":{"type":"string","description":"주문번호"},"claimNo":{"type":"string","description":"클레임번호"},"uprPayNo":{"type":"string","description":"상위결제번호"},"payGbCd":{"type":"string","description":"결제구분코드(OM012)"},"payGbCdNm":{"type":"string","description":"결제구분코드명(OM012)"},"payWayCd":{"type":"string","description":"결제수단코드(OM013)"},"payWayCdNm":{"type":"string","description":"결제수단코드명(OM013)"},"payStatCd":{"type":"string","description":"결제상태코드(OM014)"},"payStatCdNm":{"type":"string","description":"결제상태코드명(OM014)"},"payAmt":{"type":"integer","description":"결제금액","format":"int64"},"taxFreeAmt":{"type":"integer","description":"면세가","format":"int64"},"rfdPsbAmt":{"type":"integer","description":"환불가능금액","format":"int64"},"rfdAmt":{"type":"integer","description":"환불금액","format":"int64"},"payFnshDtm":{"type":"string","description":"결제완료일시","format":"date-time"},"trdNo":{"type":"string","description":"거래번호(tid)"},"trdDtm":{"type":"string","description":"거래일시","format":"date-time"},"iscmCd":{"type":"string","description":"발급사코드(OM027)"},"iscmCdNm":{"type":"string","description":"발급사코드명(OM027)"},"payReqCardcoCd":{"type":"string","description":"결제요청카드사코드(OM057)"},"payReqCardcoCdNm":{"type":"string","description":"결제요청카드사코드명(OM057)"},"cardNo":{"type":"string","description":"카드번호"},"cardNm":{"type":"string","description":"카드명"},"cardValiTerm":{"type":"string","description":"카드유효기간"},"nintDivYn":{"type":"string","description":"무이자할부여부"},"divMonCnt":{"type":"integer","description":"할부개월수","format":"int32"},"cardPointUseYn":{"type":"string","description":"카드포인트사용여부"},"mersNo":{"type":"string","description":"가맹점번호"},"acqrCd":{"type":"string","description":"매입사코드(OM028)"},"acqrCdNm":{"type":"string","description":"매입사코드명(OM028)"},"aprvNo":{"type":"string","description":"승인번호"},"aprvDtm":{"type":"string","description":"승인일시","format":"date-time"},"sctnCnclPsbYn":{"type":"string","description":"부분취소가능여부"},"bankCd":{"type":"string","description":"은행코드(OM026)"},"bankCdNm":{"type":"string","description":"은행코드명(OM026)"},"actnNo":{"type":"string","description":"계좌번호"},"dpmnNm":{"type":"string","description":"입금자명"},"dptFcstDt":{"type":"string","description":"입금예정일자"},"dptCnfmDtm":{"type":"string","description":"입금확인일시","format":"date-time"},"rfdBankCd":{"type":"string","description":"환불은행코드(OM026)"},"rfdBankCdNm":{"type":"string","description":"환불은행코드명(OM026)"},"rfdActnNo":{"type":"string","description":"환불계좌번호"},"rfdActnDepositorNm":{"type":"string","description":"환불계좌 예금주명"},"vbankPaymentPending":{"type":"boolean"},"vbankDptCnfm":{"type":"boolean"}},"description":"환불가능한 결제수단 DTO"},"RfdInfoResponse":{"type":"object","properties":{"rfdBankCd":{"type":"string","description":"은행코드 (OM026)"},"rfdBankNm":{"type":"string","description":"은행명"},"rfdActnNo":{"type":"string","description":"환불계좌번호"},"rfdActnDepositorNm":{"type":"string","description":"환불 계좌 예금주명"},"rfdActnCertiYn":{"type":"string","description":"환불 계좌 인증여부"}},"description":"환불 계좌정보 조회 Response"},"ClaimProcessResultResponse":{"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"claimNo":{"type":"string","description":"클레임번호"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","description":"result time","format":"date-time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","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"}},"description":"validation error list"}}}}
```

## 주문 취소 대상 조회(BO)

> \## 기능설명\
> \* 주문 내역과 취소 가능 상품 목록, 화면 처리 시 필요한 기타 정보를 조회합니다.\
> \---\
> \## 상세설명\
> \* \*\*주문번호(ordNo), 클레임업무유형(claimBusinessType), 시스템유형(systemType)\*\*은 필수 파라미터입니다.\
> \* 다음의 조건을 모두 충족하는 대상에 대해 주문취소 처리가 가능합니다.\
> &#x20;   \* 주문내역구분(OM003) 값이 \*\*주문일반(10)\*\*인 경우\
> &#x20;   \* 주문내역상태(OM005) 값이 \*\*주문완료(12)\*\* 이거나 \*\*배송지시(21)\*\* 이거나 \*\*출고지시(22)\*\* 이거나 \*\*출고대기(23)\*\* 인 경우\
> &#x20;   \* 일반상품인 경우(사은품 제외)\
> &#x20;   \* 취소 가능 수량이 1개 이상인 경우( \*\*주문수량 – 취소수량 – 반품수량 > 0\*\* )\
> &#x20;   \* 주문 취소 가능 여부가 'Y'인 경우\
> \* 기타 정보에 포함된 사항은 아래와 같습니다.\
> &#x20;   \* 주문취소 중분류 사유 List\
> &#x20;   \* 귀책사유 코드를 Key로 하고 주문취소 중분류 사유를 Value로 하는 Map\
> \---\
> \## 수정번호\
> \* release\_231204\_01 : Request DTO 배송지순번(dlvpSeq) 추가, 대상 조회시 배송지 순번 값이 있는경우 필터링 추가 실행\
> \* Release v2.00\_240729 : 주문 취소 가능 여부(ordCnclPsbYn)값이 "N"인 경우 대상 제외<br>

```json
{"openapi":"3.0.1","info":{"title":"X2BEE Order API","version":"v1"},"servers":[{"url":"https://api-order.x2bee.com/api/order/","description":"prd"}],"paths":{"/v1/claim/orderCancel/cancelPopup":{"post":{"tags":["주문취소"],"summary":"주문 취소 대상 조회(BO)","description":"## 기능설명\n* 주문 내역과 취소 가능 상품 목록, 화면 처리 시 필요한 기타 정보를 조회합니다.\n---\n## 상세설명\n* **주문번호(ordNo), 클레임업무유형(claimBusinessType), 시스템유형(systemType)**은 필수 파라미터입니다.\n* 다음의 조건을 모두 충족하는 대상에 대해 주문취소 처리가 가능합니다.\n    * 주문내역구분(OM003) 값이 **주문일반(10)**인 경우\n    * 주문내역상태(OM005) 값이 **주문완료(12)** 이거나 **배송지시(21)** 이거나 **출고지시(22)** 이거나 **출고대기(23)** 인 경우\n    * 일반상품인 경우(사은품 제외)\n    * 취소 가능 수량이 1개 이상인 경우( **주문수량 – 취소수량 – 반품수량 > 0** )\n    * 주문 취소 가능 여부가 'Y'인 경우\n* 기타 정보에 포함된 사항은 아래와 같습니다.\n    * 주문취소 중분류 사유 List\n    * 귀책사유 코드를 Key로 하고 주문취소 중분류 사유를 Value로 하는 Map\n---\n## 수정번호\n* release_231204_01 : Request DTO 배송지순번(dlvpSeq) 추가, 대상 조회시 배송지 순번 값이 있는경우 필터링 추가 실행\n* Release v2.00_240729 : 주문 취소 가능 여부(ordCnclPsbYn)값이 \"N\"인 경우 대상 제외\n","operationId":"getOrderCancelPopupInfo","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimTargetRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OrderCancelPopupResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"ClaimTargetRequest":{"required":["ordNo","systemType"],"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"claimBusinessType":{"type":"string","description":"        ClaimBusiness(클레임업무유형)\n        * 11 : 주문취소\n        * 20 : 반품접수\n        * 21 : 반품취소\n        * 30 : 교환접수\n        * 31 : 교환취소\n        * 22 : 반품완료\n        * 23 : 반품불가\n        * 24 : 교환반품\n        * 25 : 반품보류\n","enum":["ORDER_CANCEL","RETURN_ACCEPT","RETURN_WITHDRAWAL","EXCHANGE_ACCEPT","EXCHANGE_WITHDRAWAL","RETURN_COMPLETE","RETURN_REJECT","RETURN_TRANSFORM","RETURN_PENDING","DELIVERY_FEE_PAYMENT"]},"orgClmNo":{"type":"string","description":"원클레임 번호"},"systemType":{"type":"string","description":"        SYSTEM(시스템유형)\n        * 10 : FO\n        * 20 : BO\n","enum":["FO","BO"],"default":"20"},"dlvpSeq":{"type":"string","description":"배송지순번"},"systemCdNmAndButtonCode":{"type":"string"},"claimBusiness":{"type":"string","description":"        ClaimBusiness(클레임업무유형)\n        * 11 : 주문취소\n        * 20 : 반품접수\n        * 21 : 반품취소\n        * 30 : 교환접수\n        * 31 : 교환취소\n        * 22 : 반품완료\n        * 23 : 반품불가\n        * 24 : 교환반품\n        * 25 : 반품보류\n","enum":["ORDER_CANCEL","RETURN_ACCEPT","RETURN_WITHDRAWAL","EXCHANGE_ACCEPT","EXCHANGE_WITHDRAWAL","RETURN_COMPLETE","RETURN_REJECT","RETURN_TRANSFORM","RETURN_PENDING","DELIVERY_FEE_PAYMENT"]},"system":{"type":"string","description":"        SYSTEM(시스템유형)\n        * 10 : FO\n        * 20 : BO\n","enum":["FO","BO"]}},"description":"클레임 가능 대상 조회 요청 DTO"},"OrderCancelPopupResponse":{"type":"object","properties":{"claimTargetResponse":{"$ref":"#/components/schemas/ClaimTargetResponse"},"claimCausCdList":{"type":"array","description":"클레임 대분류 사유","items":{"$ref":"#/components/schemas/StCdDtlResponse"}},"claimMgrpRspnGbCdMap":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/StCdDtlResponse"},"description":"귀책구분코드의 코드를 Key로 하는 클레임 중분류 사유 Map"}},"description":"클레임 가능 대상 조회 응답 DTO"},"ClaimTargetResponse":{"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"mbrNo":{"type":"string","description":"회원번호"},"mbrGradeCd":{"type":"string","description":"회원등급코드(ME008)\n 10 : GREEN\n, 20 : FAMILY\n, 30 : GOLD\n, 40 : VIP\n, 50 : VVIP\n","enum":["10","20","30","40","50"]},"ordGbCd":{"type":"string","description":"OM002(주문 구분 코드)\n 10: 일반주문\n , 20: 선물하기\n , 30: e-쿠폰\n , 40: 제휴\n","enum":["GENERAL_ORDER","GIVE_GIFT_ORDER","E_COUPON","SUBSCRIBE_ORDER"]},"mbrMgrCd":{"type":"string","description":"ME002(회원관리코드)\n 10: UNION_MEMBER(통합회원)\n,20: GENERAL_MEMBER(일반회원)\n,30: SOCIAL_MEMBER(소셜회원)\n,99: NO_MEMBER(비회원)\n","enum":["UNION_MEMBER","GENERAL_MEMBER","SOCIAL_MEMBER","ENTERPRISE_MEMBER","NO_MEMBER"]},"ordManNm":{"type":"string","description":"주문자명"},"ordManEmailAddr":{"type":"string","description":"주문자이메일주소"},"ordManCellSctNo":{"type":"string","description":"주문자휴대폰구분번호"},"ordManCellTxnoNo":{"type":"string","description":"주문자휴대폰국번번호"},"ordManCellEndNo":{"type":"string","description":"주문자휴대폰끝번호"},"ordMediaCd":{"type":"string","description":"주문매체 코드(OM007)\n 10 : 전화상담(CC)\n, 20 : PC\n, 30 : 모바일웹\n, 40 : 안드로이드앱\n, 50 : IOS앱\n, 60 : 정기주문\n","enum":["10","20","30","40","50","60"]},"ordAccpDtm":{"type":"string","description":"주문접수일자","format":"date-time"},"sctnCnclPsbYn":{"type":"string","description":"부분취소가능여부","enum":["Y","N"]},"claimTargetGoodsResponseList":{"type":"array","description":"클레임 대상 상품 목록","items":{"$ref":"#/components/schemas/ClaimTargetGoodsResponse"}},"allNonReturnable":{"type":"boolean"},"vbankPaymentPending":{"type":"boolean"},"allEcoupon":{"type":"boolean"},"upGoodsImg":{"type":"object","additionalProperties":{"type":"string"},"writeOnly":true}},"description":"클레임 처리대상 응답 DTO"},"ClaimTargetGoodsResponse":{"required":["claimMgrpCd"],"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호"},"deliProcTypCd":{"type":"string","description":"PR008(배송처리유형코드)\n 10: CNTR_DLV(센터배송)\n,20: CORP_DLV(업체배송)\n,30: E_COUPON_DLV(e-쿠폰배송)\n","enum":["CNTR_DLV","CORP_DLV","E_COUPON_DLV"]},"deliPolcNo":{"type":"string","description":"배송정책번호"},"deliNo":{"type":"string","description":"배송번호"},"entrNo":{"type":"string","description":"협력사번호"},"ordQty":{"type":"integer","description":"주문수량","format":"int32"},"salePrc":{"type":"integer","description":"판매가","format":"int64"},"dcAmt":{"type":"integer","description":"할인가","format":"int64"},"sysModDtm":{"type":"string","description":"시스템수정일시","format":"date-time"},"ordNo":{"type":"string","description":"주문번호"},"ordSeq":{"type":"integer","description":"주문순번","format":"int32"},"ordProcSeq":{"type":"integer","description":"주문처리순번","format":"int32"},"uprOrdProcSeq":{"type":"integer","description":"상위주문처리순번","format":"int32"},"maxOrdProcSeq":{"type":"integer","description":"최대주문처리순번","format":"int32"},"claimNo":{"type":"string","description":"클레임번호"},"itmNo":{"type":"string","description":"단품번호"},"ordDtlGbCd":{"type":"string","description":"OM003(주문내역구분코드)\n 10: 주문일반\n , 11: 주문취소\n , 20: 반품일반\n , 21: 반품취소\n , 30: 교환주문\n , 31: 교환취소\n , 40: 교환반품\n","enum":["ORDER_GENERAL","ORDER_CANCEL","RETURN_GENERAL","RETURN_WITHDRAWAL","EXCHANGE_ORDER","EXCHANGE_WITHDRAWAL","EXCHANGE_RETURN"]},"ordDtlGbCdNm":{"type":"string","description":"주문내역구분코드명"},"ordDtlStatCd":{"type":"string","description":"OM005(주문내역상태코드)\n 10: REPAY_REQ(재결제요청)\n,11: ORDER_ACCEPT(주문접수)\n,12: ORDER_COMPLETE(주문완료)\n,13: ORDER_CANCEL(주문취소)\n,21: DELIVERY_ORDER(배송지시)\n,22: SHIPPING_ORDER(출고지시)\n,23: SHIPPING_WAIT(출고대기)\n,25: SHIPPING_CONFIRM(출고확정)\n,26: SHIPPING_FINISH(출고완료)\n,27: DELIVERY_FINISH(배송완료)\n,31: RETURN_APPLY(결제대기)\n,32: RETURN_ACCEPT(반품접수)\n,33: RETURN_CANCEL(반품취소)\n,34: WITHDRAWAL_ORDER(회수지시)\n,35: WITHDRAWAL_CONFIRM(회수확인)\n,36: WITHDRAWAL_FINISH(회수완료)\n,37: RETURN_FINISH(반품완료)\n","enum":["REPAY_REQ","ORDER_ACCEPT","ORDER_COMPLETE","ORDER_CANCEL","DELIVERY_ORDER","SHIPPING_ORDER","SHIPPING_WAIT","SHIPPING_CONFIRM","SHIPPING_FINISH","DELIVERY_FINISH","PARTIAL_SHIPPING","RETURN_APPLY","RETURN_ACCEPT","RETURN_CANCEL","WITHDRAWAL_ORDER","WITHDRAWAL_CONFIRM","WITHDRAWAL_FINISH","RETURN_FINISH"]},"ordDtlStatCdNm":{"type":"string","description":"주문내역상태코드명"},"deliGbCd":{"type":"string","description":"        LO001(배송구분코드)\n        * 10 : 출하\n        * 20 : 회수\n","enum":["SHIPPING","WITHDRAWAL"]},"ordAccpDtm":{"type":"string","description":"주문접수일시","format":"date-time"},"ordFnshDtm":{"type":"string","description":"주문완료일시","format":"date-time"},"cnclQty":{"type":"integer","description":"취소수량","format":"int32"},"rtnQty":{"type":"integer","description":"반품수량","format":"int32"},"claimQty":{"type":"integer","description":"클레임수량","format":"int32"},"claimPossibleQty":{"type":"integer","description":"클레임가능수량","format":"int32"},"deliIndiDtm":{"type":"string","description":"배송지시일시","format":"date-time"},"deliIndiRsvDtm":{"type":"string","description":"배송지시예약일시","format":"date-time"},"exchMidRtnYn":{"type":"string","description":"교환중반품여부","enum":["Y","N"]},"rtnPsbYn":{"type":"string","description":"반품가능여부","enum":["Y","N"]},"exchPsbYn":{"type":"string","description":"교환가능여부","enum":["Y","N"]},"ordCnclPsbYn":{"type":"string","description":"취소가능여부","enum":["Y","N"]},"wthdYn":{"type":"string","description":"회수여부","enum":["Y","N"]},"ecpnNo":{"type":"string","description":"e쿠폰번호"},"etcktNo":{"type":"string","description":"e티켓번호"},"claimLgrpCd":{"type":"string","description":"OM047(클레임대분류코드)\n 10: 단순변심\n , 20: 상품불량\n , 30: 배송불만\n , 40: 상품정보오류\n , 50: 재결제주문\n","enum":["SIMPLE_CHANGE","GOODS_BAD","DELIVERY_CLAIM","GOODS_INFOMATION_ERROR","REPAYMENT_ORDER"]},"claimLgrpCdNm":{"type":"string","description":"클레임대분류코드명"},"claimMgrpCd":{"type":"string","description":"OM006(클레임중분류코드)\n 100: 배송이 늦어짐\n , 101: 상품이 품절됨\n , 102: 옵션/사이즈 변경/취소\n , 103: 다른 곳보다 비쌈\n , 104: 쿠폰/할인혜택 변경\n , 105: 구매의사 없어짐\n , 106: 사은품 변경/취소\n , 107: 결제수단 변경(구매사은 적용/카드변경 등)\n , 108: 유사상품 구매\n , 109: 상품정보 미흡\n , 110: 판매자 취소(판매자)\n , 111: 직권 취소(상담사)\n , 112: 자동 취소(결제부족)\n , 113: 자동 취소(결품취소)\n , 300: 사이즈가 큼\n , 301: 사이즈가 작음\n , 302: 단순변심 색상변경\n , 303: 오염\n , 304: 파손(울트임 등)\n , 305: 구성품 누락(목걸이, 벨트 등)\n , 306: 내용물 불량(화장품 등)\n , 307: 상품 오배송\n , 308: 기타\n , 200: 다른상품 주문\n , 201: 사이즈가 큼\n , 203: 사이즈가 작음\n , 204: 상품이미지 상이(컬러, 디자인, 핏)\n , 205: 구매의사가 사라짐\n , 206: 색상 또는 사이즈 교환기능이 없어서\n , 207: 기타\n , 208: 오염\n , 209: 파손(울트임 등)\n , 210: 구성품 누락(목걸이, 벨트 등)\n , 211: 내용물 불량(화장품 등)\n , 212: 기타\n , 213: 사이즈 오배송\n , 214: 컬러 오배송\n , 215: 상품 오배송\n , 216: 배송지연\n , 217: 기타\n , 218: 실측 사이즈 오류\n , 219: 소재 오류\n , 220: 색상 오류\n , 221: 상품 설명과 다름(오표기)\n , 222: 기타\n , 223: 반품보류\n , 224: 반품불가\n","enum":["CLAIM_MGRP_CD_100","CLAIM_MGRP_CD_101","CLAIM_MGRP_CD_102","CLAIM_MGRP_CD_103","CLAIM_MGRP_CD_104","CLAIM_MGRP_CD_105","CLAIM_MGRP_CD_106","CLAIM_MGRP_CD_107","CLAIM_MGRP_CD_108","CLAIM_MGRP_CD_109","CLAIM_MGRP_CD_110","CLAIM_MGRP_CD_111","CLAIM_MGRP_CD_112","CLAIM_MGRP_CD_113","CLAIM_MGRP_CD_114","CLAIM_MGRP_CD_300","CLAIM_MGRP_CD_301","CLAIM_MGRP_CD_302","CLAIM_MGRP_CD_303","CLAIM_MGRP_CD_304","CLAIM_MGRP_CD_305","CLAIM_MGRP_CD_306","CLAIM_MGRP_CD_307","CLAIM_MGRP_CD_308","CLAIM_MGRP_CD_200","CLAIM_MGRP_CD_201","CLAIM_MGRP_CD_203","CLAIM_MGRP_CD_204","CLAIM_MGRP_CD_205","CLAIM_MGRP_CD_206","CLAIM_MGRP_CD_207","CLAIM_MGRP_CD_208","CLAIM_MGRP_CD_209","CLAIM_MGRP_CD_210","CLAIM_MGRP_CD_211","CLAIM_MGRP_CD_212","CLAIM_MGRP_CD_213","CLAIM_MGRP_CD_214","CLAIM_MGRP_CD_215","CLAIM_MGRP_CD_216","CLAIM_MGRP_CD_217","CLAIM_MGRP_CD_218","CLAIM_MGRP_CD_219","CLAIM_MGRP_CD_220","CLAIM_MGRP_CD_221","CLAIM_MGRP_CD_222","CLAIM_MGRP_CD_223","CLAIM_MGRP_CD_224"]},"claimMgrpCdNm":{"type":"string","description":"클레임중분류코드명"},"claimCausEtcCont":{"type":"string","description":"클레임사유기타내용"},"ordSaleTypCd":{"type":"string","description":"OM004(주문판매유형코드)\n 10: 일반판매\n , 20: 주문사은품\n , 30: 상품사은품\n","enum":["GENERAL_SALES","ORDER_FREE_GIFT","GOODS_FREE_GIFT"]},"chlNo":{"type":"string","description":"채널번호"},"chlDtlNo":{"type":"string","description":"채널상세번호"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"infDispCtgNoGbCd":{"type":"string","description":"OM041(유입전시카테고리번호구분코드)\n 01: DISPLAY_STORE(전시매장)\n,02: EXHIBITIONS(기획전)\n,06: SEARCH_SALES(검색매출)\n,07: SEARCH_AD_BANNER(검색광고배너)\n,08: FLOATING_BANNER(플로팅배너)\n,09: WISHLIST(위시리스트)\n,10: NONE(유입전시번호없음)\n","enum":["DISPLAY_STORE","EXHIBITIONS","SEARCH_SALES","SEARCH_AD_BANNER","FLOATING_BANNER","WISHLIST","NONE"]},"infDispCtgNo":{"type":"string","description":"유입전시카테고리번호"},"repDispCtgNo":{"type":"string","description":"대표전시카테고리번호"},"conrNo":{"type":"string","description":"코너번호"},"brandNo":{"type":"string","description":"브랜드번호"},"brandNm":{"type":"string","description":"브랜드명"},"goodsNm":{"type":"string","description":"상품명"},"goodsImg":{"type":"string","description":"상품이미지경로"},"itmNm":{"type":"string","description":"단품명"},"prestNm":{"type":"string","description":"증정품명"},"goodsCompCd":{"type":"string","description":"PR001(상품구성코드)\n 10: GEN_GOODS(일반상품)\n,20: PKG_GOODS(묶음상품)\n","enum":["GEN_GOODS","PKG_GOODS"]},"goodsTypCd":{"type":"string","description":"PR002(상품유형코드)\n 10: GEN_GOODS(일반상품)\n,20: GFT_GOODS(사은품)\n,30: CPN_GOODS(e-쿠폰상품)\n","enum":["GEN_GOODS","GFT_GOODS","CPN_GOODS"]},"saleMethCd":{"type":"string","description":"PR003(판매방식코드)\n 10: NORMAL_SALE(일반판매)\n,20: RSV_SALE(예약상품)\n","enum":["NORMAL_SALE","RSV_SALE"]},"taxGbCd":{"type":"string","description":"과면세구분코드(PR007)"},"buyTypCd":{"type":"string","description":"매입형태코드(PR006)"},"supPcost":{"type":"integer","description":"공급원가","format":"int64"},"norPrc":{"type":"integer","description":"정상가","format":"int64"},"mrgnRate":{"type":"integer","description":"마진율","format":"int64"},"deliDday":{"type":"integer","description":"배송기일","format":"int64"},"deliGoodsGbCd":{"type":"string","description":"PR010(배송상품구분코드)\n 01: GEN_GOODS(일반상품)\n,02: INST_GOODS(설치상품)\n,03: ORDMK_GOODS(주문제작)\n,04: E_COUPON(e-쿠폰)\n","enum":["GEN_GOODS","INST_GOODS","ORDMK_GOODS","E_COUPON"]},"deliWayCd":{"type":"string","description":"PR009(배송수단코드)\n 01: COURIER_DELIVERY(택배배송)\n,02: NON_DELIVERY(무배송)\n","enum":["COURIER_DELIVERY","NON_DELIVERY"]},"bpckPsbYn":{"type":"string","description":"합포장가능여부","enum":["Y","N"]},"hsCd":{"type":"string","description":"HS코드"},"goodsRevWrtYn":{"type":"string","description":"상품리뷰작성여부","enum":["Y","N"]},"bnfAmt":{"type":"integer","description":"혜택금액","format":"int64"},"ordPrc":{"type":"integer","description":"주문금액","format":"int64"},"aeGoodsYn":{"type":"string","description":"사은품여부","enum":["Y","N"]},"withdrawalDeliNo":{"type":"string","description":"회수지배송번호"},"shipmentDeliNo":{"type":"string","description":"배송지배송번호"},"deliTypCd":{"type":"string","description":"        LO002(배송유형코드)\n        * 10 : 정상출하\n        * 11 : 교환출하\n        * 20 : 반품회수\n        * 21 : 교환회수\n","enum":["NORMAL_SHIPPING","EXCHANGE_SHIPPING","RETURN_RECOVERY","EXCHANGE_RECOVERY"]},"deliKindCd":{"type":"string","description":"LO009(배송종류코드)\n 10: NORMAL_DELIVERY(일반배송)\n,20: RESERVATION_DELIVERY(예약배송)\n","enum":["NORMAL_DELIVERY","RESERVATION_DELIVERY"]},"deliMethodCd":{"type":"string","description":"        LO010(배송방법코드)\n        * 10 : 택배배송\n        * 30 : 매장수령\n        * 40 : 퀵배송\n        * 50 : 해외배송\n        * 60 : 무배송\n","enum":["COURIER_DELIVERY","FOUR_PM","STORE_PICK_UP","QUICK_DELIVERY","OVERSEAS_DELIVERY","NON_DELIVERY"]},"deliProcTypCdNm":{"type":"string","description":"배송처리유형코드명"},"puTypCd":{"type":"string","description":"        LO006(수거유형코드)\n        * 20 : 회수\n        * 30 : 회수불필요\n","enum":["SHIPPING","WITHDRAWAL","WITHDRAWAL_NOT_REQUIRED"]},"wthdFnshGbCd":{"type":"string","description":"회수완료구분코드","enum":["NORMAL_RETURN","BAD_RETURN","COURIER_LOSE","RETURN_TRANSFORM"]},"dlvpNm":{"type":"string","description":"배송지명"},"rcvmnNm":{"type":"string","description":"수취인명"},"dlvpSeq":{"type":"string","description":"배송지순번"},"maxDlvpSeq":{"type":"string","description":"최대배송지순번"},"zipNo":{"type":"string","description":"우편번호"},"zipAddr":{"type":"string","description":"우편주소"},"dtlAddr":{"type":"string","description":"상세주소"},"rcvmnEmailAddr":{"type":"string","description":"수취인이메일주소"},"rcvmnCellSctNo":{"type":"string","description":"수취인휴대폰구분번호"},"rcvmnCellTxnoNo":{"type":"string","description":"수취인휴대폰국번번호"},"rcvmnCellEndNo":{"type":"string","description":"수취인휴대폰끝번호"},"rcvmnTelRgnNo":{"type":"string","description":"수취인전화지역번호"},"rcvmnTelTxnoNo":{"type":"string","description":"수취인전화국번번호"},"rcvmnTelEndNo":{"type":"string","description":"수취인전화끝번호"},"deliMsg":{"type":"string","description":"배송메시지"},"deliMsgCd":{"type":"string","description":"배송메시지코드(ME039)"},"shopTrafMsg":{"type":"string","description":"매장전달메시지"},"comnFrdrCogoMethodCd":{"type":"string","description":"공동현관출입방법코드(ME040)"},"comnFrdrEtcMethod":{"type":"string","description":"공동현관기타방법"},"comnFrdrPwd":{"type":"string","description":"공동현관비밀번호"},"orgDlvpInfo":{"$ref":"#/components/schemas/ClaimDlvp"},"orgDeliNo":{"type":"string","description":"원배송번호"},"lastDeliResponse":{"$ref":"#/components/schemas/ClaimTargetGoodsDeliResponse"},"shippingDeliGbCd":{"type":"boolean"},"opOrdDtlUpdateKey":{"$ref":"#/components/schemas/OpOrdDtl"},"generalSalesProduct":{"type":"boolean"},"exchangeShipping":{"type":"boolean"},"withdrawalDeliGbCd":{"type":"boolean"},"withdrawShipping":{"type":"boolean"},"ordSeqAndUprOrdProcSeq":{"type":"string"},"goodsNoAndItmNo":{"type":"string"},"ordSeqAndOrdProcSeq":{"type":"string"}},"description":"클레임 처리대상 상품 응답 DTO"},"ClaimDlvp":{"required":["dlvpNm","dtlAddr","rcvmnNm","zipAddr","zipNo"],"type":"object","properties":{"mbrOrdDlvpGb":{"type":"string","description":"        ClaimDlvpGbCd(클레임배송지유형)\n        * 10 : 회원배송지\n        * 20 : 주문배송지\n","enum":["MBR","ORD"]},"dlvpSeq":{"type":"string","description":"배송지순번"},"zipNoSeq":{"type":"integer","description":"우편번호 순번","format":"int64"},"dlvpNm":{"type":"string","description":"배송지명"},"rcvmnNm":{"type":"string","description":"수취인명"},"zipNo":{"type":"string","description":"우편번호"},"zipAddr":{"type":"string","description":"우편주소"},"dtlAddr":{"type":"string","description":"상세주소"},"rcvmnEmailAddr":{"type":"string","description":"수취인이메일주소"},"rcvmnCellSctNo":{"type":"string","description":"수취인휴대폰구분번호"},"rcvmnCellTxnoNo":{"type":"string","description":"수취인휴대폰국번번호"},"rcvmnCellEndNo":{"type":"string","description":"수취인휴대폰국번번호"},"rcvmnTelRgnNo":{"type":"string","description":"수취인전화지역번호"},"rcvmnTelTxnoNo":{"type":"string","description":"수취인전화국번번호"},"rcvmnTelEndNo":{"type":"string","description":"수취인전화끝번호"},"deliMsg":{"type":"string","description":"배송메시지"},"deliMsgCd":{"type":"string","description":"배송메시지코드(ME039) 20:배송 전 연락 바랍니다, 30:부재 시 문 앞에 놓아주세요, 40:부재 시 경비실에 맡겨주세요, 50:빠른 배송 부탁 드립니다, 60:부재 시 핸드폰으로 연락바랍니다, 70:직접입력"},"shopTrafMsg":{"type":"string","description":"매장전달메시지"},"comnFrdrCogoMethodCd":{"type":"string","description":"공동현관출입방법코드(ME040) 10:공동현관 출입번호, 20:자유 출입 가능, 30:기타","default":"20"},"comnFrdrEtcMethod":{"type":"string","description":"공동현관기타방법"},"comnFrdrPwd":{"type":"string","description":"공동현관비밀번호"}},"description":"클레임 배송 정보 DTO"},"ClaimTargetGoodsDeliResponse":{"type":"object","properties":{"ordNo":{"type":"string"},"deliNo":{"type":"string"},"ordSeq":{"type":"string"},"ordProcSeq":{"type":"string"},"shipIndiDtm":{"type":"string","format":"date-time"},"shipCfmDtm":{"type":"string","format":"date-time"},"shipFnshDtm":{"type":"string","format":"date-time"},"deliFnshDtm":{"type":"string","format":"date-time"},"hdcCd":{"type":"string"},"invNo":{"type":"string"},"deliDtlStatCd":{"type":"string"}},"description":"클레임 처리대상 배송 정보 응답 DTO"},"OpOrdDtl":{"type":"object","properties":{"ordNo":{"type":"string"},"ordSeq":{"type":"integer","format":"int32"},"ordProcSeq":{"type":"integer","format":"int32"},"uprOrdProcSeq":{"type":"integer","format":"int32"},"claimNo":{"type":"string"},"goodsNo":{"type":"string"},"itmNo":{"type":"string"},"ordDtlGbCd":{"type":"string"},"deliGbCd":{"type":"string"},"ordAccpDtm":{"type":"string","format":"date-time"},"ordFnshDtm":{"type":"string","format":"date-time"},"ordDtlStatCd":{"type":"string"},"ordQty":{"type":"integer","format":"int32"},"cnclQty":{"type":"integer","format":"int32"},"rtnQty":{"type":"integer","format":"int32"},"deliIndiDtm":{"type":"string","format":"date-time"},"deliIndiRsvDtm":{"type":"string","format":"date-time"},"deliNo":{"type":"string"},"exchMidRtnYn":{"type":"string"},"claimLgrpCd":{"type":"string"},"claimMgrpCd":{"type":"string"},"claimCausEtcCont":{"type":"string"},"rtnPsbYn":{"type":"string"},"exchPsbYn":{"type":"string"},"ordCnclPsbYn":{"type":"string"},"wthdYn":{"type":"string"},"wthdFnshGbCd":{"type":"string"},"shipFnshFcstDtm":{"type":"string","format":"date-time"},"etcktNo":{"type":"string"},"ecpnNo":{"type":"string"}},"description":"주문상세 목록"},"StCdDtlResponse":{"type":"object","properties":{"cd":{"type":"string","description":"코드"},"cdNm":{"type":"string","description":"코드명"},"cdDesc":{"type":"string","description":"코드설명"},"sortSeq":{"type":"string","description":"정렬순서"},"ref1Val":{"type":"string","description":"참조1값"},"ref2Val":{"type":"string","description":"참조2값"},"ref3Val":{"type":"string","description":"참조3값"},"ref4Val":{"type":"string","description":"참조4값"},"ref5Val":{"type":"string","description":"참조5값"},"ref6Val":{"type":"string","description":"참조6값"},"ref7Val":{"type":"string","description":"참조7값"}},"description":"공통코드 응답 DTO"},"Response":{"type":"object","properties":{"timestamp":{"type":"string","description":"result time","format":"date-time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","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"}},"description":"validation error list"}}}}
```

## 주문 취소 대상 조회(FO)

> \## 기능설명\
> \* 주문 내역과 취소 가능 상품 목록, 화면 처리 시 필요한 기타 정보를 조회합니다.\
> \---\
> \## 상세설명\
> \* \*\*주문번호(ordNo), 클레임업무유형(claimBusinessType), 시스템유형(systemType)\*\*은 필수 파라미터입니다.\
> \* 다음의 조건을 모두 충족하는 대상에 대해 주문취소 처리가 가능합니다.\
> &#x20;   \* 주문내역구분(OM003) 값이 \*\*주문일반(10)\*\*인 경우\
> &#x20;   \* 주문내역상태(OM005) 값이 \*\*주문완료(12)\*\* 이거나 \*\*배송지시(21)\*\* 이거나 \*\*출고지시(22)\*\* 이거나 \*\*출고대기(23)\*\* 인 경우\
> &#x20;   \* 일반상품인 경우(사은품 제외)\
> &#x20;   \* 취소 가능 수량이 1개 이상인 경우( \*\*주문수량 – 취소수량 – 반품수량 > 0\*\* )\
> &#x20;   \* 주문 취소 가능 여부가 'Y'인 경우\
> \* 기타 정보에 포함된 사항은 아래와 같습니다.\
> &#x20;   \* 주문취소 중분류 사유 List\
> &#x20;   \* 귀책사유 코드를 Key로 하고 주문취소 중분류 사유를 Value로 하는 Map\
> \---\
> \## 수정번호\
> \* release\_231204\_01 : Request DTO 배송지순번(dlvpSeq) 추가, 대상 조회시 배송지 순번 값이 있는경우 필터링 추가 실행\
> \* Release v2.00\_240729 : 주문 취소 가능 여부(ordCnclPsbYn)값이 "N"인 경우 대상 제외<br>

```json
{"openapi":"3.0.1","info":{"title":"X2BEE Order API","version":"v1"},"servers":[{"url":"https://api-order.x2bee.com/api/order/","description":"prd"}],"paths":{"/v1/claim/orderCancel/cancelPopupFO":{"post":{"tags":["주문취소"],"summary":"주문 취소 대상 조회(FO)","description":"## 기능설명\n* 주문 내역과 취소 가능 상품 목록, 화면 처리 시 필요한 기타 정보를 조회합니다.\n---\n## 상세설명\n* **주문번호(ordNo), 클레임업무유형(claimBusinessType), 시스템유형(systemType)**은 필수 파라미터입니다.\n* 다음의 조건을 모두 충족하는 대상에 대해 주문취소 처리가 가능합니다.\n    * 주문내역구분(OM003) 값이 **주문일반(10)**인 경우\n    * 주문내역상태(OM005) 값이 **주문완료(12)** 이거나 **배송지시(21)** 이거나 **출고지시(22)** 이거나 **출고대기(23)** 인 경우\n    * 일반상품인 경우(사은품 제외)\n    * 취소 가능 수량이 1개 이상인 경우( **주문수량 – 취소수량 – 반품수량 > 0** )\n    * 주문 취소 가능 여부가 'Y'인 경우\n* 기타 정보에 포함된 사항은 아래와 같습니다.\n    * 주문취소 중분류 사유 List\n    * 귀책사유 코드를 Key로 하고 주문취소 중분류 사유를 Value로 하는 Map\n---\n## 수정번호\n* release_231204_01 : Request DTO 배송지순번(dlvpSeq) 추가, 대상 조회시 배송지 순번 값이 있는경우 필터링 추가 실행\n* Release v2.00_240729 : 주문 취소 가능 여부(ordCnclPsbYn)값이 \"N\"인 경우 대상 제외\n","operationId":"getOrderCancelPopupInfoFO","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimTargetRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OrderCancelPopupResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"ClaimTargetRequest":{"required":["ordNo","systemType"],"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"claimBusinessType":{"type":"string","description":"        ClaimBusiness(클레임업무유형)\n        * 11 : 주문취소\n        * 20 : 반품접수\n        * 21 : 반품취소\n        * 30 : 교환접수\n        * 31 : 교환취소\n        * 22 : 반품완료\n        * 23 : 반품불가\n        * 24 : 교환반품\n        * 25 : 반품보류\n","enum":["ORDER_CANCEL","RETURN_ACCEPT","RETURN_WITHDRAWAL","EXCHANGE_ACCEPT","EXCHANGE_WITHDRAWAL","RETURN_COMPLETE","RETURN_REJECT","RETURN_TRANSFORM","RETURN_PENDING","DELIVERY_FEE_PAYMENT"]},"orgClmNo":{"type":"string","description":"원클레임 번호"},"systemType":{"type":"string","description":"        SYSTEM(시스템유형)\n        * 10 : FO\n        * 20 : BO\n","enum":["FO","BO"],"default":"20"},"dlvpSeq":{"type":"string","description":"배송지순번"},"systemCdNmAndButtonCode":{"type":"string"},"claimBusiness":{"type":"string","description":"        ClaimBusiness(클레임업무유형)\n        * 11 : 주문취소\n        * 20 : 반품접수\n        * 21 : 반품취소\n        * 30 : 교환접수\n        * 31 : 교환취소\n        * 22 : 반품완료\n        * 23 : 반품불가\n        * 24 : 교환반품\n        * 25 : 반품보류\n","enum":["ORDER_CANCEL","RETURN_ACCEPT","RETURN_WITHDRAWAL","EXCHANGE_ACCEPT","EXCHANGE_WITHDRAWAL","RETURN_COMPLETE","RETURN_REJECT","RETURN_TRANSFORM","RETURN_PENDING","DELIVERY_FEE_PAYMENT"]},"system":{"type":"string","description":"        SYSTEM(시스템유형)\n        * 10 : FO\n        * 20 : BO\n","enum":["FO","BO"]}},"description":"클레임 가능 대상 조회 요청 DTO"},"OrderCancelPopupResponse":{"type":"object","properties":{"claimTargetResponse":{"$ref":"#/components/schemas/ClaimTargetResponse"},"claimCausCdList":{"type":"array","description":"클레임 대분류 사유","items":{"$ref":"#/components/schemas/StCdDtlResponse"}},"claimMgrpRspnGbCdMap":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/StCdDtlResponse"},"description":"귀책구분코드의 코드를 Key로 하는 클레임 중분류 사유 Map"}},"description":"클레임 가능 대상 조회 응답 DTO"},"ClaimTargetResponse":{"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"mbrNo":{"type":"string","description":"회원번호"},"mbrGradeCd":{"type":"string","description":"회원등급코드(ME008)\n 10 : GREEN\n, 20 : FAMILY\n, 30 : GOLD\n, 40 : VIP\n, 50 : VVIP\n","enum":["10","20","30","40","50"]},"ordGbCd":{"type":"string","description":"OM002(주문 구분 코드)\n 10: 일반주문\n , 20: 선물하기\n , 30: e-쿠폰\n , 40: 제휴\n","enum":["GENERAL_ORDER","GIVE_GIFT_ORDER","E_COUPON","SUBSCRIBE_ORDER"]},"mbrMgrCd":{"type":"string","description":"ME002(회원관리코드)\n 10: UNION_MEMBER(통합회원)\n,20: GENERAL_MEMBER(일반회원)\n,30: SOCIAL_MEMBER(소셜회원)\n,99: NO_MEMBER(비회원)\n","enum":["UNION_MEMBER","GENERAL_MEMBER","SOCIAL_MEMBER","ENTERPRISE_MEMBER","NO_MEMBER"]},"ordManNm":{"type":"string","description":"주문자명"},"ordManEmailAddr":{"type":"string","description":"주문자이메일주소"},"ordManCellSctNo":{"type":"string","description":"주문자휴대폰구분번호"},"ordManCellTxnoNo":{"type":"string","description":"주문자휴대폰국번번호"},"ordManCellEndNo":{"type":"string","description":"주문자휴대폰끝번호"},"ordMediaCd":{"type":"string","description":"주문매체 코드(OM007)\n 10 : 전화상담(CC)\n, 20 : PC\n, 30 : 모바일웹\n, 40 : 안드로이드앱\n, 50 : IOS앱\n, 60 : 정기주문\n","enum":["10","20","30","40","50","60"]},"ordAccpDtm":{"type":"string","description":"주문접수일자","format":"date-time"},"sctnCnclPsbYn":{"type":"string","description":"부분취소가능여부","enum":["Y","N"]},"claimTargetGoodsResponseList":{"type":"array","description":"클레임 대상 상품 목록","items":{"$ref":"#/components/schemas/ClaimTargetGoodsResponse"}},"allNonReturnable":{"type":"boolean"},"vbankPaymentPending":{"type":"boolean"},"allEcoupon":{"type":"boolean"},"upGoodsImg":{"type":"object","additionalProperties":{"type":"string"},"writeOnly":true}},"description":"클레임 처리대상 응답 DTO"},"ClaimTargetGoodsResponse":{"required":["claimMgrpCd"],"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호"},"deliProcTypCd":{"type":"string","description":"PR008(배송처리유형코드)\n 10: CNTR_DLV(센터배송)\n,20: CORP_DLV(업체배송)\n,30: E_COUPON_DLV(e-쿠폰배송)\n","enum":["CNTR_DLV","CORP_DLV","E_COUPON_DLV"]},"deliPolcNo":{"type":"string","description":"배송정책번호"},"deliNo":{"type":"string","description":"배송번호"},"entrNo":{"type":"string","description":"협력사번호"},"ordQty":{"type":"integer","description":"주문수량","format":"int32"},"salePrc":{"type":"integer","description":"판매가","format":"int64"},"dcAmt":{"type":"integer","description":"할인가","format":"int64"},"sysModDtm":{"type":"string","description":"시스템수정일시","format":"date-time"},"ordNo":{"type":"string","description":"주문번호"},"ordSeq":{"type":"integer","description":"주문순번","format":"int32"},"ordProcSeq":{"type":"integer","description":"주문처리순번","format":"int32"},"uprOrdProcSeq":{"type":"integer","description":"상위주문처리순번","format":"int32"},"maxOrdProcSeq":{"type":"integer","description":"최대주문처리순번","format":"int32"},"claimNo":{"type":"string","description":"클레임번호"},"itmNo":{"type":"string","description":"단품번호"},"ordDtlGbCd":{"type":"string","description":"OM003(주문내역구분코드)\n 10: 주문일반\n , 11: 주문취소\n , 20: 반품일반\n , 21: 반품취소\n , 30: 교환주문\n , 31: 교환취소\n , 40: 교환반품\n","enum":["ORDER_GENERAL","ORDER_CANCEL","RETURN_GENERAL","RETURN_WITHDRAWAL","EXCHANGE_ORDER","EXCHANGE_WITHDRAWAL","EXCHANGE_RETURN"]},"ordDtlGbCdNm":{"type":"string","description":"주문내역구분코드명"},"ordDtlStatCd":{"type":"string","description":"OM005(주문내역상태코드)\n 10: REPAY_REQ(재결제요청)\n,11: ORDER_ACCEPT(주문접수)\n,12: ORDER_COMPLETE(주문완료)\n,13: ORDER_CANCEL(주문취소)\n,21: DELIVERY_ORDER(배송지시)\n,22: SHIPPING_ORDER(출고지시)\n,23: SHIPPING_WAIT(출고대기)\n,25: SHIPPING_CONFIRM(출고확정)\n,26: SHIPPING_FINISH(출고완료)\n,27: DELIVERY_FINISH(배송완료)\n,31: RETURN_APPLY(결제대기)\n,32: RETURN_ACCEPT(반품접수)\n,33: RETURN_CANCEL(반품취소)\n,34: WITHDRAWAL_ORDER(회수지시)\n,35: WITHDRAWAL_CONFIRM(회수확인)\n,36: WITHDRAWAL_FINISH(회수완료)\n,37: RETURN_FINISH(반품완료)\n","enum":["REPAY_REQ","ORDER_ACCEPT","ORDER_COMPLETE","ORDER_CANCEL","DELIVERY_ORDER","SHIPPING_ORDER","SHIPPING_WAIT","SHIPPING_CONFIRM","SHIPPING_FINISH","DELIVERY_FINISH","PARTIAL_SHIPPING","RETURN_APPLY","RETURN_ACCEPT","RETURN_CANCEL","WITHDRAWAL_ORDER","WITHDRAWAL_CONFIRM","WITHDRAWAL_FINISH","RETURN_FINISH"]},"ordDtlStatCdNm":{"type":"string","description":"주문내역상태코드명"},"deliGbCd":{"type":"string","description":"        LO001(배송구분코드)\n        * 10 : 출하\n        * 20 : 회수\n","enum":["SHIPPING","WITHDRAWAL"]},"ordAccpDtm":{"type":"string","description":"주문접수일시","format":"date-time"},"ordFnshDtm":{"type":"string","description":"주문완료일시","format":"date-time"},"cnclQty":{"type":"integer","description":"취소수량","format":"int32"},"rtnQty":{"type":"integer","description":"반품수량","format":"int32"},"claimQty":{"type":"integer","description":"클레임수량","format":"int32"},"claimPossibleQty":{"type":"integer","description":"클레임가능수량","format":"int32"},"deliIndiDtm":{"type":"string","description":"배송지시일시","format":"date-time"},"deliIndiRsvDtm":{"type":"string","description":"배송지시예약일시","format":"date-time"},"exchMidRtnYn":{"type":"string","description":"교환중반품여부","enum":["Y","N"]},"rtnPsbYn":{"type":"string","description":"반품가능여부","enum":["Y","N"]},"exchPsbYn":{"type":"string","description":"교환가능여부","enum":["Y","N"]},"ordCnclPsbYn":{"type":"string","description":"취소가능여부","enum":["Y","N"]},"wthdYn":{"type":"string","description":"회수여부","enum":["Y","N"]},"ecpnNo":{"type":"string","description":"e쿠폰번호"},"etcktNo":{"type":"string","description":"e티켓번호"},"claimLgrpCd":{"type":"string","description":"OM047(클레임대분류코드)\n 10: 단순변심\n , 20: 상품불량\n , 30: 배송불만\n , 40: 상품정보오류\n , 50: 재결제주문\n","enum":["SIMPLE_CHANGE","GOODS_BAD","DELIVERY_CLAIM","GOODS_INFOMATION_ERROR","REPAYMENT_ORDER"]},"claimLgrpCdNm":{"type":"string","description":"클레임대분류코드명"},"claimMgrpCd":{"type":"string","description":"OM006(클레임중분류코드)\n 100: 배송이 늦어짐\n , 101: 상품이 품절됨\n , 102: 옵션/사이즈 변경/취소\n , 103: 다른 곳보다 비쌈\n , 104: 쿠폰/할인혜택 변경\n , 105: 구매의사 없어짐\n , 106: 사은품 변경/취소\n , 107: 결제수단 변경(구매사은 적용/카드변경 등)\n , 108: 유사상품 구매\n , 109: 상품정보 미흡\n , 110: 판매자 취소(판매자)\n , 111: 직권 취소(상담사)\n , 112: 자동 취소(결제부족)\n , 113: 자동 취소(결품취소)\n , 300: 사이즈가 큼\n , 301: 사이즈가 작음\n , 302: 단순변심 색상변경\n , 303: 오염\n , 304: 파손(울트임 등)\n , 305: 구성품 누락(목걸이, 벨트 등)\n , 306: 내용물 불량(화장품 등)\n , 307: 상품 오배송\n , 308: 기타\n , 200: 다른상품 주문\n , 201: 사이즈가 큼\n , 203: 사이즈가 작음\n , 204: 상품이미지 상이(컬러, 디자인, 핏)\n , 205: 구매의사가 사라짐\n , 206: 색상 또는 사이즈 교환기능이 없어서\n , 207: 기타\n , 208: 오염\n , 209: 파손(울트임 등)\n , 210: 구성품 누락(목걸이, 벨트 등)\n , 211: 내용물 불량(화장품 등)\n , 212: 기타\n , 213: 사이즈 오배송\n , 214: 컬러 오배송\n , 215: 상품 오배송\n , 216: 배송지연\n , 217: 기타\n , 218: 실측 사이즈 오류\n , 219: 소재 오류\n , 220: 색상 오류\n , 221: 상품 설명과 다름(오표기)\n , 222: 기타\n , 223: 반품보류\n , 224: 반품불가\n","enum":["CLAIM_MGRP_CD_100","CLAIM_MGRP_CD_101","CLAIM_MGRP_CD_102","CLAIM_MGRP_CD_103","CLAIM_MGRP_CD_104","CLAIM_MGRP_CD_105","CLAIM_MGRP_CD_106","CLAIM_MGRP_CD_107","CLAIM_MGRP_CD_108","CLAIM_MGRP_CD_109","CLAIM_MGRP_CD_110","CLAIM_MGRP_CD_111","CLAIM_MGRP_CD_112","CLAIM_MGRP_CD_113","CLAIM_MGRP_CD_114","CLAIM_MGRP_CD_300","CLAIM_MGRP_CD_301","CLAIM_MGRP_CD_302","CLAIM_MGRP_CD_303","CLAIM_MGRP_CD_304","CLAIM_MGRP_CD_305","CLAIM_MGRP_CD_306","CLAIM_MGRP_CD_307","CLAIM_MGRP_CD_308","CLAIM_MGRP_CD_200","CLAIM_MGRP_CD_201","CLAIM_MGRP_CD_203","CLAIM_MGRP_CD_204","CLAIM_MGRP_CD_205","CLAIM_MGRP_CD_206","CLAIM_MGRP_CD_207","CLAIM_MGRP_CD_208","CLAIM_MGRP_CD_209","CLAIM_MGRP_CD_210","CLAIM_MGRP_CD_211","CLAIM_MGRP_CD_212","CLAIM_MGRP_CD_213","CLAIM_MGRP_CD_214","CLAIM_MGRP_CD_215","CLAIM_MGRP_CD_216","CLAIM_MGRP_CD_217","CLAIM_MGRP_CD_218","CLAIM_MGRP_CD_219","CLAIM_MGRP_CD_220","CLAIM_MGRP_CD_221","CLAIM_MGRP_CD_222","CLAIM_MGRP_CD_223","CLAIM_MGRP_CD_224"]},"claimMgrpCdNm":{"type":"string","description":"클레임중분류코드명"},"claimCausEtcCont":{"type":"string","description":"클레임사유기타내용"},"ordSaleTypCd":{"type":"string","description":"OM004(주문판매유형코드)\n 10: 일반판매\n , 20: 주문사은품\n , 30: 상품사은품\n","enum":["GENERAL_SALES","ORDER_FREE_GIFT","GOODS_FREE_GIFT"]},"chlNo":{"type":"string","description":"채널번호"},"chlDtlNo":{"type":"string","description":"채널상세번호"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"infDispCtgNoGbCd":{"type":"string","description":"OM041(유입전시카테고리번호구분코드)\n 01: DISPLAY_STORE(전시매장)\n,02: EXHIBITIONS(기획전)\n,06: SEARCH_SALES(검색매출)\n,07: SEARCH_AD_BANNER(검색광고배너)\n,08: FLOATING_BANNER(플로팅배너)\n,09: WISHLIST(위시리스트)\n,10: NONE(유입전시번호없음)\n","enum":["DISPLAY_STORE","EXHIBITIONS","SEARCH_SALES","SEARCH_AD_BANNER","FLOATING_BANNER","WISHLIST","NONE"]},"infDispCtgNo":{"type":"string","description":"유입전시카테고리번호"},"repDispCtgNo":{"type":"string","description":"대표전시카테고리번호"},"conrNo":{"type":"string","description":"코너번호"},"brandNo":{"type":"string","description":"브랜드번호"},"brandNm":{"type":"string","description":"브랜드명"},"goodsNm":{"type":"string","description":"상품명"},"goodsImg":{"type":"string","description":"상품이미지경로"},"itmNm":{"type":"string","description":"단품명"},"prestNm":{"type":"string","description":"증정품명"},"goodsCompCd":{"type":"string","description":"PR001(상품구성코드)\n 10: GEN_GOODS(일반상품)\n,20: PKG_GOODS(묶음상품)\n","enum":["GEN_GOODS","PKG_GOODS"]},"goodsTypCd":{"type":"string","description":"PR002(상품유형코드)\n 10: GEN_GOODS(일반상품)\n,20: GFT_GOODS(사은품)\n,30: CPN_GOODS(e-쿠폰상품)\n","enum":["GEN_GOODS","GFT_GOODS","CPN_GOODS"]},"saleMethCd":{"type":"string","description":"PR003(판매방식코드)\n 10: NORMAL_SALE(일반판매)\n,20: RSV_SALE(예약상품)\n","enum":["NORMAL_SALE","RSV_SALE"]},"taxGbCd":{"type":"string","description":"과면세구분코드(PR007)"},"buyTypCd":{"type":"string","description":"매입형태코드(PR006)"},"supPcost":{"type":"integer","description":"공급원가","format":"int64"},"norPrc":{"type":"integer","description":"정상가","format":"int64"},"mrgnRate":{"type":"integer","description":"마진율","format":"int64"},"deliDday":{"type":"integer","description":"배송기일","format":"int64"},"deliGoodsGbCd":{"type":"string","description":"PR010(배송상품구분코드)\n 01: GEN_GOODS(일반상품)\n,02: INST_GOODS(설치상품)\n,03: ORDMK_GOODS(주문제작)\n,04: E_COUPON(e-쿠폰)\n","enum":["GEN_GOODS","INST_GOODS","ORDMK_GOODS","E_COUPON"]},"deliWayCd":{"type":"string","description":"PR009(배송수단코드)\n 01: COURIER_DELIVERY(택배배송)\n,02: NON_DELIVERY(무배송)\n","enum":["COURIER_DELIVERY","NON_DELIVERY"]},"bpckPsbYn":{"type":"string","description":"합포장가능여부","enum":["Y","N"]},"hsCd":{"type":"string","description":"HS코드"},"goodsRevWrtYn":{"type":"string","description":"상품리뷰작성여부","enum":["Y","N"]},"bnfAmt":{"type":"integer","description":"혜택금액","format":"int64"},"ordPrc":{"type":"integer","description":"주문금액","format":"int64"},"aeGoodsYn":{"type":"string","description":"사은품여부","enum":["Y","N"]},"withdrawalDeliNo":{"type":"string","description":"회수지배송번호"},"shipmentDeliNo":{"type":"string","description":"배송지배송번호"},"deliTypCd":{"type":"string","description":"        LO002(배송유형코드)\n        * 10 : 정상출하\n        * 11 : 교환출하\n        * 20 : 반품회수\n        * 21 : 교환회수\n","enum":["NORMAL_SHIPPING","EXCHANGE_SHIPPING","RETURN_RECOVERY","EXCHANGE_RECOVERY"]},"deliKindCd":{"type":"string","description":"LO009(배송종류코드)\n 10: NORMAL_DELIVERY(일반배송)\n,20: RESERVATION_DELIVERY(예약배송)\n","enum":["NORMAL_DELIVERY","RESERVATION_DELIVERY"]},"deliMethodCd":{"type":"string","description":"        LO010(배송방법코드)\n        * 10 : 택배배송\n        * 30 : 매장수령\n        * 40 : 퀵배송\n        * 50 : 해외배송\n        * 60 : 무배송\n","enum":["COURIER_DELIVERY","FOUR_PM","STORE_PICK_UP","QUICK_DELIVERY","OVERSEAS_DELIVERY","NON_DELIVERY"]},"deliProcTypCdNm":{"type":"string","description":"배송처리유형코드명"},"puTypCd":{"type":"string","description":"        LO006(수거유형코드)\n        * 20 : 회수\n        * 30 : 회수불필요\n","enum":["SHIPPING","WITHDRAWAL","WITHDRAWAL_NOT_REQUIRED"]},"wthdFnshGbCd":{"type":"string","description":"회수완료구분코드","enum":["NORMAL_RETURN","BAD_RETURN","COURIER_LOSE","RETURN_TRANSFORM"]},"dlvpNm":{"type":"string","description":"배송지명"},"rcvmnNm":{"type":"string","description":"수취인명"},"dlvpSeq":{"type":"string","description":"배송지순번"},"maxDlvpSeq":{"type":"string","description":"최대배송지순번"},"zipNo":{"type":"string","description":"우편번호"},"zipAddr":{"type":"string","description":"우편주소"},"dtlAddr":{"type":"string","description":"상세주소"},"rcvmnEmailAddr":{"type":"string","description":"수취인이메일주소"},"rcvmnCellSctNo":{"type":"string","description":"수취인휴대폰구분번호"},"rcvmnCellTxnoNo":{"type":"string","description":"수취인휴대폰국번번호"},"rcvmnCellEndNo":{"type":"string","description":"수취인휴대폰끝번호"},"rcvmnTelRgnNo":{"type":"string","description":"수취인전화지역번호"},"rcvmnTelTxnoNo":{"type":"string","description":"수취인전화국번번호"},"rcvmnTelEndNo":{"type":"string","description":"수취인전화끝번호"},"deliMsg":{"type":"string","description":"배송메시지"},"deliMsgCd":{"type":"string","description":"배송메시지코드(ME039)"},"shopTrafMsg":{"type":"string","description":"매장전달메시지"},"comnFrdrCogoMethodCd":{"type":"string","description":"공동현관출입방법코드(ME040)"},"comnFrdrEtcMethod":{"type":"string","description":"공동현관기타방법"},"comnFrdrPwd":{"type":"string","description":"공동현관비밀번호"},"orgDlvpInfo":{"$ref":"#/components/schemas/ClaimDlvp"},"orgDeliNo":{"type":"string","description":"원배송번호"},"lastDeliResponse":{"$ref":"#/components/schemas/ClaimTargetGoodsDeliResponse"},"shippingDeliGbCd":{"type":"boolean"},"opOrdDtlUpdateKey":{"$ref":"#/components/schemas/OpOrdDtl"},"generalSalesProduct":{"type":"boolean"},"exchangeShipping":{"type":"boolean"},"withdrawalDeliGbCd":{"type":"boolean"},"withdrawShipping":{"type":"boolean"},"ordSeqAndUprOrdProcSeq":{"type":"string"},"goodsNoAndItmNo":{"type":"string"},"ordSeqAndOrdProcSeq":{"type":"string"}},"description":"클레임 처리대상 상품 응답 DTO"},"ClaimDlvp":{"required":["dlvpNm","dtlAddr","rcvmnNm","zipAddr","zipNo"],"type":"object","properties":{"mbrOrdDlvpGb":{"type":"string","description":"        ClaimDlvpGbCd(클레임배송지유형)\n        * 10 : 회원배송지\n        * 20 : 주문배송지\n","enum":["MBR","ORD"]},"dlvpSeq":{"type":"string","description":"배송지순번"},"zipNoSeq":{"type":"integer","description":"우편번호 순번","format":"int64"},"dlvpNm":{"type":"string","description":"배송지명"},"rcvmnNm":{"type":"string","description":"수취인명"},"zipNo":{"type":"string","description":"우편번호"},"zipAddr":{"type":"string","description":"우편주소"},"dtlAddr":{"type":"string","description":"상세주소"},"rcvmnEmailAddr":{"type":"string","description":"수취인이메일주소"},"rcvmnCellSctNo":{"type":"string","description":"수취인휴대폰구분번호"},"rcvmnCellTxnoNo":{"type":"string","description":"수취인휴대폰국번번호"},"rcvmnCellEndNo":{"type":"string","description":"수취인휴대폰국번번호"},"rcvmnTelRgnNo":{"type":"string","description":"수취인전화지역번호"},"rcvmnTelTxnoNo":{"type":"string","description":"수취인전화국번번호"},"rcvmnTelEndNo":{"type":"string","description":"수취인전화끝번호"},"deliMsg":{"type":"string","description":"배송메시지"},"deliMsgCd":{"type":"string","description":"배송메시지코드(ME039) 20:배송 전 연락 바랍니다, 30:부재 시 문 앞에 놓아주세요, 40:부재 시 경비실에 맡겨주세요, 50:빠른 배송 부탁 드립니다, 60:부재 시 핸드폰으로 연락바랍니다, 70:직접입력"},"shopTrafMsg":{"type":"string","description":"매장전달메시지"},"comnFrdrCogoMethodCd":{"type":"string","description":"공동현관출입방법코드(ME040) 10:공동현관 출입번호, 20:자유 출입 가능, 30:기타","default":"20"},"comnFrdrEtcMethod":{"type":"string","description":"공동현관기타방법"},"comnFrdrPwd":{"type":"string","description":"공동현관비밀번호"}},"description":"클레임 배송 정보 DTO"},"ClaimTargetGoodsDeliResponse":{"type":"object","properties":{"ordNo":{"type":"string"},"deliNo":{"type":"string"},"ordSeq":{"type":"string"},"ordProcSeq":{"type":"string"},"shipIndiDtm":{"type":"string","format":"date-time"},"shipCfmDtm":{"type":"string","format":"date-time"},"shipFnshDtm":{"type":"string","format":"date-time"},"deliFnshDtm":{"type":"string","format":"date-time"},"hdcCd":{"type":"string"},"invNo":{"type":"string"},"deliDtlStatCd":{"type":"string"}},"description":"클레임 처리대상 배송 정보 응답 DTO"},"OpOrdDtl":{"type":"object","properties":{"ordNo":{"type":"string"},"ordSeq":{"type":"integer","format":"int32"},"ordProcSeq":{"type":"integer","format":"int32"},"uprOrdProcSeq":{"type":"integer","format":"int32"},"claimNo":{"type":"string"},"goodsNo":{"type":"string"},"itmNo":{"type":"string"},"ordDtlGbCd":{"type":"string"},"deliGbCd":{"type":"string"},"ordAccpDtm":{"type":"string","format":"date-time"},"ordFnshDtm":{"type":"string","format":"date-time"},"ordDtlStatCd":{"type":"string"},"ordQty":{"type":"integer","format":"int32"},"cnclQty":{"type":"integer","format":"int32"},"rtnQty":{"type":"integer","format":"int32"},"deliIndiDtm":{"type":"string","format":"date-time"},"deliIndiRsvDtm":{"type":"string","format":"date-time"},"deliNo":{"type":"string"},"exchMidRtnYn":{"type":"string"},"claimLgrpCd":{"type":"string"},"claimMgrpCd":{"type":"string"},"claimCausEtcCont":{"type":"string"},"rtnPsbYn":{"type":"string"},"exchPsbYn":{"type":"string"},"ordCnclPsbYn":{"type":"string"},"wthdYn":{"type":"string"},"wthdFnshGbCd":{"type":"string"},"shipFnshFcstDtm":{"type":"string","format":"date-time"},"etcktNo":{"type":"string"},"ecpnNo":{"type":"string"}},"description":"주문상세 목록"},"StCdDtlResponse":{"type":"object","properties":{"cd":{"type":"string","description":"코드"},"cdNm":{"type":"string","description":"코드명"},"cdDesc":{"type":"string","description":"코드설명"},"sortSeq":{"type":"string","description":"정렬순서"},"ref1Val":{"type":"string","description":"참조1값"},"ref2Val":{"type":"string","description":"참조2값"},"ref3Val":{"type":"string","description":"참조3값"},"ref4Val":{"type":"string","description":"참조4값"},"ref5Val":{"type":"string","description":"참조5값"},"ref6Val":{"type":"string","description":"참조6값"},"ref7Val":{"type":"string","description":"참조7값"}},"description":"공통코드 응답 DTO"},"Response":{"type":"object","properties":{"timestamp":{"type":"string","description":"result time","format":"date-time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","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"}},"description":"validation error list"}}}}
```

## 주문 취소(FO)

> \## 기능설명\
> \* 주문취소를 진행합니다.\
> \---\
> \## 상세설명\
> \* 주문취소 처리 API 호출 시점의 주문 상태를 확인, 접수 가능 여부를 확인합니다.\
> \* 주문취소 요청 데이터의 유효성 검증은 다음의 항목에 대해 진행합니다.\
> &#x20;   \* 접수 상품 사은품 유무 체크(-> \*부분 수량 클레임 불가\*)\
> &#x20;   \* 부분취소불가 결제수단 사용 여부 체크(-> \*부분 클레임 불가\*)\
> \* 주문 취소 데이터 생성 및 업데이트합니다.\
> \* 주문 취소 시 발생하는 환불/결제 금액에 대해 검증을 수행합니다.\
> \* 복원 쿠폰이 있을 경우 쿠폰 복원이 일어납니다.\
> \* 주문 취소 상품에 대한 재고 복원이 일어납니다.\
> \* 환불/결제 처리됩니다.\
> \* 주문 취소 고객에게 알림을 발송합니다.(이메일/알림톡/알림함)\
> \---\
> \## 수정번호\
> \* release\_231009\_01 : 주문혜택관계테이블 주문수량, 취소수량 컬럼 추가\
> \* Release v2.00\_240627: 접수 상품 배송번호 일치 여부 체크 로직 제거 ( 전체 취소 기능 추가)\
> \* Release v2.00\_250714: 클레임 처리 시 환불 세금계산서 발행 추가\
> \* Release v2.00\_250801 : 환경설정에 따른 증빙서류(세금계산서) 활성화 처리\
> \* Release v2.00\_251020 : 이니시스 클레임 처리 시 현금영수증 취소 발행 추가<br>

```json
{"openapi":"3.0.1","info":{"title":"X2BEE Order API","version":"v1"},"servers":[{"url":"https://api-order.x2bee.com/api/order/","description":"prd"}],"paths":{"/v1/claim/orderCancel/cancelFO":{"post":{"tags":["주문취소"],"summary":"주문 취소(FO)","description":"## 기능설명\n* 주문취소를 진행합니다.\n---\n## 상세설명\n* 주문취소 처리 API 호출 시점의 주문 상태를 확인, 접수 가능 여부를 확인합니다.\n* 주문취소 요청 데이터의 유효성 검증은 다음의 항목에 대해 진행합니다.\n    * 접수 상품 사은품 유무 체크(-> *부분 수량 클레임 불가*)\n    * 부분취소불가 결제수단 사용 여부 체크(-> *부분 클레임 불가*)\n* 주문 취소 데이터 생성 및 업데이트합니다.\n* 주문 취소 시 발생하는 환불/결제 금액에 대해 검증을 수행합니다.\n* 복원 쿠폰이 있을 경우 쿠폰 복원이 일어납니다.\n* 주문 취소 상품에 대한 재고 복원이 일어납니다.\n* 환불/결제 처리됩니다.\n* 주문 취소 고객에게 알림을 발송합니다.(이메일/알림톡/알림함)\n---\n## 수정번호\n* release_231009_01 : 주문혜택관계테이블 주문수량, 취소수량 컬럼 추가\n* Release v2.00_240627: 접수 상품 배송번호 일치 여부 체크 로직 제거 ( 전체 취소 기능 추가)\n* Release v2.00_250714: 클레임 처리 시 환불 세금계산서 발행 추가\n* Release v2.00_250801 : 환경설정에 따른 증빙서류(세금계산서) 활성화 처리\n* Release v2.00_251020 : 이니시스 클레임 처리 시 현금영수증 취소 발행 추가\n","operationId":"cancelOrderFO","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ClaimProcessResultResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"ClaimRequest":{"required":["claimBusinessType","claimDlvp","claimGoodsList","claimNo","claimReturnDlvp","ordMediaCd","ordNo","systemType","wthdFnshWaitProcCaus"],"type":"object","properties":{"systemType":{"type":"string","description":"        SYSTEM(시스템유형)\n        * 10 : FO\n        * 20 : BO\n","enum":["FO","BO"]},"claimBusinessType":{"type":"string","description":"        ClaimBusiness(클레임업무유형)\n        * 11 : 주문취소\n        * 20 : 반품접수\n        * 21 : 반품취소\n        * 30 : 교환접수\n        * 31 : 교환취소\n        * 22 : 반품완료\n        * 23 : 반품불가\n        * 24 : 교환반품\n        * 25 : 반품보류\n","enum":["ORDER_CANCEL","RETURN_ACCEPT","RETURN_WITHDRAWAL","EXCHANGE_ACCEPT","EXCHANGE_WITHDRAWAL","RETURN_COMPLETE","RETURN_REJECT","RETURN_TRANSFORM","RETURN_PENDING","DELIVERY_FEE_PAYMENT"]},"ordMediaCd":{"type":"string","description":"주문매체 코드(OM007)\n 10 : 전화상담(CC)\n, 20 : PC\n, 30 : 모바일웹\n, 40 : 안드로이드앱\n, 50 : IOS앱\n, 60 : 정기주문\n","enum":["10","20","30","40","50","60"]},"ordNo":{"type":"string","description":"주문번호"},"mbrNo":{"type":"string","description":"회원번호"},"claimNo":{"type":"string","description":"클레임번호"},"claimGoodsList":{"type":"array","description":"클레임 대상 상품정보 리스트","items":{"$ref":"#/components/schemas/ClaimGoodsRequest"}},"paymentRequest":{"$ref":"#/components/schemas/PaymentRequestPaymentInfo"},"claimCpnInfoList":{"type":"array","description":"쿠폰 리스트","items":{"$ref":"#/components/schemas/ClaimCpnInfo"}},"claimReturnDlvp":{"$ref":"#/components/schemas/ClaimDlvp"},"claimDlvp":{"$ref":"#/components/schemas/ClaimDlvp"},"claimFinalAmtInfo":{"$ref":"#/components/schemas/ClaimFinalAmtInfo"},"wthdFnshWaitProcCaus":{"type":"string","description":"회수완료 대기처리 사유"},"occurPayment":{"type":"boolean"},"existAddtionPayAmt":{"type":"boolean"},"claimBusiness":{"type":"string","description":"        ClaimBusiness(클레임업무유형)\n        * 11 : 주문취소\n        * 20 : 반품접수\n        * 21 : 반품취소\n        * 30 : 교환접수\n        * 31 : 교환취소\n        * 22 : 반품완료\n        * 23 : 반품불가\n        * 24 : 교환반품\n        * 25 : 반품보류\n","enum":["ORDER_CANCEL","RETURN_ACCEPT","RETURN_WITHDRAWAL","EXCHANGE_ACCEPT","EXCHANGE_WITHDRAWAL","RETURN_COMPLETE","RETURN_REJECT","RETURN_TRANSFORM","RETURN_PENDING","DELIVERY_FEE_PAYMENT"]}},"description":"클레임 처리 요청 DTO"},"ClaimGoodsRequest":{"required":["claimLgrpCd","claimMgrpCd","claimQty","exchangeGoodsNo","exchangeItmNm","exchangeItmNo"],"type":"object","properties":{"ordSeq":{"type":"integer","description":"주문순번","format":"int32"},"ordProcSeq":{"type":"integer","description":"주문처리순번","format":"int32"},"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"exchangeGoodsNo":{"type":"string","description":"교환 상품 번호"},"exchangeItmNo":{"type":"string","description":"교환 단품 번호"},"exchangeItmNm":{"type":"string","description":"교환 단품명"},"claimQty":{"type":"integer","description":"클레임 수량","format":"int32"},"claimLgrpCd":{"type":"string","description":"OM047(클레임대분류코드)\n 10: 단순변심\n , 20: 상품불량\n , 30: 배송불만\n , 40: 상품정보오류\n , 50: 재결제주문\n","enum":["SIMPLE_CHANGE","GOODS_BAD","DELIVERY_CLAIM","GOODS_INFOMATION_ERROR","REPAYMENT_ORDER"]},"claimMgrpCd":{"type":"string","description":"OM006(클레임중분류코드)\n 100: 배송이 늦어짐\n , 101: 상품이 품절됨\n , 102: 옵션/사이즈 변경/취소\n , 103: 다른 곳보다 비쌈\n , 104: 쿠폰/할인혜택 변경\n , 105: 구매의사 없어짐\n , 106: 사은품 변경/취소\n , 107: 결제수단 변경(구매사은 적용/카드변경 등)\n , 108: 유사상품 구매\n , 109: 상품정보 미흡\n , 110: 판매자 취소(판매자)\n , 111: 직권 취소(상담사)\n , 112: 자동 취소(결제부족)\n , 113: 자동 취소(결품취소)\n , 300: 사이즈가 큼\n , 301: 사이즈가 작음\n , 302: 단순변심 색상변경\n , 303: 오염\n , 304: 파손(울트임 등)\n , 305: 구성품 누락(목걸이, 벨트 등)\n , 306: 내용물 불량(화장품 등)\n , 307: 상품 오배송\n , 308: 기타\n , 200: 다른상품 주문\n , 201: 사이즈가 큼\n , 203: 사이즈가 작음\n , 204: 상품이미지 상이(컬러, 디자인, 핏)\n , 205: 구매의사가 사라짐\n , 206: 색상 또는 사이즈 교환기능이 없어서\n , 207: 기타\n , 208: 오염\n , 209: 파손(울트임 등)\n , 210: 구성품 누락(목걸이, 벨트 등)\n , 211: 내용물 불량(화장품 등)\n , 212: 기타\n , 213: 사이즈 오배송\n , 214: 컬러 오배송\n , 215: 상품 오배송\n , 216: 배송지연\n , 217: 기타\n , 218: 실측 사이즈 오류\n , 219: 소재 오류\n , 220: 색상 오류\n , 221: 상품 설명과 다름(오표기)\n , 222: 기타\n , 223: 반품보류\n , 224: 반품불가\n","enum":["CLAIM_MGRP_CD_100","CLAIM_MGRP_CD_101","CLAIM_MGRP_CD_102","CLAIM_MGRP_CD_103","CLAIM_MGRP_CD_104","CLAIM_MGRP_CD_105","CLAIM_MGRP_CD_106","CLAIM_MGRP_CD_107","CLAIM_MGRP_CD_108","CLAIM_MGRP_CD_109","CLAIM_MGRP_CD_110","CLAIM_MGRP_CD_111","CLAIM_MGRP_CD_112","CLAIM_MGRP_CD_113","CLAIM_MGRP_CD_114","CLAIM_MGRP_CD_300","CLAIM_MGRP_CD_301","CLAIM_MGRP_CD_302","CLAIM_MGRP_CD_303","CLAIM_MGRP_CD_304","CLAIM_MGRP_CD_305","CLAIM_MGRP_CD_306","CLAIM_MGRP_CD_307","CLAIM_MGRP_CD_308","CLAIM_MGRP_CD_200","CLAIM_MGRP_CD_201","CLAIM_MGRP_CD_203","CLAIM_MGRP_CD_204","CLAIM_MGRP_CD_205","CLAIM_MGRP_CD_206","CLAIM_MGRP_CD_207","CLAIM_MGRP_CD_208","CLAIM_MGRP_CD_209","CLAIM_MGRP_CD_210","CLAIM_MGRP_CD_211","CLAIM_MGRP_CD_212","CLAIM_MGRP_CD_213","CLAIM_MGRP_CD_214","CLAIM_MGRP_CD_215","CLAIM_MGRP_CD_216","CLAIM_MGRP_CD_217","CLAIM_MGRP_CD_218","CLAIM_MGRP_CD_219","CLAIM_MGRP_CD_220","CLAIM_MGRP_CD_221","CLAIM_MGRP_CD_222","CLAIM_MGRP_CD_223","CLAIM_MGRP_CD_224"]},"claimCausEtcCont":{"type":"string","description":"클레임사유기타내용"},"withdrawalDeliNo":{"type":"string","description":"회수 배송번호"},"shipmentDeliNo":{"type":"string","description":"출하 배송번호"},"prOrdDtlAtchFileInfoList":{"type":"array","description":"첨부이미지목록","items":{"$ref":"#/components/schemas/PrOrdDtlAtchFileInfo"}},"ordSeqAndOrdProcSeq":{"type":"string"}},"description":"클레임 요청 상품 정보 DTO"},"PrOrdDtlAtchFileInfo":{"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"ordSeq":{"type":"integer","description":"주문순번","format":"int32"},"ordProcSeq":{"type":"integer","description":"주문처리순번","format":"int32"},"fileSeq":{"type":"string","description":"파일순번"},"filePathNm":{"type":"string","description":"파일경로"},"fileNm":{"type":"string","description":"파일명"}},"description":"주문상세첨부파일정보 DTO"},"PaymentRequestPaymentInfo":{"type":"object","properties":{"siteNo":{"type":"string","description":"사이트 번호"},"orderInfo":{"$ref":"#/components/schemas/PaymentOrderInfo"},"payInfoList":{"type":"array","description":"결제를 요청하는 주문/클레임 DTO","items":{"$ref":"#/components/schemas/PaymentInfo"}}},"description":"결제 및 결제 취소 DTO","nullable":true},"PaymentOrderInfo":{"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"claimNo":{"type":"string","description":"클레임번호"},"goodsNm":{"type":"string","description":"상품명"},"ordManNm":{"type":"string","description":"주문자명"},"ordmnCellNo":{"type":"string","description":"주문자휴대폰번호"},"ordmnEmailAddr":{"type":"string","description":"주문자이메일주소"},"crcUnitCd":{"type":"string","description":"통화단위코드"},"ordMediaCd":{"type":"string","description":"주문매체코드(OM007)"},"mbrNo":{"type":"string","description":"회원번호"},"ordDtlGbCd":{"type":"string","description":"주문내역상세구분코드(OM003)"},"clientIp":{"type":"string","description":"클라이언트IP"},"taxFreeAmt":{"type":"integer","description":"면세 금액","format":"int64"}},"description":"결제에 필요한 주문 DTO"},"PaymentInfo":{"type":"object","properties":{"payNo":{"type":"string","description":"결제번호"},"payWayCd":{"type":"string","description":"결제수단코드(OM013)"},"payAmt":{"type":"integer","description":"결제금액","format":"int64"},"mersNo":{"type":"string","description":"가맹점번호"},"pgGbCd":{"type":"string","description":"PG구분코드(OM030)"},"trdNo":{"type":"string","description":"거래번호(tid)"},"selectCardCd":{"type":"string","description":"결제요청카드사코드(OM057)"},"termlId":{"type":"string","description":"터미널ID(mid)"},"billKey":{"type":"string","description":"승인요청할 빌링키 값"},"authResultMap":{"type":"object","additionalProperties":{"type":"string","description":"인증결과정보"},"description":"인증결과정보"}},"description":"결제 DTO"},"ClaimCpnInfo":{"type":"object","properties":{"cpnNo":{"type":"string","description":"쿠폰발급번호"}},"description":"클레임 쿠폰 정보 DTO"},"ClaimDlvp":{"required":["dlvpNm","dtlAddr","rcvmnNm","zipAddr","zipNo"],"type":"object","properties":{"mbrOrdDlvpGb":{"type":"string","description":"        ClaimDlvpGbCd(클레임배송지유형)\n        * 10 : 회원배송지\n        * 20 : 주문배송지\n","enum":["MBR","ORD"]},"dlvpSeq":{"type":"string","description":"배송지순번"},"zipNoSeq":{"type":"integer","description":"우편번호 순번","format":"int64"},"dlvpNm":{"type":"string","description":"배송지명"},"rcvmnNm":{"type":"string","description":"수취인명"},"zipNo":{"type":"string","description":"우편번호"},"zipAddr":{"type":"string","description":"우편주소"},"dtlAddr":{"type":"string","description":"상세주소"},"rcvmnEmailAddr":{"type":"string","description":"수취인이메일주소"},"rcvmnCellSctNo":{"type":"string","description":"수취인휴대폰구분번호"},"rcvmnCellTxnoNo":{"type":"string","description":"수취인휴대폰국번번호"},"rcvmnCellEndNo":{"type":"string","description":"수취인휴대폰국번번호"},"rcvmnTelRgnNo":{"type":"string","description":"수취인전화지역번호"},"rcvmnTelTxnoNo":{"type":"string","description":"수취인전화국번번호"},"rcvmnTelEndNo":{"type":"string","description":"수취인전화끝번호"},"deliMsg":{"type":"string","description":"배송메시지"},"deliMsgCd":{"type":"string","description":"배송메시지코드(ME039) 20:배송 전 연락 바랍니다, 30:부재 시 문 앞에 놓아주세요, 40:부재 시 경비실에 맡겨주세요, 50:빠른 배송 부탁 드립니다, 60:부재 시 핸드폰으로 연락바랍니다, 70:직접입력"},"shopTrafMsg":{"type":"string","description":"매장전달메시지"},"comnFrdrCogoMethodCd":{"type":"string","description":"공동현관출입방법코드(ME040) 10:공동현관 출입번호, 20:자유 출입 가능, 30:기타","default":"20"},"comnFrdrEtcMethod":{"type":"string","description":"공동현관기타방법"},"comnFrdrPwd":{"type":"string","description":"공동현관비밀번호"}},"description":"클레임 배송 정보 DTO"},"ClaimFinalAmtInfo":{"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"totAplyAdtnAmt":{"type":"integer","description":"총발생배송비금액","format":"int64"},"totCnclAdtnAmt":{"type":"integer","description":"총취소배송비금액","format":"int64"},"totFvrAdtnAmt":{"type":"integer","description":"총혜택배송비금액","format":"int64"},"totOrdPrc":{"type":"integer","description":"클레임상품금액","format":"int64"},"totDcAmt":{"type":"integer","description":"클레임취소할인금액","format":"int64"},"expectedRefundAmt":{"type":"integer","description":"환불예정금액","format":"int64"},"addtionPayAmt":{"type":"integer","description":"추가결제금액","format":"int64"},"returnAcceptAmt":{"type":"integer","description":"반품접수금액","format":"int64"},"refundAdditionAmtInfoList":{"type":"array","description":"추가결제/환불정보 리스트","items":{"$ref":"#/components/schemas/RefundAdditionAmtInfo"}},"refundPaymentMethodList":{"type":"array","description":"환불결제정보 리스트","items":{"$ref":"#/components/schemas/PaymentClaimResponse"}},"paymentOrderInfo":{"$ref":"#/components/schemas/PaymentOrderInfo"},"rfdInfoResponse":{"$ref":"#/components/schemas/RfdInfoResponse"}},"description":"클레임 최종 결제/환불금액 정보 DTO"},"RefundAdditionAmtInfo":{"type":"object","properties":{"adtnOcurGbCd":{"type":"string","description":"OM017(부가비용발생구분코드)\n 10: 발생\n , 20: 취소\n","enum":["OCCURRNECE","CANCEL"]},"adtnOcurGbNm":{"type":"string","description":"부가비용발생구분명"},"type":{"type":"string","description":"        ClaimAmountType(클레임부가비용유형)\n        * 10 : 배송비\n        * 20 : 회수배송비\n        * 30 : 교환배송비\n        * 40 : 상품\n        * 50 : 추가배송비\n        * 60 : 사은품\n","enum":["DELIVERY_FEE","RETURN_FEE","EXCHANGE_FEE","GOODS","EXTRA_FEE","GIFTS"]},"typeNm":{"type":"string","description":"유형구분명"},"goodsNoItmNo":{"type":"string","description":"상품번호+단품번호"},"goodsNm":{"type":"string","description":"상품명"},"ordAmt":{"type":"integer","description":"결제금액","format":"int64"},"discountMethod":{"type":"string","description":"OM019(부가비용상세구분코드)\n 11: 상품할인쿠폰\n , 12: 장바구니쿠폰\n , 13: 중복할인쿠폰\n , 14: 무료배송쿠폰\n , 15: 무료반품쿠폰\n , 20: 임직원할인\n , 21: 상품즉시할인\n , 51: 상품사은품\n , 40: 프로모션적립\n , 41: 기본적립\n , 42: 회원등급추가적립\n","enum":["GOODS_DISCOUNT","SHOPPING_BASKET","REDUNDANT_DISCOUNT","FREE_DELIVERY","FREE_RETURN","EXECUTIVES","GOODS_DIRECT","GOODS_GIFTS","MILEAGE","BASIC_ACCUMULATION","MBR_GRADE_ACCUMULATION"]},"discountMethodNm":{"type":"string","description":"혜택상세정보명"},"cnclDcAmt":{"type":"integer","description":"취소혜택금액","format":"int64"},"rtnDlvBenefitInfoList":{"type":"array","description":"반품쿠폰정보 리스트","items":{"$ref":"#/components/schemas/ClaimDlvBenefitInfo"}},"reCalAdtnOcurGbCdAdtnAmt":{"type":"integer","format":"int64"}},"description":"추가결제/환불정보 DTO"},"ClaimDlvBenefitInfo":{"type":"object","properties":{"promoNo":{"type":"string","description":"쿠폰번호"},"promoNm":{"type":"string","description":"쿠폰명"},"promoTypCd":{"type":"string","description":"프로모션 유형 코드(MK002)\n 11 : 상품할인쿠폰\n , 12 : 장바구니쿠폰\n , 13 : 중복할인쿠폰\n , 14 : 무료배송쿠폰\n , 15 : 무료반품쿠폰\n , 20 : 임직원할인\n , 21 : 상품즉시할인\n , 40 : 상품마일리지\n","enum":["11","12","13","14","15","20","21","40"]},"ourChrgRate":{"type":"integer","description":"당사분담율","format":"int32"},"entrChrgRate":{"type":"integer","description":"협력사분담율","format":"int32"},"cpnIsuNo":{"type":"string","description":"쿠폰발급번호"},"aplyYn":{"type":"string","description":"적용여부","enum":["Y","N"]}},"description":"반품쿠폰정보 리스트"},"PaymentClaimResponse":{"type":"object","properties":{"payNo":{"type":"string","description":"결제번호"},"mbrNo":{"type":"string","description":"회원번호"},"ordNo":{"type":"string","description":"주문번호"},"claimNo":{"type":"string","description":"클레임번호"},"uprPayNo":{"type":"string","description":"상위결제번호"},"payGbCd":{"type":"string","description":"결제구분코드(OM012)"},"payGbCdNm":{"type":"string","description":"결제구분코드명(OM012)"},"payWayCd":{"type":"string","description":"결제수단코드(OM013)"},"payWayCdNm":{"type":"string","description":"결제수단코드명(OM013)"},"payStatCd":{"type":"string","description":"결제상태코드(OM014)"},"payStatCdNm":{"type":"string","description":"결제상태코드명(OM014)"},"payAmt":{"type":"integer","description":"결제금액","format":"int64"},"taxFreeAmt":{"type":"integer","description":"면세가","format":"int64"},"rfdPsbAmt":{"type":"integer","description":"환불가능금액","format":"int64"},"rfdAmt":{"type":"integer","description":"환불금액","format":"int64"},"payFnshDtm":{"type":"string","description":"결제완료일시","format":"date-time"},"trdNo":{"type":"string","description":"거래번호(tid)"},"trdDtm":{"type":"string","description":"거래일시","format":"date-time"},"iscmCd":{"type":"string","description":"발급사코드(OM027)"},"iscmCdNm":{"type":"string","description":"발급사코드명(OM027)"},"payReqCardcoCd":{"type":"string","description":"결제요청카드사코드(OM057)"},"payReqCardcoCdNm":{"type":"string","description":"결제요청카드사코드명(OM057)"},"cardNo":{"type":"string","description":"카드번호"},"cardNm":{"type":"string","description":"카드명"},"cardValiTerm":{"type":"string","description":"카드유효기간"},"nintDivYn":{"type":"string","description":"무이자할부여부"},"divMonCnt":{"type":"integer","description":"할부개월수","format":"int32"},"cardPointUseYn":{"type":"string","description":"카드포인트사용여부"},"mersNo":{"type":"string","description":"가맹점번호"},"acqrCd":{"type":"string","description":"매입사코드(OM028)"},"acqrCdNm":{"type":"string","description":"매입사코드명(OM028)"},"aprvNo":{"type":"string","description":"승인번호"},"aprvDtm":{"type":"string","description":"승인일시","format":"date-time"},"sctnCnclPsbYn":{"type":"string","description":"부분취소가능여부"},"bankCd":{"type":"string","description":"은행코드(OM026)"},"bankCdNm":{"type":"string","description":"은행코드명(OM026)"},"actnNo":{"type":"string","description":"계좌번호"},"dpmnNm":{"type":"string","description":"입금자명"},"dptFcstDt":{"type":"string","description":"입금예정일자"},"dptCnfmDtm":{"type":"string","description":"입금확인일시","format":"date-time"},"rfdBankCd":{"type":"string","description":"환불은행코드(OM026)"},"rfdBankCdNm":{"type":"string","description":"환불은행코드명(OM026)"},"rfdActnNo":{"type":"string","description":"환불계좌번호"},"rfdActnDepositorNm":{"type":"string","description":"환불계좌 예금주명"},"vbankPaymentPending":{"type":"boolean"},"vbankDptCnfm":{"type":"boolean"}},"description":"환불가능한 결제수단 DTO"},"RfdInfoResponse":{"type":"object","properties":{"rfdBankCd":{"type":"string","description":"은행코드 (OM026)"},"rfdBankNm":{"type":"string","description":"은행명"},"rfdActnNo":{"type":"string","description":"환불계좌번호"},"rfdActnDepositorNm":{"type":"string","description":"환불 계좌 예금주명"},"rfdActnCertiYn":{"type":"string","description":"환불 계좌 인증여부"}},"description":"환불 계좌정보 조회 Response"},"ClaimProcessResultResponse":{"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"claimNo":{"type":"string","description":"클레임번호"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","description":"result time","format":"date-time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","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"}},"description":"validation error list"}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://tech.x2bee.com/api/store-front-api/order-api/undefined-26.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.