> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api/store-front-api/order-api/undefined-27.md).

# 주문교환

## 교환 접수 철회(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"}}}}
```