주문서
기능 설명
주문을 생성하는 API입니다.
상세 설명
결제 승인을 하고 주문을 생성합니다. 주문이 성공하면 주문자에게 주문완료 알림톡과 메일을 발송합니다.
특이사항
비회원으로 주문 성공 시 비회원 로그인 처리 쿠키를 생성합니다.
주문 실패시 오류 응답 내 isProcess 값이 true이면 주로 결제 관련 오류로, 결제수단을 변경하면 같은 정보로 재주문이 가능합니다. 주문서 페이지로 이동 처리해주세요.
주문 실패시 오류 응답 내 isProcess 값이 false이면 동일 정보로 주문이 불가한 오류로, 주문 실패 페이지로 이동 처리해주세요.
FO 전용 API로 FO의 로그인 정보로 주문을 생성합니다.
로그인 정보를 API 내부에서 조회하기 때문에 파라미터로 회원번호(mbrNo)는 필요하지 않습니다.
수정번호
release_231009_01: 내부 개선.
Release v2.00_240401 : 주문상세상품정보 조회 시 단일상품여부(snsGoodsYn) 추가
Release v2.00_240401 : 주문완료 이메일에 필요한 값 추가 및 변경
Release v2.00_240509 : request 주문프로모션정보 값 nullable 제거
Release v2.00_240530 : 정기주문으로 주문한 경우, 주문완료 이메일에 필요한 값 추가 및 변경
Release v2.00_240530 : 입점사 평가 관련하여 주문 상세에 출고완료예정일시 추가
Release v2.00_240613 : 토스 결제 승인 추가
Release v2.00_240627 : 토스 간편결제 추가
Release v2.00_240725 : E쿠폰상품인 경우 주문내역상태를 주문완료에서 발송완료처리로 적용
Release v2.00_240808 : 사은품, 선물하기 상품의 주문상세 테이블에 주문취소가능여부, 회수여부 컬럼 추가
Release v2.00_250717 : 증빙서류(세금계산서) 발행 추가
Release v2.00_250801 : 환경설정에 따른 증빙서류(세금계산서) 활성화 처리
Access Token
주문하기 Request
주문 성공
No content
업무처리 오류 내용
POST /api/order/v1/order HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 7426
{
"ordBaseInfo": {
"ordNo": "20230810O008148",
"siteNo": "1",
"ordMediaCd": "20",
"ordGbCd": "10",
"rfdBankCd": "104",
"rfdActnNo": "000000000000",
"rcdActnDepositorNm": "홍길동",
"rglrDeliNo": "1",
"chlNo": "1",
"chlDtlNo": "1",
"ordererInfo": {
"mbrNo": "100001311",
"ordManNm": "홍길동",
"umemPwd": "password123!",
"ordManEmailAddr": "nonmember@plateer.com",
"cellSctNo": "010",
"cellTxnoNo": "0000",
"cellEndNo": "0000",
"telRgnNo": "02",
"telTxnoNo": "554",
"telEndNo": "4583",
"ordLmtYn": "N",
"brth": "19961212",
"adlCertiYn": "Y",
"comGbCd": "P00",
"stafYn": "Y",
"nonMemberAge": 19,
"nonMemberCertiYn": "Y"
},
"giftCard": {
"prstTypCd": "10",
"prstMsg": "생일 축하해요."
},
"ordGoodsGb": "10"
},
"ordGoodsInfoList": [
{
"basketGoods": {
"goodsNo": "100000001",
"deliProcTypCd": "10",
"deliPolcNo": "1",
"deliNo": "100000021",
"entrNo": "1000001",
"ordQty": 1,
"salePrc": 15000,
"dcAmt": 3000,
"sysModDtm": "2026-01-01T00:00:00.000Z",
"itmNo": "001",
"bsketNo": 100000001,
"chlNo": "1",
"chlDtlNo": "1",
"infDispCtgNoGbCd": "01",
"infDispCtgNo": "1",
"repDispCtgNo": "1",
"conrNo": "1",
"bsketQty": 1,
"goodsNm": "상품명",
"stdCtgNo": "1",
"goodsCompCd": "10",
"goodsTypCd": "10",
"saleMethCd": "10",
"brandNo": "1",
"brandNm": "브랜드명",
"buyrAgeLmtCd": "0",
"dispYn": "Y",
"saleStatCd": "10",
"saleStrDtm": "2026-01-01T00:00:00.000Z",
"saleEndDtm": "2026-01-01T00:00:00.000Z",
"buyTypCd": "10",
"taxGbCd": "10",
"stkMgrYn": "Y",
"buyQtyLmtYn": "Y",
"minLmtQty": 1,
"maxLmtQty": 10,
"safeStkNotiYn": "Y",
"deliGoodsGbCd": "01",
"deliWayCd": "01",
"deliPsbRgnCd": "01",
"deliDday": 1,
"bpckPsbYn": "Y",
"rtnPsbYn": "Y",
"exchPsbYn": "Y",
"supPcost": 10000,
"norPrc": 20000,
"preSalePrc": 20000,
"mrgnRate": 4,
"payMeanInfo": "11,12,32",
"itmNm": "아이템명1>아이템명2>아이템명3",
"stkQty": 999,
"prestNm": "증정품명",
"rsvStrtDtm": "2026-01-01T00:00:00.000Z",
"rsvEndDtm": "2026-01-01T00:00:00.000Z",
"fwdidcPrarDy": "2026-01-01",
"hsCd": "1",
"wishYn": "Y",
"maxDcAmt": 1000,
"goodsImg": "files/goods/2023/07/04/img",
"itmSaleStatCd": "10",
"gvgfPsbYn": "Y",
"rglrDeliGoodsYn": "Y",
"sngGoodsYn": "Y",
"marketingDisplayNo": "1",
"entrGoodsNo": "100042110583831",
"entrItmNo": "100042110583831001",
"ordCnclPsbYn": "N",
"wthdYn": "N",
"frgnDirPurGoodsYn": "text"
},
"aplyGoodsBnfInfo": {
"goodsNo": "10000001",
"itmNo": "001",
"dcAmt": 5000,
"benefitList": [
{
"promoNo": "C1000000",
"promoNm": "프로모션 명",
"promoTypCd": "11",
"ourChrgRate": 100,
"entrChrgRate": 0,
"fixamtFxrtGbCd": "01",
"dcRateAmt": 5000,
"minBuyAmt": 1000,
"maxDcAmt": 5000,
"isMaxYn": "Y",
"dcAmt": 5000,
"dcAmtPerCnt": 2500,
"cpnIsuNo": "100000"
}
]
},
"aeEvtList": [
{
"goodsNo": "10000001",
"itmNo": "001",
"aeNo": "C1000000",
"addEvtTypCd": "20",
"aeStrDtm": "2026-01-01T00:00:00.000Z",
"aeEndDtm": "2026-01-01T00:00:00.000Z",
"payStrDt": "20231201",
"payEndDt": "20231231",
"tmEvtYn": "N",
"aplyStrTm": "0800",
"aplyEndTm": "2359",
"aeDesc": "사은행사 설명",
"aeNm": "사은행사 명",
"aeGoodsList": [
{
"aeFvrSeq": "1",
"aplyMinAmt": 5000,
"aplyMaxAmt": 10000,
"aeGoodsNm": "사은품 명",
"aeGoodsNo": "10000001",
"aeGoodsItmNo": "001",
"aeGoodsImgPath": "/path/image001.png"
}
]
}
]
}
],
"ordDlvInfoList": [
{
"dlvpSeq": "1",
"mbrDlvpSeq": "1",
"baseDlvpYn": "Y",
"dlvpNm": "우리집",
"zipNo": "05837",
"zipAddr": "서울 송파구 법원로9길",
"dtlAddr": "에이치비지니스파크 D동 6층",
"rcvmnNm": "홍길동",
"rcvmnEmailAddr": "receiver@plateer.com",
"rcvmnCellSctNo": "010",
"rcvmnCellTxnoNo": "0000",
"rcvmnCellEndNo": "0000",
"rcvmnTelRgnNo": "02",
"rcvmnTelTxnoNo": "554",
"rcvmnTelEndNo": "4583",
"shopTrafMsg": "포장 안 해주셔도 돼요.",
"deliMsgCd": "40",
"deliMsg": "벨X, 노크X",
"comnFrdrCogoMethodCd": "20",
"comnFrdrEtcMethod": "뒷문 있어요.",
"comnFrdrPwd": "123456",
"pcccSeq": "text",
"persCstmCd": "P100000000000",
"newPersCstmCd": "P100000000000",
"dlvGrpInfoList": [
{
"dlvpSeq": "1",
"deliNo": "1",
"deliKindCd": "10",
"deliProcTypCd": "10",
"deliMethodCd": "10",
"basketGoodsList": [
{
"goodsNo": "100000001",
"deliProcTypCd": "10",
"deliPolcNo": "1",
"deliNo": "100000021",
"entrNo": "1000001",
"ordQty": 1,
"salePrc": 15000,
"dcAmt": 3000,
"sysModDtm": "2026-01-01T00:00:00.000Z",
"itmNo": "001",
"bsketNo": 100000001,
"chlNo": "1",
"chlDtlNo": "1",
"infDispCtgNoGbCd": "01",
"infDispCtgNo": "1",
"repDispCtgNo": "1",
"conrNo": "1",
"bsketQty": 1,
"goodsNm": "상품명",
"stdCtgNo": "1",
"goodsCompCd": "10",
"goodsTypCd": "10",
"saleMethCd": "10",
"brandNo": "1",
"brandNm": "브랜드명",
"buyrAgeLmtCd": "0",
"dispYn": "Y",
"saleStatCd": "10",
"saleStrDtm": "2026-01-01T00:00:00.000Z",
"saleEndDtm": "2026-01-01T00:00:00.000Z",
"buyTypCd": "10",
"taxGbCd": "10",
"stkMgrYn": "Y",
"buyQtyLmtYn": "Y",
"minLmtQty": 1,
"maxLmtQty": 10,
"safeStkNotiYn": "Y",
"deliGoodsGbCd": "01",
"deliWayCd": "01",
"deliPsbRgnCd": "01",
"deliDday": 1,
"bpckPsbYn": "Y",
"rtnPsbYn": "Y",
"exchPsbYn": "Y",
"supPcost": 10000,
"norPrc": 20000,
"preSalePrc": 20000,
"mrgnRate": 4,
"payMeanInfo": "11,12,32",
"itmNm": "아이템명1>아이템명2>아이템명3",
"stkQty": 999,
"prestNm": "증정품명",
"rsvStrtDtm": "2026-01-01T00:00:00.000Z",
"rsvEndDtm": "2026-01-01T00:00:00.000Z",
"fwdidcPrarDy": "2026-01-01",
"hsCd": "1",
"wishYn": "Y",
"maxDcAmt": 1000,
"goodsImg": "files/goods/2023/07/04/img",
"itmSaleStatCd": "10",
"gvgfPsbYn": "Y",
"rglrDeliGoodsYn": "Y",
"sngGoodsYn": "Y",
"marketingDisplayNo": "1",
"entrGoodsNo": "100042110583831",
"entrItmNo": "100042110583831001",
"ordCnclPsbYn": "N",
"wthdYn": "N",
"frgnDirPurGoodsYn": "text"
}
],
"dlvAmtInfoList": [
{
"ordCostGbCd": "10",
"dlexTypCd": "10",
"stdAdtnAmt": 20000,
"dlexAmt": 3500,
"aplyAdtnAmt": 20000,
"trdTypCd": "text",
"entrNo": "1000211",
"deliPolcNo": "10000431",
"dlvBenefitInfo": {
"promoNo": "C1000000",
"promoNm": "프로모션 명",
"promoTypCd": "11",
"ourChrgRate": 100,
"entrChrgRate": 0,
"cpnIsuNo": "100000",
"ordCostGbCd": "10"
}
}
]
}
]
}
],
"ordBnfInfo": {
"promoNo": "C1000000",
"promoNm": "프로모션 명",
"promoTypCd": "11",
"ourChrgRate": 100,
"entrChrgRate": 0,
"fixamtFxrtGbCd": "01",
"dcRateAmt": 5000,
"minBuyAmt": 1000,
"maxDcAmt": 5000,
"isMaxYn": "Y",
"dcAmt": 5000,
"cpnIsuNo": "100000",
"goods": [
{
"goodsNo": "10000001",
"itmNo": "001",
"dcAmt": 5000
}
]
},
"accmInfo": {
"totalAccmAmt": 3000,
"accmList": [
{
"accmGbCd": "21",
"accmRate": 10,
"accmAmt": 3000,
"promoNo": "C1000000",
"promoNm": "프로모션 명",
"promoTypCd": "40",
"ourChrgRate": 100,
"entrChrgRate": 0,
"fixamtFxrtGbCd": "01",
"rsrvStdAmt": 5000,
"goodsAccmList": [
{
"goodsNo": "10000001",
"itmNo": "001",
"accmAmt": 3000
}
]
}
]
},
"paymentRequest": {
"siteNo": "1",
"orderInfo": {
"ordNo": "20990101O000001",
"claimNo": "20990101C000001",
"goodsNm": "플래티어커피",
"ordManNm": "김플래티어",
"ordmnCellNo": "01012345678",
"ordmnEmailAddr": "kim@plateer.com",
"crcUnitCd": "KRW",
"ordMediaCd": "30",
"mbrNo": "100000001",
"ordDtlGbCd": "10",
"clientIp": "127.0.0.1",
"taxFreeAmt": 1
},
"payInfoList": [
{
"payNo": "1",
"payWayCd": "11",
"payAmt": 1000,
"mersNo": "1",
"pgGbCd": "10",
"trdNo": "INIMX_DBNKINIpayTest20990101090000685510",
"selectCardCd": "01",
"termlId": "INIBillTst",
"billKey": "text",
"authResultMap": "{P_STATUS:결과코드, P_RMESG1:결과메시지, P_TID:인증거래번호, P_AMT:거래금액, idc_name:IDC센터코드P_REQ_URL:승인요청 URL, P_NOTI:가맹점 임의 데이터}"
}
]
},
"proofDocInfo": {
"ordNo": "text",
"mbrNo": "text",
"ordManNm": "홍길동",
"proofType": "text",
"payWayCd": "11",
"orderTaxInvoiceRequest": {
"entrNo": "text",
"goodsNm": "text",
"goodsCount": 1,
"payAmt": 1,
"bmanNo": "text",
"bmanNm": "text",
"rpstmnNm": "text",
"zipNo": "text",
"zipAddr": "text",
"dtlAddr": "text",
"aempNm": "text",
"aempTelRgnNo": "text",
"aempTelTxnoNo": "text",
"aempTelEndNo": "text",
"aempEmailId": "text",
"aempEmailDomain": "text",
"aempEmail": "text",
"validYn": "text"
},
"orderCashReceiptRequest": {
"prsntPurpsCd": "text",
"idefNo": "text",
"prchsrNm": "text",
"prchsrEmail": "text",
"prchsrCell": "text",
"smsTrnsYn": "text",
"faxTrnsYn": "text",
"valiYn": "text"
}
}
}No content
기능 설명
기준일자를 받아서 실제 근무일자를 계산하여 리턴합니다.
상세 설명
기준일자를 기준으로 입력받은 일수를 합산합니다.
날짜 계산 중 휴일이 있는 경우 해당 날짜는 합산에서 제외됩니다.
주문상품 출고완료예정일시를 계산하는 경우 주문완료 시점에 상품의 출고완료예정일시를 계산합니다.
주문상품 출고완료예정일시를 계산하는 경우 일반상품인 경우에는 주문시간을, 예약상품인 경우에는 배송지시예약일시를 기준으로 출고완료예정일시를 계산합니다.
BO의 협력사 평가 중 소명이의제기에서 자동승인예정일자, 소명사유등록가능일자를 계산합니다.
수정번호
Release v2.00_240613:휴일업무구분코드 파라미터 추가, URL 변경
Access Token
실 업무일자 DTO
기준날짜
일수
1휴일업무구분코드(CM001)
03성공
업무처리 오류 내용
POST /api/order/v1/orderSheet/workingDay HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 74
{
"standardDtm": "2026-01-01T00:00:00.000Z",
"dayCount": 1,
"holiJobGbCd": "03"
}2026-01-01T00:00:00.000ZAccess Token
주문서 진입 시 검증 Request DTO
LO010(배송방법코드) * 10 : 택배배송 * 30 : 매장수령 * 40 : 퀵배송 * 50 : 해외배송 * 60 : 무배송
10Possible values: OM002(주문 구분 코드) 10: 일반주문 , 20: 선물하기 , 30: e-쿠폰 , 40: 제휴
10Possible values: 주문매체 코드(OM007) 10 : 전화상담(CC) , 20 : PC , 30 : 모바일웹 , 40 : 안드로이드앱 , 50 : IOS앱 , 60 : 정기주문
20Possible values: 장바구니번호
[100009929]성공
No content
업무처리 오류 내용
POST /api/order/v1/orderSheet/validateOrderSheet HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 80
{
"deliMethodCd": "10",
"ordGbCd": "10",
"ordMediaCd": "20",
"bsketNoList": [
100009929
]
}No content
Access Token
주문하기 Request
성공
업무처리 오류 내용
POST /api/order/v1/orderSheet/taxFreeAmount HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 7426
{
"ordBaseInfo": {
"ordNo": "20230810O008148",
"siteNo": "1",
"ordMediaCd": "20",
"ordGbCd": "10",
"rfdBankCd": "104",
"rfdActnNo": "000000000000",
"rcdActnDepositorNm": "홍길동",
"rglrDeliNo": "1",
"chlNo": "1",
"chlDtlNo": "1",
"ordererInfo": {
"mbrNo": "100001311",
"ordManNm": "홍길동",
"umemPwd": "password123!",
"ordManEmailAddr": "nonmember@plateer.com",
"cellSctNo": "010",
"cellTxnoNo": "0000",
"cellEndNo": "0000",
"telRgnNo": "02",
"telTxnoNo": "554",
"telEndNo": "4583",
"ordLmtYn": "N",
"brth": "19961212",
"adlCertiYn": "Y",
"comGbCd": "P00",
"stafYn": "Y",
"nonMemberAge": 19,
"nonMemberCertiYn": "Y"
},
"giftCard": {
"prstTypCd": "10",
"prstMsg": "생일 축하해요."
},
"ordGoodsGb": "10"
},
"ordGoodsInfoList": [
{
"basketGoods": {
"goodsNo": "100000001",
"deliProcTypCd": "10",
"deliPolcNo": "1",
"deliNo": "100000021",
"entrNo": "1000001",
"ordQty": 1,
"salePrc": 15000,
"dcAmt": 3000,
"sysModDtm": "2026-01-01T00:00:00.000Z",
"itmNo": "001",
"bsketNo": 100000001,
"chlNo": "1",
"chlDtlNo": "1",
"infDispCtgNoGbCd": "01",
"infDispCtgNo": "1",
"repDispCtgNo": "1",
"conrNo": "1",
"bsketQty": 1,
"goodsNm": "상품명",
"stdCtgNo": "1",
"goodsCompCd": "10",
"goodsTypCd": "10",
"saleMethCd": "10",
"brandNo": "1",
"brandNm": "브랜드명",
"buyrAgeLmtCd": "0",
"dispYn": "Y",
"saleStatCd": "10",
"saleStrDtm": "2026-01-01T00:00:00.000Z",
"saleEndDtm": "2026-01-01T00:00:00.000Z",
"buyTypCd": "10",
"taxGbCd": "10",
"stkMgrYn": "Y",
"buyQtyLmtYn": "Y",
"minLmtQty": 1,
"maxLmtQty": 10,
"safeStkNotiYn": "Y",
"deliGoodsGbCd": "01",
"deliWayCd": "01",
"deliPsbRgnCd": "01",
"deliDday": 1,
"bpckPsbYn": "Y",
"rtnPsbYn": "Y",
"exchPsbYn": "Y",
"supPcost": 10000,
"norPrc": 20000,
"preSalePrc": 20000,
"mrgnRate": 4,
"payMeanInfo": "11,12,32",
"itmNm": "아이템명1>아이템명2>아이템명3",
"stkQty": 999,
"prestNm": "증정품명",
"rsvStrtDtm": "2026-01-01T00:00:00.000Z",
"rsvEndDtm": "2026-01-01T00:00:00.000Z",
"fwdidcPrarDy": "2026-01-01",
"hsCd": "1",
"wishYn": "Y",
"maxDcAmt": 1000,
"goodsImg": "files/goods/2023/07/04/img",
"itmSaleStatCd": "10",
"gvgfPsbYn": "Y",
"rglrDeliGoodsYn": "Y",
"sngGoodsYn": "Y",
"marketingDisplayNo": "1",
"entrGoodsNo": "100042110583831",
"entrItmNo": "100042110583831001",
"ordCnclPsbYn": "N",
"wthdYn": "N",
"frgnDirPurGoodsYn": "text"
},
"aplyGoodsBnfInfo": {
"goodsNo": "10000001",
"itmNo": "001",
"dcAmt": 5000,
"benefitList": [
{
"promoNo": "C1000000",
"promoNm": "프로모션 명",
"promoTypCd": "11",
"ourChrgRate": 100,
"entrChrgRate": 0,
"fixamtFxrtGbCd": "01",
"dcRateAmt": 5000,
"minBuyAmt": 1000,
"maxDcAmt": 5000,
"isMaxYn": "Y",
"dcAmt": 5000,
"dcAmtPerCnt": 2500,
"cpnIsuNo": "100000"
}
]
},
"aeEvtList": [
{
"goodsNo": "10000001",
"itmNo": "001",
"aeNo": "C1000000",
"addEvtTypCd": "20",
"aeStrDtm": "2026-01-01T00:00:00.000Z",
"aeEndDtm": "2026-01-01T00:00:00.000Z",
"payStrDt": "20231201",
"payEndDt": "20231231",
"tmEvtYn": "N",
"aplyStrTm": "0800",
"aplyEndTm": "2359",
"aeDesc": "사은행사 설명",
"aeNm": "사은행사 명",
"aeGoodsList": [
{
"aeFvrSeq": "1",
"aplyMinAmt": 5000,
"aplyMaxAmt": 10000,
"aeGoodsNm": "사은품 명",
"aeGoodsNo": "10000001",
"aeGoodsItmNo": "001",
"aeGoodsImgPath": "/path/image001.png"
}
]
}
]
}
],
"ordDlvInfoList": [
{
"dlvpSeq": "1",
"mbrDlvpSeq": "1",
"baseDlvpYn": "Y",
"dlvpNm": "우리집",
"zipNo": "05837",
"zipAddr": "서울 송파구 법원로9길",
"dtlAddr": "에이치비지니스파크 D동 6층",
"rcvmnNm": "홍길동",
"rcvmnEmailAddr": "receiver@plateer.com",
"rcvmnCellSctNo": "010",
"rcvmnCellTxnoNo": "0000",
"rcvmnCellEndNo": "0000",
"rcvmnTelRgnNo": "02",
"rcvmnTelTxnoNo": "554",
"rcvmnTelEndNo": "4583",
"shopTrafMsg": "포장 안 해주셔도 돼요.",
"deliMsgCd": "40",
"deliMsg": "벨X, 노크X",
"comnFrdrCogoMethodCd": "20",
"comnFrdrEtcMethod": "뒷문 있어요.",
"comnFrdrPwd": "123456",
"pcccSeq": "text",
"persCstmCd": "P100000000000",
"newPersCstmCd": "P100000000000",
"dlvGrpInfoList": [
{
"dlvpSeq": "1",
"deliNo": "1",
"deliKindCd": "10",
"deliProcTypCd": "10",
"deliMethodCd": "10",
"basketGoodsList": [
{
"goodsNo": "100000001",
"deliProcTypCd": "10",
"deliPolcNo": "1",
"deliNo": "100000021",
"entrNo": "1000001",
"ordQty": 1,
"salePrc": 15000,
"dcAmt": 3000,
"sysModDtm": "2026-01-01T00:00:00.000Z",
"itmNo": "001",
"bsketNo": 100000001,
"chlNo": "1",
"chlDtlNo": "1",
"infDispCtgNoGbCd": "01",
"infDispCtgNo": "1",
"repDispCtgNo": "1",
"conrNo": "1",
"bsketQty": 1,
"goodsNm": "상품명",
"stdCtgNo": "1",
"goodsCompCd": "10",
"goodsTypCd": "10",
"saleMethCd": "10",
"brandNo": "1",
"brandNm": "브랜드명",
"buyrAgeLmtCd": "0",
"dispYn": "Y",
"saleStatCd": "10",
"saleStrDtm": "2026-01-01T00:00:00.000Z",
"saleEndDtm": "2026-01-01T00:00:00.000Z",
"buyTypCd": "10",
"taxGbCd": "10",
"stkMgrYn": "Y",
"buyQtyLmtYn": "Y",
"minLmtQty": 1,
"maxLmtQty": 10,
"safeStkNotiYn": "Y",
"deliGoodsGbCd": "01",
"deliWayCd": "01",
"deliPsbRgnCd": "01",
"deliDday": 1,
"bpckPsbYn": "Y",
"rtnPsbYn": "Y",
"exchPsbYn": "Y",
"supPcost": 10000,
"norPrc": 20000,
"preSalePrc": 20000,
"mrgnRate": 4,
"payMeanInfo": "11,12,32",
"itmNm": "아이템명1>아이템명2>아이템명3",
"stkQty": 999,
"prestNm": "증정품명",
"rsvStrtDtm": "2026-01-01T00:00:00.000Z",
"rsvEndDtm": "2026-01-01T00:00:00.000Z",
"fwdidcPrarDy": "2026-01-01",
"hsCd": "1",
"wishYn": "Y",
"maxDcAmt": 1000,
"goodsImg": "files/goods/2023/07/04/img",
"itmSaleStatCd": "10",
"gvgfPsbYn": "Y",
"rglrDeliGoodsYn": "Y",
"sngGoodsYn": "Y",
"marketingDisplayNo": "1",
"entrGoodsNo": "100042110583831",
"entrItmNo": "100042110583831001",
"ordCnclPsbYn": "N",
"wthdYn": "N",
"frgnDirPurGoodsYn": "text"
}
],
"dlvAmtInfoList": [
{
"ordCostGbCd": "10",
"dlexTypCd": "10",
"stdAdtnAmt": 20000,
"dlexAmt": 3500,
"aplyAdtnAmt": 20000,
"trdTypCd": "text",
"entrNo": "1000211",
"deliPolcNo": "10000431",
"dlvBenefitInfo": {
"promoNo": "C1000000",
"promoNm": "프로모션 명",
"promoTypCd": "11",
"ourChrgRate": 100,
"entrChrgRate": 0,
"cpnIsuNo": "100000",
"ordCostGbCd": "10"
}
}
]
}
]
}
],
"ordBnfInfo": {
"promoNo": "C1000000",
"promoNm": "프로모션 명",
"promoTypCd": "11",
"ourChrgRate": 100,
"entrChrgRate": 0,
"fixamtFxrtGbCd": "01",
"dcRateAmt": 5000,
"minBuyAmt": 1000,
"maxDcAmt": 5000,
"isMaxYn": "Y",
"dcAmt": 5000,
"cpnIsuNo": "100000",
"goods": [
{
"goodsNo": "10000001",
"itmNo": "001",
"dcAmt": 5000
}
]
},
"accmInfo": {
"totalAccmAmt": 3000,
"accmList": [
{
"accmGbCd": "21",
"accmRate": 10,
"accmAmt": 3000,
"promoNo": "C1000000",
"promoNm": "프로모션 명",
"promoTypCd": "40",
"ourChrgRate": 100,
"entrChrgRate": 0,
"fixamtFxrtGbCd": "01",
"rsrvStdAmt": 5000,
"goodsAccmList": [
{
"goodsNo": "10000001",
"itmNo": "001",
"accmAmt": 3000
}
]
}
]
},
"paymentRequest": {
"siteNo": "1",
"orderInfo": {
"ordNo": "20990101O000001",
"claimNo": "20990101C000001",
"goodsNm": "플래티어커피",
"ordManNm": "김플래티어",
"ordmnCellNo": "01012345678",
"ordmnEmailAddr": "kim@plateer.com",
"crcUnitCd": "KRW",
"ordMediaCd": "30",
"mbrNo": "100000001",
"ordDtlGbCd": "10",
"clientIp": "127.0.0.1",
"taxFreeAmt": 1
},
"payInfoList": [
{
"payNo": "1",
"payWayCd": "11",
"payAmt": 1000,
"mersNo": "1",
"pgGbCd": "10",
"trdNo": "INIMX_DBNKINIpayTest20990101090000685510",
"selectCardCd": "01",
"termlId": "INIBillTst",
"billKey": "text",
"authResultMap": "{P_STATUS:결과코드, P_RMESG1:결과메시지, P_TID:인증거래번호, P_AMT:거래금액, idc_name:IDC센터코드P_REQ_URL:승인요청 URL, P_NOTI:가맹점 임의 데이터}"
}
]
},
"proofDocInfo": {
"ordNo": "text",
"mbrNo": "text",
"ordManNm": "홍길동",
"proofType": "text",
"payWayCd": "11",
"orderTaxInvoiceRequest": {
"entrNo": "text",
"goodsNm": "text",
"goodsCount": 1,
"payAmt": 1,
"bmanNo": "text",
"bmanNm": "text",
"rpstmnNm": "text",
"zipNo": "text",
"zipAddr": "text",
"dtlAddr": "text",
"aempNm": "text",
"aempTelRgnNo": "text",
"aempTelTxnoNo": "text",
"aempTelEndNo": "text",
"aempEmailId": "text",
"aempEmailDomain": "text",
"aempEmail": "text",
"validYn": "text"
},
"orderCashReceiptRequest": {
"prsntPurpsCd": "text",
"idefNo": "text",
"prchsrNm": "text",
"prchsrEmail": "text",
"prchsrCell": "text",
"smsTrnsYn": "text",
"faxTrnsYn": "text",
"valiYn": "text"
}
}
}1기능 설명
회원 및 비회원의 주문서 정보를 조회합니다.
상세 설명
주문서 진입 시 회원 및 비회원의 주문서 정보를 조회합니다. 주문서 정보에는 회원, 결제수단, 주문기본, 주문상품, 주문배송, 주문프로모션, 적립 정보들이 포함됩니다.
주문한 상품이 다수이면, 상품들의 공통된 결제 가능한 결제수단을 조회합니다.
회원 주문 시 최대 혜택 정보를 조회합니다.
비회원 주문 시 회원의 부결제수단 정보를 조회하지 않습니다.
비회원 주문 시 혜택 및 적립 정보를 조회하지 않습니다.
수정번호
Release v2.00_240401 : 주문서 진입 시 구매수량 확인 후 에러메시지 노출 적용
Release v2.00_240725 : 주문서 진입 시 상품유형코드에 따른 주문상품구분 셋팅
Access Token
주문서 조회 Request DTO
LO010(배송방법코드) * 10 : 택배배송 * 30 : 매장수령 * 40 : 퀵배송 * 50 : 해외배송 * 60 : 무배송
10Possible values: OM002(주문 구분 코드) 10: 일반주문 , 20: 선물하기 , 30: e-쿠폰 , 40: 제휴
10Possible values: 주문매체 코드(OM007) 10 : 전화상담(CC) , 20 : PC , 30 : 모바일웹 , 40 : 안드로이드앱 , 50 : IOS앱 , 60 : 정기주문
20Possible values: 주문상품구분(OM029)
10장바구니번호
[100009929]성공
주문서 조회 Response DTO
업무처리 오류 내용
POST /api/order/v1/orderSheet/orderSheet HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 835
{
"deliMethodCd": "10",
"ordGbCd": "10",
"ordMediaCd": "20",
"ordGoodsGb": "10",
"bsketNoList": [
100009929
],
"dlvpInfoList": [
{
"dlvpSeq": "1",
"dlvpNm": "플래티어",
"mbrDlvpSeq": "1",
"baseDlvpYn": "Y",
"zipNoSeq": 1,
"zipNo": "05836",
"zipAddr": "서울 송파구 법원로9길 26",
"dtlAddr": "101동",
"emailAddr": "mac9692@plateer.com",
"rcvmnNm": "박진성",
"cellSctNo": "010",
"cellTxnoNo": "2023",
"cellEndNo": "4046",
"telRgnNo": "031",
"telTxnoNo": "406",
"telEndNo": "4129",
"deliMsgCd": "10",
"deliMsg": "초인종누르지마세요.",
"comnFrdrCogoMethodCd": "10",
"comnFrdrEtcMethod": "조심히 오세요.",
"comnFrdrPwd": "2321",
"comnFrdrPwdMask": "****",
"deliMsgCdNm": "부재 시 경비실에 맡겨주세요",
"comnFrdrCogoMethodCdNm": "자유출입가능",
"aplyBsketInfoList": [
{
"bsketNum": 1,
"aplyCnt": 1
}
],
"pcccSeq": "text",
"persCstmCd": "text",
"newPersCstmCd": "text"
}
]
}{
"orderSheetInfo": {
"ordGbCd": "10",
"mainPayMethodInfoList": [
{
"payWayCd": "11",
"useYn": "Y",
"langCd": "ko",
"cdNm": "text",
"cdDesc": "text",
"pgGbCd": "text",
"memberSubPaymethodAmount": 1,
"cardCompanyList": [
{
"cd": "302",
"cdNm": "색상변경",
"cdDesc": "[단순변심]",
"sortSeq": "22",
"ref1Val": "30",
"ref2Val": "10",
"ref3Val": "10",
"ref4Val": "10",
"ref5Val": "Y",
"ref6Val": "null",
"ref7Val": "null"
}
],
"mainPaymethod": true
}
],
"subPayMethodInfoList": [
{
"payWayCd": "11",
"useYn": "Y",
"langCd": "ko",
"cdNm": "text",
"cdDesc": "text",
"pgGbCd": "text",
"memberSubPaymethodAmount": 1,
"cardCompanyList": [
{
"cd": "302",
"cdNm": "색상변경",
"cdDesc": "[단순변심]",
"sortSeq": "22",
"ref1Val": "30",
"ref2Val": "10",
"ref3Val": "10",
"ref4Val": "10",
"ref5Val": "Y",
"ref6Val": "null",
"ref7Val": "null"
}
],
"mainPaymethod": true
}
],
"memberInfo": {
"mbrNo": "100000551",
"mbrGradeCd": "10",
"mbrGradeNm": "GREEN",
"mbrGbCd": "10",
"mbrGbNm": "정회원",
"mbrMgrCd": "20",
"mbrMgrNm": "일반회원",
"mgrGbCd": "10",
"brth": "19890506",
"sexGbCd": "F",
"sexGbNm": "여",
"nafrGbCd": "10",
"nafrGbNm": "내국인",
"stafYn": "Y",
"comGbCd": "P00",
"comGbNm": "플래티어",
"frstLoginDtm": "2023-06-14 10:09:00",
"mbrNm": "박슬기",
"loginId": "id089",
"zipNo": "05831",
"zipAddr": "서울 송파구 동남로 99",
"dtlAddr": "111",
"cellSctNo": "010",
"cellTxnoNo": "1234",
"cellEndNo": "4321",
"telRgnNo": "02",
"telTxnoNo": "123",
"telEndNo": "1234",
"emailAddr": "x2bee@plateer.com",
"emailRecvAgrYn": "N",
"smsRecvAgrYn": "N",
"histStrDt": "2023-04-01",
"histEndDt": "2023-09-30",
"smpctAcctLinkGbCd": "10",
"smpctAcctLinkGbNm": "카카오톡",
"frstOrdDt": "20230808",
"lstOrdDt": "20230908",
"loginCnt": 99,
"ordCnt": 0,
"mbrJoinDtm": "2026-01-01T00:00:00.000Z",
"ordLmtYn": "N",
"ciCtacValYn": "Y",
"appPushAgrYn": "N",
"pwdChgDtm": "2026-01-01T00:00:00.000Z",
"bmanRegNo": "10000001",
"bmanNm": "플래티어",
"bmanRegDt": "20230524",
"rpstmnNm": "이상훈",
"repTelSctNo": "010",
"repTelTxnoNo": "1234",
"repTelEndNo": "4321"
}
},
"orderRegisterRequest": {
"ordBaseInfo": {
"ordNo": "20230810O008148",
"siteNo": "1",
"ordMediaCd": "20",
"ordGbCd": "10",
"rfdBankCd": "104",
"rfdActnNo": "000000000000",
"rcdActnDepositorNm": "홍길동",
"rglrDeliNo": "1",
"chlNo": "1",
"chlDtlNo": "1",
"ordererInfo": {
"mbrNo": "100001311",
"ordManNm": "홍길동",
"umemPwd": "password123!",
"ordManEmailAddr": "nonmember@plateer.com",
"cellSctNo": "010",
"cellTxnoNo": "0000",
"cellEndNo": "0000",
"telRgnNo": "02",
"telTxnoNo": "554",
"telEndNo": "4583",
"ordLmtYn": "N",
"brth": "19961212",
"adlCertiYn": "Y",
"comGbCd": "P00",
"stafYn": "Y",
"nonMemberAge": 19,
"nonMemberCertiYn": "Y"
},
"giftCard": {
"prstTypCd": "10",
"prstMsg": "생일 축하해요."
},
"ordGoodsGb": "10"
},
"ordGoodsInfoList": [
{
"basketGoods": {
"goodsNo": "100000001",
"deliProcTypCd": "10",
"deliPolcNo": "1",
"deliNo": "100000021",
"entrNo": "1000001",
"ordQty": 1,
"salePrc": 15000,
"dcAmt": 3000,
"sysModDtm": "2026-01-01T00:00:00.000Z",
"itmNo": "001",
"bsketNo": 100000001,
"chlNo": "1",
"chlDtlNo": "1",
"infDispCtgNoGbCd": "01",
"infDispCtgNo": "1",
"repDispCtgNo": "1",
"conrNo": "1",
"bsketQty": 1,
"goodsNm": "상품명",
"stdCtgNo": "1",
"goodsCompCd": "10",
"goodsTypCd": "10",
"saleMethCd": "10",
"brandNo": "1",
"brandNm": "브랜드명",
"buyrAgeLmtCd": "0",
"dispYn": "Y",
"saleStatCd": "10",
"saleStrDtm": "2026-01-01T00:00:00.000Z",
"saleEndDtm": "2026-01-01T00:00:00.000Z",
"buyTypCd": "10",
"taxGbCd": "10",
"stkMgrYn": "Y",
"buyQtyLmtYn": "Y",
"minLmtQty": 1,
"maxLmtQty": 10,
"safeStkNotiYn": "Y",
"deliGoodsGbCd": "01",
"deliWayCd": "01",
"deliPsbRgnCd": "01",
"deliDday": 1,
"bpckPsbYn": "Y",
"rtnPsbYn": "Y",
"exchPsbYn": "Y",
"supPcost": 10000,
"norPrc": 20000,
"preSalePrc": 20000,
"mrgnRate": 4,
"payMeanInfo": "11,12,32",
"itmNm": "아이템명1>아이템명2>아이템명3",
"stkQty": 999,
"prestNm": "증정품명",
"rsvStrtDtm": "2026-01-01T00:00:00.000Z",
"rsvEndDtm": "2026-01-01T00:00:00.000Z",
"fwdidcPrarDy": "2026-01-01",
"hsCd": "1",
"wishYn": "Y",
"maxDcAmt": 1000,
"goodsImg": "files/goods/2023/07/04/img",
"itmSaleStatCd": "10",
"gvgfPsbYn": "Y",
"rglrDeliGoodsYn": "Y",
"sngGoodsYn": "Y",
"marketingDisplayNo": "1",
"entrGoodsNo": "100042110583831",
"entrItmNo": "100042110583831001",
"ordCnclPsbYn": "N",
"wthdYn": "N",
"frgnDirPurGoodsYn": "text"
},
"aplyGoodsBnfInfo": {
"goodsNo": "10000001",
"itmNo": "001",
"dcAmt": 5000,
"benefitList": [
{
"promoNo": "C1000000",
"promoNm": "프로모션 명",
"promoTypCd": "11",
"ourChrgRate": 100,
"entrChrgRate": 0,
"fixamtFxrtGbCd": "01",
"dcRateAmt": 5000,
"minBuyAmt": 1000,
"maxDcAmt": 5000,
"isMaxYn": "Y",
"dcAmt": 5000,
"dcAmtPerCnt": 2500,
"cpnIsuNo": "100000"
}
]
},
"aeEvtList": [
{
"goodsNo": "10000001",
"itmNo": "001",
"aeNo": "C1000000",
"addEvtTypCd": "20",
"aeStrDtm": "2026-01-01T00:00:00.000Z",
"aeEndDtm": "2026-01-01T00:00:00.000Z",
"payStrDt": "20231201",
"payEndDt": "20231231",
"tmEvtYn": "N",
"aplyStrTm": "0800",
"aplyEndTm": "2359",
"aeDesc": "사은행사 설명",
"aeNm": "사은행사 명",
"aeGoodsList": [
{
"aeFvrSeq": "1",
"aplyMinAmt": 5000,
"aplyMaxAmt": 10000,
"aeGoodsNm": "사은품 명",
"aeGoodsNo": "10000001",
"aeGoodsItmNo": "001",
"aeGoodsImgPath": "/path/image001.png"
}
]
}
]
}
],
"ordDlvInfoList": [
{
"dlvpSeq": "1",
"mbrDlvpSeq": "1",
"baseDlvpYn": "Y",
"dlvpNm": "우리집",
"zipNo": "05837",
"zipAddr": "서울 송파구 법원로9길",
"dtlAddr": "에이치비지니스파크 D동 6층",
"rcvmnNm": "홍길동",
"rcvmnEmailAddr": "receiver@plateer.com",
"rcvmnCellSctNo": "010",
"rcvmnCellTxnoNo": "0000",
"rcvmnCellEndNo": "0000",
"rcvmnTelRgnNo": "02",
"rcvmnTelTxnoNo": "554",
"rcvmnTelEndNo": "4583",
"shopTrafMsg": "포장 안 해주셔도 돼요.",
"deliMsgCd": "40",
"deliMsg": "벨X, 노크X",
"comnFrdrCogoMethodCd": "20",
"comnFrdrEtcMethod": "뒷문 있어요.",
"comnFrdrPwd": "123456",
"pcccSeq": "text",
"persCstmCd": "P100000000000",
"newPersCstmCd": "P100000000000",
"dlvGrpInfoList": [
{
"dlvpSeq": "1",
"deliNo": "1",
"deliKindCd": "10",
"deliProcTypCd": "10",
"deliMethodCd": "10",
"basketGoodsList": [
{
"goodsNo": "100000001",
"deliProcTypCd": "10",
"deliPolcNo": "1",
"deliNo": "100000021",
"entrNo": "1000001",
"ordQty": 1,
"salePrc": 15000,
"dcAmt": 3000,
"sysModDtm": "2026-01-01T00:00:00.000Z",
"itmNo": "001",
"bsketNo": 100000001,
"chlNo": "1",
"chlDtlNo": "1",
"infDispCtgNoGbCd": "01",
"infDispCtgNo": "1",
"repDispCtgNo": "1",
"conrNo": "1",
"bsketQty": 1,
"goodsNm": "상품명",
"stdCtgNo": "1",
"goodsCompCd": "10",
"goodsTypCd": "10",
"saleMethCd": "10",
"brandNo": "1",
"brandNm": "브랜드명",
"buyrAgeLmtCd": "0",
"dispYn": "Y",
"saleStatCd": "10",
"saleStrDtm": "2026-01-01T00:00:00.000Z",
"saleEndDtm": "2026-01-01T00:00:00.000Z",
"buyTypCd": "10",
"taxGbCd": "10",
"stkMgrYn": "Y",
"buyQtyLmtYn": "Y",
"minLmtQty": 1,
"maxLmtQty": 10,
"safeStkNotiYn": "Y",
"deliGoodsGbCd": "01",
"deliWayCd": "01",
"deliPsbRgnCd": "01",
"deliDday": 1,
"bpckPsbYn": "Y",
"rtnPsbYn": "Y",
"exchPsbYn": "Y",
"supPcost": 10000,
"norPrc": 20000,
"preSalePrc": 20000,
"mrgnRate": 4,
"payMeanInfo": "11,12,32",
"itmNm": "아이템명1>아이템명2>아이템명3",
"stkQty": 999,
"prestNm": "증정품명",
"rsvStrtDtm": "2026-01-01T00:00:00.000Z",
"rsvEndDtm": "2026-01-01T00:00:00.000Z",
"fwdidcPrarDy": "2026-01-01",
"hsCd": "1",
"wishYn": "Y",
"maxDcAmt": 1000,
"goodsImg": "files/goods/2023/07/04/img",
"itmSaleStatCd": "10",
"gvgfPsbYn": "Y",
"rglrDeliGoodsYn": "Y",
"sngGoodsYn": "Y",
"marketingDisplayNo": "1",
"entrGoodsNo": "100042110583831",
"entrItmNo": "100042110583831001",
"ordCnclPsbYn": "N",
"wthdYn": "N",
"frgnDirPurGoodsYn": "text"
}
],
"dlvAmtInfoList": [
{
"ordCostGbCd": "10",
"dlexTypCd": "10",
"stdAdtnAmt": 20000,
"dlexAmt": 3500,
"aplyAdtnAmt": 20000,
"trdTypCd": "text",
"entrNo": "1000211",
"deliPolcNo": "10000431",
"dlvBenefitInfo": {
"promoNo": "C1000000",
"promoNm": "프로모션 명",
"promoTypCd": "11",
"ourChrgRate": 100,
"entrChrgRate": 0,
"cpnIsuNo": "100000",
"ordCostGbCd": "10"
}
}
]
}
]
}
],
"ordBnfInfo": {
"promoNo": "C1000000",
"promoNm": "프로모션 명",
"promoTypCd": "11",
"ourChrgRate": 100,
"entrChrgRate": 0,
"fixamtFxrtGbCd": "01",
"dcRateAmt": 5000,
"minBuyAmt": 1000,
"maxDcAmt": 5000,
"isMaxYn": "Y",
"dcAmt": 5000,
"cpnIsuNo": "100000",
"goods": [
{
"goodsNo": "10000001",
"itmNo": "001",
"dcAmt": 5000
}
]
},
"accmInfo": {
"totalAccmAmt": 3000,
"accmList": [
{
"accmGbCd": "21",
"accmRate": 10,
"accmAmt": 3000,
"promoNo": "C1000000",
"promoNm": "프로모션 명",
"promoTypCd": "40",
"ourChrgRate": 100,
"entrChrgRate": 0,
"fixamtFxrtGbCd": "01",
"rsrvStdAmt": 5000,
"goodsAccmList": [
{
"goodsNo": "10000001",
"itmNo": "001",
"accmAmt": 3000
}
]
}
]
},
"paymentRequest": {
"siteNo": "1",
"orderInfo": {
"ordNo": "20990101O000001",
"claimNo": "20990101C000001",
"goodsNm": "플래티어커피",
"ordManNm": "김플래티어",
"ordmnCellNo": "01012345678",
"ordmnEmailAddr": "kim@plateer.com",
"crcUnitCd": "KRW",
"ordMediaCd": "30",
"mbrNo": "100000001",
"ordDtlGbCd": "10",
"clientIp": "127.0.0.1",
"taxFreeAmt": 1
},
"payInfoList": [
{
"payNo": "1",
"payWayCd": "11",
"payAmt": 1000,
"mersNo": "1",
"pgGbCd": "10",
"trdNo": "INIMX_DBNKINIpayTest20990101090000685510",
"selectCardCd": "01",
"termlId": "INIBillTst",
"billKey": "text",
"authResultMap": "{P_STATUS:결과코드, P_RMESG1:결과메시지, P_TID:인증거래번호, P_AMT:거래금액, idc_name:IDC센터코드P_REQ_URL:승인요청 URL, P_NOTI:가맹점 임의 데이터}"
}
]
},
"proofDocInfo": {
"ordNo": "text",
"mbrNo": "text",
"ordManNm": "홍길동",
"proofType": "text",
"payWayCd": "11",
"orderTaxInvoiceRequest": {
"entrNo": "text",
"goodsNm": "text",
"goodsCount": 1,
"payAmt": 1,
"bmanNo": "text",
"bmanNm": "text",
"rpstmnNm": "text",
"zipNo": "text",
"zipAddr": "text",
"dtlAddr": "text",
"aempNm": "text",
"aempTelRgnNo": "text",
"aempTelTxnoNo": "text",
"aempTelEndNo": "text",
"aempEmailId": "text",
"aempEmailDomain": "text",
"aempEmail": "text",
"validYn": "text"
},
"orderCashReceiptRequest": {
"prsntPurpsCd": "text",
"idefNo": "text",
"prchsrNm": "text",
"prchsrEmail": "text",
"prchsrCell": "text",
"smsTrnsYn": "text",
"faxTrnsYn": "text",
"valiYn": "text"
}
}
}
}Access Token
FO 주문서 사은행사 조회 Request DTO
주문매체 코드(OM007) 10 : 전화상담(CC) , 20 : PC , 30 : 모바일웹 , 40 : 안드로이드앱 , 50 : IOS앱 , 60 : 정기주문
20Possible values: 회원번호
회원등급코드(ME008) 10 : GREEN , 20 : FAMILY , 30 : GOLD , 40 : VIP , 50 : VVIP
10Possible values: 사이트번호
1임직원여부
Y성공
사은행사정보
상품번호
10000001단품번호
001사은행사번호
C1000000사은행사 유형 코드(MK012) 10 : 구매금액사은품 , 20 : 상품사은품
20Possible values: 사은행사시작일시
사은행사종료일시
지급시작일자
20231201지급종료일자
20231231타임행사여부
N적용시작시간
0800적용종료시간
2359사은행사설명
사은행사 설명사은행사명
사은행사 명업무처리 오류 내용
POST /api/order/v1/orderSheet/getCounselorOrderAeEvtList HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 2353
{
"ordGoodsInfoList": [
{
"basketGoods": {
"goodsNo": "100000001",
"deliProcTypCd": "10",
"deliPolcNo": "1",
"deliNo": "100000021",
"entrNo": "1000001",
"ordQty": 1,
"salePrc": 15000,
"dcAmt": 3000,
"sysModDtm": "2026-01-01T00:00:00.000Z",
"itmNo": "001",
"bsketNo": 100000001,
"chlNo": "1",
"chlDtlNo": "1",
"infDispCtgNoGbCd": "01",
"infDispCtgNo": "1",
"repDispCtgNo": "1",
"conrNo": "1",
"bsketQty": 1,
"goodsNm": "상품명",
"stdCtgNo": "1",
"goodsCompCd": "10",
"goodsTypCd": "10",
"saleMethCd": "10",
"brandNo": "1",
"brandNm": "브랜드명",
"buyrAgeLmtCd": "0",
"dispYn": "Y",
"saleStatCd": "10",
"saleStrDtm": "2026-01-01T00:00:00.000Z",
"saleEndDtm": "2026-01-01T00:00:00.000Z",
"buyTypCd": "10",
"taxGbCd": "10",
"stkMgrYn": "Y",
"buyQtyLmtYn": "Y",
"minLmtQty": 1,
"maxLmtQty": 10,
"safeStkNotiYn": "Y",
"deliGoodsGbCd": "01",
"deliWayCd": "01",
"deliPsbRgnCd": "01",
"deliDday": 1,
"bpckPsbYn": "Y",
"rtnPsbYn": "Y",
"exchPsbYn": "Y",
"supPcost": 10000,
"norPrc": 20000,
"preSalePrc": 20000,
"mrgnRate": 4,
"payMeanInfo": "11,12,32",
"itmNm": "아이템명1>아이템명2>아이템명3",
"stkQty": 999,
"prestNm": "증정품명",
"rsvStrtDtm": "2026-01-01T00:00:00.000Z",
"rsvEndDtm": "2026-01-01T00:00:00.000Z",
"fwdidcPrarDy": "2026-01-01",
"hsCd": "1",
"wishYn": "Y",
"maxDcAmt": 1000,
"goodsImg": "files/goods/2023/07/04/img",
"itmSaleStatCd": "10",
"gvgfPsbYn": "Y",
"rglrDeliGoodsYn": "Y",
"sngGoodsYn": "Y",
"marketingDisplayNo": "1",
"entrGoodsNo": "100042110583831",
"entrItmNo": "100042110583831001",
"ordCnclPsbYn": "N",
"wthdYn": "N",
"frgnDirPurGoodsYn": "text"
},
"aplyGoodsBnfInfo": {
"goodsNo": "10000001",
"itmNo": "001",
"dcAmt": 5000,
"benefitList": [
{
"promoNo": "C1000000",
"promoNm": "프로모션 명",
"promoTypCd": "11",
"ourChrgRate": 100,
"entrChrgRate": 0,
"fixamtFxrtGbCd": "01",
"dcRateAmt": 5000,
"minBuyAmt": 1000,
"maxDcAmt": 5000,
"isMaxYn": "Y",
"dcAmt": 5000,
"dcAmtPerCnt": 2500,
"cpnIsuNo": "100000"
}
]
},
"aeEvtList": [
{
"goodsNo": "10000001",
"itmNo": "001",
"aeNo": "C1000000",
"addEvtTypCd": "20",
"aeStrDtm": "2026-01-01T00:00:00.000Z",
"aeEndDtm": "2026-01-01T00:00:00.000Z",
"payStrDt": "20231201",
"payEndDt": "20231231",
"tmEvtYn": "N",
"aplyStrTm": "0800",
"aplyEndTm": "2359",
"aeDesc": "사은행사 설명",
"aeNm": "사은행사 명",
"aeGoodsList": [
{
"aeFvrSeq": "1",
"aplyMinAmt": 5000,
"aplyMaxAmt": 10000,
"aeGoodsNm": "사은품 명",
"aeGoodsNo": "10000001",
"aeGoodsItmNo": "001",
"aeGoodsImgPath": "/path/image001.png"
}
]
}
]
}
],
"ordMediaCd": "20",
"mbrNo": "text",
"mbrGradeCd": "10",
"siteNo": "1",
"stafYn": "Y"
}[
{
"goodsNo": "10000001",
"itmNo": "001",
"aeNo": "C1000000",
"addEvtTypCd": "20",
"aeStrDtm": "2026-01-01T00:00:00.000Z",
"aeEndDtm": "2026-01-01T00:00:00.000Z",
"payStrDt": "20231201",
"payEndDt": "20231231",
"tmEvtYn": "N",
"aplyStrTm": "0800",
"aplyEndTm": "2359",
"aeDesc": "사은행사 설명",
"aeNm": "사은행사 명",
"aeGoodsList": [
{
"aeFvrSeq": "1",
"aplyMinAmt": 5000,
"aplyMaxAmt": 10000,
"aeGoodsNm": "사은품 명",
"aeGoodsNo": "10000001",
"aeGoodsItmNo": "001",
"aeGoodsImgPath": "/path/image001.png"
}
]
}
]Access Token
FO 주문서 사은행사 조회 Request DTO
주문매체 코드(OM007) 10 : 전화상담(CC) , 20 : PC , 30 : 모바일웹 , 40 : 안드로이드앱 , 50 : IOS앱 , 60 : 정기주문
20Possible values: 회원번호
회원등급코드(ME008) 10 : GREEN , 20 : FAMILY , 30 : GOLD , 40 : VIP , 50 : VVIP
10Possible values: 사이트번호
1임직원여부
Y성공
사은행사정보
상품번호
10000001단품번호
001사은행사번호
C1000000사은행사 유형 코드(MK012) 10 : 구매금액사은품 , 20 : 상품사은품
20Possible values: 사은행사시작일시
사은행사종료일시
지급시작일자
20231201지급종료일자
20231231타임행사여부
N적용시작시간
0800적용종료시간
2359사은행사설명
사은행사 설명사은행사명
사은행사 명업무처리 오류 내용
POST /api/order/v1/orderSheet/aeEvtList HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 2353
{
"ordGoodsInfoList": [
{
"basketGoods": {
"goodsNo": "100000001",
"deliProcTypCd": "10",
"deliPolcNo": "1",
"deliNo": "100000021",
"entrNo": "1000001",
"ordQty": 1,
"salePrc": 15000,
"dcAmt": 3000,
"sysModDtm": "2026-01-01T00:00:00.000Z",
"itmNo": "001",
"bsketNo": 100000001,
"chlNo": "1",
"chlDtlNo": "1",
"infDispCtgNoGbCd": "01",
"infDispCtgNo": "1",
"repDispCtgNo": "1",
"conrNo": "1",
"bsketQty": 1,
"goodsNm": "상품명",
"stdCtgNo": "1",
"goodsCompCd": "10",
"goodsTypCd": "10",
"saleMethCd": "10",
"brandNo": "1",
"brandNm": "브랜드명",
"buyrAgeLmtCd": "0",
"dispYn": "Y",
"saleStatCd": "10",
"saleStrDtm": "2026-01-01T00:00:00.000Z",
"saleEndDtm": "2026-01-01T00:00:00.000Z",
"buyTypCd": "10",
"taxGbCd": "10",
"stkMgrYn": "Y",
"buyQtyLmtYn": "Y",
"minLmtQty": 1,
"maxLmtQty": 10,
"safeStkNotiYn": "Y",
"deliGoodsGbCd": "01",
"deliWayCd": "01",
"deliPsbRgnCd": "01",
"deliDday": 1,
"bpckPsbYn": "Y",
"rtnPsbYn": "Y",
"exchPsbYn": "Y",
"supPcost": 10000,
"norPrc": 20000,
"preSalePrc": 20000,
"mrgnRate": 4,
"payMeanInfo": "11,12,32",
"itmNm": "아이템명1>아이템명2>아이템명3",
"stkQty": 999,
"prestNm": "증정품명",
"rsvStrtDtm": "2026-01-01T00:00:00.000Z",
"rsvEndDtm": "2026-01-01T00:00:00.000Z",
"fwdidcPrarDy": "2026-01-01",
"hsCd": "1",
"wishYn": "Y",
"maxDcAmt": 1000,
"goodsImg": "files/goods/2023/07/04/img",
"itmSaleStatCd": "10",
"gvgfPsbYn": "Y",
"rglrDeliGoodsYn": "Y",
"sngGoodsYn": "Y",
"marketingDisplayNo": "1",
"entrGoodsNo": "100042110583831",
"entrItmNo": "100042110583831001",
"ordCnclPsbYn": "N",
"wthdYn": "N",
"frgnDirPurGoodsYn": "text"
},
"aplyGoodsBnfInfo": {
"goodsNo": "10000001",
"itmNo": "001",
"dcAmt": 5000,
"benefitList": [
{
"promoNo": "C1000000",
"promoNm": "프로모션 명",
"promoTypCd": "11",
"ourChrgRate": 100,
"entrChrgRate": 0,
"fixamtFxrtGbCd": "01",
"dcRateAmt": 5000,
"minBuyAmt": 1000,
"maxDcAmt": 5000,
"isMaxYn": "Y",
"dcAmt": 5000,
"dcAmtPerCnt": 2500,
"cpnIsuNo": "100000"
}
]
},
"aeEvtList": [
{
"goodsNo": "10000001",
"itmNo": "001",
"aeNo": "C1000000",
"addEvtTypCd": "20",
"aeStrDtm": "2026-01-01T00:00:00.000Z",
"aeEndDtm": "2026-01-01T00:00:00.000Z",
"payStrDt": "20231201",
"payEndDt": "20231231",
"tmEvtYn": "N",
"aplyStrTm": "0800",
"aplyEndTm": "2359",
"aeDesc": "사은행사 설명",
"aeNm": "사은행사 명",
"aeGoodsList": [
{
"aeFvrSeq": "1",
"aplyMinAmt": 5000,
"aplyMaxAmt": 10000,
"aeGoodsNm": "사은품 명",
"aeGoodsNo": "10000001",
"aeGoodsItmNo": "001",
"aeGoodsImgPath": "/path/image001.png"
}
]
}
]
}
],
"ordMediaCd": "20",
"mbrNo": "text",
"mbrGradeCd": "10",
"siteNo": "1",
"stafYn": "Y"
}[
{
"goodsNo": "10000001",
"itmNo": "001",
"aeNo": "C1000000",
"addEvtTypCd": "20",
"aeStrDtm": "2026-01-01T00:00:00.000Z",
"aeEndDtm": "2026-01-01T00:00:00.000Z",
"payStrDt": "20231201",
"payEndDt": "20231231",
"tmEvtYn": "N",
"aplyStrTm": "0800",
"aplyEndTm": "2359",
"aeDesc": "사은행사 설명",
"aeNm": "사은행사 명",
"aeGoodsList": [
{
"aeFvrSeq": "1",
"aplyMinAmt": 5000,
"aplyMaxAmt": 10000,
"aeGoodsNm": "사은품 명",
"aeGoodsNo": "10000001",
"aeGoodsItmNo": "001",
"aeGoodsImgPath": "/path/image001.png"
}
]
}
]Access Token
FO 주문서 적립 조회 Request DTO
주문매체 코드(OM007) 10 : 전화상담(CC) , 20 : PC , 30 : 모바일웹 , 40 : 안드로이드앱 , 50 : IOS앱 , 60 : 정기주문
20Possible values: 성공
적립정보
전체적립금액
3000업무처리 오류 내용
POST /api/order/v1/orderSheet/accumulationInfo HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 2606
{
"ordGoodsInfoList": [
{
"basketGoods": {
"goodsNo": "100000001",
"deliProcTypCd": "10",
"deliPolcNo": "1",
"deliNo": "100000021",
"entrNo": "1000001",
"ordQty": 1,
"salePrc": 15000,
"dcAmt": 3000,
"sysModDtm": "2026-01-01T00:00:00.000Z",
"itmNo": "001",
"bsketNo": 100000001,
"chlNo": "1",
"chlDtlNo": "1",
"infDispCtgNoGbCd": "01",
"infDispCtgNo": "1",
"repDispCtgNo": "1",
"conrNo": "1",
"bsketQty": 1,
"goodsNm": "상품명",
"stdCtgNo": "1",
"goodsCompCd": "10",
"goodsTypCd": "10",
"saleMethCd": "10",
"brandNo": "1",
"brandNm": "브랜드명",
"buyrAgeLmtCd": "0",
"dispYn": "Y",
"saleStatCd": "10",
"saleStrDtm": "2026-01-01T00:00:00.000Z",
"saleEndDtm": "2026-01-01T00:00:00.000Z",
"buyTypCd": "10",
"taxGbCd": "10",
"stkMgrYn": "Y",
"buyQtyLmtYn": "Y",
"minLmtQty": 1,
"maxLmtQty": 10,
"safeStkNotiYn": "Y",
"deliGoodsGbCd": "01",
"deliWayCd": "01",
"deliPsbRgnCd": "01",
"deliDday": 1,
"bpckPsbYn": "Y",
"rtnPsbYn": "Y",
"exchPsbYn": "Y",
"supPcost": 10000,
"norPrc": 20000,
"preSalePrc": 20000,
"mrgnRate": 4,
"payMeanInfo": "11,12,32",
"itmNm": "아이템명1>아이템명2>아이템명3",
"stkQty": 999,
"prestNm": "증정품명",
"rsvStrtDtm": "2026-01-01T00:00:00.000Z",
"rsvEndDtm": "2026-01-01T00:00:00.000Z",
"fwdidcPrarDy": "2026-01-01",
"hsCd": "1",
"wishYn": "Y",
"maxDcAmt": 1000,
"goodsImg": "files/goods/2023/07/04/img",
"itmSaleStatCd": "10",
"gvgfPsbYn": "Y",
"rglrDeliGoodsYn": "Y",
"sngGoodsYn": "Y",
"marketingDisplayNo": "1",
"entrGoodsNo": "100042110583831",
"entrItmNo": "100042110583831001",
"ordCnclPsbYn": "N",
"wthdYn": "N",
"frgnDirPurGoodsYn": "text"
},
"aplyGoodsBnfInfo": {
"goodsNo": "10000001",
"itmNo": "001",
"dcAmt": 5000,
"benefitList": [
{
"promoNo": "C1000000",
"promoNm": "프로모션 명",
"promoTypCd": "11",
"ourChrgRate": 100,
"entrChrgRate": 0,
"fixamtFxrtGbCd": "01",
"dcRateAmt": 5000,
"minBuyAmt": 1000,
"maxDcAmt": 5000,
"isMaxYn": "Y",
"dcAmt": 5000,
"dcAmtPerCnt": 2500,
"cpnIsuNo": "100000"
}
]
},
"aeEvtList": [
{
"goodsNo": "10000001",
"itmNo": "001",
"aeNo": "C1000000",
"addEvtTypCd": "20",
"aeStrDtm": "2026-01-01T00:00:00.000Z",
"aeEndDtm": "2026-01-01T00:00:00.000Z",
"payStrDt": "20231201",
"payEndDt": "20231231",
"tmEvtYn": "N",
"aplyStrTm": "0800",
"aplyEndTm": "2359",
"aeDesc": "사은행사 설명",
"aeNm": "사은행사 명",
"aeGoodsList": [
{
"aeFvrSeq": "1",
"aplyMinAmt": 5000,
"aplyMaxAmt": 10000,
"aeGoodsNm": "사은품 명",
"aeGoodsNo": "10000001",
"aeGoodsItmNo": "001",
"aeGoodsImgPath": "/path/image001.png"
}
]
}
]
}
],
"benefitOrderPromotionInfo": {
"promoNo": "C1000000",
"promoNm": "프로모션 명",
"promoTypCd": "11",
"ourChrgRate": 100,
"entrChrgRate": 0,
"fixamtFxrtGbCd": "01",
"dcRateAmt": 5000,
"minBuyAmt": 1000,
"maxDcAmt": 5000,
"isMaxYn": "Y",
"dcAmt": 5000,
"cpnIsuNo": "100000",
"goods": [
{
"goodsNo": "10000001",
"itmNo": "001",
"dcAmt": 5000
}
]
},
"ordMediaCd": "20"
}{
"totalAccmAmt": 3000,
"accmList": [
{
"accmGbCd": "21",
"accmRate": 10,
"accmAmt": 3000,
"promoNo": "C1000000",
"promoNm": "프로모션 명",
"promoTypCd": "40",
"ourChrgRate": 100,
"entrChrgRate": 0,
"fixamtFxrtGbCd": "01",
"rsrvStdAmt": 5000,
"goodsAccmList": [
{
"goodsNo": "10000001",
"itmNo": "001",
"accmAmt": 3000
}
]
}
]
}기능 설명
주문 성공 후 주문완료 정보를 조회하는 API 입니다.
상세 설명
요청한 주문에 클레임이 진행되었다면 예외가 발생합니다.
비회원의 경우 비회원 로그인 처리 API를 통해 생성된 쿠키 값이 필수입니다.
수정번호
Release v2.00_240401 : 상품 리스트(OrderCompleteGoodsInfo)에 증정품명(prestNm) 추가
Release v2.00_240401 : 구매 상품별로 사은품 목록을 표시할 수 있도록 주문순번(ordSeq)과 본품주문순번(aeOrdSeq)을 추가
Release v2.00_240401 : 단일상품여부(snsGoodsYn) 조회 추가
비회원 주문정보. 비회원 주문완료 조회시 필수
Access Token
주문완료조회 Request
주문번호
20230809O007055시스템구분코드 10:FO, 20:BO
10Possible values: 주문완료 조회 성공
주문완료정보
주문번호
20230809O007055주문순번
1주문자명
홍길동주문구분코드(OM002)
10주문일시
본품주문순번
1주문상품구분(OM029)
10업무처리 오류 내용
POST /api/order/v1/order/getOrderCompleteInfo HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 45
{
"ordNo": "20230809O007055",
"systemType": "10"
}{
"ordNo": "20230809O007055",
"ordSeq": 1,
"ordManNm": "홍길동",
"ordGbCd": "10",
"ordAccpDtm": "2026-01-01T00:00:00.000Z",
"giftCard": {
"prstTypCd": "10",
"prstMsg": "생일 축하해요.",
"cardImgPath": "/card-image.png"
},
"deliveryPlaceList": [
{
"dlvpSeq": "1",
"dlvpNm": "플래티어",
"rcvmnNm": "홍길동",
"rcvmnCellSctNo": "010",
"rcvmnCellTxnoNo": "0000",
"rcvmnCellEndNo": "0000",
"zipNo": "05837",
"zipAddr": "서울 송파구 법원로9길",
"dtlAddr": "에이치비지니스파크 D동 6층",
"deliMsgCd": "40",
"deliMsgCdNm": "부재 시 경비실에 맡겨주세요",
"deliMsg": "벨X, 노크X",
"comnFrdrCogoMethodCd": "20",
"comnFrdrCogoMethodCdNm": "자유출입 가능",
"comnFrdrPwd": "123456",
"persCstmCd": "text",
"deliveryGroupList": [
{
"deliNo": "1",
"goodsInfoList": [
{
"ordQty": 1,
"goodsNo": "10002293",
"itmNo": "001",
"itmNm": "F",
"ordSaleTypCd": "10",
"saleMethCd": "10",
"prestNm": "증정품",
"goodsNm": "초코파이",
"goodsImg": "text",
"brandNm": "**제과",
"norPrc": 3000,
"salePrc": 2700,
"ordSeq": 1,
"aeOrdSeq": 1,
"sngGoodsYn": "Y"
}
]
}
]
}
],
"payInfoList": [
{
"ordNo": "text",
"payAmt": 2700,
"payWayCd": "11",
"payWayNm": "신용카드",
"cardNm": "국민카드",
"divMonCnt": 3,
"bankCd": "201",
"bankNm": "신한은행",
"actnNo": "계좌번호 암호화",
"dpmnNm": "김플래티어",
"dptFcstDt": "20990101"
}
],
"orderAmount": {
"ordNo": "20230809O007055",
"saleAmt": 2700,
"deliveryAmt": 0,
"benefitAmt": 0,
"accmAmt": 270,
"payAmt": 2700
},
"aeOrdSeq": 1,
"ordGoodsGb": "10"
}Access Token
배송그룹 배송비조회 DTO
LO010(배송방법코드) * 10 : 택배배송 * 30 : 매장수령 * 40 : 퀵배송 * 50 : 해외배송 * 60 : 무배송
10Possible values: 성공
배송지순번
1배송번호
1협력사번호
10000002배송정책번호
10000431업무처리 오류 내용
POST /api/order/v1/delivery/deliveryGroupAmountList HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 156
{
"deliMethodCd": "10",
"deliveryGroupFeeRequestList": [
{
"dlvpSeq": "1",
"deliNo": "1",
"deliPolcNo": "10000431",
"entrNo": "10000002",
"zipNo": "12345",
"amount": 1000
}
]
}[
{
"dlvpSeq": "1",
"deliNo": "1",
"entrNo": "10000002",
"deliPolcNo": "10000431",
"adtnCostInfoList": [
{
"ordCostGbCd": "10",
"dlexTypCd": "10",
"stdAdtnAmt": 20000,
"dlexAmt": 3500,
"aplyAdtnAmt": 20000,
"trdTypCd": "10"
}
]
}
]Access Token
배송비 조회 Request DTO
LO010(배송방법코드) * 10 : 택배배송 * 30 : 매장수령 * 40 : 퀵배송 * 50 : 해외배송 * 60 : 무배송
10Possible values: 전체클레임 여부
성공
배송지 목록
배송지 순번
1회원 배송지순번
1기본 배송지 여부
Y배송지명. 일반주문 필수
우리집우편번호. 일반주문 필수
05837우편주소. 일반주문 필수
서울 송파구 법원로9길상세주소. 일반주문 필수
에이치비지니스파크 D동 6층수취인명
홍길동수취인 이메일주소
receiver@plateer.com수취인 휴대폰 구분번호
010수취인 휴대폰 국번번호
0000수취인 휴대폰 끝번호
0000수취인 전화 지역번호
02수취인 전화 국번번호
554수취인 전화 끝번호
4583매장전달메시지
포장 안 해주셔도 돼요.배송메시지코드(ME039) 20:배송 전 연락 바랍니다,30:부재 시 문 앞에 놓아주세요,40:부재 시 경비실에 맡겨주세요,50:빠른 배송 부탁 드립니다,60:부재 시 핸드폰으로 연락바랍니다,70:직접입력
40배송메시지
벨X, 노크X공동현관출입방법코드(ME040) 10:공동현관 출입번호,20:자유 출입 가능,30:기타
20공동현관출입 기타방법
뒷문 있어요.공동현관비밀번호
123456회원통관고유부호순번
통관고유번호
P100000000000새 통관고유번호
P100000000000업무처리 오류 내용
POST /api/order/v1/delivery/deliveryAmount HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 2219
{
"deliMethodCd": "10",
"dlvpInfo": {
"dlvpSeq": "1",
"dlvpNm": "플래티어",
"mbrDlvpSeq": "1",
"baseDlvpYn": "Y",
"zipNoSeq": 1,
"zipNo": "05836",
"zipAddr": "서울 송파구 법원로9길 26",
"dtlAddr": "101동",
"emailAddr": "mac9692@plateer.com",
"rcvmnNm": "박진성",
"cellSctNo": "010",
"cellTxnoNo": "2023",
"cellEndNo": "4046",
"telRgnNo": "031",
"telTxnoNo": "406",
"telEndNo": "4129",
"deliMsgCd": "10",
"deliMsg": "초인종누르지마세요.",
"comnFrdrCogoMethodCd": "10",
"comnFrdrEtcMethod": "조심히 오세요.",
"comnFrdrPwd": "2321",
"comnFrdrPwdMask": "****",
"deliMsgCdNm": "부재 시 경비실에 맡겨주세요",
"comnFrdrCogoMethodCdNm": "자유출입가능",
"aplyBsketInfoList": [
{
"bsketNum": 1,
"aplyCnt": 1
}
],
"pcccSeq": "text",
"persCstmCd": "text",
"newPersCstmCd": "text"
},
"goodsList": [
{
"goodsNo": "100000001",
"deliProcTypCd": "10",
"deliPolcNo": "1",
"deliNo": "100000021",
"entrNo": "1000001",
"ordQty": 1,
"salePrc": 15000,
"dcAmt": 3000,
"sysModDtm": "2026-01-01T00:00:00.000Z",
"itmNo": "001",
"bsketNo": 100000001,
"chlNo": "1",
"chlDtlNo": "1",
"infDispCtgNoGbCd": "01",
"infDispCtgNo": "1",
"repDispCtgNo": "1",
"conrNo": "1",
"bsketQty": 1,
"goodsNm": "상품명",
"stdCtgNo": "1",
"goodsCompCd": "10",
"goodsTypCd": "10",
"saleMethCd": "10",
"brandNo": "1",
"brandNm": "브랜드명",
"buyrAgeLmtCd": "0",
"dispYn": "Y",
"saleStatCd": "10",
"saleStrDtm": "2026-01-01T00:00:00.000Z",
"saleEndDtm": "2026-01-01T00:00:00.000Z",
"buyTypCd": "10",
"taxGbCd": "10",
"stkMgrYn": "Y",
"buyQtyLmtYn": "Y",
"minLmtQty": 1,
"maxLmtQty": 10,
"safeStkNotiYn": "Y",
"deliGoodsGbCd": "01",
"deliWayCd": "01",
"deliPsbRgnCd": "01",
"deliDday": 1,
"bpckPsbYn": "Y",
"rtnPsbYn": "Y",
"exchPsbYn": "Y",
"supPcost": 10000,
"norPrc": 20000,
"preSalePrc": 20000,
"mrgnRate": 4,
"payMeanInfo": "11,12,32",
"itmNm": "아이템명1>아이템명2>아이템명3",
"stkQty": 999,
"prestNm": "증정품명",
"rsvStrtDtm": "2026-01-01T00:00:00.000Z",
"rsvEndDtm": "2026-01-01T00:00:00.000Z",
"fwdidcPrarDy": "2026-01-01",
"hsCd": "1",
"wishYn": "Y",
"maxDcAmt": 1000,
"goodsImg": "files/goods/2023/07/04/img",
"itmSaleStatCd": "10",
"gvgfPsbYn": "Y",
"rglrDeliGoodsYn": "Y",
"sngGoodsYn": "Y",
"marketingDisplayNo": "1",
"entrGoodsNo": "100042110583831",
"entrItmNo": "100042110583831001",
"ordCnclPsbYn": "N",
"wthdYn": "N",
"frgnDirPurGoodsYn": "text"
}
],
"allClaim": true,
"allNonReturnable": true
}[
{
"dlvpSeq": "1",
"mbrDlvpSeq": "1",
"baseDlvpYn": "Y",
"dlvpNm": "우리집",
"zipNo": "05837",
"zipAddr": "서울 송파구 법원로9길",
"dtlAddr": "에이치비지니스파크 D동 6층",
"rcvmnNm": "홍길동",
"rcvmnEmailAddr": "receiver@plateer.com",
"rcvmnCellSctNo": "010",
"rcvmnCellTxnoNo": "0000",
"rcvmnCellEndNo": "0000",
"rcvmnTelRgnNo": "02",
"rcvmnTelTxnoNo": "554",
"rcvmnTelEndNo": "4583",
"shopTrafMsg": "포장 안 해주셔도 돼요.",
"deliMsgCd": "40",
"deliMsg": "벨X, 노크X",
"comnFrdrCogoMethodCd": "20",
"comnFrdrEtcMethod": "뒷문 있어요.",
"comnFrdrPwd": "123456",
"pcccSeq": "text",
"persCstmCd": "P100000000000",
"newPersCstmCd": "P100000000000",
"dlvGrpInfoList": [
{
"dlvpSeq": "1",
"deliNo": "1",
"deliKindCd": "10",
"deliProcTypCd": "10",
"deliMethodCd": "10",
"basketGoodsList": [
{
"goodsNo": "100000001",
"deliProcTypCd": "10",
"deliPolcNo": "1",
"deliNo": "100000021",
"entrNo": "1000001",
"ordQty": 1,
"salePrc": 15000,
"dcAmt": 3000,
"sysModDtm": "2026-01-01T00:00:00.000Z",
"itmNo": "001",
"bsketNo": 100000001,
"chlNo": "1",
"chlDtlNo": "1",
"infDispCtgNoGbCd": "01",
"infDispCtgNo": "1",
"repDispCtgNo": "1",
"conrNo": "1",
"bsketQty": 1,
"goodsNm": "상품명",
"stdCtgNo": "1",
"goodsCompCd": "10",
"goodsTypCd": "10",
"saleMethCd": "10",
"brandNo": "1",
"brandNm": "브랜드명",
"buyrAgeLmtCd": "0",
"dispYn": "Y",
"saleStatCd": "10",
"saleStrDtm": "2026-01-01T00:00:00.000Z",
"saleEndDtm": "2026-01-01T00:00:00.000Z",
"buyTypCd": "10",
"taxGbCd": "10",
"stkMgrYn": "Y",
"buyQtyLmtYn": "Y",
"minLmtQty": 1,
"maxLmtQty": 10,
"safeStkNotiYn": "Y",
"deliGoodsGbCd": "01",
"deliWayCd": "01",
"deliPsbRgnCd": "01",
"deliDday": 1,
"bpckPsbYn": "Y",
"rtnPsbYn": "Y",
"exchPsbYn": "Y",
"supPcost": 10000,
"norPrc": 20000,
"preSalePrc": 20000,
"mrgnRate": 4,
"payMeanInfo": "11,12,32",
"itmNm": "아이템명1>아이템명2>아이템명3",
"stkQty": 999,
"prestNm": "증정품명",
"rsvStrtDtm": "2026-01-01T00:00:00.000Z",
"rsvEndDtm": "2026-01-01T00:00:00.000Z",
"fwdidcPrarDy": "2026-01-01",
"hsCd": "1",
"wishYn": "Y",
"maxDcAmt": 1000,
"goodsImg": "files/goods/2023/07/04/img",
"itmSaleStatCd": "10",
"gvgfPsbYn": "Y",
"rglrDeliGoodsYn": "Y",
"sngGoodsYn": "Y",
"marketingDisplayNo": "1",
"entrGoodsNo": "100042110583831",
"entrItmNo": "100042110583831001",
"ordCnclPsbYn": "N",
"wthdYn": "N",
"frgnDirPurGoodsYn": "text"
}
],
"dlvAmtInfoList": [
{
"ordCostGbCd": "10",
"dlexTypCd": "10",
"stdAdtnAmt": 20000,
"dlexAmt": 3500,
"aplyAdtnAmt": 20000,
"trdTypCd": "text",
"entrNo": "1000211",
"deliPolcNo": "10000431",
"dlvBenefitInfo": {
"promoNo": "C1000000",
"promoNm": "프로모션 명",
"promoTypCd": "11",
"ourChrgRate": 100,
"entrChrgRate": 0,
"cpnIsuNo": "100000",
"ordCostGbCd": "10"
}
}
]
}
]
}
]Access Token
주문하기 Request
주문 성공
No content
업무처리 오류 내용
POST /api/order/v1/counselorOrder HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 7426
{
"ordBaseInfo": {
"ordNo": "20230810O008148",
"siteNo": "1",
"ordMediaCd": "20",
"ordGbCd": "10",
"rfdBankCd": "104",
"rfdActnNo": "000000000000",
"rcdActnDepositorNm": "홍길동",
"rglrDeliNo": "1",
"chlNo": "1",
"chlDtlNo": "1",
"ordererInfo": {
"mbrNo": "100001311",
"ordManNm": "홍길동",
"umemPwd": "password123!",
"ordManEmailAddr": "nonmember@plateer.com",
"cellSctNo": "010",
"cellTxnoNo": "0000",
"cellEndNo": "0000",
"telRgnNo": "02",
"telTxnoNo": "554",
"telEndNo": "4583",
"ordLmtYn": "N",
"brth": "19961212",
"adlCertiYn": "Y",
"comGbCd": "P00",
"stafYn": "Y",
"nonMemberAge": 19,
"nonMemberCertiYn": "Y"
},
"giftCard": {
"prstTypCd": "10",
"prstMsg": "생일 축하해요."
},
"ordGoodsGb": "10"
},
"ordGoodsInfoList": [
{
"basketGoods": {
"goodsNo": "100000001",
"deliProcTypCd": "10",
"deliPolcNo": "1",
"deliNo": "100000021",
"entrNo": "1000001",
"ordQty": 1,
"salePrc": 15000,
"dcAmt": 3000,
"sysModDtm": "2026-01-01T00:00:00.000Z",
"itmNo": "001",
"bsketNo": 100000001,
"chlNo": "1",
"chlDtlNo": "1",
"infDispCtgNoGbCd": "01",
"infDispCtgNo": "1",
"repDispCtgNo": "1",
"conrNo": "1",
"bsketQty": 1,
"goodsNm": "상품명",
"stdCtgNo": "1",
"goodsCompCd": "10",
"goodsTypCd": "10",
"saleMethCd": "10",
"brandNo": "1",
"brandNm": "브랜드명",
"buyrAgeLmtCd": "0",
"dispYn": "Y",
"saleStatCd": "10",
"saleStrDtm": "2026-01-01T00:00:00.000Z",
"saleEndDtm": "2026-01-01T00:00:00.000Z",
"buyTypCd": "10",
"taxGbCd": "10",
"stkMgrYn": "Y",
"buyQtyLmtYn": "Y",
"minLmtQty": 1,
"maxLmtQty": 10,
"safeStkNotiYn": "Y",
"deliGoodsGbCd": "01",
"deliWayCd": "01",
"deliPsbRgnCd": "01",
"deliDday": 1,
"bpckPsbYn": "Y",
"rtnPsbYn": "Y",
"exchPsbYn": "Y",
"supPcost": 10000,
"norPrc": 20000,
"preSalePrc": 20000,
"mrgnRate": 4,
"payMeanInfo": "11,12,32",
"itmNm": "아이템명1>아이템명2>아이템명3",
"stkQty": 999,
"prestNm": "증정품명",
"rsvStrtDtm": "2026-01-01T00:00:00.000Z",
"rsvEndDtm": "2026-01-01T00:00:00.000Z",
"fwdidcPrarDy": "2026-01-01",
"hsCd": "1",
"wishYn": "Y",
"maxDcAmt": 1000,
"goodsImg": "files/goods/2023/07/04/img",
"itmSaleStatCd": "10",
"gvgfPsbYn": "Y",
"rglrDeliGoodsYn": "Y",
"sngGoodsYn": "Y",
"marketingDisplayNo": "1",
"entrGoodsNo": "100042110583831",
"entrItmNo": "100042110583831001",
"ordCnclPsbYn": "N",
"wthdYn": "N",
"frgnDirPurGoodsYn": "text"
},
"aplyGoodsBnfInfo": {
"goodsNo": "10000001",
"itmNo": "001",
"dcAmt": 5000,
"benefitList": [
{
"promoNo": "C1000000",
"promoNm": "프로모션 명",
"promoTypCd": "11",
"ourChrgRate": 100,
"entrChrgRate": 0,
"fixamtFxrtGbCd": "01",
"dcRateAmt": 5000,
"minBuyAmt": 1000,
"maxDcAmt": 5000,
"isMaxYn": "Y",
"dcAmt": 5000,
"dcAmtPerCnt": 2500,
"cpnIsuNo": "100000"
}
]
},
"aeEvtList": [
{
"goodsNo": "10000001",
"itmNo": "001",
"aeNo": "C1000000",
"addEvtTypCd": "20",
"aeStrDtm": "2026-01-01T00:00:00.000Z",
"aeEndDtm": "2026-01-01T00:00:00.000Z",
"payStrDt": "20231201",
"payEndDt": "20231231",
"tmEvtYn": "N",
"aplyStrTm": "0800",
"aplyEndTm": "2359",
"aeDesc": "사은행사 설명",
"aeNm": "사은행사 명",
"aeGoodsList": [
{
"aeFvrSeq": "1",
"aplyMinAmt": 5000,
"aplyMaxAmt": 10000,
"aeGoodsNm": "사은품 명",
"aeGoodsNo": "10000001",
"aeGoodsItmNo": "001",
"aeGoodsImgPath": "/path/image001.png"
}
]
}
]
}
],
"ordDlvInfoList": [
{
"dlvpSeq": "1",
"mbrDlvpSeq": "1",
"baseDlvpYn": "Y",
"dlvpNm": "우리집",
"zipNo": "05837",
"zipAddr": "서울 송파구 법원로9길",
"dtlAddr": "에이치비지니스파크 D동 6층",
"rcvmnNm": "홍길동",
"rcvmnEmailAddr": "receiver@plateer.com",
"rcvmnCellSctNo": "010",
"rcvmnCellTxnoNo": "0000",
"rcvmnCellEndNo": "0000",
"rcvmnTelRgnNo": "02",
"rcvmnTelTxnoNo": "554",
"rcvmnTelEndNo": "4583",
"shopTrafMsg": "포장 안 해주셔도 돼요.",
"deliMsgCd": "40",
"deliMsg": "벨X, 노크X",
"comnFrdrCogoMethodCd": "20",
"comnFrdrEtcMethod": "뒷문 있어요.",
"comnFrdrPwd": "123456",
"pcccSeq": "text",
"persCstmCd": "P100000000000",
"newPersCstmCd": "P100000000000",
"dlvGrpInfoList": [
{
"dlvpSeq": "1",
"deliNo": "1",
"deliKindCd": "10",
"deliProcTypCd": "10",
"deliMethodCd": "10",
"basketGoodsList": [
{
"goodsNo": "100000001",
"deliProcTypCd": "10",
"deliPolcNo": "1",
"deliNo": "100000021",
"entrNo": "1000001",
"ordQty": 1,
"salePrc": 15000,
"dcAmt": 3000,
"sysModDtm": "2026-01-01T00:00:00.000Z",
"itmNo": "001",
"bsketNo": 100000001,
"chlNo": "1",
"chlDtlNo": "1",
"infDispCtgNoGbCd": "01",
"infDispCtgNo": "1",
"repDispCtgNo": "1",
"conrNo": "1",
"bsketQty": 1,
"goodsNm": "상품명",
"stdCtgNo": "1",
"goodsCompCd": "10",
"goodsTypCd": "10",
"saleMethCd": "10",
"brandNo": "1",
"brandNm": "브랜드명",
"buyrAgeLmtCd": "0",
"dispYn": "Y",
"saleStatCd": "10",
"saleStrDtm": "2026-01-01T00:00:00.000Z",
"saleEndDtm": "2026-01-01T00:00:00.000Z",
"buyTypCd": "10",
"taxGbCd": "10",
"stkMgrYn": "Y",
"buyQtyLmtYn": "Y",
"minLmtQty": 1,
"maxLmtQty": 10,
"safeStkNotiYn": "Y",
"deliGoodsGbCd": "01",
"deliWayCd": "01",
"deliPsbRgnCd": "01",
"deliDday": 1,
"bpckPsbYn": "Y",
"rtnPsbYn": "Y",
"exchPsbYn": "Y",
"supPcost": 10000,
"norPrc": 20000,
"preSalePrc": 20000,
"mrgnRate": 4,
"payMeanInfo": "11,12,32",
"itmNm": "아이템명1>아이템명2>아이템명3",
"stkQty": 999,
"prestNm": "증정품명",
"rsvStrtDtm": "2026-01-01T00:00:00.000Z",
"rsvEndDtm": "2026-01-01T00:00:00.000Z",
"fwdidcPrarDy": "2026-01-01",
"hsCd": "1",
"wishYn": "Y",
"maxDcAmt": 1000,
"goodsImg": "files/goods/2023/07/04/img",
"itmSaleStatCd": "10",
"gvgfPsbYn": "Y",
"rglrDeliGoodsYn": "Y",
"sngGoodsYn": "Y",
"marketingDisplayNo": "1",
"entrGoodsNo": "100042110583831",
"entrItmNo": "100042110583831001",
"ordCnclPsbYn": "N",
"wthdYn": "N",
"frgnDirPurGoodsYn": "text"
}
],
"dlvAmtInfoList": [
{
"ordCostGbCd": "10",
"dlexTypCd": "10",
"stdAdtnAmt": 20000,
"dlexAmt": 3500,
"aplyAdtnAmt": 20000,
"trdTypCd": "text",
"entrNo": "1000211",
"deliPolcNo": "10000431",
"dlvBenefitInfo": {
"promoNo": "C1000000",
"promoNm": "프로모션 명",
"promoTypCd": "11",
"ourChrgRate": 100,
"entrChrgRate": 0,
"cpnIsuNo": "100000",
"ordCostGbCd": "10"
}
}
]
}
]
}
],
"ordBnfInfo": {
"promoNo": "C1000000",
"promoNm": "프로모션 명",
"promoTypCd": "11",
"ourChrgRate": 100,
"entrChrgRate": 0,
"fixamtFxrtGbCd": "01",
"dcRateAmt": 5000,
"minBuyAmt": 1000,
"maxDcAmt": 5000,
"isMaxYn": "Y",
"dcAmt": 5000,
"cpnIsuNo": "100000",
"goods": [
{
"goodsNo": "10000001",
"itmNo": "001",
"dcAmt": 5000
}
]
},
"accmInfo": {
"totalAccmAmt": 3000,
"accmList": [
{
"accmGbCd": "21",
"accmRate": 10,
"accmAmt": 3000,
"promoNo": "C1000000",
"promoNm": "프로모션 명",
"promoTypCd": "40",
"ourChrgRate": 100,
"entrChrgRate": 0,
"fixamtFxrtGbCd": "01",
"rsrvStdAmt": 5000,
"goodsAccmList": [
{
"goodsNo": "10000001",
"itmNo": "001",
"accmAmt": 3000
}
]
}
]
},
"paymentRequest": {
"siteNo": "1",
"orderInfo": {
"ordNo": "20990101O000001",
"claimNo": "20990101C000001",
"goodsNm": "플래티어커피",
"ordManNm": "김플래티어",
"ordmnCellNo": "01012345678",
"ordmnEmailAddr": "kim@plateer.com",
"crcUnitCd": "KRW",
"ordMediaCd": "30",
"mbrNo": "100000001",
"ordDtlGbCd": "10",
"clientIp": "127.0.0.1",
"taxFreeAmt": 1
},
"payInfoList": [
{
"payNo": "1",
"payWayCd": "11",
"payAmt": 1000,
"mersNo": "1",
"pgGbCd": "10",
"trdNo": "INIMX_DBNKINIpayTest20990101090000685510",
"selectCardCd": "01",
"termlId": "INIBillTst",
"billKey": "text",
"authResultMap": "{P_STATUS:결과코드, P_RMESG1:결과메시지, P_TID:인증거래번호, P_AMT:거래금액, idc_name:IDC센터코드P_REQ_URL:승인요청 URL, P_NOTI:가맹점 임의 데이터}"
}
]
},
"proofDocInfo": {
"ordNo": "text",
"mbrNo": "text",
"ordManNm": "홍길동",
"proofType": "text",
"payWayCd": "11",
"orderTaxInvoiceRequest": {
"entrNo": "text",
"goodsNm": "text",
"goodsCount": 1,
"payAmt": 1,
"bmanNo": "text",
"bmanNm": "text",
"rpstmnNm": "text",
"zipNo": "text",
"zipAddr": "text",
"dtlAddr": "text",
"aempNm": "text",
"aempTelRgnNo": "text",
"aempTelTxnoNo": "text",
"aempTelEndNo": "text",
"aempEmailId": "text",
"aempEmailDomain": "text",
"aempEmail": "text",
"validYn": "text"
},
"orderCashReceiptRequest": {
"prsntPurpsCd": "text",
"idefNo": "text",
"prchsrNm": "text",
"prchsrEmail": "text",
"prchsrCell": "text",
"smsTrnsYn": "text",
"faxTrnsYn": "text",
"valiYn": "text"
}
}
}No content
마지막 업데이트