# 클레임공통

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

> \## 기능 설명\
> \* 결제대기 상태의 클레임에 대해 배송비 추가결제를 진행하고 주문내역상태를 수정합니다.\
> \---\
> \## 상세 설명\
> \* \*\*주문 번호(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"}}}}
```


---

# Agent Instructions: Querying This Documentation

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

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

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

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

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