상담원 주문

주문하기

post

기능 설명

• 주문을 생성하는 API 입니다.

---

상세 설명

• 결제 승인을 하고 주문을 생성합니다. 주문이 성공하면 주문자에게 주문완료 알림톡과 메일을 발송합니다.

---

수정번호

• Release v2.00_240729: 주문상품구분 컬럼 추가

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

주문하기 Request

Responses

200

주문 성공

900

업무처리 오류 내용

application/json

post

/v1/order/counselorOrder/order

HTTPcURLJavaScriptPython

POST /api/bo/v1/order/counselorOrder/order HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 6089

{
  "ordBaseInfo": {
    "ordNo": "20230810O008148",
    "siteNo": 1,
    "ordMediaCd": 20,
    "ordGbCd": 10,
    "rfdBankCd": 104,
    "rfdActnNo": "000000000000",
    "rcdActnDepositorNm": "홍길동",
    "rglrDeliNo": 1,
    "chlNo": 1,
    "chlDtlNo": 1,
    "ordererInfo": {
      "mbrNo": "text",
      "ordManNm": "홍길동",
      "umemPwd": "password123!",
      "ordManEmailAddr": "[email protected]",
      "cellSctNo": "010",
      "cellTxnoNo": "0000",
      "cellEndNo": "0000",
      "telRgnNo": "02",
      "telTxnoNo": 554,
      "telEndNo": 4583,
      "ordLmtYn": "N",
      "brth": 19961212,
      "adlCertiYn": "Y",
      "comGbCd": "P00",
      "stafYn": "Y"
    },
    "giftCard": {
      "prstTypCd": 10,
      "prstMsg": "생일 축하해요."
    },
    "ordGoodsGb": "text"
  },
  "ordGoodsInfoList": [
    {
      "basketGoods": {
        "goodsNo": 100000001,
        "deliProcTypCd": 10,
        "deliPolcNo": 1,
        "deliNo": 100000021,
        "entrNo": 1000001,
        "ordQty": 1,
        "salePrc": 15000,
        "dcAmt": 3000,
        "sysModDtm": "2029-01-01 00:00:00",
        "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": "2021-01-01 00:00:00",
        "saleEndDtm": "2021-01-01 00:00:00",
        "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": "2021-01-01 00:00:00",
        "rsvEndDtm": "2021-01-01 00:00:00",
        "fwdidcPrarDy": 20210101,
        "hsCd": 1,
        "wishYn": "Y",
        "maxDcAmt": 1000,
        "goodsImg": "files/goods/2023/07/04/img",
        "itmSaleStatCd": 10,
        "gvgfPsbYn": "Y",
        "rglrDeliGoodsYn": "Y",
        "marketingDisplayNo": 1000000
      },
      "aplyGoodsBnfInfo": {
        "goodsNo": 10000001,
        "itmNo": "001",
        "dcAmt": 5000,
        "benefitList": [
          {
            "promoNo": "C1000000",
            "promoNm": "프로모션 명",
            "promoTypCd": "text",
            "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": 10,
          "aeStrDtm": "2026-03-11T21:16:19.243Z",
          "aeEndDtm": "2026-03-11T21:16:19.243Z",
          "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": "[email protected]",
      "rcvmnCellSctNo": "010",
      "rcvmnCellTxnoNo": "0000",
      "rcvmnCellEndNo": "0000",
      "rcvmnTelRgnNo": "02",
      "rcvmnTelTxnoNo": 554,
      "rcvmnTelEndNo": 4583,
      "shopTrafMsg": "포장 안 해주셔도 돼요.",
      "deliMsgCd": 40,
      "deliMsg": "벨X, 노크X",
      "comnFrdrCogoMethodCd": 20,
      "comnFrdrEtcMethod": "뒷문 있어요.",
      "comnFrdrPwd": 123456,
      "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": "2029-01-01 00:00:00",
              "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": "2021-01-01 00:00:00",
              "saleEndDtm": "2021-01-01 00:00:00",
              "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": "2021-01-01 00:00:00",
              "rsvEndDtm": "2021-01-01 00:00:00",
              "fwdidcPrarDy": 20210101,
              "hsCd": 1,
              "wishYn": "Y",
              "maxDcAmt": 1000,
              "goodsImg": "files/goods/2023/07/04/img",
              "itmSaleStatCd": 10,
              "gvgfPsbYn": "Y",
              "rglrDeliGoodsYn": "Y",
              "marketingDisplayNo": 1000000
            }
          ],
          "dlvAmtInfoList": [
            {
              "ordCostGbCd": "text",
              "dlexTypCd": "text",
              "stdAdtnAmt": 1,
              "dlexAmt": 1,
              "aplyAdtnAmt": 1,
              "trdTypCd": "text",
              "entrNo": "text",
              "deliPolcNo": "text",
              "dlvBenefitInfo": {
                "promoNo": "text",
                "promoNm": "text",
                "promoTypCd": "text",
                "ourChrgRate": 1,
                "entrChrgRate": 1,
                "cpnIsuNo": "text"
              }
            }
          ]
        }
      ]
    }
  ],
  "ordBnfInfo": {
    "promoNo": "C1000000",
    "promoNm": "프로모션 명",
    "promoTypCd": "text",
    "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": 29,
        "accmRate": 10,
        "accmAmt": 3000,
        "promoNo": "C1000000",
        "promoNm": "프로모션 명",
        "promoTypCd": "40",
        "ourChrgRate": 100,
        "entrChrgRate": 0,
        "fixamtFxrtGbCd": "01",
        "rsrvStdAmt": 5000,
        "goodsAccmList": [
          {
            "goodsNo": "text",
            "itmNo": "text",
            "accmAmt": 1
          }
        ]
      }
    ]
  },
  "paymentRequest": {
    "orderInfo": {
      "ordNo": "20990101O000001",
      "claimNo": "20990101C000001",
      "goodsNm": "플래티어커피",
      "ordManNm": "김플래티어",
      "ordmnCellNo": "01012345678",
      "ordmnEmailAddr": "[email protected]",
      "crcUnitCd": "KRW",
      "ordMediaCd": 30,
      "mbrNo": 100000001,
      "ordDtlGbCd": 10,
      "clientIp": "127.0.0.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:가맹점 임의 데이터}"
      }
    ]
  }
}

No content

상담원 주문서 할인 혜택 정보 조회

post

기능 설명

• 상담원 주문 시 주문 정보에 맞는 할인 혜택 정보를 조회합니다.

---

상세 설명

• 상담원 주문 시 배송비 정보를 확인 완료하면 해당 주문 정보에 맞는 할인 혜택 정보를 조회합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

goodsNostringOptional

itmNostringOptional

supPcostnumberOptional

norPrcnumberOptional

salePrcnumberOptional

purchaseAmtnumberOptional

stdCtgNostringOptional

dispCtgNostringOptional

brandNostringOptional

entrNostringOptional

chlNostringOptional

dcAmtnumberOptional

cntinteger · int32Optional

mrgnRatenumberOptional

marketingDisplayNostringOptional

siteNostringOptional

사이트번호

Example: 1

mbrNostringOptional

회원번호

Example: 100000300

mbrGradeCdstring · enumRequired

회원등급코드

Example: 10Possible values:

stafYnstringRequired

임직원여부

Example: Y

cpnPopupGbCdstring · enumOptional

쿠폰팝업호출구분코드

Example: 10Possible values:

ordMediaCdstring · enumOptional

주문매체코드(OM007)

Example: 20Possible values:

ordTypeGbCdstring · enumRequired

주문유형구분코드

Example: 10Possible values:

Responses

200

성공

*/*

900

업무처리 오류 내용

*/*

post

/v1/order/counselorOrder/getOrderPromotionInfo

HTTPcURLJavaScriptPython

POST /api/bo/v1/order/counselorOrder/getOrderPromotionInfo HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 817

{
  "goodsNo": "text",
  "itmNo": "text",
  "supPcost": 1,
  "norPrc": 1,
  "salePrc": 1,
  "purchaseAmt": 1,
  "stdCtgNo": "text",
  "dispCtgNo": "text",
  "brandNo": "text",
  "entrNo": "text",
  "chlNo": "text",
  "dcAmt": 1,
  "cnt": 1,
  "mrgnRate": 1,
  "marketingDisplayNo": "text",
  "siteNo": 1,
  "mbrNo": 100000300,
  "mbrGradeCd": 10,
  "stafYn": "Y",
  "cpnPopupGbCd": 10,
  "ordMediaCd": 20,
  "ordTypeGbCd": 10,
  "goodsList": [
    {
      "goodsNo": "text",
      "itmNo": "text",
      "supPcost": 1,
      "norPrc": 1,
      "salePrc": 1,
      "purchaseAmt": 1,
      "stdCtgNo": "text",
      "dispCtgNo": "text",
      "brandNo": "text",
      "entrNo": "text",
      "chlNo": "text",
      "dcAmt": 1,
      "cnt": 1,
      "mrgnRate": 1,
      "marketingDisplayNo": "text",
      "goodsNm": "상품명 예시",
      "brandNm": "브랜드명 예시"
    }
  ],
  "dlvGrpList": [
    {
      "deliNo": 100000001,
      "entrNo": 1000000,
      "benefitInfo": {
        "promoNo": "text",
        "promoNm": "text",
        "promoTypCd": "text",
        "ourChrgRate": 1,
        "entrChrgRate": 1,
        "cpnIsuNo": "text"
      }
    }
  ]
}

{
  "executivesDiscountInfo": {
    "totalDcAmt": 1,
    "goodsList": [
      {
        "goodsNo": 10000001,
        "goodsNm": "상품 명",
        "brandNm": "브랜드 명",
        "itmNo": "001",
        "dcAmt": 5000,
        "bnfInfo": {
          "promoNo": "C1000000",
          "promoNm": "프로모션 명",
          "promoTypCd": "text",
          "ourChrgRate": 100,
          "entrChrgRate": 0,
          "fixamtFxrtGbCd": "01",
          "dcRateAmt": 5000,
          "minBuyAmt": 1000,
          "maxDcAmt": 5000,
          "isMaxYn": "Y",
          "dcAmt": 5000,
          "dcAmtPerCnt": 2500,
          "cpnIsuNo": 100000
        }
      }
    ]
  },
  "goodsDirectDiscountInfo": {
    "totalDcAmt": 1,
    "goodsList": [
      {
        "goodsNo": 10000001,
        "goodsNm": "상품 명",
        "brandNm": "브랜드 명",
        "itmNo": "001",
        "dcAmt": 5000,
        "bnfInfo": {
          "promoNo": "C1000000",
          "promoNm": "프로모션 명",
          "promoTypCd": "text",
          "ourChrgRate": 100,
          "entrChrgRate": 0,
          "fixamtFxrtGbCd": "01",
          "dcRateAmt": 5000,
          "minBuyAmt": 1000,
          "maxDcAmt": 5000,
          "isMaxYn": "Y",
          "dcAmt": 5000,
          "dcAmtPerCnt": 2500,
          "cpnIsuNo": 100000
        }
      }
    ]
  },
  "goodsBenefitInfo": [
    {
      "goodsNo": 10000001,
      "itmNo": "001",
      "promoNoList": []
    }
  ],
  "basketCouponBenefitinfo": [
    {
      "promoNo": "C1000000",
      "goodsList": [
        {
          "goodsNo": 10000001,
          "itmNo": "001"
        }
      ]
    }
  ],
  "promoList": [
    {
      "promoNo": "C1000000",
      "promoNm": "프로모션 명",
      "promoTypCd": "text",
      "ourChrgRate": 100,
      "entrChrgRate": 0,
      "fixamtFxrtGbCd": "01",
      "dcRateAmt": 5000,
      "minBuyAmt": 1000,
      "maxDcAmt": 5000,
      "couponIssuedInfo": [
        {
          "cpnIsuNo": 100000000,
          "mbrNo": 100000000,
          "cpnNo": "C1000000",
          "cpnIsuDtm": "2026-03-11T21:16:19.243Z",
          "valiStrtDtm": "2026-03-11T21:16:19.243Z",
          "valiEndDtm": "2026-03-11T21:16:19.243Z",
          "useYn": "N"
        }
      ],
      "goodsNo": 10000001,
      "itmNo": "001",
      "baseAmt": 1
    }
  ],
  "dlvCouponInfo": {
    "dlvCpnCnt": 1,
    "dlvGrpInfo": [
      {
        "deliNo": 100000001,
        "entrNo": 1000000,
        "benefitInfo": {
          "promoNo": "text",
          "promoNm": "text",
          "promoTypCd": "text",
          "ourChrgRate": 1,
          "entrChrgRate": 1,
          "cpnIsuNo": "text"
        }
      }
    ]
  },
  "maxBenefitInfo": {
    "totalDcAmt": 10000,
    "goodsBenefitList": [
      {
        "goodsNo": 10000001,
        "itmNo": "001",
        "dcAmt": 5000,
        "benefitList": [
          {
            "promoNo": "C1000000",
            "promoNm": "프로모션 명",
            "promoTypCd": "text",
            "ourChrgRate": 100,
            "entrChrgRate": 0,
            "fixamtFxrtGbCd": "01",
            "dcRateAmt": 5000,
            "minBuyAmt": 1000,
            "maxDcAmt": 5000,
            "isMaxYn": "Y",
            "dcAmt": 5000,
            "dcAmtPerCnt": 2500,
            "cpnIsuNo": 100000
          }
        ]
      }
    ],
    "orderBenefitList": [
      {
        "promoNo": "C1000000",
        "promoNm": "프로모션 명",
        "promoTypCd": "text",
        "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
          }
        ]
      }
    ]
  }
}

주문상품 단품 옵션 조회

post

기능 설명

• 주문서 화면의 상품 상세 팝업에서 상품 선택 시 단품 옵션을 조회합니다.

---

상세 설명

• 주문서 화면의 상품 상세 팝업에서 상품 선택 시 해당 상품의 상품번호를 이용하여 단품 옵션을 조회합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Bodyobject[]

application/json

상품상세 조회관련 조건 DTO

siteNostringOptional

사이트번호

Default: 1

dispYnstring · enumOptional

전시여부

Default: YPossible values:

goodsNostring · min: 1Required

상품번호

Example: 10001921

schKwdNmstringOptional

검색어

Example: 검색어1,검색어2

stdCtgNostringOptional

표준카테고리

brandNostringOptional

브랜드번호

lgcGoodsNostring[]Optional

판매자 상품번호

itmNostring[]Optional

단품번호

stkQtyinteger · int64Optional

단품재고수량

saleStatCdstringOptional

판매상태코드(PR005)

Default: 10

entrNostringOptional

협력사번호

infDispCtgNoGbCdstringOptional

카테고리유입번호

infDispCtgNostringOptional

유입카테고리번호

mbrNostringOptional

회원번호

callTypestring · enumOptional

호출유형

Default: ALLPossible values:

chlNostringOptional

채널번호

optionItmNostringOptional

단품번호

previewDatestring · dateOptional

미리보기날짜

Example: 2023-08-28

previewLangCdstringOptional

미리보기 언어코드(CM009)

Default: koExample: ko

Responses

200

성공

*/*

900

업무처리 오류 내용

*/*

post

/v1/order/counselorOrder/getItmInfo

HTTPcURLJavaScriptPython

POST /api/bo/v1/order/counselorOrder/getItmInfo HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 366

[
  {
    "siteNo": "1",
    "dispYn": "Y",
    "goodsNo": 10001921,
    "schKwdNm": "검색어1,검색어2",
    "stdCtgNo": "text",
    "brandNo": "text",
    "lgcGoodsNo": [
      "text"
    ],
    "itmNo": [
      "text"
    ],
    "stkQty": 1,
    "saleStatCd": "10",
    "entrNo": "text",
    "infDispCtgNoGbCd": "text",
    "infDispCtgNo": "text",
    "mbrNo": "text",
    "callType": "ALL",
    "chlNo": "text",
    "optionItmNo": "text",
    "previewDate": "2023-08-28",
    "previewLangCd": "ko"
  }
]

[
  {
    "goodsNo": "text",
    "goodsNm": "text",
    "modlNm": "text",
    "homeNm": "text",
    "mfcoNm": "text",
    "incomNm": "text",
    "salemnNm": "text",
    "manufYm": "text",
    "schKwdNm": "text",
    "lgcGoodsNo": "text",
    "entrNo": "text",
    "stdCtgNo": "text",
    "goodsCompCd": "text",
    "goodsTypCd": "text",
    "saleMethCd": "text",
    "brandNo": "text",
    "safeCertiTgtYn": "text",
    "buyrAgeLmtCd": "text",
    "dispYn": "text",
    "saleStatCd": "text",
    "aprvReqDt": "text",
    "saleStatChgCausCd": "text",
    "soutCausCd": "text",
    "goodsRegDtm": "2026-03-11T21:16:19.243Z",
    "saleStrDtm": "2026-03-11T21:16:19.243Z",
    "saleEndDtm": "2026-03-11T21:16:19.243Z",
    "buyTypCd": "text",
    "taxGbCd": "text",
    "stkMgrYn": "text",
    "buyQtyLmtYn": "text",
    "minLmtQty": 1,
    "maxLmtQty": 1,
    "deliProcTypCd": "text",
    "deliGoodsGbCd": "text",
    "deliWayCd": "text",
    "deliDday": 1,
    "itmSoutNotiYn": "text",
    "deliPolcNo": "text",
    "deliPsbRgnCd": "text",
    "rtnPsbYn": "text",
    "exchPsbYn": "text",
    "prcCompaExpYn": "text",
    "pkgGoodsPrioRnkCd": "text",
    "bpckPsbYn": "text",
    "hsCd": "text",
    "safeStkNotiYn": "text",
    "rglrDeliGoodsYn": "text",
    "regInfPathCd": "text",
    "aprvDt": "text",
    "retnCausCd": "text",
    "retnCausCdNm": "text",
    "retnCaus": "text",
    "retnDt": "text",
    "schPsbYn": "text",
    "optnYn": "text",
    "optnCDYn": "text",
    "goodsNoArray": [
      "text"
    ],
    "szGdeUseYn": "text",
    "szGdeRegMethodCd": "text",
    "szGdeCd": "text",
    "szGdeConts": "text",
    "gftWthdYn": "text",
    "milgRsrvPsbYn": "text",
    "gvgfPsbYn": "text",
    "frgnDirPurGoodsYn": "text",
    "entrGoodsNo": "text",
    "ordCnclPsbYn": "text",
    "wthdYn": "text",
    "ecpnAplyTermGbCd": "text",
    "ecpnIssuDdStdUseDds": 1,
    "ecpnUsePsbStrDt": "2026-03-11",
    "ecpnUsePsbEndDt": "2026-03-11",
    "itmInfo": [
      {
        "goodsNo": "text",
        "itmNo": "text",
        "itmNm": "text",
        "stkQty": "text",
        "itmSaleStatCd": "text",
        "salePrc": 1,
        "supPrc": 1,
        "norPrc": 1
      }
    ],
    "fwdidcPrarDy": "text",
    "dispGoodsInfoList": [
      {
        "siteNo": 1,
        "siteNm": "플래티어닷컴",
        "dpmlNo": 10001,
        "dpmlNm": "통합몰",
        "dispCtgNo": 242,
        "dispCtgNm": "잡화>주얼리"
      }
    ]
  }
]

주문상품 상세 조회

post

기능 설명

• 주문서 화면의 상품선택 단계 완료 시 상품의 상세 정보를 조회합니다.

---

상세 설명

• 주문서 화면의 상품선택 단계 완료 시 해당 상품의 단품 정보를 이용하여 상품의 상세 정보를 조회합니다.

---

수정번호

• Release v2.00_240703: 상품 API 변경에 따른 request, response 객체 타입 수정

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Bodyobject[]

application/json

상품상세 조회관련 조건 DTO

siteNostringOptional

사이트번호

Default: 1

dispYnstring · enumOptional

전시여부

Default: YPossible values:

goodsNostring · min: 1Required

상품번호

Example: 10001921

schKwdNmstringOptional

검색어

Example: 검색어1,검색어2

stdCtgNostringOptional

표준카테고리

brandNostringOptional

브랜드번호

lgcGoodsNostring[]Optional

판매자 상품번호

itmNostring[]Optional

단품번호

stkQtyinteger · int64Optional

단품재고수량

saleStatCdstringOptional

판매상태코드(PR005)

Default: 10

entrNostringOptional

협력사번호

infDispCtgNoGbCdstringOptional

카테고리유입번호

infDispCtgNostringOptional

유입카테고리번호

mbrNostringOptional

회원번호

callTypestring · enumOptional

호출유형

Default: ALLPossible values:

chlNostringOptional

채널번호

optionItmNostringOptional

단품번호

previewDatestring · dateOptional

미리보기날짜

Example: 2023-08-28

previewLangCdstringOptional

미리보기 언어코드(CM009)

Default: koExample: ko

Responses

200

성공

*/*

900

업무처리 오류 내용

*/*

post

/v1/order/counselorOrder/getGoodsDetailInfo

HTTPcURLJavaScriptPython

POST /api/bo/v1/order/counselorOrder/getGoodsDetailInfo HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 366

[
  {
    "siteNo": "1",
    "dispYn": "Y",
    "goodsNo": 10001921,
    "schKwdNm": "검색어1,검색어2",
    "stdCtgNo": "text",
    "brandNo": "text",
    "lgcGoodsNo": [
      "text"
    ],
    "itmNo": [
      "text"
    ],
    "stkQty": 1,
    "saleStatCd": "10",
    "entrNo": "text",
    "infDispCtgNoGbCd": "text",
    "infDispCtgNo": "text",
    "mbrNo": "text",
    "callType": "ALL",
    "chlNo": "text",
    "optionItmNo": "text",
    "previewDate": "2023-08-28",
    "previewLangCd": "ko"
  }
]

[
  {
    "goodsNo": "text",
    "goodsNm": "text",
    "entrNo": "text",
    "stdCtgNo": "text",
    "goodsCompCd": "text",
    "goodsCompCdNm": "text",
    "goodsTypCd": "text",
    "goodsTypCdNm": "text",
    "saleMethCd": "text",
    "saleMethCdNm": "text",
    "brandNo": "text",
    "brandNm": "text",
    "buyrAgeLmtCd": "text",
    "dispYn": "text",
    "saleStatCd": "text",
    "saleStatCdNm": "text",
    "saleStrDtm": "2026-03-11T21:16:19.243Z",
    "saleEndDtm": "2026-03-11T21:16:19.243Z",
    "buyTypCd": "text",
    "taxGbCd": "text",
    "stkMgrYn": "text",
    "buyQtyLmtYn": "text",
    "minLmtQty": "text",
    "maxLmtQty": "text",
    "safeStkNotiYn": "text",
    "deliGoodsGbCd": "text",
    "deliWayCd": "text",
    "deliPsbRgnCd": "text",
    "deliDday": "text",
    "deliPolcNo": "text",
    "bpckPsbYn": "text",
    "rtnPsbYn": "text",
    "exchPsbYn": "text",
    "supPcost": 1,
    "norPrc": 1,
    "preSalePrc": 1,
    "salePrc": 1,
    "mrgnRate": 1,
    "payMeanInfo": "text",
    "itmNo": "text",
    "itmNm": "text",
    "stkQty": 1,
    "itmSaleStatCd": "text",
    "prestNm": "text",
    "rsvStrtDtm": "2026-03-11T21:16:19.243Z",
    "rsvEndDtm": "2026-03-11T21:16:19.243Z",
    "fwdidcPrarDy": "text",
    "deliProcTypCd": "text",
    "gvgfPsbYn": "text",
    "milgRsrvPsbYn": "text",
    "ordCnclPsbYn": "text",
    "wthdYn": "text",
    "tsupPrc": 1,
    "tsalePrc": 1
  }
]

주문서 배송비 조회

post

기능 설명

• 주문서 화면에서 사용자의 주문 배송지 정보 선택 시 배송비를 조회합니다.

---

상세 설명

• 주문서 화면에서 사용자의 주문 배송지 정보 선택 시 배송비를 조회합니다.

• 변경된 배송지가 도서산간 지역일 경우 추가 배송비가 부과될 수 있습니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

배송비 조회 Request DTO

deliMethodCdstring · min: 1Required

배송방법코드(LO010)

Example: 10

allClaimbooleanOptional

전체클레임 여부

Responses

200

성공

*/*

900

업무처리 오류 내용

*/*

post

/v1/order/counselorOrder/getDeliveryAmountInfo

HTTPcURLJavaScriptPython

POST /api/bo/v1/order/counselorOrder/getDeliveryAmountInfo HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1907

{
  "deliMethodCd": 10,
  "dlvpInfo": {
    "dlvpSeq": 1,
    "dlvpNm": "플래티어",
    "mbrDlvpSeq": 1,
    "baseDlvpYn": "Y",
    "zipNoSeq": 1,
    "zipNo": "05836",
    "zipAddr": "서울 송파구 법원로9길 26",
    "dtlAddr": "101동",
    "emailAddr": "[email protected]",
    "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
      }
    ]
  },
  "goodsList": [
    {
      "goodsNo": 100000001,
      "deliProcTypCd": 10,
      "deliPolcNo": 1,
      "deliNo": 100000021,
      "entrNo": 1000001,
      "ordQty": 1,
      "salePrc": 15000,
      "dcAmt": 3000,
      "sysModDtm": "2029-01-01 00:00:00",
      "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": "2021-01-01 00:00:00",
      "saleEndDtm": "2021-01-01 00:00:00",
      "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": "2021-01-01 00:00:00",
      "rsvEndDtm": "2021-01-01 00:00:00",
      "fwdidcPrarDy": 20210101,
      "hsCd": 1,
      "wishYn": "Y",
      "maxDcAmt": 1000,
      "goodsImg": "files/goods/2023/07/04/img",
      "itmSaleStatCd": 10,
      "gvgfPsbYn": "Y",
      "rglrDeliGoodsYn": "Y",
      "marketingDisplayNo": 1000000
    }
  ],
  "allClaim": true
}

[
  {
    "dlvpSeq": 1,
    "mbrDlvpSeq": 1,
    "baseDlvpYn": "Y",
    "dlvpNm": "우리집",
    "zipNo": "05837",
    "zipAddr": "서울 송파구 법원로9길",
    "dtlAddr": "에이치비지니스파크 D동 6층",
    "rcvmnNm": "홍길동",
    "rcvmnEmailAddr": "[email protected]",
    "rcvmnCellSctNo": "010",
    "rcvmnCellTxnoNo": "0000",
    "rcvmnCellEndNo": "0000",
    "rcvmnTelRgnNo": "02",
    "rcvmnTelTxnoNo": 554,
    "rcvmnTelEndNo": 4583,
    "shopTrafMsg": "포장 안 해주셔도 돼요.",
    "deliMsgCd": 40,
    "deliMsg": "벨X, 노크X",
    "comnFrdrCogoMethodCd": 20,
    "comnFrdrEtcMethod": "뒷문 있어요.",
    "comnFrdrPwd": 123456,
    "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": "2029-01-01 00:00:00",
            "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": "2021-01-01 00:00:00",
            "saleEndDtm": "2021-01-01 00:00:00",
            "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": "2021-01-01 00:00:00",
            "rsvEndDtm": "2021-01-01 00:00:00",
            "fwdidcPrarDy": 20210101,
            "hsCd": 1,
            "wishYn": "Y",
            "maxDcAmt": 1000,
            "goodsImg": "files/goods/2023/07/04/img",
            "itmSaleStatCd": 10,
            "gvgfPsbYn": "Y",
            "rglrDeliGoodsYn": "Y",
            "marketingDisplayNo": 1000000
          }
        ],
        "dlvAmtInfoList": [
          {
            "ordCostGbCd": "text",
            "dlexTypCd": "text",
            "stdAdtnAmt": 1,
            "dlexAmt": 1,
            "aplyAdtnAmt": 1,
            "trdTypCd": "text",
            "entrNo": "text",
            "deliPolcNo": "text",
            "dlvBenefitInfo": {
              "promoNo": "text",
              "promoNm": "text",
              "promoTypCd": "text",
              "ourChrgRate": 1,
              "entrChrgRate": 1,
              "cpnIsuNo": "text"
            }
          }
        ]
      }
    ]
  }
]

주문서 사은행사 조회

post

기능 설명

• 주문한 상품에 진행 중인 사은행사가 존재하는 지 조회합니다.

---

상세 설명

• 주문서 진입 시 주문한 상품에 진행 중인 사은행사가 존재하는 지 조회합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

BO 상담원 주문서 사은행사 조회 Request DTO

mbrNostringOptional

회원번호

mbrGradeCdstring · enumOptional

회원등급코드 (ME008)

Example: 10Possible values:

siteNostringOptional

사이트번호

Example: 1

ordMediaCdstring · enumOptional

주문매체코드(OM007)

Example: 30Possible values:

Responses

200

성공

*/*

900

업무처리 오류 내용

*/*

post

/v1/order/counselorOrder/getAeEvtList

HTTPcURLJavaScriptPython

POST /api/bo/v1/order/counselorOrder/getAeEvtList HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 2110

{
  "mbrNo": "text",
  "mbrGradeCd": 10,
  "siteNo": 1,
  "ordGoodsInfoList": [
    {
      "basketGoods": {
        "goodsNo": 100000001,
        "deliProcTypCd": 10,
        "deliPolcNo": 1,
        "deliNo": 100000021,
        "entrNo": 1000001,
        "ordQty": 1,
        "salePrc": 15000,
        "dcAmt": 3000,
        "sysModDtm": "2029-01-01 00:00:00",
        "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": "2021-01-01 00:00:00",
        "saleEndDtm": "2021-01-01 00:00:00",
        "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": "2021-01-01 00:00:00",
        "rsvEndDtm": "2021-01-01 00:00:00",
        "fwdidcPrarDy": 20210101,
        "hsCd": 1,
        "wishYn": "Y",
        "maxDcAmt": 1000,
        "goodsImg": "files/goods/2023/07/04/img",
        "itmSaleStatCd": 10,
        "gvgfPsbYn": "Y",
        "rglrDeliGoodsYn": "Y",
        "marketingDisplayNo": 1000000
      },
      "aplyGoodsBnfInfo": {
        "goodsNo": 10000001,
        "itmNo": "001",
        "dcAmt": 5000,
        "benefitList": [
          {
            "promoNo": "C1000000",
            "promoNm": "프로모션 명",
            "promoTypCd": "text",
            "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": 10,
          "aeStrDtm": "2026-03-11T21:16:19.243Z",
          "aeEndDtm": "2026-03-11T21:16:19.243Z",
          "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": 30
}

[
  {
    "goodsNo": 10000001,
    "itmNo": "001",
    "aeNo": "C1000000",
    "addEvtTypCd": 10,
    "aeStrDtm": "2026-03-11T21:16:19.243Z",
    "aeEndDtm": "2026-03-11T21:16:19.243Z",
    "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"
      }
    ]
  }
]

주문서 적립정보 조회

post

기능 설명

• 회원의 주문 정보에 맞는 적립 정보를 조회합니다.

---

상세 설명

• 배송비 정보 확인 완료 시 해당 주문 정보에 맞는 적립 정보를 조회합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

적립조회 Request

mbrNostringRequired

회원번호

Example: 100000000

mbrGradeCdstringRequired

회원등급코드

ordMediaCdstringRequired

주문매체코드(OM007)

baseDtmstring · date-timeRequired

기준일시

Responses

200

성공

*/*

900

업무처리 오류 내용

*/*

post

/v1/order/counselorOrder/getAccumulationInfo

HTTPcURLJavaScriptPython

POST /api/bo/v1/order/counselorOrder/getAccumulationInfo HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 2814

{
  "mbrNo": 100000000,
  "mbrGradeCd": "text",
  "ordMediaCd": "text",
  "baseDtm": "2026-03-11T21:16:19.243Z",
  "goodsList": [
    {
      "goodsNo": 10000001,
      "itmNo": "001",
      "purchaseAmt": 6000,
      "stdCtgNo": "EX00000000",
      "dispCtgNo": "000",
      "brandNo": 100000,
      "entrNo": 1000000,
      "chlNo": 1000000,
      "promoNo": "C1000000'"
    }
  ],
  "ordAccmList": [
    {
      "accmGbCd": "text",
      "promoNo": "C1000000",
      "promoNm": "프로모션 명",
      "ourChrgRate": 100,
      "entrChrgRate": 0,
      "fixamtFxrtGbCd": "01",
      "rsrvStdAmt": 5000,
      "accmRate": 10
    }
  ],
  "ordGoodsInfoList": [
    {
      "basketGoods": {
        "goodsNo": 100000001,
        "deliProcTypCd": 10,
        "deliPolcNo": 1,
        "deliNo": 100000021,
        "entrNo": 1000001,
        "ordQty": 1,
        "salePrc": 15000,
        "dcAmt": 3000,
        "sysModDtm": "2029-01-01 00:00:00",
        "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": "2021-01-01 00:00:00",
        "saleEndDtm": "2021-01-01 00:00:00",
        "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": "2021-01-01 00:00:00",
        "rsvEndDtm": "2021-01-01 00:00:00",
        "fwdidcPrarDy": 20210101,
        "hsCd": 1,
        "wishYn": "Y",
        "maxDcAmt": 1000,
        "goodsImg": "files/goods/2023/07/04/img",
        "itmSaleStatCd": 10,
        "gvgfPsbYn": "Y",
        "rglrDeliGoodsYn": "Y",
        "marketingDisplayNo": 1000000
      },
      "aplyGoodsBnfInfo": {
        "goodsNo": 10000001,
        "itmNo": "001",
        "dcAmt": 5000,
        "benefitList": [
          {
            "promoNo": "C1000000",
            "promoNm": "프로모션 명",
            "promoTypCd": "text",
            "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": 10,
          "aeStrDtm": "2026-03-11T21:16:19.243Z",
          "aeEndDtm": "2026-03-11T21:16:19.243Z",
          "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": "text",
    "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
      }
    ]
  }
}

{
  "totalAccmAmt": 3000,
  "accmList": [
    {
      "accmGbCd": 29,
      "accmRate": 10,
      "accmAmt": 3000,
      "promoNo": "C1000000",
      "promoNm": "프로모션 명",
      "promoTypCd": "40",
      "ourChrgRate": 100,
      "entrChrgRate": 0,
      "fixamtFxrtGbCd": "01",
      "rsrvStdAmt": 5000,
      "goodsAccmList": [
        {
          "goodsNo": "text",
          "itmNo": "text",
          "accmAmt": 1
        }
      ]
    }
  ]
}

주문번호 채번

get

기능 설명

• 주문번호를 채번합니다.

---

상세 설명

• 주문서에서 결제하기 직전에 호출되어 주문번호를 채번합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

성공

*/*

900

업무처리 오류 내용

*/*

get

/v1/order/counselorOrder/getOrderNo

HTTPcURLJavaScriptPython

GET /api/bo/v1/order/counselorOrder/getOrderNo HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

text

가용 마일리지 조회

get

기능 설명

• 회원의 가용 마일리지를 조회합니다.

---

상세 설명

• 주문서에서 회원 정보 선택 시 해당 회원의 가용 마일리지를 조회합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

mbrNoStringRequired

회원번호

Responses

200

성공

*/*

900

업무처리 오류 내용

*/*

get

/v1/order/counselorOrder/getAvailableMileageAmount

HTTPcURLJavaScriptPython

GET /api/bo/v1/order/counselorOrder/getAvailableMileageAmount?mbrNo=null HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "mlgAvalAmt": 1
}