# 주문교환

## 교환 접수 철회(BO)

> \## 기능 설명\
> \* BO에서 교환접수대상을 철회처리합니다.\
> \---\
> \## 상세 설명\
> \* \*\*주문 번호(ordNo)\*\*, \*\*클레임업무유형(claimBusinessType)\*\*, \*\*시스템 유형(systemType)\*\*은 필수로 있어야합니다.\
> \* 다음의 조건을 모두 충족하는 대상에 대해 교환 철회 처리가 가능합니다.\
>     \* \*\*주문내역구분(OM003)\*\* 값이 \*\*교환(30)\*\*인 경우\
>     \* \*\*주문내역상태(OM005)\*\* 값이 \*\*결제대기(31)\*\* 이거나 \*\*교환접수(32)\*\* 이거나 \*\*회수지시(34)\*\*인 경우\
> \* 기존 \*\*주문교환데이터\*\*를 업데이트하고 \*\*주문교환철회데이터\*\*를 생성 처리합니다.\
> \* 교환 철회시 발생하는 \*\*결제 정보\*\*를 \*\*검증\*\*처리합니다.\
> \* \*\*재고 증감처리\*\*를 수행합니다.\
> \---\
> \## 특이 사항\
> \* \*\*클레임업무유형(claimBusinessType)\*\*이 \*\*교환철회(31)\*\*인 경우에만 교환접수철회가 진행됩니다.\
> \---\
> \## 수정번호\
> \* release\_231009\_01 : 주문혜택관계테이블 주문수량, 취소수량 컬럼 추가<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/exchange/withdrawalExchange":{"post":{"tags":["주문교환"],"summary":"교환 접수 철회(BO)","description":"## 기능 설명\n* BO에서 교환접수대상을 철회처리합니다.\n---\n## 상세 설명\n* **주문 번호(ordNo)**, **클레임업무유형(claimBusinessType)**, **시스템 유형(systemType)**은 필수로 있어야합니다.\n* 다음의 조건을 모두 충족하는 대상에 대해 교환 철회 처리가 가능합니다.\n    * **주문내역구분(OM003)** 값이 **교환(30)**인 경우\n    * **주문내역상태(OM005)** 값이 **결제대기(31)** 이거나 **교환접수(32)** 이거나 **회수지시(34)**인 경우\n* 기존 **주문교환데이터**를 업데이트하고 **주문교환철회데이터**를 생성 처리합니다.\n* 교환 철회시 발생하는 **결제 정보**를 **검증**처리합니다.\n* **재고 증감처리**를 수행합니다.\n---\n## 특이 사항\n* **클레임업무유형(claimBusinessType)**이 **교환철회(31)**인 경우에만 교환접수철회가 진행됩니다.\n---\n## 수정번호\n* release_231009_01 : 주문혜택관계테이블 주문수량, 취소수량 컬럼 추가\n","operationId":"withdrawalExchange","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"}}}}
```

## 교환 접수 철회(FO)

> \## 기능 설명\
> \* FO에서 교환접수대상을 철회처리합니다.\
> \---\
> \## 상세 설명\
> \* \*\*주문 번호(ordNo)\*\*, \*\*클레임업무유형(claimBusinessType)\*\*, \*\*시스템 유형(systemType)\*\*은 필수로 있어야합니다.\
> \* 다음의 조건을 모두 충족하는 대상에 대해 교환 철회 처리가 가능합니다.\
> &#x20;   \* \*\*주문내역구분(OM003)\*\* 값이 \*\*교환(30)\*\*인 경우\
> &#x20;   \* \*\*주문내역상태(OM005)\*\* 값이 \*\*결제대기(31)\*\* 이거나 \*\*교환접수(32)\*\*인 경우\
> \* 기존 \*\*주문교환데이터\*\*를 업데이트하고 \*\*주문교환철회데이터\*\*를 생성 처리합니다.\
> \* 교환 철회시 발생하는 \*\*결제 정보\*\*를 \*\*검증\*\*처리합니다.\
> \* \*\*재고 증감처리\*\*를 수행합니다.\
> \---\
> \## 특이 사항\
> \* \*\*클레임업무유형(claimBusinessType)\*\*이 \*\*교환철회(31)\*\*인 경우에만 교환접수철회가 진행됩니다.\
> \---\
> \## 수정번호\
> \* release\_231009\_01 : 주문혜택관계테이블 주문수량, 취소수량 컬럼 추가<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/exchange/withdrawalExchangeFO":{"post":{"tags":["주문교환"],"summary":"교환 접수 철회(FO)","description":"## 기능 설명\n* FO에서 교환접수대상을 철회처리합니다.\n---\n## 상세 설명\n* **주문 번호(ordNo)**, **클레임업무유형(claimBusinessType)**, **시스템 유형(systemType)**은 필수로 있어야합니다.\n* 다음의 조건을 모두 충족하는 대상에 대해 교환 철회 처리가 가능합니다.\n    * **주문내역구분(OM003)** 값이 **교환(30)**인 경우\n    * **주문내역상태(OM005)** 값이 **결제대기(31)** 이거나 **교환접수(32)**인 경우\n* 기존 **주문교환데이터**를 업데이트하고 **주문교환철회데이터**를 생성 처리합니다.\n* 교환 철회시 발생하는 **결제 정보**를 **검증**처리합니다.\n* **재고 증감처리**를 수행합니다.\n---\n## 특이 사항\n* **클레임업무유형(claimBusinessType)**이 **교환철회(31)**인 경우에만 교환접수철회가 진행됩니다.\n---\n## 수정번호\n* release_231009_01 : 주문혜택관계테이블 주문수량, 취소수량 컬럼 추가\n","operationId":"withdrawalExchangeFO","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에서 교환클레임옵션변경대상이 유효한지 체크합니다.\
> \---\
> \## 상세 설명\
> \* \*\*상품 번호(goodsNo)\*\*, \*\*단품번호(itmNo)\*\*는 필수로 있어야합니다.\
> \* 다음의 조건을 모두 체크합니다.\
> &#x20;   \* 옵션변경대상의 \*\*판매상태코드(PR005)\*\*가 \*\*판매중(10)\*\*인지 체크합니다.\
> &#x20;   \* 옵션변경대상의 \*\*판매방식코드가(PR003)\*\*가 \*\*일반판매(10)\*\*인지 체크합니다.\
> &#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/exchange/isExistsExchangeGoodsItm":{"post":{"tags":["주문교환"],"summary":"교환 대상상품 옵션변경 가능여부 체크","description":"## 기능 설명\n* BO에서 교환클레임옵션변경대상이 유효한지 체크합니다.\n---\n## 상세 설명\n* **상품 번호(goodsNo)**, **단품번호(itmNo)**는 필수로 있어야합니다.\n* 다음의 조건을 모두 체크합니다.\n    * 옵션변경대상의 **판매상태코드(PR005)**가 **판매중(10)**인지 체크합니다.\n    * 옵션변경대상의 **판매방식코드가(PR003)**가 **일반판매(10)**인지 체크합니다.\n    * 옵션변경대상이 기존대상과 동일한 가격인지 체크합니다.\n    * 옵션변경대상의 재고를 체크합니다.\n","operationId":"isExistsExchangeGoodsItm","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ClaimGoodsItmInfoRequest"}}}},"required":true},"responses":{"200":{"description":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"ClaimGoodsItmInfoRequest":{"required":["goodsNo","itmNo"],"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호","default":"10001861"},"itmNo":{"type":"string","description":"단품번호","default":"001"},"claimQty":{"type":"integer","description":"클레임수량","format":"int32","default":1},"salePrc":{"type":"integer","description":"판매가","format":"int64"}},"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"}}}}
```

## 반품/교환 철회대상 조회

> \## 기능 설명\
> \* BO에서 반품/교환 철회대상을 조회합니다.\
> \---\
> \## 상세 설명\
> \* \*\*주문 번호(ordNo)\*\*, \*\*시스템 유형(systemType)\*\*은 필수로 있어야합니다.\
> \* 다음의 조건을 모두 충족하는 대상에 대해 반품/교환 철회 처리가 가능합니다.\
> &#x20;   \* \*\*주문내역구분(OM003)\*\* 값이 \*\*반품(20)\*\* 이거나 \*\*교환(30)\*\*인 경우\
> &#x20;   \* \*\*주문내역상태(OM005)\*\* 값이 \*\*결제대기(31)\*\*, \*\*반품/교환접수(32)\*\*, \*\*회수지시(32)\*\*인 경우\
> &#x20;   \* \*\*반품 가능여부(rtnPsbYn)\*\* 값이 \*\*Y\*\* 인 경우\
> &#x20;   \* 일반 상품인 경우\*\*(사은품 제외)\*\*\
> &#x20;   \* 철회 가능 수량이 1개 이상인 경우 \*\*( 주문수량 – 취소수량 – 반품수량 > 0 )\*\*\
> \---\
> \## 수정번호\
> \* release\_231204\_01 : Deprecated 처리됨, 클레임 공통으로 이동(변경된 API 경로 : api/order/v1/claim/common/getReturnExchangeCancelTargetInfo)<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/exchange/getReturnExchangeCancelTargetInfo":{"post":{"tags":["주문교환"],"summary":"반품/교환 철회대상 조회","description":"## 기능 설명\n* BO에서 반품/교환 철회대상을 조회합니다.\n---\n## 상세 설명\n* **주문 번호(ordNo)**, **시스템 유형(systemType)**은 필수로 있어야합니다.\n* 다음의 조건을 모두 충족하는 대상에 대해 반품/교환 철회 처리가 가능합니다.\n    * **주문내역구분(OM003)** 값이 **반품(20)** 이거나 **교환(30)**인 경우\n    * **주문내역상태(OM005)** 값이 **결제대기(31)**, **반품/교환접수(32)**, **회수지시(32)**인 경우\n    * **반품 가능여부(rtnPsbYn)** 값이 **Y** 인 경우\n    * 일반 상품인 경우**(사은품 제외)**\n    * 철회 가능 수량이 1개 이상인 경우 **( 주문수량 – 취소수량 – 반품수량 > 0 )**\n---\n## 수정번호\n* release_231204_01 : Deprecated 처리됨, 클레임 공통으로 이동(변경된 API 경로 : api/order/v1/claim/common/getReturnExchangeCancelTargetInfo)\n","operationId":"getReturnExchangeCancelTargetInfo","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/ClaimTargetResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}},"deprecated":true}}},"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"},"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":"주문상세 목록"},"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)

> \## 기능 설명\
> \* BO에서 주문교환대상을 조회합니다.\
> \---\
> \## 상세 설명\
> \* \*\*주문 번호(ordNo)\*\*, \*\*클레임업무유형(claimBusinessType)\*\*, \*\*시스템 유형(systemType)\*\*은 필수로 있어야합니다.\
> \* 다음의 조건을 모두 충족하는 대상에 대해 교환 접수 처리가 가능합니다.\
> &#x20;   \* \*\*주문내역구분(OM003)\*\* 값이 \*\*주문일반(10)\*\* 이거나 \*\*교환(30)\*\*인 경우\
> &#x20;   \* \*\*주문내역상태(OM005)\*\* 값이 \*\*출고완료(26)\*\* 이거나 \*\*배송완료(27)\*\*인 경우\
> &#x20;   \* \*\*반품 가능여부(rtnPsbYn)\*\* 값이 \*\*Y\*\* 인 경우\
> &#x20;   \* 일반 상품인 경우\*\*(사은품 제외)\*\*\
> &#x20;   \* 교환 가능 수량이 1개 이상인 경우 \*\*( 주문수량 – 취소수량 – 반품수량 > 0 )\*\*\
> \---\
> \## 특이 사항\
> \* \*\*클레임업무유형(claimBusinessType)\*\*이 \*\*교환(30)\*\*인 경우에 교환대상을 가져옵니다.\
> \---\
> \## 수정 번호\
> \* release\_231204\_01 : Request DTO 배송지순번(dlvpSeq) 추가, 대상 조회시 배송지 순번 값이 있는경우 필터링 추가 실행\
> \* release v2.00\_240409 : Response DTO 오타 수정 ( CaimTargetResponse -> ClaimTargetResponse )\
> \* Release v2.00\_240729 : 회수여부(wthdYn), 회수불필요주문여부(isAllNonReturnable) 추가<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/exchange/getExchageTargetInfo":{"post":{"tags":["주문교환"],"summary":"교환 대상 조회(BO)","description":"## 기능 설명\n* BO에서 주문교환대상을 조회합니다.\n---\n## 상세 설명\n* **주문 번호(ordNo)**, **클레임업무유형(claimBusinessType)**, **시스템 유형(systemType)**은 필수로 있어야합니다.\n* 다음의 조건을 모두 충족하는 대상에 대해 교환 접수 처리가 가능합니다.\n    * **주문내역구분(OM003)** 값이 **주문일반(10)** 이거나 **교환(30)**인 경우\n    * **주문내역상태(OM005)** 값이 **출고완료(26)** 이거나 **배송완료(27)**인 경우\n    * **반품 가능여부(rtnPsbYn)** 값이 **Y** 인 경우\n    * 일반 상품인 경우**(사은품 제외)**\n    * 교환 가능 수량이 1개 이상인 경우 **( 주문수량 – 취소수량 – 반품수량 > 0 )**\n---\n## 특이 사항\n* **클레임업무유형(claimBusinessType)**이 **교환(30)**인 경우에 교환대상을 가져옵니다.\n---\n## 수정 번호\n* release_231204_01 : Request DTO 배송지순번(dlvpSeq) 추가, 대상 조회시 배송지 순번 값이 있는경우 필터링 추가 실행\n* release v2.00_240409 : Response DTO 오타 수정 ( CaimTargetResponse -> ClaimTargetResponse )\n* Release v2.00_240729 : 회수여부(wthdYn), 회수불필요주문여부(isAllNonReturnable) 추가\n","operationId":"getExchageTargetInfo","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/ExchangeTargetResponse"}}}},"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"},"ExchangeTargetResponse":{"type":"object","properties":{"claimTargetResponse":{"$ref":"#/components/schemas/ClaimTargetResponse"},"codeMap":{"type":"object","additionalProperties":{"type":"array","description":"클레임 공통코드","items":{"$ref":"#/components/schemas/StCdDtlResponse"}},"description":"클레임 공통코드"}},"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)

> \## 기능 설명\
> \* FO에서 주문교환대상을 조회합니다.\
> \---\
> \## 상세 설명\
> \* \*\*주문 번호(ordNo)\*\*, \*\*클레임업무유형(claimBusinessType)\*\*, \*\*시스템 유형(systemType)\*\*은 필수로 있어야합니다.\
> \* 다음의 조건을 모두 충족하는 대상에 대해 교환 접수 처리가 가능합니다.\
> &#x20;   \* \*\*주문내역구분(OM003)\*\* 값이 \*\*주문일반(10)\*\* 이거나 \*\*교환(30)\*\*인 경우\
> &#x20;   \* \*\*주문내역상태(OM005)\*\* 값이 \*\*출고완료(26)\*\* 이거나 \*\*배송완료(27)\*\*인 경우\
> &#x20;   \* \*\*반품 가능여부(rtnPsbYn)\*\* 값이 \*\*Y\*\* 인 경우\
> &#x20;   \* 일반 상품인 경우\*\*(사은품 제외)\*\*\
> &#x20;   \* 교환 가능 수량이 1개 이상인 경우 \*\*( 주문수량 – 취소수량 – 반품수량 > 0 )\*\*\
> \---\
> \## 특이 사항\
> \* \*\*클레임업무유형(claimBusinessType)\*\*이 \*\*교환(30)\*\*인 경우에 교환대상을 가져옵니다.\
> \---\
> \## 수정 번호\
> \* release\_231204\_01 : Request DTO 배송지순번(dlvpSeq) 추가, 대상 조회시 배송지 순번 값이 있는경우 필터링 추가 실행\
> \* release v2.00\_240409 : Response DTO 오타 수정 ( CaimTargetResponse -> ClaimTargetResponse )\
> \* Release v2.00\_240729 : 회수여부(wthdYn), 회수불필요주문여부(isAllNonReturnable) 추가<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/exchange/getExchageTargetInfoFO":{"post":{"tags":["주문교환"],"summary":"교환 대상 조회(FO)","description":"## 기능 설명\n* FO에서 주문교환대상을 조회합니다.\n---\n## 상세 설명\n* **주문 번호(ordNo)**, **클레임업무유형(claimBusinessType)**, **시스템 유형(systemType)**은 필수로 있어야합니다.\n* 다음의 조건을 모두 충족하는 대상에 대해 교환 접수 처리가 가능합니다.\n    * **주문내역구분(OM003)** 값이 **주문일반(10)** 이거나 **교환(30)**인 경우\n    * **주문내역상태(OM005)** 값이 **출고완료(26)** 이거나 **배송완료(27)**인 경우\n    * **반품 가능여부(rtnPsbYn)** 값이 **Y** 인 경우\n    * 일반 상품인 경우**(사은품 제외)**\n    * 교환 가능 수량이 1개 이상인 경우 **( 주문수량 – 취소수량 – 반품수량 > 0 )**\n---\n## 특이 사항\n* **클레임업무유형(claimBusinessType)**이 **교환(30)**인 경우에 교환대상을 가져옵니다.\n---\n## 수정 번호\n* release_231204_01 : Request DTO 배송지순번(dlvpSeq) 추가, 대상 조회시 배송지 순번 값이 있는경우 필터링 추가 실행\n* release v2.00_240409 : Response DTO 오타 수정 ( CaimTargetResponse -> ClaimTargetResponse )\n* Release v2.00_240729 : 회수여부(wthdYn), 회수불필요주문여부(isAllNonReturnable) 추가\n","operationId":"getExchageTargetInfoFO","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/ExchangeTargetResponse"}}}},"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"},"ExchangeTargetResponse":{"type":"object","properties":{"claimTargetResponse":{"$ref":"#/components/schemas/ClaimTargetResponse"},"codeMap":{"type":"object","additionalProperties":{"type":"array","description":"클레임 공통코드","items":{"$ref":"#/components/schemas/StCdDtlResponse"}},"description":"클레임 공통코드"}},"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)\*\*, \*\*클레임번호(claimNo)\*\*는 필수로 있어야합니다.\
> \* 대상 클레임의 \*\*추가배송비\*\*를 조회합니다.\
> \* 대상 클레임의 상품목록을 조회합니다.\
> &#x20;   \* \*\*주문내역구분(OM003)\*\* 값이 \*\*반품(20)\*\* 이거나 \*\*교환(30)\*\*인 경우\
> &#x20;   \* \*\*주문내역상태(OM005)\*\* 값이 \*\*결제대기(31)\*\*인 경우\
> &#x20;   \* \*\*반품 가능여부(rtnPsbYn)\*\* 값이 \*\*Y\*\* 인 경우\
> &#x20;   \* 대상 클레임 수량이 1개 이상인 경우 \*\*( 주문수량 – 취소수량 – 반품수량 > 0 )\*\*\
> \---\
> \## 수정번호\
> \* release\_231204\_01 : Deprecated 처리됨, 클레임 공통으로 이동(변경된 API 경로 : api/order/v1/claim/common/getClaimPayWaitStateInfo)<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/exchange/getClaimPayWaitStateInfo":{"post":{"tags":["주문교환"],"summary":"클레임 배송비 결제대기상태 대상 정보","description":"## 기능 설명\n* FO에서 클레임 배송비 결제대기상태 대상 정보를 조회합니다.\n---\n## 상세 설명\n* **주문 번호(ordNo)**, **클레임번호(claimNo)**는 필수로 있어야합니다.\n* 대상 클레임의 **추가배송비**를 조회합니다.\n* 대상 클레임의 상품목록을 조회합니다.\n    * **주문내역구분(OM003)** 값이 **반품(20)** 이거나 **교환(30)**인 경우\n    * **주문내역상태(OM005)** 값이 **결제대기(31)**인 경우\n    * **반품 가능여부(rtnPsbYn)** 값이 **Y** 인 경우\n    * 대상 클레임 수량이 1개 이상인 경우 **( 주문수량 – 취소수량 – 반품수량 > 0 )**\n---\n## 수정번호\n* release_231204_01 : Deprecated 처리됨, 클레임 공통으로 이동(변경된 API 경로 : api/order/v1/claim/common/getClaimPayWaitStateInfo)\n","operationId":"getClaimPayWaitStateInfo","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimDetailsInfoRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ClaimAdtnCostInfoResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}},"deprecated":true}}},"components":{"schemas":{"ClaimDetailsInfoRequest":{"required":["claimNo","ordNo"],"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"claimNo":{"type":"string","description":"클레임번호"}},"description":"클레임 상세 내역 조회 요청 DTO"},"ClaimAdtnCostInfoResponse":{"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"ordAccpDtm":{"type":"string","description":"주문접수일자","format":"date-time"},"deliAmtSum":{"type":"integer","description":"배송비합계","format":"int64"},"totAplyAdtnAmt":{"type":"integer","description":"추가비용합계","format":"int64"},"addtionPayAmt":{"type":"integer","description":"추가금액","format":"int64"},"claimTargetResponse":{"$ref":"#/components/schemas/ClaimTargetResponse"},"opOrdAdtnCostList":{"type":"array","description":"추가비용목록","items":{"$ref":"#/components/schemas/OpOrdAdtnCost"}},"payWayInfoMap":{"type":"array","description":"결제수단목록","items":{"$ref":"#/components/schemas/PayMethodInfo"}},"foSystemNmAndDeliveryButtonCode":{"type":"string"}},"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":"주문상세 목록"},"OpOrdAdtnCost":{"type":"object","properties":{"ordAdtnSn":{"type":"string","description":"주문부가비용순번"},"ordNo":{"type":"string","description":"주문번호"},"claimNo":{"type":"string","description":"클레임번호"},"deliNo":{"type":"string","description":"배송번호"},"uprOrdAdtnSn":{"type":"string","description":"상위부가비용순번"},"entrNo":{"type":"string","description":"협력사번호"},"adtnOcurGbCd":{"type":"string","description":"OM017(부가비용발생구분코드)\n 10: 발생\n , 20: 취소\n","enum":["OCCURRNECE","CANCEL"]},"ordCostGbCd":{"type":"string","description":"OM043(주문비용구분코드)\n 10: 배송비\n , 20: 회수반품비\n , 30: 교환배송비\n , 40: 추가배송비\n","enum":["DELIVERY_FEE","RETURN_FEE","EXCHANGE_FEE","EXTRA_FEE"]},"stdAdtnAmt":{"type":"integer","description":"기준부가비용금액","format":"int64"},"aplyAdtnAmt":{"type":"integer","description":"적용부가비용금액","format":"int64"},"cnclAdtnAmt":{"type":"integer","description":"취소부가비용금액","format":"int64"},"fvrAdtnAmt":{"type":"integer","description":"혜택부가비용금액","format":"int64"},"deliPolcNo":{"type":"string","description":"배송정책번호"},"dlexTypCd":{"type":"string","description":"배송비유형코드","enum":["FREE","CHARGED","CONDITIONAL_FREE"]},"dlexCnclCausCd":{"type":"string","description":"OM022(배송비취소사유코드)\n 10: N/A\n , 20: 무료배송권\n , 30: 고객클레임\n , 40: 당사귀책사유\n","enum":["NOT_APPLICABLE","FREE_DELIVERY_COUPON","CUSTOMER_CLAIM","COMPANY_FALUT"]},"dlexAmt":{"type":"integer","description":"배송비금액","format":"int64"},"adtnBassNo":{"type":"string","description":"부가비용근거번호"},"adtnDtlBassNo":{"type":"string","description":"부가비용상세근거번호"},"fvrPolcTypCd":{"type":"string","description":"OM020(혜택정책유형코드)\n 00: 사용안함\n , 11: 정액할인\n , 12: 정률할인\n , 21: 정액적립\n , 22: 정률적립\n","enum":["NOT_AVAILABLE","DISCOUNT_PRICE","DISCOUNT_RATE","ACCUMULATE_PRICE","ACCUMULATE_RATE"]},"fvrPolcAplyVal":{"type":"integer","description":"혜택정책적용값","format":"int64"},"fvrMinBuyAmt":{"type":"integer","description":"혜택최소구매금액","format":"int64"},"fvrMaxDcAmt":{"type":"integer","description":"혜택최대할인금액","format":"int64"},"entrChrgRate":{"type":"integer","description":"협력사분담율","format":"int32"},"entrChrgAmt":{"type":"integer","description":"협력사부담금액","format":"int64"},"ourChrgRate":{"type":"integer","description":"당사분담율","format":"int32"},"ourChrgAmt":{"type":"integer","description":"당사부담금액","format":"int64"},"promoNm":{"type":"string","description":"프로모션명"}},"description":"주문부가비용정보 DTO"},"PayMethodInfo":{"type":"object","properties":{"payWayCd":{"type":"string","description":"OM013(결제수단코드)\n 11: 신용카드\n,12: 실시간계좌이체\n,13: 가상계좌(무통장입금)\n,14: 네이버페이\n,15: 카카오페이\n,16: 페이코\n,17: 삼성페이\n,18: 애플페이\n,19: LPAY\n,20: 토스페이\n,21: SSG페이\n,32: 마일리지\n","enum":["CREDIT_CARD","REAL_TIME_ACCOUNT_TRANSFER","VBANK","NAVER_PAY","KAKAO_PAY","PAYCO","SAMSUNG_PAY","APPLE_PAY","L_PAY","TOSS_PAY","SSG_PAY","MILEAGE"]},"useYn":{"type":"string","description":"사용여부","enum":["Y","N"]},"langCd":{"type":"string","description":"결제수단코드","enum":["KOREAN","ENGLISH"]},"cdNm":{"type":"string","description":"코드명"},"cdDesc":{"type":"string","description":"코드설명"},"pgGbCd":{"type":"string","description":"PG구분코드"},"memberSubPaymethodAmount":{"type":"integer","description":"회원의 보조결제수단 금액","format":"int64"},"cardCompanyList":{"type":"array","description":"카드사 리스트(신용카드 결제)","items":{"$ref":"#/components/schemas/StCdDtlResponse"}},"mainPaymethod":{"type":"boolean"}},"description":"결제 수단 정보 DTO"},"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"}}}}
```

## 교환접수(BO)

> \## 기능 설명\
> \* BO에서 교환대상을 접수처리합니다.\
> \---\
> \## 상세 설명\
> \* \*\*주문 번호(ordNo)\*\*, \*\*클레임업무유형(claimBusinessType)\*\*, \*\*시스템 유형(systemType)\*\*은 필수로 있어야합니다.\
> \* 교환 접수 대상은 모두 같은 배송번호여야 접수 가능합니다.\
> \* 교환 접수 대상에 사은품 여부 확인(사은품 포항 될 경우 부분클레임 불가능)\
> \* 다음의 조건을 모두 충족하는 교환 대상에 대해 교환 처리가 가능합니다.\
> &#x20;   \* 유효한 상품인지 체크합니다.\
> &#x20;       \* 교환받을 상품의 \*\*판매상태코드(PR005)\*\*가 \*\*판매중(10)\*\*인지 체크합니다.\
> &#x20;       \* 교환받을 상품의 \*\*판매방식코드가(PR003)\*\*가 \*\*일반판매(10)\*\*인지 체크합니다.\
> &#x20;       \* 교환받을 상품이 교환대상 상품과 동일한 가격인지 체크합니다.\
> &#x20;       \* 교환받을 상품의 재고를 체크합니다.\
> \* \*\*주문교환데이터\*\*를 생성하고 업데이트 처리합니다.\
> &#x20;   \* \*\*클레임 대분류 코드(claimLgrpCd)\*\*가 \*\*단순변심(10)\*\*인 경우 배송비가 발생합니다.\
> &#x20;       \* \*\*추가결제금액(배송비)\*\*이 발생할 경우 \*\*주문내역상태(OM005)\*\* 값이 \*\*교환접수(32)\*\*가 아닌 \*\*결제대기(31)\*\*상태로 변경됩니다.\
> &#x20;       \* \*\*결제대기(31)\*\*일 경우에는 \*\*FO\*\*에서 \*\*배송비결제\*\* 화면을 통한 결제를 진행해야 \*\*교환접수(32)\*\*가 됩니다.\
> \* 교환 접수시 발생하는 \*\*결제 정보\*\*를 \*\*검증\*\*처리합니다.\
> \* \*\*재고 증감처리\*\*를 수행합니다.\
> \* 교환 접수 후 \*\*알림메시지 발송\*\* 처리합니다.\
> \---\
> \## 특이 사항\
> \* \*\*클레임업무유형(claimBusinessType)\*\*이 \*\*교환(30)\*\*인 경우에만 교환접수가 진행됩니다.\
> \---\
> \## 수정번호\
> \* release\_231009\_01 : 주문혜택관계테이블 주문수량, 취소수량 컬럼 추가\
> \* release v2.00\_240409 : 교환 접수 이메일 템플릿 변경에 따른 세팅 정보 추가 및 변경\
> \* Release v2.00\_240729 : 교환 접수 대상이 모두 '회수여부'가 '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/exchange/acceptExchange":{"post":{"tags":["주문교환"],"summary":"교환접수(BO)","description":"## 기능 설명\n* BO에서 교환대상을 접수처리합니다.\n---\n## 상세 설명\n* **주문 번호(ordNo)**, **클레임업무유형(claimBusinessType)**, **시스템 유형(systemType)**은 필수로 있어야합니다.\n* 교환 접수 대상은 모두 같은 배송번호여야 접수 가능합니다.\n* 교환 접수 대상에 사은품 여부 확인(사은품 포항 될 경우 부분클레임 불가능)\n* 다음의 조건을 모두 충족하는 교환 대상에 대해 교환 처리가 가능합니다.\n    * 유효한 상품인지 체크합니다.\n        * 교환받을 상품의 **판매상태코드(PR005)**가 **판매중(10)**인지 체크합니다.\n        * 교환받을 상품의 **판매방식코드가(PR003)**가 **일반판매(10)**인지 체크합니다.\n        * 교환받을 상품이 교환대상 상품과 동일한 가격인지 체크합니다.\n        * 교환받을 상품의 재고를 체크합니다.\n* **주문교환데이터**를 생성하고 업데이트 처리합니다.\n    * **클레임 대분류 코드(claimLgrpCd)**가 **단순변심(10)**인 경우 배송비가 발생합니다.\n        * **추가결제금액(배송비)**이 발생할 경우 **주문내역상태(OM005)** 값이 **교환접수(32)**가 아닌 **결제대기(31)**상태로 변경됩니다.\n        * **결제대기(31)**일 경우에는 **FO**에서 **배송비결제** 화면을 통한 결제를 진행해야 **교환접수(32)**가 됩니다.\n* 교환 접수시 발생하는 **결제 정보**를 **검증**처리합니다.\n* **재고 증감처리**를 수행합니다.\n* 교환 접수 후 **알림메시지 발송** 처리합니다.\n---\n## 특이 사항\n* **클레임업무유형(claimBusinessType)**이 **교환(30)**인 경우에만 교환접수가 진행됩니다.\n---\n## 수정번호\n* release_231009_01 : 주문혜택관계테이블 주문수량, 취소수량 컬럼 추가\n* release v2.00_240409 : 교환 접수 이메일 템플릿 변경에 따른 세팅 정보 추가 및 변경\n* Release v2.00_240729 : 교환 접수 대상이 모두 '회수여부'가 'N'인 경우, 회수 배송비 부과 제외, 알림 템플릿 변경\n","operationId":"acceptExchange","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"}}}}
```

## 교환접수(FO)

> \## 기능 설명\
> \* FO에서 교환대상을 접수처리합니다.\
> \---\
> \## 상세 설명\
> \* \*\*주문 번호(ordNo)\*\*, \*\*클레임업무유형(claimBusinessType)\*\*, \*\*시스템 유형(systemType)\*\*은 필수로 있어야합니다.\
> \* 교환 접수 대상은 모두 같은 배송번호여야 접수 가능합니다.\
> \* 교환 접수 대상에 사은품 여부 확인(사은품 포항 될 경우 부분클레임 불가능)\
> \* 다음의 조건을 모두 충족하는 교환 대상에 대해 교환 처리가 가능합니다.\
> &#x20;   \* 유효한 상품인지 체크합니다.\
> &#x20;       \* 교환받을 상품의 \*\*판매상태코드(PR005)\*\*가 \*\*판매중(10)\*\*인지 체크합니다.\
> &#x20;       \* 교환받을 상품의 \*\*판매방식코드가(PR003)\*\*가 \*\*일반판매(10)\*\*인지 체크합니다.\
> &#x20;       \* 교환받을 상품이 교환대상 상품과 동일한 가격인지 체크합니다.\
> &#x20;       \* 교환받을 상품의 재고를 체크합니다.\
> \* \*\*주문교환데이터\*\*를 생성하고 업데이트 처리합니다.\
> &#x20;   \* \*\*클레임 대분류 코드(claimLgrpCd)\*\*가 \*\*단순변심(10)\*\*인 경우 배송비가 발생합니다.\
> \* 교환 접수시 발생하는 \*\*결제 승인 정보\*\*를 저장합니다.\
> \* 교환 접수시 발생하는 \*\*결제 정보\*\*를 \*\*검증\*\*처리합니다.\
> \* \*\*재고 증감처리\*\*를 수행합니다.\
> \* 교환 접수 후 \*\*알림메시지 발송\*\* 처리합니다.\
> \---\
> \## 특이 사항\
> \* \*\*클레임업무유형(claimBusinessType)\*\*이 \*\*교환(30)\*\*인 경우에만 교환접수가 진행됩니다.\
> \---\
> \## 수정번호\
> \* release\_231009\_01 : 주문혜택관계테이블 주문수량, 취소수량 컬럼 추가\
> \* release v2.00\_240409 : 교환 접수 이메일 템플릿 변경에 따른 세팅 정보 추가 및 변경\
> \* Release v2.00\_240729 : 교환 접수 대상이 모두 '회수여부'가 '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/exchange/acceptExchangeFO":{"post":{"tags":["주문교환"],"summary":"교환접수(FO)","description":"## 기능 설명\n* FO에서 교환대상을 접수처리합니다.\n---\n## 상세 설명\n* **주문 번호(ordNo)**, **클레임업무유형(claimBusinessType)**, **시스템 유형(systemType)**은 필수로 있어야합니다.\n* 교환 접수 대상은 모두 같은 배송번호여야 접수 가능합니다.\n* 교환 접수 대상에 사은품 여부 확인(사은품 포항 될 경우 부분클레임 불가능)\n* 다음의 조건을 모두 충족하는 교환 대상에 대해 교환 처리가 가능합니다.\n    * 유효한 상품인지 체크합니다.\n        * 교환받을 상품의 **판매상태코드(PR005)**가 **판매중(10)**인지 체크합니다.\n        * 교환받을 상품의 **판매방식코드가(PR003)**가 **일반판매(10)**인지 체크합니다.\n        * 교환받을 상품이 교환대상 상품과 동일한 가격인지 체크합니다.\n        * 교환받을 상품의 재고를 체크합니다.\n* **주문교환데이터**를 생성하고 업데이트 처리합니다.\n    * **클레임 대분류 코드(claimLgrpCd)**가 **단순변심(10)**인 경우 배송비가 발생합니다.\n* 교환 접수시 발생하는 **결제 승인 정보**를 저장합니다.\n* 교환 접수시 발생하는 **결제 정보**를 **검증**처리합니다.\n* **재고 증감처리**를 수행합니다.\n* 교환 접수 후 **알림메시지 발송** 처리합니다.\n---\n## 특이 사항\n* **클레임업무유형(claimBusinessType)**이 **교환(30)**인 경우에만 교환접수가 진행됩니다.\n---\n## 수정번호\n* release_231009_01 : 주문혜택관계테이블 주문수량, 취소수량 컬럼 추가\n* release v2.00_240409 : 교환 접수 이메일 템플릿 변경에 따른 세팅 정보 추가 및 변경\n* Release v2.00_240729 : 교환 접수 대상이 모두 '회수여부'가 'N'인 경우, 회수 배송비 부과 제외, 알림 템플릿 변경\n","operationId":"acceptExchangeFO","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-28.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.