상담원 주문

주문하기

post

기능 설명

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

---

상세 설명

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

---

수정번호

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

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

주문하기 Request

Responses

200

주문 성공

No content

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": "[e-mail]",
      "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-02-27T18:21:08.687Z",
          "aeEndDtm": "2026-02-27T18:21:08.687Z",
          "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": "[e-mail]",
      "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": "[e-mail]",
      "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-02-27T18:21:08.687Z",
          "valiStrtDtm": "2026-02-27T18:21:08.687Z",
          "valiEndDtm": "2026-02-27T18:21:08.687Z",
          "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

성공

*/*

상품정보조회 DTO

goodsNostringOptional

상품번호

goodsNmstringOptional

상품명

modlNmstringOptional

모델명

homeNmstringOptional

원산지명

mfcoNmstringOptional

제조사명

incomNmstringOptional

수입자명

salemnNmstringOptional

판매자명

manufYmstringOptional

제조년월

schKwdNmstringOptional

검색키워드명

lgcGoodsNostringOptional

자체상품번호

entrNostringOptional

협력사번호

stdCtgNostringOptional

표준카테고리번호

goodsCompCdstringOptional

상품구성코드(PR001)

goodsTypCdstringOptional

상품유형코드(PR002)

saleMethCdstringOptional

판매방식코드(PR003)

brandNostringOptional

브랜드번호

safeCertiTgtYnstringOptional

안전인증대상여부

buyrAgeLmtCdstringOptional

구입자나이제한코드(PR004)

dispYnstringOptional

전시여부

saleStatCdstringOptional

판매상태코드(PR005)

aprvReqDtstringOptional

승인요청일자

saleStatChgCausCdstringOptional

판매상태변경사유코드(PR058)

soutCausCdstringOptional

품절사유코드(PR032)

goodsRegDtmstring · date-timeOptional

상품등록일시

saleStrDtmstring · date-timeOptional

판매시작일시

saleEndDtmstring · date-timeOptional

판매종료일시

buyTypCdstringOptional

매입유형코드(PR006)

taxGbCdstringOptional

과면세구분코드(PR007)

stkMgrYnstringOptional

재고관리여부

buyQtyLmtYnstringOptional

구매수량제한여부

minLmtQtyinteger · int32Optional

최소제한수량

maxLmtQtyinteger · int32Optional

최대제한수량

deliProcTypCdstringOptional

배송처리유형코드(PR008)

deliGoodsGbCdstringOptional

배송상품구분코드(PR010)

deliWayCdstringOptional

배송수단코드(PR009)

deliDdayinteger · int32Optional

배송기일

itmSoutNotiYnstringOptional

단품품절알림여부

deliPolcNostringOptional

배송정책번호

deliPsbRgnCdstringOptional

배송가능지역코드

rtnPsbYnstringOptional

반품가능여부

exchPsbYnstringOptional

교환가능여부

prcCompaExpYnstringOptional

가격비교노출여부

pkgGoodsPrioRnkCdstringOptional

묶음상품우선순위코드(PR035)

bpckPsbYnstringOptional

합포가능여부

hsCdstringOptional

hsCd

safeStkNotiYnstringOptional

안전재고알림여부

rglrDeliGoodsYnstringOptional

정기배송상품여부

regInfPathCdstringOptional

등록유입경로코드(PR029)

aprvDtstringOptional

승인일자

retnCausCdstringOptional

반려사유코드(PR042)

retnCausCdNmstringOptional

반려사유코드명(PR042)

retnCausstringOptional

반려사유

retnDtstringOptional

반려일자

schPsbYnstringOptional

검색가능여부

optnYnstringOptional

옵션관리여부

optnCDYnstringOptional

옵션 추가/삭제 여부

goodsNoArraystring[]Optional

상품번호배열

szGdeUseYnstringOptional

사이즈가이드 사용여부

szGdeRegMethodCdstringOptional

사이즈가이드 등록방법 코드(PR023)

szGdeCdstringOptional

사이즈가이드코드(PR024)

szGdeContsstringOptional

사이즈가이드 내용

gftWthdYnstringOptional

회수 여부

milgRsrvPsbYnstringOptional

마일리지적립가능여부

gvgfPsbYnstringOptional

선물하기가능여부

frgnDirPurGoodsYnstringOptional

해외직구상품여부

entrGoodsNostringOptional

협력사상품번호

ordCnclPsbYnstringOptional

주문취소가능여부

wthdYnstringOptional

회수여부

ecpnAplyTermGbCdstringOptional

e-쿠폰적용기간구분코드(MK015)

ecpnIssuDdStdUseDdsinteger · int32Optional

e-쿠폰발급일기준사용일수

ecpnUsePsbStrDtstring · dateOptional

e-쿠폰사용가능시작일자

ecpnUsePsbEndDtstring · dateOptional

e-쿠폰사용가능종료일자

fwdidcPrarDystringOptional

출고지시예정일자

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-02-27T18:21:08.687Z",
    "saleStrDtm": "2026-02-27T18:21:08.687Z",
    "saleEndDtm": "2026-02-27T18:21:08.687Z",
    "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-02-27",
    "ecpnUsePsbEndDt": "2026-02-27",
    "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

성공

*/*

goodsNostringOptional

상품번호

goodsNmstringOptional

상품명

entrNostringOptional

협력사번호

stdCtgNostringOptional

표준카테고리번호

goodsCompCdstringOptional

상품구성코드(PR001)

goodsCompCdNmstringOptional

상품구성코드명

goodsTypCdstringOptional

상품유형코드(PR002)

goodsTypCdNmstringOptional

상품유형코드명

saleMethCdstringOptional

판매방식코드(PR003)

saleMethCdNmstringOptional

판매방식코드명

brandNostringOptional

브랜드번호

brandNmstringOptional

브랜드명

buyrAgeLmtCdstringOptional

구입자나이제한코드(PR004)

dispYnstringOptional

전시여부

saleStatCdstringOptional

판매상태코드(PR005)

saleStatCdNmstringOptional

판매상태코드명

saleStrDtmstring · date-timeOptional

판매시작일시

saleEndDtmstring · date-timeOptional

판매종료일시

buyTypCdstringOptional

매입유형코드(PR006)

taxGbCdstringOptional

과면세구분코드(PR007)

stkMgrYnstringOptional

재고관리여부

buyQtyLmtYnstringOptional

구매수량제한여부

minLmtQtystringOptional

최소제한수량

maxLmtQtystringOptional

최대제한수량

safeStkNotiYnstringOptional

안전재고알림여부

deliGoodsGbCdstringOptional

배송상품구분코드(PR010)

deliWayCdstringOptional

배송수단코드(PR009)

deliPsbRgnCdstringOptional

배송가능지역코드(PR030)

deliDdaystringOptional

배송기일

deliPolcNostringOptional

배송정책번호

bpckPsbYnstringOptional

합포가능여부

rtnPsbYnstringOptional

반품가능여부

exchPsbYnstringOptional

교환가능여부

supPcostnumberOptional

공급원가

norPrcnumberOptional

정상가

preSalePrcnumberOptional

종전판매가

salePrcnumberOptional

판매가

mrgnRatenumberOptional

마진율

payMeanInfostringOptional

결제수단

itmNostringOptional

단품번호

itmNmstringOptional

단품명

stkQtyinteger · int32Optional

단품수량

itmSaleStatCdstringOptional

판매상태코드(PR005)

prestNmstringOptional

증정품명

rsvStrtDtmstring · date-timeOptional

예약시작일시

rsvEndDtmstring · date-timeOptional

예약종료일시

fwdidcPrarDystringOptional

출고지시예정일자

deliProcTypCdstringOptional

배송처리유형코드(PR008)

gvgfPsbYnstringOptional

선물하기가능여부

milgRsrvPsbYnstringOptional

마일리지적립가능여부

ordCnclPsbYnstringOptional

주문취소가능여부

wthdYnstringOptional

회수여부

tsupPrcnumberOptional

tsalePrcnumberOptional

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-02-27T18:21:08.687Z",
    "saleEndDtm": "2026-02-27T18:21:08.687Z",
    "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-02-27T18:21:08.687Z",
    "rsvEndDtm": "2026-02-27T18:21:08.687Z",
    "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

성공

*/*

dlvpSeqstringOptional

배송지 순번

Example: 1

mbrDlvpSeqstringOptional

회원 배송지순번

Example: 1

baseDlvpYnstringOptional

기본 배송지 여부

Example: Y

dlvpNmstring · min: 1Required

배송지명. 일반주문 필수

Example: 우리집

zipNostring · min: 1Required

우편번호. 일반주문 필수

Example: 05837

zipAddrstring · min: 1Required

우편주소. 일반주문 필수

Example: 서울 송파구 법원로9길

dtlAddrstring · min: 1Required

상세주소. 일반주문 필수

Example: 에이치비지니스파크 D동 6층

rcvmnNmstring · min: 1Required

수취인명

Example: 홍길동

rcvmnEmailAddrstringOptional

수취인 이메일주소

Example: [e-mail]

rcvmnCellSctNostring · min: 1Required

수취인 휴대폰 구분번호

Example: 010

rcvmnCellTxnoNostring · min: 1Required

수취인 휴대폰 국번번호

Example: 0000

rcvmnCellEndNostring · min: 1Required

수취인 휴대폰 끝번호

Example: 0000

rcvmnTelRgnNostringOptional

수취인 전화 지역번호

Example: 02

rcvmnTelTxnoNostringOptional

수취인 전화 국번번호

Example: 554

rcvmnTelEndNostringOptional

수취인 전화 끝번호

Example: 4583

shopTrafMsgstringOptional

매장전달메시지

Example: 포장 안 해주셔도 돼요.

deliMsgCdstringOptional

배송메시지코드(ME039) 20:배송 전 연락 바랍니다,30:부재 시 문 앞에 놓아주세요,40:부재 시 경비실에 맡겨주세요,50:빠른 배송 부탁 드립니다,60:부재 시 핸드폰으로 연락바랍니다,70:직접입력

Example: 40

deliMsgstringOptional

배송메시지

Example: 벨X, 노크X

comnFrdrCogoMethodCdstringOptional

공동현관출입방법코드(ME040) 10:공동현관 출입번호,20:자유 출입 가능,30:기타

Example: 20

comnFrdrEtcMethodstringOptional

공동현관출입 기타방법

Example: 뒷문 있어요.

comnFrdrPwdstringOptional

공동현관비밀번호

Example: 123456

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": "[e-mail]",
    "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": "[e-mail]",
    "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

성공

*/*

goodsNostringRequired

상품번호

Example: 10000001

itmNostringRequired

단품번호

Example: 001

aeNostringRequired

사은행사번호

Example: C1000000

addEvtTypCdstring · enumRequired

사은행사유형코드(MK012)

Example: 10Possible values:

aeStrDtmstring · date-timeRequired

사은행사시작일시

aeEndDtmstring · date-timeRequired

사은행사종료일시

payStrDtstringOptional

지급시작일자

Example: 20231201

payEndDtstringOptional

지급종료일자

Example: 20231231

tmEvtYnstringRequired

타임행사여부

Example: N

aplyStrTmstringOptional

적용시작시간

Example: 0800

aplyEndTmstringOptional

적용종료시간

Example: 2359

aeDescstringRequired

사은행사설명

Example: 사은행사 설명

aeNmstringRequired

사은행사명

Example: 사은행사 명

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-02-27T18:21:08.687Z",
          "aeEndDtm": "2026-02-27T18:21:08.687Z",
          "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-02-27T18:21:08.687Z",
    "aeEndDtm": "2026-02-27T18:21:08.687Z",
    "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

성공

*/*

totalAccmAmtinteger · int64Required

전체적립금액

Example: 3000

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-02-27T18:21:08.687Z",
  "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-02-27T18:21:08.687Z",
          "aeEndDtm": "2026-02-27T18:21:08.687Z",
          "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

성공

*/*

stringOptional

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

성공

*/*

mlgAvalAmtinteger · int64Optional

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
}