# 가상계좌

## 가상계좌 입금 노티

> \## 기능설명\
> 이니시스 가상계좌 입금 노티 수신 (PC/모바일 통합)\
> \---\
> \## 상세설명\
> \* 이니시스 가상계좌 입금 노티를 수신하여 주문 정보를 업데이트합니다.\
> \* 주문 정보 업데이트 성공 시, 현금영수증 발급 및 주문 완료 알림 메시지를 전송합니다.<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/inicis/vbank/noti":{"post":{"tags":["가상계좌"],"summary":"가상계좌 입금 노티","description":"## 기능설명\n이니시스 가상계좌 입금 노티 수신 (PC/모바일 통합)\n---\n## 상세설명\n* 이니시스 가상계좌 입금 노티를 수신하여 주문 정보를 업데이트합니다.\n* 주문 정보 업데이트 성공 시, 현금영수증 발급 및 주문 완료 알림 메시지를 전송합니다.\n","operationId":"notify","parameters":[{"name":"params","in":"query","required":true,"schema":{"type":"object","additionalProperties":{"type":"string"}}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"성공","content":{"text/plain":{"schema":{"type":"string"}}}},"900":{"description":"실패","content":{"text/plain":{"schema":{"type":"string"}}}}}}}}}
```

## 가상계좌 입금 확인 처리 (BO)

> \## 기능설명\
> BO에서 가상계좌 입금 확인 요청을 통해 주문/결제 상태를 업데이트합니다.\
> \---\
> \## 상세설명\
> \* 자동 입금 노티 미수신 건에 대해 보조적으로 사용됩니다.\
> \* 중복 요청 시 추가 처리는 수행되지 않습니다.<br>

```json
{"openapi":"3.0.1","info":{"title":"X2BEE Order API","version":"v1"},"servers":[{"url":"https://api-order.x2bee.com/api/order/","description":"prd"}],"paths":{"/v1/inicis/vbank/manualConfirm":{"post":{"tags":["가상계좌"],"summary":"가상계좌 입금 확인 처리 (BO)","description":"## 기능설명\nBO에서 가상계좌 입금 확인 요청을 통해 주문/결제 상태를 업데이트합니다.\n---\n## 상세설명\n* 자동 입금 노티 미수신 건에 대해 보조적으로 사용됩니다.\n* 중복 요청 시 추가 처리는 수행되지 않습니다.\n","operationId":"manualConfirm","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InicisVBankNotifyRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/DepositNotifyResult"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"InicisVBankNotifyRequest":{"type":"object","properties":{"clientIp":{"type":"string","description":"ip"},"systemType":{"type":"string","description":"        SYSTEM(시스템유형)\n        * 10 : FO\n        * 20 : BO\n","enum":["FO","BO"],"default":"10"},"tid":{"type":"string","description":"거래번호 (PC: no_tid, 모바일: P_TID)"},"ordNo":{"type":"string","description":"상점 주문번호 (PC: no_oid, 모바일: P_OID)"},"merchantId":{"type":"string","description":"상점 아이디 (PC: id_merchant, 모바일: P_MID)"},"transDate":{"type":"string","description":"금융기관 발생 거래 일자 (PC: dt_trans, 모바일: P_AUTH_DT 앞 8자리)"},"transTime":{"type":"string","description":"금융기관 발생 거래 시각 (PC: tm_trans, 모바일: P_AUTH_DT 뒤 6자리)"},"bankCode":{"type":"string","description":"은행코드 (PC: cd_bank, 모바일: P_FN_CD1)"},"dealBankCode":{"type":"string","description":"고객 실입금 시 은행코드 (PC만 해당)"},"vbankNo":{"type":"string","description":"가상계좌번호 (PC: no_vacct, 모바일: P_VACCT_NO)"},"inputAmount":{"type":"integer","description":"입금금액 (PC: amt_input, 모바일: P_AMT)","format":"int64"},"closeFlag":{"type":"string","description":"마감구분 (PC만 해당)"},"closeCode":{"type":"string","description":"마감구분코드 (PC만 해당)"},"msgType":{"type":"string","description":"거래구분 (PC: type_msg, 모바일: P_STATUS)"},"inputBankName":{"type":"string","description":"입금은행명 (PC: nm_inputbank, 모바일: P_FN_NM)"},"depositorName":{"type":"string","description":"입금자명 (PC: nm_input, 모바일: P_UNAME)"},"resultMsg1":{"type":"string","description":"메시지1"},"resultMsg2":{"type":"string","description":"메시지2"},"notiData":{"type":"string","description":"가맹점 임의 데이터"},"authNo":{"type":"string","description":"승인번호"},"payType":{"type":"string","description":"결제수단 (모바일: P_TYPE)"},"normalTransaction":{"type":"boolean"},"mobileNotify":{"type":"boolean"},"pcNotify":{"type":"boolean"}},"description":"이니시스 가상계좌 입금 노티 요청"},"DepositNotifyResult":{"type":"object","properties":{"result":{"type":"string"},"mgrLog":{"$ref":"#/components/schemas/OpOrdMgrLog"},"targetInfo":{"$ref":"#/components/schemas/VBankNotifyTargetInfo"},"alreadyConfirmed":{"type":"boolean"}}},"OpOrdMgrLog":{"type":"object","properties":{"siteNo":{"type":"string"},"ordMgrLogSeq":{"type":"string"},"logDt":{"type":"string"},"logGbCd":{"type":"string"},"ordNo":{"type":"string"},"claimNo":{"type":"string"},"mbrNo":{"type":"string"},"procStatCd":{"type":"string"},"reqHerJson":{"type":"string"},"reqPrmtJson":{"type":"string"},"rplyConts":{"type":"string"},"errorConts":{"type":"string"},"rmkConts":{"type":"string"},"reqDtlJson":{"type":"string"}}},"VBankNotifyTargetInfo":{"required":["ordGbCd"],"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"trdNo":{"type":"string","description":"거래번호"},"trdDtm":{"type":"string","description":"거래일시","format":"date-time"},"payFnshDtm":{"type":"string","description":"결제완료일시","format":"date-time"},"mbrNo":{"type":"string","description":"회원번호"},"ordManNm":{"type":"string","description":"주문자명"},"ordManCellNo":{"type":"string","description":"주문자휴대폰번호"},"ordManEmailAddr":{"type":"string","description":"주문자이메일주소"},"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"]},"prstTypCd":{"type":"string","description":"선물유형코드(OM045)"},"prstMsg":{"type":"string","description":"선물메시지"},"ordGoodsGb":{"type":"string","description":"OM029(주문 상품 구분 코드)\n 10: 일반상품\n , 20: e쿠폰\n","enum":["GENERAL_GOODS","E_COUPON"]},"ordSeq":{"type":"integer","description":"주문순번","format":"int32"},"ordProcSeq":{"type":"integer","description":"주문처리순번","format":"int32"},"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"]},"ecpnNo":{"type":"string","description":"e쿠폰번호"},"payNo":{"type":"string","description":"결제번호"},"payAmt":{"type":"integer","description":"결제금액","format":"int64"},"dptFcstDt":{"type":"string","description":"입금예정일자"},"dptCnfmDtm":{"type":"string","description":"입금확인일시","format":"date-time"},"opOrdBase":{"$ref":"#/components/schemas/OpOrdBase"},"opOrdDtlList":{"type":"array","description":"주문상세 목록","items":{"$ref":"#/components/schemas/OpOrdDtl"}},"opOrdDtlGoodsInfoList":{"type":"array","description":"주문상품 목록","items":{"$ref":"#/components/schemas/OpOrdDtlGoodsInfo"}},"ordDlvInfoList":{"type":"array","description":"배송지 목록","items":{"$ref":"#/components/schemas/OrdDlvInfo"}},"opOrdPayBaseList":{"type":"array","description":"결제정보 목록","items":{"$ref":"#/components/schemas/OpOrdPayBase"}},"opOrdAdtnCostList":{"type":"array","description":"주문부가비용 목록","items":{"$ref":"#/components/schemas/OpOrdAdtnCost"}},"opOrdFvrCostList":{"type":"array","description":"주문혜택비용 목록","items":{"$ref":"#/components/schemas/OpOrdFvrCost"}},"goodsDeliInfoList":{"type":"array","description":"주문상품배송 목록","items":{"$ref":"#/components/schemas/OrdGoodsDeliInfo"}},"alreadyConfirmed":{"type":"boolean"}}},"OpOrdBase":{"type":"object","properties":{"siteNo":{"type":"string"},"ordNo":{"type":"string"},"ordMediaCd":{"type":"string"},"ordGbCd":{"type":"string"},"mbrNo":{"type":"string"},"loginId":{"type":"string"},"mbrMgrGbCd":{"type":"string"},"ordManNm":{"type":"string"},"ordAccpDtm":{"type":"string","format":"date-time"},"mbrGradeCd":{"type":"string"},"mbrMgrCd":{"type":"string"},"fstOrdYn":{"type":"string"},"umemPwd":{"type":"string"},"ordManEmailAddr":{"type":"string"},"ordManCellSctNo":{"type":"string"},"ordManCellTxnoNo":{"type":"string"},"ordManCellEndNo":{"type":"string"},"ordManTelRgnNo":{"type":"string"},"ordManTelTxnoNo":{"type":"string"},"ordManTelEndNo":{"type":"string"},"ordManZipNo":{"type":"string"},"ordManZipAddr":{"type":"string"},"ordManDtlAddr":{"type":"string"},"rfdBankCd":{"type":"string"},"rfdActnNo":{"type":"string"},"rfdActnDepositorNm":{"type":"string"},"prstTypCd":{"type":"string"},"prstStatCd":{"type":"string"},"prstMsg":{"type":"string"},"prstRecvmnMbrNo":{"type":"string"},"rglrDeliNo":{"type":"string"},"chlNo":{"type":"string"},"chlDtlNo":{"type":"string"},"ordGoodsGb":{"type":"string"}},"description":"주문기본"},"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":"주문상세 목록"},"OpOrdDtlGoodsInfo":{"type":"object","properties":{"ordNo":{"type":"string"},"goodsNo":{"type":"string"},"itmNo":{"type":"string"},"ordSaleTypCd":{"type":"string"},"chlNo":{"type":"string"},"chlDtlNo":{"type":"string"},"stdCtgNo":{"type":"string"},"infDispCtgNoGbCd":{"type":"string"},"infDispCtgNo":{"type":"string"},"repDispCtgNo":{"type":"string"},"conrNo":{"type":"string"},"brandNo":{"type":"string"},"brandNm":{"type":"string"},"goodsNm":{"type":"string"},"itmNm":{"type":"string"},"prestNm":{"type":"string"},"goodsCompCd":{"type":"string"},"goodsTypCd":{"type":"string"},"saleMethCd":{"type":"string"},"taxGbCd":{"type":"string"},"buyTypCd":{"type":"string"},"supPcost":{"type":"integer","format":"int64"},"norPrc":{"type":"integer","format":"int64"},"salePrc":{"type":"integer","format":"int64"},"preSalePrc":{"type":"integer","format":"int64"},"mrgnRate":{"type":"number","format":"double"},"entrNo":{"type":"string"},"deliPolcNo":{"type":"string"},"deliDday":{"type":"integer","format":"int64"},"deliGoodsGbCd":{"type":"string"},"deliWayCd":{"type":"string"},"bpckPsbYn":{"type":"string"},"rtnPsbYn":{"type":"string"},"sngGoodsYn":{"type":"string"},"hsCd":{"type":"string"},"goodsRevWrtYn":{"type":"string"},"exchPsbYn":{"type":"string"},"entrGoodsNo":{"type":"string"},"entrItmNo":{"type":"string"},"ordCnclPsbYn":{"type":"string"},"wthdYn":{"type":"string"},"frgnDirPurGoodsYn":{"type":"string"}},"description":"주문상품 목록"},"OrdDlvInfo":{"required":["dlvGrpInfoList","dlvpNm","dtlAddr","rcvmnCellEndNo","rcvmnCellSctNo","rcvmnCellTxnoNo","rcvmnNm","zipAddr","zipNo"],"type":"object","properties":{"dlvpSeq":{"type":"string","description":"배송지 순번"},"mbrDlvpSeq":{"type":"string","description":"회원 배송지순번"},"baseDlvpYn":{"type":"string","description":"기본 배송지 여부"},"dlvpNm":{"type":"string","description":"배송지명. 일반주문 필수"},"zipNo":{"type":"string","description":"우편번호. 일반주문 필수"},"zipAddr":{"type":"string","description":"우편주소. 일반주문 필수"},"dtlAddr":{"type":"string","description":"상세주소. 일반주문 필수"},"rcvmnNm":{"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":"수취인 전화 끝번호"},"shopTrafMsg":{"type":"string","description":"매장전달메시지"},"deliMsgCd":{"type":"string","description":"배송메시지코드(ME039) 20:배송 전 연락 바랍니다,30:부재 시 문 앞에 놓아주세요,40:부재 시 경비실에 맡겨주세요,50:빠른 배송 부탁 드립니다,60:부재 시 핸드폰으로 연락바랍니다,70:직접입력"},"deliMsg":{"type":"string","description":"배송메시지","nullable":true},"comnFrdrCogoMethodCd":{"type":"string","description":"공동현관출입방법코드(ME040) 10:공동현관 출입번호,20:자유 출입 가능,30:기타","nullable":true},"comnFrdrEtcMethod":{"type":"string","description":"공동현관출입 기타방법","nullable":true},"comnFrdrPwd":{"type":"string","description":"공동현관비밀번호","nullable":true},"pcccSeq":{"type":"string","description":"회원통관고유부호순번"},"persCstmCd":{"type":"string","description":"통관고유번호","nullable":true},"newPersCstmCd":{"type":"string","description":"새 통관고유번호","nullable":true},"dlvGrpInfoList":{"type":"array","description":"배송그룹정보 리스트","items":{"$ref":"#/components/schemas/DlvGrpInfo"}}},"description":"배송지 목록"},"DlvGrpInfo":{"required":["basketGoodsList","deliKindCd","deliMethodCd","deliNo","deliProcTypCd","dlvAmtInfoList"],"type":"object","properties":{"dlvpSeq":{"type":"string","description":"배송지순번"},"deliNo":{"type":"string","description":"합배송번호"},"deliKindCd":{"type":"string","description":"LO009(배송종류코드)\n 10: NORMAL_DELIVERY(일반배송)\n,20: RESERVATION_DELIVERY(예약배송)\n","enum":["NORMAL_DELIVERY","RESERVATION_DELIVERY"]},"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"]},"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"]},"basketGoodsList":{"type":"array","description":"장바구니상품정보","items":{"$ref":"#/components/schemas/BasketGoods"}},"dlvAmtInfoList":{"type":"array","description":"배송비정보","items":{"$ref":"#/components/schemas/DlvAmtInfo"}}},"description":"배송그룹정보 DTO"},"BasketGoods":{"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"},"itmNo":{"type":"string","description":"단품번호"},"bsketNo":{"type":"integer","description":"장바구니번호","format":"int64"},"chlNo":{"type":"string","description":"채널번호"},"chlDtlNo":{"type":"string","description":"채널상세번호"},"infDispCtgNoGbCd":{"type":"string","description":"유입전시카테고리번호구분코드(OM041)"},"infDispCtgNo":{"type":"string","description":"유입전시카테고리번호"},"repDispCtgNo":{"type":"string","description":"대표전시카테고리번호"},"conrNo":{"type":"string","description":"코너번호"},"bsketQty":{"type":"integer","description":"장바구니 수량","format":"int32"},"goodsNm":{"type":"string","description":"상품명"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"goodsCompCd":{"type":"string","description":"상품구성코드(PR001)"},"goodsTypCd":{"type":"string","description":"상품유형코드(PR002)"},"saleMethCd":{"type":"string","description":"판매방식코드(PR003)"},"brandNo":{"type":"string","description":"브랜드번호"},"brandNm":{"type":"string","description":"브랜드명"},"buyrAgeLmtCd":{"type":"string","description":"구매연령제한코드"},"dispYn":{"type":"string","description":"전시여부"},"saleStatCd":{"type":"string","description":"판매상태코드(PR005)"},"saleStrDtm":{"type":"string","description":"판매시작일시","format":"date-time"},"saleEndDtm":{"type":"string","description":"판매종료일시","format":"date-time"},"buyTypCd":{"type":"string","description":"매입유형코드(PR006)"},"taxGbCd":{"type":"string","description":"과면세구분코드(PR007)"},"stkMgrYn":{"type":"string","description":"재고관리여부"},"buyQtyLmtYn":{"type":"string","description":"구매수량제한여부"},"minLmtQty":{"type":"integer","description":"최소제한수량","format":"int32"},"maxLmtQty":{"type":"integer","description":"최대제한수량","format":"int32"},"safeStkNotiYn":{"type":"string","description":"안전재고알림여부"},"deliGoodsGbCd":{"type":"string","description":"배송상품구분코드(PR010)"},"deliWayCd":{"type":"string","description":"배송수단코드(PR009)"},"deliPsbRgnCd":{"type":"string","description":"배송가능지역코드(PR030)"},"deliDday":{"type":"integer","description":"배송기일","format":"int64"},"bpckPsbYn":{"type":"string","description":"합포장가능여부"},"rtnPsbYn":{"type":"string","description":"반품가능여부"},"exchPsbYn":{"type":"string","description":"교환가능여부"},"supPcost":{"type":"integer","description":"공급원가","format":"int64"},"norPrc":{"type":"integer","description":"정상가","format":"int64"},"preSalePrc":{"type":"integer","description":"종전판매가","format":"int64"},"mrgnRate":{"type":"number","description":"마진율","format":"double"},"payMeanInfo":{"type":"string","description":"결제수단"},"itmNm":{"type":"string","description":"단품명"},"stkQty":{"type":"integer","description":"단품수량","format":"int64"},"prestNm":{"type":"string","description":"증정품명"},"rsvStrtDtm":{"type":"string","description":"예약시작일시","format":"date-time"},"rsvEndDtm":{"type":"string","description":"예약종료일시","format":"date-time"},"fwdidcPrarDy":{"type":"string","description":"출고지시예정일자","format":"date"},"hsCd":{"type":"string","description":"품목분류코드"},"wishYn":{"type":"string","description":"위시리스트 여부"},"maxDcAmt":{"type":"integer","description":"최대혜택금액","format":"int64"},"goodsImg":{"type":"string","description":"상품이미지"},"itmSaleStatCd":{"type":"string","description":"단품판매상태코드(PR005)"},"gvgfPsbYn":{"type":"string","description":"선물하기가능여부"},"rglrDeliGoodsYn":{"type":"string","description":"정기배송상품여부"},"sngGoodsYn":{"type":"string","description":"단일상품여부"},"marketingDisplayNo":{"type":"string","description":"기획전번호"},"entrGoodsNo":{"type":"string","description":"협력사상품번호"},"entrItmNo":{"type":"string","description":"협력사단품번호"},"ordCnclPsbYn":{"type":"string","description":"주문취소가능여부"},"wthdYn":{"type":"string","description":"회수여부"},"frgnDirPurGoodsYn":{"type":"string","description":"해외직구상품여부"}},"description":"장바구니 상품 DTO"},"DlvAmtInfo":{"required":["aplyAdtnAmt","deliPolcNo","dlexAmt","dlexTypCd","entrNo","ordCostGbCd","stdAdtnAmt"],"type":"object","properties":{"ordCostGbCd":{"type":"string","description":"OM043(주문비용구분코드)\n 10: 배송비\n , 20: 회수반품비\n , 30: 교환배송비\n , 40: 추가배송비\n","enum":["DELIVERY_FEE","RETURN_FEE","EXCHANGE_FEE","EXTRA_FEE"]},"dlexTypCd":{"type":"string","description":"배송비유형코드(VD005)","enum":["FREE","CHARGED","CONDITIONAL_FREE"]},"stdAdtnAmt":{"type":"integer","description":"기준부가비용금액","format":"int64"},"dlexAmt":{"type":"integer","description":"배송비금액","format":"int64"},"aplyAdtnAmt":{"type":"integer","description":"적용부가비용금액","format":"int64"},"trdTypCd":{"type":"string","description":"거래유형코드(VD002)"},"entrNo":{"type":"string","description":"협력사번호"},"deliPolcNo":{"type":"string","description":"배송정책번호"},"dlvBenefitInfo":{"$ref":"#/components/schemas/DlvBenefitInfo"}},"description":"배송비정보 DTO"},"DlvBenefitInfo":{"required":["cpnIsuNo","entrChrgRate","ourChrgRate","promoNm","promoNo","promoTypCd"],"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":"쿠폰발급번호"},"ordCostGbCd":{"type":"string","description":"비용구분코드(OM043)"}},"description":"배송혜택정보","nullable":true},"OpOrdPayBase":{"type":"object","properties":{"payNo":{"type":"string"},"ordNo":{"type":"string"},"claimNo":{"type":"string"},"uprPayNo":{"type":"string"},"payGbCd":{"type":"string"},"payWayCd":{"type":"string"},"payStatCd":{"type":"string"},"payAmt":{"type":"integer","format":"int64"},"rfdPsbAmt":{"type":"integer","format":"int64"},"payFnshDtm":{"type":"string","format":"date-time"},"trdNo":{"type":"string"},"trdDtm":{"type":"string","format":"date-time"},"reqTrdNo":{"type":"string"},"reqTrdDtm":{"type":"string","format":"date-time"},"iscmCd":{"type":"string","description":"발급사코드(OM027)"},"payReqCardcoCd":{"type":"string","description":"결제요청카드사코드(OM057)"},"cardNo":{"type":"string","description":"카드번호"},"cardNm":{"type":"string"},"cardValiTerm":{"type":"string"},"nintDivYn":{"type":"string"},"divMonCnt":{"type":"integer","format":"int32"},"cardPointUseYn":{"type":"string"},"mersNo":{"type":"string"},"acqrCd":{"type":"string","description":"매입사코드(OM028)"},"aprvNo":{"type":"string"},"aprvDtm":{"type":"string","format":"date-time"},"sctnCnclPsbYn":{"type":"string"},"bankCd":{"type":"string","description":"은행코드(OM026)"},"actnNo":{"type":"string","description":"계좌번호"},"dpmnNm":{"type":"string"},"dptFcstDt":{"type":"string"},"dptCnfmDtm":{"type":"string","format":"date-time"}},"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"},"OpOrdFvrCost":{"type":"object","properties":{"ordFvrCostSeq":{"type":"string"},"ordNo":{"type":"string"},"claimNo":{"type":"string"},"uprOrdFvrCostSeq":{"type":"string"},"adtnGbCd":{"type":"string"},"adtnDtlGbCd":{"type":"string"},"stdAdtnAmt":{"type":"integer","format":"int64"},"aplyAdtnAmt":{"type":"integer","format":"int64"},"cnclAdtnAmt":{"type":"integer","format":"int64"},"entrChrgRate":{"type":"integer","format":"int32"},"ourChrgRate":{"type":"integer","format":"int32"},"adtnBassNo":{"type":"string"},"adtnDtlBassNo":{"type":"string"},"fvrPolcTypCd":{"type":"string"},"fvrPolcAplyVal":{"type":"number","format":"double"},"fvrMinBuyAmt":{"type":"integer","format":"int64"},"fvrMaxDcAmt":{"type":"integer","format":"int64"},"promoNm":{"type":"string"}},"description":"주문혜택비용 목록"},"OrdGoodsDeliInfo":{"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"ordSeq":{"type":"integer","description":"주문순번","format":"int32"},"ordProcSeq":{"type":"integer","description":"주문처리순번","format":"int32"},"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"dlvpSeq":{"type":"string","description":"배송지순번"},"deliNo":{"type":"string","description":"합배송번호"},"deliKindCd":{"type":"string","description":"LO009(배송종류코드)\n 10: NORMAL_DELIVERY(일반배송)\n,20: RESERVATION_DELIVERY(예약배송)\n","enum":["NORMAL_DELIVERY","RESERVATION_DELIVERY"]},"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"]},"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"]}},"description":"주문상품배송 목록"},"Response":{"type":"object","properties":{"timestamp":{"type":"string","description":"result time","format":"date-time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}},"description":"validation error list"}}}}
```


---

# Agent Instructions: Querying This Documentation

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

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

```
GET https://tech.x2bee.com/api/store-front-api/order-api/undefined-16.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.
