> 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-26.md).

# 클레임공통

## 클레임 배송비 결제 처리

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

## 비회원 주문 환불 계좌 정보 수정(BO)

> \## 기능설명\
> \* 주문번호 기준으로 비회원 주문 환불 계좌 정보를 업데이트합니다.\
> \---\
> \## 상세설명\
> \---\
> \## 특이사항\
> \* 예금주명은 주문자명과 일치해야합니다.\
> \* 필수 값 목록\
> &#x20;  \* 주문번호\
> &#x20;  \* 주문자명\
> &#x20;  \* 환불은행코드\
> &#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/common/saveNonMemberRefundActn":{"post":{"tags":["클레임공통"],"summary":"비회원 주문 환불 계좌 정보 수정(BO)","description":"## 기능설명\n* 주문번호 기준으로 비회원 주문 환불 계좌 정보를 업데이트합니다.\n---\n## 상세설명\n---\n## 특이사항\n* 예금주명은 주문자명과 일치해야합니다.\n* 필수 값 목록\n   * 주문번호\n   * 주문자명\n   * 환불은행코드\n   * 환불계좌번호\n   * 환불예금주\n","operationId":"saveNonMemberRefundActn","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefundAcceptRegisterRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"RefundAcceptRegisterRequest":{"required":["acptmnId","loginId","mbrNm","mbrNo","rfdActnCertiYn","rfdActnDepositorNm","rfdActnNo","rfdAmt","rfdBankCd","rfdCausCd","rfdCmsnAmt","rfdPrgsStatCd","rfdSmsSndYn","rfdTypCd"],"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"mbrNo":{"type":"string","description":"회원번호"},"mbrNm":{"type":"string","description":"회원명"},"loginId":{"type":"string","description":"로그인ID"},"rfdTypCd":{"type":"string","description":"환불유형코드(OM023)"},"rfdPrgsStatCd":{"type":"string","description":"환불진행상태코드(OM024)"},"rfdBankCd":{"type":"string","description":"환불은행코드(OM026)"},"rfdActnNo":{"type":"string","description":"환불계좌번호"},"rfdActnDepositorNm":{"type":"string","description":"환불예금주"},"rfdCausCd":{"type":"string","description":"환불사유코드(OM025)"},"rfdActnCertiYn":{"type":"string","description":"환불계좌인증여부"},"rfdAmt":{"type":"integer","description":"환불금액","format":"int64"},"rfdCmsnAmt":{"type":"integer","description":"환불수수료금액","format":"int64"},"acptmnId":{"type":"string","description":"접수자ID"},"rfdSmsSndYn":{"type":"string","description":"환불SMS발송여부"}},"description":"환불접수등록 Request 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"}}}}
```

## 비회원 주문 환불 계좌 정보 수정

> \## 기능설명\
> \* 주문번호 기준으로 비회원 주문 환불 계좌 정보를 업데이트합니다.\
> \---\
> \## 상세설명\
> \---\
> \## 특이사항\
> \* 예금주명은 주문자명과 일치해야합니다.\
> \* 필수 값 목록\
> &#x20;  \* 주문번호\
> &#x20;  \* 주문자명\
> &#x20;  \* 환불은행코드\
> &#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/common/saveNonMemberRefundActnFO":{"post":{"tags":["클레임공통"],"summary":"비회원 주문 환불 계좌 정보 수정","description":"## 기능설명\n* 주문번호 기준으로 비회원 주문 환불 계좌 정보를 업데이트합니다.\n---\n## 상세설명\n---\n## 특이사항\n* 예금주명은 주문자명과 일치해야합니다.\n* 필수 값 목록\n   * 주문번호\n   * 주문자명\n   * 환불은행코드\n   * 환불계좌번호\n   * 환불예금주\n","operationId":"saveNonMemberRefundActnFO","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefundAcceptRegisterRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"RefundAcceptRegisterRequest":{"required":["acptmnId","loginId","mbrNm","mbrNo","rfdActnCertiYn","rfdActnDepositorNm","rfdActnNo","rfdAmt","rfdBankCd","rfdCausCd","rfdCmsnAmt","rfdPrgsStatCd","rfdSmsSndYn","rfdTypCd"],"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"mbrNo":{"type":"string","description":"회원번호"},"mbrNm":{"type":"string","description":"회원명"},"loginId":{"type":"string","description":"로그인ID"},"rfdTypCd":{"type":"string","description":"환불유형코드(OM023)"},"rfdPrgsStatCd":{"type":"string","description":"환불진행상태코드(OM024)"},"rfdBankCd":{"type":"string","description":"환불은행코드(OM026)"},"rfdActnNo":{"type":"string","description":"환불계좌번호"},"rfdActnDepositorNm":{"type":"string","description":"환불예금주"},"rfdCausCd":{"type":"string","description":"환불사유코드(OM025)"},"rfdActnCertiYn":{"type":"string","description":"환불계좌인증여부"},"rfdAmt":{"type":"integer","description":"환불금액","format":"int64"},"rfdCmsnAmt":{"type":"integer","description":"환불수수료금액","format":"int64"},"acptmnId":{"type":"string","description":"접수자ID"},"rfdSmsSndYn":{"type":"string","description":"환불SMS발송여부"}},"description":"환불접수등록 Request 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)\*\*, \*\*시스템 유형(systemType)\*\*은 필수로 있어야합니다.\
> \* 다음의 조건을 모두 충족하는 대상에 대해 반품/교환 철회 처리가 가능합니다.\
> &#x20;   \* \*\*주문내역구분(OM003)\*\* 값이 \*\*반품(20)\*\* 이거나 \*\*교환(30)\*\*인 경우\
> &#x20;   \* \*\*주문내역상태(OM005)\*\* 값이 \*\*결제대기(31)\*\*, \*\*반품/교환접수(32)\*\*, \*\*회수지시(32)\*\*인 경우\
> &#x20;   \* \*\*반품 가능여부(rtnPsbYn)\*\* 값이 \*\*Y\*\* 인 경우\
> &#x20;   \* 일반 상품인 경우\*\*(사은품 제외)\*\*\
> &#x20;   \* 철회 가능 수량이 1개 이상인 경우 \*\*( 주문수량 – 취소수량 – 반품수량 > 0 )\*\*\
> \---\
> \## 수정 번호\
> \* Release v2.00\_240729 : 회수여부(wthdYn) 추가<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/common/getReturnExchangeCancelTargetInfo":{"post":{"tags":["클레임공통"],"summary":"반품/교환 철회대상 조회(BO)","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 v2.00_240729 : 회수여부(wthdYn) 추가\n","operationId":"getReturnExchangeCancelTargetInfo_1","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"}}}}}}}},"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"}}}}
```

## 배송 번호 채번 처리

> &#x20; \## 기능 설명\
> &#x20; \* 배송 번호 채번 목록 조회합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#x20; \* 요청 \*\*배송번호 리스트(dlvpList)\*\*는 필수로 있어야합니다.\
> &#x20; \* 요청하는 \*\*배송번호 리스트(dlvpList)\*\*의 수에 따라 배송번호를 채번합니다.\
> &#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/common/getNewNumberedDeliNo":{"post":{"tags":["클레임공통"],"summary":"배송 번호 채번 처리","description":"  ## 기능 설명\n  * 배송 번호 채번 목록 조회합니다.\n  ---\n  ## 상세 설명\n  * 요청 **배송번호 리스트(dlvpList)**는 필수로 있어야합니다.\n  * 요청하는 **배송번호 리스트(dlvpList)**의 수에 따라 배송번호를 채번합니다.\n  * 배송번호 채번 완료 후 채번한 **배송번호 목록**을 전달합니다.\n","operationId":"getNewNumberedDeliNo","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimDeliNoRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"array","items":{"type":"string"}}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"ClaimDeliNoRequest":{"required":["dlvpList"],"type":"object","properties":{"dlvpList":{"type":"array","description":"배송번호 리스트","items":{"type":"string","description":"배송번호 리스트"}}},"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 )\*\*<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/common/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","operationId":"getClaimPayWaitStateInfo_1","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"}}}}}}}},"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"}}}}
```

## 이미지 업로드 처리

> &#x20; \## 기능 설명\
> &#x20; \* 이미지 S3 업로드 처리합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#x20; \* \*\*시스템 유형(systemType)\*\*, \*\*주문 번호(ordNo)\*\*, \*\*업로드 파일(MultipartHttpServletRequest)\*\*은 필수로 있어야합니다.\
> &#x20; \* \*\*클레임 중분류\*\*가 \*\*상품불량\*\*일 경우에만 처리합니다.\
> &#x20; \* \*\*첨부파일업로드모듈(AttacheFileKind)\*\*에 따라 업로드 경로 설정됩니다.\
> &#x20; \* 업로드 완료 시 \*\*주문번호\*\*, \*\*주문순번\*\*, \*\*주문처리순번\*\*, \*\*파일URL\*\*, \*\*파일명\*\*이 포함된 \*\*주문상세첨부파일정보(PrOrdDtlAtchFileInfo)\*\*를 전달합니다.<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/common/claimImgUpload":{"post":{"tags":["클레임공통"],"summary":"이미지 업로드 처리","description":"  ## 기능 설명\n  * 이미지 S3 업로드 처리합니다.\n  ---\n  ## 상세 설명\n  * **시스템 유형(systemType)**, **주문 번호(ordNo)**, **업로드 파일(MultipartHttpServletRequest)**은 필수로 있어야합니다.\n  * **클레임 중분류**가 **상품불량**일 경우에만 처리합니다.\n  * **첨부파일업로드모듈(AttacheFileKind)**에 따라 업로드 경로 설정됩니다.\n  * 업로드 완료 시 **주문번호**, **주문순번**, **주문처리순번**, **파일URL**, **파일명**이 포함된 **주문상세첨부파일정보(PrOrdDtlAtchFileInfo)**를 전달합니다.\n","operationId":"claimImgUpload","parameters":[{"name":"claimImgRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/ClaimImgRequest"}},{"name":"userDetail","in":"query","required":true,"schema":{"$ref":"#/components/schemas/UserDetail"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PrOrdDtlAtchFileInfo"}}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"ClaimImgRequest":{"required":["ordNo","systemType"],"type":"object","properties":{"systemType":{"type":"string","description":"        SYSTEM(시스템유형)\n        * 10 : FO\n        * 20 : BO\n","enum":["FO","BO"],"default":"10"},"ordNo":{"type":"string","description":"주문번호"},"claimGoodsList":{"type":"array","description":"클레임대상목록","items":{"$ref":"#/components/schemas/ClaimGoodsRequest"}}},"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"},"UserDetail":{"type":"object","properties":{"userName":{"type":"string"},"mbrNo":{"type":"string"},"mbrMgrCd":{"type":"string"},"mbrGbCd":{"type":"string"},"loginId":{"type":"string"},"mbrGradeCd":{"type":"string"},"stafYn":{"type":"string"},"sexGbCd":{"type":"string"},"adlCertiYn":{"type":"string"},"age":{"type":"string"},"langCd":{"type":"string"},"comGbCd":{"type":"string"},"token":{"type":"string"},"refreshToken":{"type":"string"},"uuid":{"type":"string"},"certiYn":{"type":"string"}}},"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"}}}}
```

## 클레임 상세 내역 조회(B0)

> &#x20; \## 기능설명\
> &#x20; \* 클레임 상세 내역을 조회합니다.\
> &#x20; \---\
> &#x20; \## 상세설명\
> &#x20; \* \*\*주문번호(ordNo), 클레임번호(claimNo)\*\*는 필수 파라미터입니다.\
> &#x20; \* 요청 주문번호, 클레임번호에 해당하는 클레임 상세 내역을 제공합니다.\
> &#x20; \* 주문 내역 정보, 클레임 상품 정보, 환불/결제 내역, 환불예정쿠폰, 배송지정보를 제공합니다.\
> &#x20; \---\
> &#x20; \## 수정번호\
> &#x20; \* Release v2.00\_240711 : 배송 지역그룹 별 추가 배송비 적용\
> &#x20; \* Release v2.00\_240729 : 회수여부(wthdYn), 상품유형코드(goodsTypCd), 쿠폰번호(ecpnNo) 추가\
> &#x20; \* Release v2.00\_250818 : 교환 완료 후 반품 시 상위 결제 정보 메핑 변경<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/common/claimDetailsInfo":{"post":{"tags":["클레임공통"],"summary":"클레임 상세 내역 조회(B0)","description":"  ## 기능설명\n  * 클레임 상세 내역을 조회합니다.\n  ---\n  ## 상세설명\n  * **주문번호(ordNo), 클레임번호(claimNo)**는 필수 파라미터입니다.\n  * 요청 주문번호, 클레임번호에 해당하는 클레임 상세 내역을 제공합니다.\n  * 주문 내역 정보, 클레임 상품 정보, 환불/결제 내역, 환불예정쿠폰, 배송지정보를 제공합니다.\n  ---\n  ## 수정번호\n  * Release v2.00_240711 : 배송 지역그룹 별 추가 배송비 적용\n  * Release v2.00_240729 : 회수여부(wthdYn), 상품유형코드(goodsTypCd), 쿠폰번호(ecpnNo) 추가\n  * Release v2.00_250818 : 교환 완료 후 반품 시 상위 결제 정보 메핑 변경\n","operationId":"getClaimDetailsInfo","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/ClaimDetailsInfoResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"ClaimDetailsInfoRequest":{"required":["claimNo","ordNo"],"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"claimNo":{"type":"string","description":"클레임번호"}},"description":"클레임 상세 내역 조회 요청 DTO"},"ClaimDetailsInfoResponse":{"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"ordGbCd":{"type":"string","description":"주문구분코드"},"mbrNo":{"type":"string","description":"회원번호"},"ordManNm":{"type":"string","description":"주문자명"},"ordManCellSctNo":{"type":"string","description":"주문자휴대폰구분번호"},"ordManCellTxnoNo":{"type":"string","description":"주문자휴대폰국번번호"},"ordManCellEndNo":{"type":"string","description":"주문자휴대폰끝번호"},"ordManEmailAddr":{"type":"string","description":"주문자이메일주소"},"claimNo":{"type":"string","description":"클레임번호"},"ordAccpDtm":{"type":"string","description":"주문접수일시","format":"date-time"},"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"]},"claimGoodsDetailsList":{"type":"array","description":"클레임 대상 상품 목록","items":{"$ref":"#/components/schemas/ClaimGoodsDetails"}},"isAllNonReturnable":{"type":"boolean","description":"전체회수불필요 여부"},"dlvpInfo":{"$ref":"#/components/schemas/ClaimDlvp"},"withdrawDlvpInfo":{"$ref":"#/components/schemas/ClaimDlvp"},"restoreCpnInfo":{"$ref":"#/components/schemas/CpnCnclRequest"},"firstExchangeItmNm":{"type":"string"},"claimGoodsDetailsListClaimQtySum":{"type":"integer","format":"int32"},"firstGoodsNm":{"type":"string"},"firstItmNm":{"type":"string"},"upGoodsImg":{"type":"object","additionalProperties":{"type":"string"},"writeOnly":true},"expectedRefundAmt":{"type":"integer","format":"int64"},"firstOrdDtlStatCd":{"type":"string"},"simpleChange":{"type":"boolean"}},"description":"클레임 상세 내역 조회 응답 DTO"},"ClaimGoodsDetails":{"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"ordSeq":{"type":"integer","description":"주문순번","format":"int32"},"aeOrdSeq":{"type":"string","description":"본품주문순번"},"ordProcSeq":{"type":"integer","description":"주문처리순번","format":"int32"},"ordProcAccpDtm":{"type":"string","description":"주문처리일시","format":"date-time"},"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"goodsImg":{"type":"string","description":"상품이미지경로"},"brandNm":{"type":"string","description":"브랜드명"},"goodsNm":{"type":"string","description":"상품명"},"itmNm":{"type":"string","description":"단품명"},"norPrc":{"type":"integer","description":"정상가","format":"int64"},"salePrc":{"type":"integer","description":"판매가","format":"int64"},"goodsTypCd":{"type":"string","description":"상품유형코드(PR002)"},"ordQty":{"type":"integer","description":"주문수량","format":"int32"},"cnclQty":{"type":"integer","description":"취소수량","format":"int32"},"rtnQty":{"type":"integer","description":"반품수량","format":"int32"},"claimQty":{"type":"integer","description":"클레임수량","format":"int32"},"deliNo":{"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"]},"deliIndiRsvDtm":{"type":"string","description":"배송지시예약일시","format":"date-time"},"deliGbCd":{"type":"string","description":"        LO001(배송구분코드)\n        * 10 : 출하\n        * 20 : 회수\n","enum":["SHIPPING","WITHDRAWAL"]},"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"]},"exchangeItemNm":{"type":"string","description":"변경된 옵션명"},"exchangeItemNo":{"type":"string","description":"변경된 옵션번호"},"dlvpInfo":{"$ref":"#/components/schemas/ClaimDlvp"},"atchFileInfoList":{"type":"array","description":"첨부이미지목록","items":{"$ref":"#/components/schemas/PrOrdDtlAtchFileInfo"}},"prestNm":{"type":"string","description":"증정품명"},"wthdYn":{"type":"string","description":"회수여부","enum":["Y","N"]},"ecpnNo":{"type":"string","description":"e쿠폰번호"}},"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"},"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"},"CpnCnclRequest":{"required":["mbrNo","ordNo","restoreGbCd"],"type":"object","properties":{"mbrNo":{"type":"string","description":"회원번호"},"ordNo":{"type":"string","description":"주문번호"},"restoreGbCd":{"type":"string","description":"쿠폰복원유형\n 10 : 주문서\n, 20 : 클레임\n, 99 : 기타\n","enum":["10","20","99"]},"cpnInfo":{"type":"array","description":"쿠폰 리스트","items":{"$ref":"#/components/schemas/CpnCnclInfo"}},"cpnIsuNoList":{"type":"array","items":{"type":"string"}}},"description":"복원 쿠폰정보 요청 DTO"},"CpnCnclInfo":{"required":["cpnIsuNo"],"type":"object","properties":{"cpnIsuNo":{"type":"string","description":"쿠폰발급번호"}},"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)

> &#x20; \## 기능설명\
> &#x20; \* 클레임 상세 내역을 조회합니다.\
> &#x20; \---\
> &#x20; \## 상세설명\
> &#x20; \* \*\*주문번호(ordNo), 클레임번호(claimNo)\*\*는 필수 파라미터입니다.\
> &#x20; \* 요청 주문번호, 클레임번호에 해당하는 클레임 상세 내역을 제공합니다.\
> &#x20; \* 주문 내역 정보, 클레임 상품 정보, 환불/결제 내역, 환불예정쿠폰, 배송지정보를 제공합니다.\
> &#x20; \---\
> &#x20; \## 수정번호\
> &#x20; \* Release 2.00\_240401: 주문구분코드 추가, 증정품명 추가\
> &#x20; \* Release v2.00\_240425 : 멀티 사이트 확장에 따른 사이트 번호(site\_no) 추가\
> &#x20; \* Release v2.00\_240711 : 배송 지역그룹 별 추가 배송비 적용\
> &#x20; \* Release v2.00\_240729 : 회수여부(wthdYn), 상품유형코드(goodsTypCd), 쿠폰번호(ecpnNo) 추가<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/common/claimDetailsInfoFO":{"post":{"tags":["클레임공통"],"summary":"클레임 상세 내역 조회(FO)","description":"  ## 기능설명\n  * 클레임 상세 내역을 조회합니다.\n  ---\n  ## 상세설명\n  * **주문번호(ordNo), 클레임번호(claimNo)**는 필수 파라미터입니다.\n  * 요청 주문번호, 클레임번호에 해당하는 클레임 상세 내역을 제공합니다.\n  * 주문 내역 정보, 클레임 상품 정보, 환불/결제 내역, 환불예정쿠폰, 배송지정보를 제공합니다.\n  ---\n  ## 수정번호\n  * Release 2.00_240401: 주문구분코드 추가, 증정품명 추가\n  * Release v2.00_240425 : 멀티 사이트 확장에 따른 사이트 번호(site_no) 추가\n  * Release v2.00_240711 : 배송 지역그룹 별 추가 배송비 적용\n  * Release v2.00_240729 : 회수여부(wthdYn), 상품유형코드(goodsTypCd), 쿠폰번호(ecpnNo) 추가\n","operationId":"getClaimDetailsInfoFO","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/ClaimDetailsInfoResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"ClaimDetailsInfoRequest":{"required":["claimNo","ordNo"],"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"claimNo":{"type":"string","description":"클레임번호"}},"description":"클레임 상세 내역 조회 요청 DTO"},"ClaimDetailsInfoResponse":{"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"ordGbCd":{"type":"string","description":"주문구분코드"},"mbrNo":{"type":"string","description":"회원번호"},"ordManNm":{"type":"string","description":"주문자명"},"ordManCellSctNo":{"type":"string","description":"주문자휴대폰구분번호"},"ordManCellTxnoNo":{"type":"string","description":"주문자휴대폰국번번호"},"ordManCellEndNo":{"type":"string","description":"주문자휴대폰끝번호"},"ordManEmailAddr":{"type":"string","description":"주문자이메일주소"},"claimNo":{"type":"string","description":"클레임번호"},"ordAccpDtm":{"type":"string","description":"주문접수일시","format":"date-time"},"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"]},"claimGoodsDetailsList":{"type":"array","description":"클레임 대상 상품 목록","items":{"$ref":"#/components/schemas/ClaimGoodsDetails"}},"isAllNonReturnable":{"type":"boolean","description":"전체회수불필요 여부"},"dlvpInfo":{"$ref":"#/components/schemas/ClaimDlvp"},"withdrawDlvpInfo":{"$ref":"#/components/schemas/ClaimDlvp"},"restoreCpnInfo":{"$ref":"#/components/schemas/CpnCnclRequest"},"firstExchangeItmNm":{"type":"string"},"claimGoodsDetailsListClaimQtySum":{"type":"integer","format":"int32"},"firstGoodsNm":{"type":"string"},"firstItmNm":{"type":"string"},"upGoodsImg":{"type":"object","additionalProperties":{"type":"string"},"writeOnly":true},"expectedRefundAmt":{"type":"integer","format":"int64"},"firstOrdDtlStatCd":{"type":"string"},"simpleChange":{"type":"boolean"}},"description":"클레임 상세 내역 조회 응답 DTO"},"ClaimGoodsDetails":{"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"ordSeq":{"type":"integer","description":"주문순번","format":"int32"},"aeOrdSeq":{"type":"string","description":"본품주문순번"},"ordProcSeq":{"type":"integer","description":"주문처리순번","format":"int32"},"ordProcAccpDtm":{"type":"string","description":"주문처리일시","format":"date-time"},"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"goodsImg":{"type":"string","description":"상품이미지경로"},"brandNm":{"type":"string","description":"브랜드명"},"goodsNm":{"type":"string","description":"상품명"},"itmNm":{"type":"string","description":"단품명"},"norPrc":{"type":"integer","description":"정상가","format":"int64"},"salePrc":{"type":"integer","description":"판매가","format":"int64"},"goodsTypCd":{"type":"string","description":"상품유형코드(PR002)"},"ordQty":{"type":"integer","description":"주문수량","format":"int32"},"cnclQty":{"type":"integer","description":"취소수량","format":"int32"},"rtnQty":{"type":"integer","description":"반품수량","format":"int32"},"claimQty":{"type":"integer","description":"클레임수량","format":"int32"},"deliNo":{"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"]},"deliIndiRsvDtm":{"type":"string","description":"배송지시예약일시","format":"date-time"},"deliGbCd":{"type":"string","description":"        LO001(배송구분코드)\n        * 10 : 출하\n        * 20 : 회수\n","enum":["SHIPPING","WITHDRAWAL"]},"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"]},"exchangeItemNm":{"type":"string","description":"변경된 옵션명"},"exchangeItemNo":{"type":"string","description":"변경된 옵션번호"},"dlvpInfo":{"$ref":"#/components/schemas/ClaimDlvp"},"atchFileInfoList":{"type":"array","description":"첨부이미지목록","items":{"$ref":"#/components/schemas/PrOrdDtlAtchFileInfo"}},"prestNm":{"type":"string","description":"증정품명"},"wthdYn":{"type":"string","description":"회수여부","enum":["Y","N"]},"ecpnNo":{"type":"string","description":"e쿠폰번호"}},"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"},"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"},"CpnCnclRequest":{"required":["mbrNo","ordNo","restoreGbCd"],"type":"object","properties":{"mbrNo":{"type":"string","description":"회원번호"},"ordNo":{"type":"string","description":"주문번호"},"restoreGbCd":{"type":"string","description":"쿠폰복원유형\n 10 : 주문서\n, 20 : 클레임\n, 99 : 기타\n","enum":["10","20","99"]},"cpnInfo":{"type":"array","description":"쿠폰 리스트","items":{"$ref":"#/components/schemas/CpnCnclInfo"}},"cpnIsuNoList":{"type":"array","items":{"type":"string"}}},"description":"복원 쿠폰정보 요청 DTO"},"CpnCnclInfo":{"required":["cpnIsuNo"],"type":"object","properties":{"cpnIsuNo":{"type":"string","description":"쿠폰발급번호"}},"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)

> &#x20; \## 기능설명\
> &#x20; \* 클레임 비용 계산 조회\
> &#x20; \---\
> &#x20; \## 상세내용\
> &#x20; \* 클레임 업무 별 화면 추가 결제/환불 금액 정보 및 환불수단 정보 제공\
> &#x20; \* 클레임 업무 처리 시 DB 기준 부가비용, 혜택정보  추가결제/환불 예정 데이터 생성 정보 및 쿠폰 사용/복원 정보 제공\
> &#x20; \---\
> &#x20; \## 수정번호\
> &#x20; \* Release v2.00\_240627 : 주문 취소시 복수 개의 배송 그룹에 대해 접수가 가능하도록 비용 계산 로직 수정 (전체 취소 기능 추가)\
> &#x20; \* Release v2.00\_240711 : 배송 지역그룹 별 추가 배송비 적용\
> &#x20; \* Release v2.00\_240729 : 접수 대상이 모두 '회수여부'가 'N'인 경우, 회수 배송비 0원 부과<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/common/claimCalculateCost":{"post":{"tags":["클레임공통"],"summary":"클레임 비용 계산 조회(BO)","description":"  ## 기능설명\n  * 클레임 비용 계산 조회\n  ---\n  ## 상세내용\n  * 클레임 업무 별 화면 추가 결제/환불 금액 정보 및 환불수단 정보 제공\n  * 클레임 업무 처리 시 DB 기준 부가비용, 혜택정보  추가결제/환불 예정 데이터 생성 정보 및 쿠폰 사용/복원 정보 제공\n  ---\n  ## 수정번호\n  * Release v2.00_240627 : 주문 취소시 복수 개의 배송 그룹에 대해 접수가 가능하도록 비용 계산 로직 수정 (전체 취소 기능 추가)\n  * Release v2.00_240711 : 배송 지역그룹 별 추가 배송비 적용\n  * Release v2.00_240729 : 접수 대상이 모두 '회수여부'가 'N'인 경우, 회수 배송비 0원 부과\n","operationId":"calculate","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimCalculateRequest"}}},"required":true},"responses":{"200":{"description":"BO 클레임 비용 계산 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ClaimCalculateResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"ClaimCalculateRequest":{"required":["claimBusinessType","claimCalculateWorkType","deliMethodCd","ordMediaCd","ordNo","systemType"],"type":"object","properties":{"ordNo":{"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"]},"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"]},"systemType":{"type":"string","description":"        SYSTEM(시스템유형)\n        * 10 : FO\n        * 20 : BO\n","enum":["FO","BO"]},"claimCalculateWorkType":{"type":"string","description":"        ClaimCalculateWorkType(클레임 혜택/비용처리 업무유형)\n        * 10 : 클레임처리 화면조회\n        * 20 : 클레임처리\n        * 30 : 클레임상세내역 화면조회\n","enum":["VIEW_SEARCH_PROCESS","CLAIM_PROCESS","VIEW_SEARCH_DETAIL"]},"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"]},"orgClmNo":{"type":"string","description":"현재 클레임 번호"},"newNumberedClmNo":{"type":"string","description":"새로 채번된 클레임 번호"},"selectedRtnDlvBenefitYn":{"type":"string","description":"반품무료쿠폰 화면선택여부","enum":["Y","N"]},"dlvpInfo":{"$ref":"#/components/schemas/ClaimDlvp"},"withdrawalInfo":{"$ref":"#/components/schemas/ClaimDlvp"},"rtnDlvBenefitInfo":{"$ref":"#/components/schemas/ClaimDlvBenefitInfo"},"claimGoodsList":{"type":"array","description":"클레임 대상 상품정보 리스트","items":{"$ref":"#/components/schemas/ClaimTargetGoodsResponse"}},"customerCauseFault":{"type":"boolean"}},"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"},"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":"반품쿠폰정보 리스트"},"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"},"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":"주문상세 목록"},"ClaimCalculateResponse":{"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"claimFinalAmtInfo":{"$ref":"#/components/schemas/ClaimFinalAmtInfo"},"restoreCouponInfo":{"$ref":"#/components/schemas/CpnCnclRequest"},"useCouponInfo":{"$ref":"#/components/schemas/CpnUseRequest"}},"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"},"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"},"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"},"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"},"CpnCnclRequest":{"required":["mbrNo","ordNo","restoreGbCd"],"type":"object","properties":{"mbrNo":{"type":"string","description":"회원번호"},"ordNo":{"type":"string","description":"주문번호"},"restoreGbCd":{"type":"string","description":"쿠폰복원유형\n 10 : 주문서\n, 20 : 클레임\n, 99 : 기타\n","enum":["10","20","99"]},"cpnInfo":{"type":"array","description":"쿠폰 리스트","items":{"$ref":"#/components/schemas/CpnCnclInfo"}},"cpnIsuNoList":{"type":"array","items":{"type":"string"}}},"description":"복원 쿠폰정보 요청 DTO"},"CpnCnclInfo":{"required":["cpnIsuNo"],"type":"object","properties":{"cpnIsuNo":{"type":"string","description":"쿠폰발급번호"}},"description":"복원 쿠폰정보 DTO"},"CpnUseRequest":{"required":["mbrNo","ordNo"],"type":"object","properties":{"mbrNo":{"type":"string","description":"회원번호"},"ordNo":{"type":"string","description":"주문번호"},"cpnInfo":{"type":"array","description":"쿠폰 리스트","items":{"$ref":"#/components/schemas/CpnUseInfo"}},"cpnIsuNoList":{"type":"array","items":{"type":"string"}}},"description":"사용 쿠폰정보 요청 DTO"},"CpnUseInfo":{"required":["cpnIsuNo"],"type":"object","properties":{"cpnIsuNo":{"type":"string","description":"쿠폰발급번호"}},"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)

> &#x20; \## 기능 설명\
> &#x20; \* 클레임 비용 계산 조회\
> &#x20; \---\
> &#x20; \## 상세 내용\
> &#x20; \* 클레임 업무 별 화면 추가 결제/환불 금액 정보 및 환불수단 정보 제공\
> &#x20; \* 클레임 업무 처리 시 DB 기준 부가비용, 혜택정보  추가결제/환불 예정 데이터 생성 정보 및 쿠폰 사용/복원 정보 제공\
> &#x20; \## 수정번호\
> &#x20; \* Release v2.00\_240401 : 배송비용 발생으로 인한 추가결제 연관 비용 체크 수정\
> &#x20; \* Release v2.00\_240509 : 쿠폰 적용대상에 기획전 정보 저장 추가\
> &#x20; \* Release v2.00\_240627 : 주문 취소시 복수 개의 배송 그룹에 대해 접수가 가능하도록 비용 계산 로직 수정 (전체 취소 기능 추가)\
> &#x20; \* Release v2.00\_240711 : 배송 지역그룹 별 추가 배송비 적용\
> &#x20; \* Release v2.00\_240729 : 접수 대상이 모두 '회수여부'가 'N'인 경우, 회수 배송비 0원 부과<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/common/claimCalculateCostFO":{"post":{"tags":["클레임공통"],"summary":"클레임 비용 계산 조회(FO)","description":"  ## 기능 설명\n  * 클레임 비용 계산 조회\n  ---\n  ## 상세 내용\n  * 클레임 업무 별 화면 추가 결제/환불 금액 정보 및 환불수단 정보 제공\n  * 클레임 업무 처리 시 DB 기준 부가비용, 혜택정보  추가결제/환불 예정 데이터 생성 정보 및 쿠폰 사용/복원 정보 제공\n  ## 수정번호\n  * Release v2.00_240401 : 배송비용 발생으로 인한 추가결제 연관 비용 체크 수정\n  * Release v2.00_240509 : 쿠폰 적용대상에 기획전 정보 저장 추가\n  * Release v2.00_240627 : 주문 취소시 복수 개의 배송 그룹에 대해 접수가 가능하도록 비용 계산 로직 수정 (전체 취소 기능 추가)\n  * Release v2.00_240711 : 배송 지역그룹 별 추가 배송비 적용\n  * Release v2.00_240729 : 접수 대상이 모두 '회수여부'가 'N'인 경우, 회수 배송비 0원 부과\n","operationId":"calculateFO","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimCalculateRequest"}}},"required":true},"responses":{"200":{"description":"FO 클레임 비용 계산 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ClaimCalculateResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"ClaimCalculateRequest":{"required":["claimBusinessType","claimCalculateWorkType","deliMethodCd","ordMediaCd","ordNo","systemType"],"type":"object","properties":{"ordNo":{"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"]},"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"]},"systemType":{"type":"string","description":"        SYSTEM(시스템유형)\n        * 10 : FO\n        * 20 : BO\n","enum":["FO","BO"]},"claimCalculateWorkType":{"type":"string","description":"        ClaimCalculateWorkType(클레임 혜택/비용처리 업무유형)\n        * 10 : 클레임처리 화면조회\n        * 20 : 클레임처리\n        * 30 : 클레임상세내역 화면조회\n","enum":["VIEW_SEARCH_PROCESS","CLAIM_PROCESS","VIEW_SEARCH_DETAIL"]},"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"]},"orgClmNo":{"type":"string","description":"현재 클레임 번호"},"newNumberedClmNo":{"type":"string","description":"새로 채번된 클레임 번호"},"selectedRtnDlvBenefitYn":{"type":"string","description":"반품무료쿠폰 화면선택여부","enum":["Y","N"]},"dlvpInfo":{"$ref":"#/components/schemas/ClaimDlvp"},"withdrawalInfo":{"$ref":"#/components/schemas/ClaimDlvp"},"rtnDlvBenefitInfo":{"$ref":"#/components/schemas/ClaimDlvBenefitInfo"},"claimGoodsList":{"type":"array","description":"클레임 대상 상품정보 리스트","items":{"$ref":"#/components/schemas/ClaimTargetGoodsResponse"}},"customerCauseFault":{"type":"boolean"}},"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"},"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":"반품쿠폰정보 리스트"},"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"},"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":"주문상세 목록"},"ClaimCalculateResponse":{"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"claimFinalAmtInfo":{"$ref":"#/components/schemas/ClaimFinalAmtInfo"},"restoreCouponInfo":{"$ref":"#/components/schemas/CpnCnclRequest"},"useCouponInfo":{"$ref":"#/components/schemas/CpnUseRequest"}},"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"},"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"},"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"},"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"},"CpnCnclRequest":{"required":["mbrNo","ordNo","restoreGbCd"],"type":"object","properties":{"mbrNo":{"type":"string","description":"회원번호"},"ordNo":{"type":"string","description":"주문번호"},"restoreGbCd":{"type":"string","description":"쿠폰복원유형\n 10 : 주문서\n, 20 : 클레임\n, 99 : 기타\n","enum":["10","20","99"]},"cpnInfo":{"type":"array","description":"쿠폰 리스트","items":{"$ref":"#/components/schemas/CpnCnclInfo"}},"cpnIsuNoList":{"type":"array","items":{"type":"string"}}},"description":"복원 쿠폰정보 요청 DTO"},"CpnCnclInfo":{"required":["cpnIsuNo"],"type":"object","properties":{"cpnIsuNo":{"type":"string","description":"쿠폰발급번호"}},"description":"복원 쿠폰정보 DTO"},"CpnUseRequest":{"required":["mbrNo","ordNo"],"type":"object","properties":{"mbrNo":{"type":"string","description":"회원번호"},"ordNo":{"type":"string","description":"주문번호"},"cpnInfo":{"type":"array","description":"쿠폰 리스트","items":{"$ref":"#/components/schemas/CpnUseInfo"}},"cpnIsuNoList":{"type":"array","items":{"type":"string"}}},"description":"사용 쿠폰정보 요청 DTO"},"CpnUseInfo":{"required":["cpnIsuNo"],"type":"object","properties":{"cpnIsuNo":{"type":"string","description":"쿠폰발급번호"}},"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"}}}}
```

## 클레임 추가 결제정보 조회

> &#x20; \## 기능 설명\
> &#x20; \* 클레임 추가결제에 필요한 정보를 조회합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#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/common/additionalFeePaymentInfo":{"post":{"tags":["클레임공통"],"summary":"클레임 추가 결제정보 조회","description":"  ## 기능 설명\n  * 클레임 추가결제에 필요한 정보를 조회합니다.\n  ---\n  ## 상세 설명\n  * 사용가능한 주결제수단, 보조결제수단 목록을 조회합니다.\n  * 로그인된 회원 정보가 있을 경우, 사용가능 마일리지 정보도 보조결제수단목록에 포함되어 조회됩니다.\n","operationId":"getAdditionalFeePaymentInfo","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ClaimAdditionalFeePaymentInfo"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"ClaimAdditionalFeePaymentInfo":{"type":"object","properties":{"mainPayMethodInfoList":{"type":"array","description":"주결제수단목록","items":{"$ref":"#/components/schemas/PayMethodInfo"}},"subPayMethodInfoList":{"type":"array","description":"보조결제수단목록","items":{"$ref":"#/components/schemas/PayMethodInfo"}}},"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"}}}}
```

## 비회원 주문 환불 계좌 정보 조회

> \## 기능설명\
> \* 주문번호 기준으로 비회원 주문 환불 계좌 정보를 조회합니다.\
> \---\
> \## 상세설명\
> \* op\_ord\_base 테이블에서 환불 계좌 정보를 조회합니다.\
> \* 주문번호는 필수 파라미터입니다.\
> \---\
> \## 특이사항\
> \* 전달하는 데이터 중 계좌번호는 마스킹 처리되어 출력됩니다.<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/common/getNonMemberRefundActnInfo":{"get":{"tags":["클레임공통"],"summary":"비회원 주문 환불 계좌 정보 조회","description":"## 기능설명\n* 주문번호 기준으로 비회원 주문 환불 계좌 정보를 조회합니다.\n---\n## 상세설명\n* op_ord_base 테이블에서 환불 계좌 정보를 조회합니다.\n* 주문번호는 필수 파라미터입니다.\n---\n## 특이사항\n* 전달하는 데이터 중 계좌번호는 마스킹 처리되어 출력됩니다.\n","operationId":"getNonMemberRefundActn","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/RefundAcceptRegisterRequest"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RfdInfoResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"RefundAcceptRegisterRequest":{"required":["acptmnId","loginId","mbrNm","mbrNo","rfdActnCertiYn","rfdActnDepositorNm","rfdActnNo","rfdAmt","rfdBankCd","rfdCausCd","rfdCmsnAmt","rfdPrgsStatCd","rfdSmsSndYn","rfdTypCd"],"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"mbrNo":{"type":"string","description":"회원번호"},"mbrNm":{"type":"string","description":"회원명"},"loginId":{"type":"string","description":"로그인ID"},"rfdTypCd":{"type":"string","description":"환불유형코드(OM023)"},"rfdPrgsStatCd":{"type":"string","description":"환불진행상태코드(OM024)"},"rfdBankCd":{"type":"string","description":"환불은행코드(OM026)"},"rfdActnNo":{"type":"string","description":"환불계좌번호"},"rfdActnDepositorNm":{"type":"string","description":"환불예금주"},"rfdCausCd":{"type":"string","description":"환불사유코드(OM025)"},"rfdActnCertiYn":{"type":"string","description":"환불계좌인증여부"},"rfdAmt":{"type":"integer","description":"환불금액","format":"int64"},"rfdCmsnAmt":{"type":"integer","description":"환불수수료금액","format":"int64"},"acptmnId":{"type":"string","description":"접수자ID"},"rfdSmsSndYn":{"type":"string","description":"환불SMS발송여부"}},"description":"환불접수등록 Request DTO"},"RfdInfoResponse":{"type":"object","properties":{"rfdBankCd":{"type":"string","description":"은행코드 (OM026)"},"rfdBankNm":{"type":"string","description":"은행명"},"rfdActnNo":{"type":"string","description":"환불계좌번호"},"rfdActnDepositorNm":{"type":"string","description":"환불 계좌 예금주명"},"rfdActnCertiYn":{"type":"string","description":"환불 계좌 인증여부"}},"description":"환불 계좌정보 조회 Response"},"Response":{"type":"object","properties":{"timestamp":{"type":"string","description":"result time","format":"date-time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}},"description":"validation error list"}}}}
```