상품상세

단품별 재고증차감

put

기능설명

단품별 재고증차감 API 입니다.

상세설명

차감한 단품수량이 재고수량보다 클경우 (마이너스 재고), 에러를 리턴합니다.
증가한 단품수량이 안전재고수량보다 클경우 단품판매상태코드 판매 중으로 변경합니다.

특이사항

재고관리여부 Y인 단품에 대해 처리합니다.

코드정리

재고증차감코드 : plus, minus

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Header parameters

AuthorizationanyOptional

Access Token

Bodyobject · StockUpdateRequest[]

단품별 재고증차감 Request

goodsNostringOptional

상품번호

Default: 10001741

itmNostringOptional

단품번호

Default: 001

stockCntinteger · int32Optional

단품수량

Default: 1

stockIncreaseCdstringOptional

재고증차감코드 : plus/minus

Default: plus

Responses

200

단품별 재고증차감 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

단품별 재고증차감 실패

*/*

put/v1/order/stockUpdate

PUT /api/goods/v1/order/stockUpdate HTTP/1.1
Host: api-goods.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 76

[
  {
    "goodsNo": "10001741",
    "itmNo": "001",
    "stockCnt": 1,
    "stockIncreaseCd": "plus"
  }
]

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "returnCode": 200,
    "message": "SUCCESS",
    "subMessages": "sub message",
    "messageType": "시스템메시지, 대고객메시지",
    "totalCount": 20,
    "data": "json data"
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

증정품 정보 조회

post

기능설명

증정품 정보를 조회합니다.

상세설명

상품에 해당하는 증정품을 조회합니다.

검증내용

1001 : request값이 없거나, request값에 상품번호가 없는 경우 발생하는 오류입니다.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Header parameters

AuthorizationanyOptional

Access Token

Body

프로모션 상품 조회관련 조건 DTO

langCdstringOptional

siteNostring · enumOptional

사이트번호 : 1,2,3, ...

Default: 1Possible values:

pageNointeger · int32Optional

호출 페이지 번호

Example: 1

pageSizeinteger · int32Optional

호출 페이지 사이즈

Example: 20

dispYnstring · enumOptional

전시여부 : Y/N

Default: YPossible values:

goodsNostring[]Optional

상품번호 : 123, ...

ordMediaCdstringOptional

주문미디어코드

offsetinteger · int64Optional

Responses

200

증정품 정보 조회 성공

*/*

증정품 DTO

goodsNostringOptional

상품번호

Example: 100000001

aplyStrDtmstring · date-timeOptional

적용시작일시

Example: 2021-01-01 00:00:00

aplyEndDtmstring · date-timeOptional

적용종료일시

Example: 2029-01-01 00:00:00

langCdstringOptional

언어코드(CM009)

Example: ko

prestNmstringOptional

증정품명

Example: 빨강

useYnstringOptional

사용여부

Example: Y

900

증정품 정보 조회 실패

*/*

post/v1/promotion/promotionGiftList

POST /api/goods/v1/promotion/promotionGiftList HTTP/1.1
Host: api-goods.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 452

{
  "langCd": "text",
  "siteNo": "1",
  "pageNo": 1,
  "pageSize": 20,
  "dispYn": "Y",
  "goodsNo": [
    "text"
  ],
  "ordMediaCd": "text",
  "goodsList": [
    {
      "langCd": "ko",
      "siteNo": "text",
      "pageNo": 1,
      "pageSize": 20,
      "dpmlNo": "text",
      "goodsNo": "text",
      "itmNo": "text",
      "norPrc": 1,
      "supPcost": 1,
      "salePrc": 1,
      "cnt": 1,
      "stdCtgNo": "text",
      "dispCtgNo": "text",
      "brandNo": "text",
      "entrNo": "text",
      "chlNo": "text",
      "infDispCtgNoGbCd": "text",
      "infDispCtgNo": "text",
      "previewDate": "2026-01-01",
      "offset": 1
    }
  ],
  "offset": 1
}

[
  {
    "goodsNo": 100000001,
    "aplyStrDtm": "2021-01-01 00:00:00",
    "aplyEndDtm": "2029-01-01 00:00:00",
    "langCd": "ko",
    "prestNm": "빨강",
    "useYn": "Y"
  }
]

전시상품정보(전시상품요약) 조회

post

기능설명

상품의 요약된 정보를 조회하는 API입니다.

상세설명

다건의 상품조회가 가능합니다.
이미지는 상품의 대표이미지를 제공합니다.
미리보기의 경우 request의 미리보기 언어코드를 사용하여 조회하고, 외의 경우는 쿠키에 저장된 언어코드를 사용하여 조회합니다.

검증내용

5001 : 미리보기의 경우 request에 미리보기날짜가 'yyyyMMdd'형식에 맞지 않는 경우 발생하는 에러입니다.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Header parameters

AuthorizationanyOptional

Access Token

Body

상품검색 조회관련 조건 DTO

langCdstringOptional

언어코드(CM009)

Default: koExample: ko

siteNostringOptional

사이트번호

Default: 1

pageNointeger · int32Optional

호출 페이지 번호

Example: 1

pageSizeinteger · int32Optional

호출 페이지 사이즈

Example: 20

dispYnstring · enumOptional

전시여부

Default: YPossible values:

goodsNostring[]Optional

상품번호

Example: 100000001

goodsNmstring[]Optional

상품명

Example: 상품명1

schKwdNmstring[]Optional

검색어

brandNostring[]Optional

브랜드번호

Example: 100001

brandNmstring[]Optional

브랜드명

Example: dior

entrNostringOptional

협력사번호

Example: 1000001

searchNmstringOptional

검색어(상품번호,상품명,브랜드명)

Example: 멀버리

previewDatestring · dateOptional

미리보기날짜

Example: 2023-09-12

previewLangCdstringOptional

미리보기 언어코드(CM009)

Example: ko

offsetinteger · int64Optional

Responses

200

상품요약정보 조회 성공

*/*

상품검색 요약정보 검색결과 DTO

idstringOptional

상품ID

goodsNostringOptional

상품번호

goodsNmstringOptional

상품명

prestNmstringOptional

증정품명

adveWrdstringOptional

홍보문구

schKwdNmstring[]Optional

검색키워드명

brandNostringOptional

브랜드번호

brandNmstringOptional

브랜드명

buyrAgeLmtCdstringOptional

구입자연령제한코드

goodsRegDtmstring · date-timeOptional

상품등록일시

saleStatCdstringOptional

판매상태코드

deliProcTypCdstringOptional

배송처리유형코드

deliWayCdstringOptional

배송수단코드

deliDdaystringOptional

배송기일

rcntSalePrcstringOptional

최근판매가격

salePrcnumberOptional

판매가

aplyPrcnumberOptional

적용가

dcRateinteger · int32Optional

할인율

dlexTypCdstringOptional

배송비유형코드

payWayMeanCdstringOptional

결제수단코드정보

rservSaleYnstringOptional

예약판매여부

goodsRevCntinteger · int32Optional

상품리뷰건수

goodsRevHlpfulCntinteger · int32Optional

상품리뷰도움돼요건수

goodsRevStarscrAvgValinteger · int32Optional

상품리뷰별점평균값

wishListCntstringOptional

위시리스트수

goodsDtlDescstringOptional

상품상세설명

sendGbstringOptional

전송구분

langCdstringOptional

언어코드

extraDatastringOptional

ExtraData

goodsRepImgPathNmstringOptional

상품 대표이미지

trnfTextContstringOptional

상품 대표이미지 대체텍스트

iconJsonstringOptional

ICON 정보

iconListstring[]Optional

900

상품요약정보 조회 실패

*/*

post/v1/detail/summary

POST /api/goods/v1/detail/summary HTTP/1.1
Host: api-goods.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 262

{
  "langCd": "ko",
  "siteNo": "1",
  "pageNo": 1,
  "pageSize": 20,
  "dispYn": "Y",
  "goodsNo": 100000001,
  "goodsNm": "상품명1",
  "schKwdNm": [
    "text"
  ],
  "brandNo": 100001,
  "brandNm": "dior",
  "entrNo": 1000001,
  "searchNm": "멀버리",
  "previewDate": "2023-09-12",
  "previewLangCd": "ko",
  "offset": 1
}

{
  "id": "text",
  "goodsNo": "text",
  "goodsNm": "text",
  "prestNm": "text",
  "adveWrd": "text",
  "schKwdNm": [
    "text"
  ],
  "brandNo": "text",
  "brandNm": "text",
  "buyrAgeLmtCd": "text",
  "goodsRegDtm": "2026-01-01T00:00:00.000Z",
  "saleStatCd": "text",
  "deliProcTypCd": "text",
  "deliWayCd": "text",
  "deliDday": "text",
  "rcntSalePrc": "text",
  "salePrc": 1,
  "aplyPrc": 1,
  "dcRate": 1,
  "dispCtgNo": [
    {
      "dispCtgNo": "text",
      "ctgFullPath": "text",
      "ctgFullPathNm": "text",
      "siteNo": "text",
      "siteNm": "text",
      "dpmlNo": "text",
      "lrgCtgNm": "text",
      "lrgCtgNo": "text"
    }
  ],
  "dlexTypCd": "text",
  "payWayMeanCd": "text",
  "rservSaleYn": "text",
  "goodsRevCnt": 1,
  "goodsRevHlpfulCnt": 1,
  "goodsRevStarscrAvgVal": 1,
  "wishListCnt": "text",
  "goodsDtlDesc": "text",
  "sendGb": "text",
  "langCd": "text",
  "extraData": "text",
  "goodsRepImgPathNm": "text",
  "trnfTextCont": "text",
  "iconJson": "text",
  "colorDataList": {
    "colorName": "text",
    "subImageUrl": "text",
    "score": "text"
  },
  "iconList": [
    "text"
  ]
}

상품별 단품정보 조회

post

기능설명

상품별 단품정보를 조회하는 API입니다.

상세설명

상품번호에 따라 상품 내 모든 단품의 정보를 조회합니다.
쿠키에 저장된 언어코드를 사용하여 조회합니다.
단품명, 재고정보, 가격 정보를 조회합니다.

수정번호

Release v1.04_231120

API 추가
사이트 조회 조건 중 거래시작일자, 거래종료일자 조건 제외

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Header parameters

AuthorizationanyOptional

Access Token

Bodyobject · ProductDetailRequest[]

상품상세 조회관련 조건 DTO

langCdstringOptional

언어코드(CM009)

Default: koExample: ko

siteNostringOptional

사이트번호

Default: 1

dispYnstring · enumOptional

전시여부

Default: YPossible values:

goodsNostringOptional

상품번호

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

dispMediaCdstringOptional

전시매체코드

Example: 20

Responses

200

상품별 단품정보 조회 성공

*/*

상품정보조회 DTO

goodsNostringOptional

상품번호

Example: 100000001

lgcGoodsNostringOptional

자체상품번호

Example: 100000001

entrNostringOptional

협력사번호

Example: 1000001

stdCtgNostringOptional

표준카테고리번호

Example: 1

goodsCompCdstringOptional

상품구성코드(PR001) 10:일반상품, 20:묶음상품

Example: 10

goodsTypCdstringOptional

상품유형코드(PR002) 10:일반상품, 20:사은품, 30:e-쿠폰상품

Example: 10

saleMethCdstringOptional

판매방식코드(PR003) 10:일반판매, 20:예약상품

Example: 10

brandNostringOptional

브랜드번호

Example: 1

safeCertiTgtYnstringOptional

안전인증대상여부

Example: Y

buyrAgeLmtCdstringOptional

구입자나이제한코드(PR004) 0:, 15:15세이용가, 19:19세이용가, 12:12세이용가

Example: 0

dispYnstringOptional

전시여부

Example: Y

saleStatCdstringOptional

판매상태코드(PR005) 01:임시저장, 02:승인대기, 03:반려, 10:판매중, 20:품절, 30:판매종료

Example: 10

saleStatChgCausCdstringOptional

판매상태변경사유코드(PR058) 41:판매종료(정상), 42:판매종료(삭제)

Example: 41

goodsRegDtmstring · date-timeOptional

상품등록일시

Example: 2021-01-01 00:00:00

saleStrDtmstring · date-timeOptional

판매시작일시

Example: 2021-01-01 00:00:00

saleEndDtmstring · date-timeOptional

판매종료일시

Example: 2029-01-01 00:00:00

buyTypCdstringOptional

매입유형코드(PR006) 10:직매입, 20:위탁판매

Example: 10

taxGbCdstringOptional

과면세구분코드(PR007) 10:과세, 20:면세, 30:영세

Example: 10

stkMgrYnstringOptional

재고관리여부

Example: Y

buyQtyLmtYnstringOptional

구매수량제한여부

Example: Y

minLmtQtyinteger · int32Optional

최소제한수량

Example: 1

maxLmtQtyinteger · int32Optional

최대제한수량

Example: 10

safeStkNotiYnstringOptional

안전재고알림여부

Example: Y

deliProcTypCdstringOptional

배송처리유형코드(PR008) 10:센터배송, 20:업체배송, 30:e-쿠폰배송

Example: 10

deliProcTypCdNmstringOptional

배송처리유형코드명

Example: 센터배송

deliGoodsGbCdstringOptional

배송상품구분코드(PR010) 01:일반상품, 02:설치상품, 03:주문제작, 04:e-쿠폰

Example: 01

deliGoodsGbCdNmstringOptional

배송상품구분코드명

Example: 일반상품

deliWayCdstringOptional

배송수단코드(PR009) 01:택배배송, 02:무배송

Example: 01

deliWayCdNmstringOptional

배송수단코드명

Example: 택배배송

deliPsbRgnCdstringOptional

배송가능지역코드(PR030) 01:전국, 02:전국, 03:서울 및 수도권

Example: 01

deliPsbRgnCdNmstringOptional

배송가능지역코드명

Example: 전국

deliDdaystringOptional

배송기일

Example: 1

deliPolcNostringOptional

배송정책번호

Example: 1

bpckPsbYnstringOptional

합포가능여부

Example: Y

rtnPsbYnstringOptional

반품가능여부

Example: Y

exchPsbYnstringOptional

교환가능여부

Example: Y

hsCdstringOptional

HS코드

Example: 123456

rglrDeliGoodsYnstringOptional

정기배송상품여부

Example: Y

frgnDirPurGoodsYnstringOptional

해외직구상품여부

Example: N

szGdeUseYnstringOptional

사이즈가이드 사용여부

Example: Y

szGdeRegMethodCdstringOptional

사이즈가이드 적용 방법 코드(PR023)

Example: 10

szGdeCdstringOptional

사이즈가이드 코드(PR024)

Example: 10

szGdeContsstringOptional

사이즈가이드

prcCompaExpYnstringOptional

가격비교노출여부

Example: Y

pkgGoodsPrioRnkCdstringOptional

묶음상품우선순위코드(PR035) 10:우선순위 높은순, 20:최저가 상품순, 30:상품번호 높은순

Example: 10

regInfPathCdstringOptional

등록유입경로코드(PR029) 01:기간계 시스템, 02:BO시스템, 03:파트너시스템

Example: 01

aprvReqDtstring · dateOptional

승인요청일자

Example: 20201231

aprvDtstring · dateOptional

승인일자

Example: 20201231

retnCausCdstringOptional

반려사유코드(PR042) 10:가격오류, 20:상품표준분류오류, 30:전시카테고리오류, 40:상품기술서, 50:상품이미지오류, 60:MD문의, 70:QC관련

Example: 10

retnCausstringOptional

반려사유

Example: 가격오류

retnDtstring · dateOptional

반려일자

prestNmstringOptional

증정품명

Example: 증정품목

langCdstringOptional

언어코드(CM009) ko:한국어, en:영어

Example: ko

goodsNmstringOptional

상품명

Example: 상품명

modlNmstringOptional

모델명

Example: 모델명

homeNmstringOptional

원산지명

Example: 원산지명

mfcoNmstringOptional

제조사명

Example: 제조사명

incomNmstringOptional

수입자명

Example: 수입자명

manufYmstringOptional

제조년월

Example: 202301

salemnNmstringOptional

판매자명

Example: 판매자명

schKwdNmstringOptional

검색키워드명

Example: 검색키워드명

adveWrdstringOptional

홍보문구

Example: 홍보문구

aplyStrDtmstring · date-timeOptional

적용시작일자

aplyEndDtmstring · date-timeOptional

적용종료일자

saleMethCdNmstringOptional

판매방식코드명

Example: 판매방식코드명

entrNmstringOptional

협력사명

Example: 협력사명

fwdidcPrarDystringOptional

출고지시예정일자

rsvStrtDtmstring · date-timeOptional

예약판매시작일시

Example: 2024-01-01 00:00:00

rsvEndDtmstring · date-timeOptional

예약판매종료일시

Example: 2024-01-31 23:59:59

dispCtgNostringOptional

전시카테고리번호

Example: 462

dispCtgNmstringOptional

전시카테고리명

Example: 여성_드레스

norPrcinteger · int32Optional

정상판매가(종전판매가)

supPcostinteger · int32Optional

공급가

orgSalePrcinteger · int32Optional

기존 판매가

orgTaxPrcnumber · doubleOptional

원가격 기준 세금

maxBenefitAmtinteger · int64Optional

최대혜택가

salePrcinteger · int32Optional

할인 적용 판매가

saleTaxPrcnumber · doubleOptional

mrgnRatestringOptional

마진율

goodsPrceTypCdstringOptional

일반행사가 구분코드

saleRateinteger · int32Optional

종전판매가 대비 혜택가 할인율

gvgfPsbYnstringOptional

선물하기 가능여부

milgRsrvPsbYnstringOptional

마일리지적립가능여부

entrGoodsNostringOptional

협력사상품번호

ordCnclPsbYnstringOptional

주문취소가능여부

wthdYnstringOptional

회수여부

ecpnAplyTermGbCdstringOptional

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

ecpnIssuDdStdUseDdsinteger · int32Optional

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

ecpnUsePsbStrDtstring · dateOptional

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

ecpnUsePsbEndDtstring · dateOptional

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

timedealYnstringOptional

타임딜여부

histEndDtmstring · dateOptional

타임딜여부

900

상품별 단품정보 조회 실패

*/*

post/v1/detail/productInfo

POST /api/goods/v1/detail/productInfo HTTP/1.1
Host: api-goods.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 397

[
  {
    "langCd": "ko",
    "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",
    "dispMediaCd": 20
  }
]

{
  "goodsNo": 100000001,
  "lgcGoodsNo": 100000001,
  "entrNo": 1000001,
  "stdCtgNo": 1,
  "goodsCompCd": 10,
  "goodsTypCd": 10,
  "saleMethCd": 10,
  "brandNo": 1,
  "safeCertiTgtYn": "Y",
  "buyrAgeLmtCd": 0,
  "dispYn": "Y",
  "saleStatCd": 10,
  "saleStatChgCausCd": 41,
  "goodsRegDtm": "2021-01-01 00:00:00",
  "saleStrDtm": "2021-01-01 00:00:00",
  "saleEndDtm": "2029-01-01 00:00:00",
  "buyTypCd": 10,
  "taxGbCd": 10,
  "stkMgrYn": "Y",
  "buyQtyLmtYn": "Y",
  "minLmtQty": 1,
  "maxLmtQty": 10,
  "safeStkNotiYn": "Y",
  "deliProcTypCd": 10,
  "deliProcTypCdNm": "센터배송",
  "deliGoodsGbCd": "01",
  "deliGoodsGbCdNm": "일반상품",
  "deliWayCd": "01",
  "deliWayCdNm": "택배배송",
  "deliPsbRgnCd": "01",
  "deliPsbRgnCdNm": "전국",
  "deliDday": 1,
  "deliPolcNo": 1,
  "bpckPsbYn": "Y",
  "rtnPsbYn": "Y",
  "exchPsbYn": "Y",
  "hsCd": 123456,
  "rglrDeliGoodsYn": "Y",
  "frgnDirPurGoodsYn": "N",
  "szGdeUseYn": "Y",
  "szGdeRegMethodCd": 10,
  "szGdeCd": 10,
  "szGdeConts": "text",
  "prcCompaExpYn": "Y",
  "pkgGoodsPrioRnkCd": 10,
  "regInfPathCd": "01",
  "aprvReqDt": 20201231,
  "aprvDt": 20201231,
  "retnCausCd": 10,
  "retnCaus": "가격오류",
  "retnDt": "2026-01-01",
  "prestNm": "증정품목",
  "langCd": "ko",
  "goodsNm": "상품명",
  "modlNm": "모델명",
  "homeNm": "원산지명",
  "mfcoNm": "제조사명",
  "incomNm": "수입자명",
  "manufYm": 202301,
  "salemnNm": "판매자명",
  "schKwdNm": "검색키워드명",
  "adveWrd": "홍보문구",
  "aplyStrDtm": "2026-01-01T00:00:00.000Z",
  "aplyEndDtm": "2026-01-01T00:00:00.000Z",
  "saleMethCdNm": "판매방식코드명",
  "entrNm": "협력사명",
  "fwdidcPrarDy": "text",
  "rsvStrtDtm": "2024-01-01 00:00:00",
  "rsvEndDtm": "2024-01-31 23:59:59",
  "dispCtgNo": 462,
  "dispCtgNm": "여성_드레스",
  "norPrc": 1,
  "supPcost": 1,
  "orgSalePrc": 1,
  "orgTaxPrc": 1,
  "maxBenefitAmt": 1,
  "salePrc": 1,
  "saleTaxPrc": 1,
  "mrgnRate": "text",
  "goodsPrceTypCd": "text",
  "saleRate": 1,
  "gvgfPsbYn": "text",
  "milgRsrvPsbYn": "text",
  "entrGoodsNo": "text",
  "ordCnclPsbYn": "text",
  "wthdYn": "text",
  "ecpnAplyTermGbCd": "text",
  "ecpnIssuDdStdUseDds": 1,
  "ecpnUsePsbStrDt": "2026-01-01",
  "ecpnUsePsbEndDt": "2026-01-01",
  "timedealYn": "text",
  "histEndDtm": "2026-01-01",
  "itmInfo": [
    {
      "goodsNo": "text",
      "itmNo": "text",
      "itmNm": "text",
      "stkQty": "text",
      "itmSaleStatCd": "text",
      "salePrc": "text",
      "supPrc": "text",
      "norPrc": "text"
    }
  ],
  "dispGoodsInfoList": [
    {
      "siteNo": 1,
      "siteNm": "플래티어닷컴",
      "dpmlNo": 10001,
      "dpmlNm": "통합몰",
      "dispCtgNo": 242,
      "dispCtgNm": "잡화>주얼리"
    }
  ]
}

상품별 단품정보 조회(주문전용)

post

기능설명

다건 상품의 단품별 대체 가능한 단품정보를 조회하는 API입니다.

상세설명

다건의 상품 조회 시 호출합니다.
요청 받은 각 상품에 대하여 요청한 단품외의 단품 중에 상품+단품+수량으로 대체가능(판매가격+단품추가금 동일한 다른 단품)한 상품별로 단품목록을 조회합니다.
단품재고가 요청수량보다 많은 경우만 조회합니다.
쿠키에 저장된 언어코드를 사용하여 조회합니다.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Header parameters

AuthorizationanyOptional

Access Token

Bodyobject · ProductOrderDetailRequest[]

장바구니 상품상세 조회관련 조건 DTO

langCdstringOptional

언어코드(CM009)

Default: koExample: ko

siteNostringOptional

사이트번호

Default: 1

mallNostringOptional

몰번호

Default: 100001

dispYnstring · enumOptional

전시여부

Default: YPossible values:

goodsNostringOptional

상품번호

Example: 10001921

itmNostring[]Optional

단품번호

Example: ["001","002"]

stkQtyinteger · int64Optional

단품수량

Default: 1Example: 1

previewDatestring · dateOptional

미리보기날짜

Example: 2023-08-28

Responses

200

다건 상품의 단품별 단품정보 조회 성공

*/*

상품별 단품정보 조회 DTO

goodsNostringOptional

상품번호

stkMgrYnstringOptional

재고관리여부

itmNostringOptional

단품번호

itmNmstringOptional

단품명

itmSaleStatCdstringOptional

판매상태코드(PR005)

stkQtystringOptional

재고수량

supPcoststringOptional

공급원가

norPrcstringOptional

정상가

salePrcstringOptional

판매가

tsalePrcstringOptional

tsupPrcstringOptional

900

다건 상품의 단품별 단품정보 조회 실패

*/*

post/v1/detail/otherItms

POST /api/goods/v1/detail/otherItms HTTP/1.1
Host: api-goods.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 140

[
  {
    "langCd": "ko",
    "siteNo": "1",
    "mallNo": "100001",
    "dispYn": "Y",
    "goodsNo": 10001921,
    "itmNo": [
      "001",
      "002"
    ],
    "stkQty": 1,
    "previewDate": "2023-08-28"
  }
]

{
  "goodsNo": "text",
  "stkMgrYn": "text",
  "itmNo": "text",
  "itmNm": "text",
  "itmSaleStatCd": "text",
  "stkQty": "text",
  "supPcost": "text",
  "norPrc": "text",
  "salePrc": "text",
  "dispGoodsInfoList": [
    {
      "siteNo": 1,
      "siteNm": "플래티어닷컴",
      "dpmlNo": 10001,
      "dpmlNm": "통합몰",
      "dispCtgNo": 242,
      "dispCtgNm": "잡화>주얼리"
    }
  ],
  "tsalePrc": "text",
  "tsupPrc": "text"
}

대체가능 상품단품정보 조회(장바구니)

post

기능설명

단건 상품의 단품별 대체 가능한 단품정보를 조회하는 API입니다.

상세설명

단건의 상품 조회 시 호출하는 API입니다.
요청 받은 상품에 대하여 요청한 단품외의 단품 중에 상품+단품+수량으로 대체가능(판매가격+단품추가금 동일한 다른 단품)한 단품목록을 조회합니다.
상품가는 동일하므로 단품추가금만 확인하여 조회합니다.
단품재고가 요청수량보다 많은 경우만 조회합니다.
쿠키에 저장된 언어코드를 사용하여 조회합니다.

수정번호

Release v1.04_231120 : 단품명이 옵션분류명이 아닌 옵션명으로 조회하도록 수정

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Header parameters

AuthorizationanyOptional

Access Token

Body

단품상세 조회관련 조건 DTO

langCdstringOptional

언어코드(CM009)

Default: koExample: ko

siteNostringOptional

사이트번호

Default: 1

dispYnstring · enumOptional

전시여부

Default: YPossible values:

goodsNostringOptional

상품번호

Example: 100000001

schKwdNmstringOptional

검색어

Example: 검색어1,검색어2

stdCtgNostringOptional

표준카테고리

brandNostringOptional

브랜드번호

lgcGoodsNostringOptional

판매자 상품번호

itmNostring[]Optional

단품번호

Example: 001

stkQtyinteger · int64Optional

단품재고수량

Example: 0

saleStatCdstringOptional

판매상태코드

Default: 10

entrNostringOptional

협력사번호

Responses

200

단건 상품의 단품별 대체 가능한 단품정보 조회 성공

*/*

상품별 단품정보 조회 DTO

goodsNostringOptional

상품번호

stkMgrYnstringOptional

재고관리여부

itmNostringOptional

단품번호

itmNmstringOptional

단품명

itmSaleStatCdstringOptional

판매상태코드(PR005)

stkQtystringOptional

재고수량

supPcoststringOptional

공급원가

norPrcstringOptional

정상가

salePrcstringOptional

판매가

tsalePrcstringOptional

tsupPrcstringOptional

900

단건 상품의 단품별 대체 가능한 단품정보 조회 실패

*/*

post/v1/detail/itm

POST /api/goods/v1/detail/itm HTTP/1.1
Host: api-goods.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 210

{
  "langCd": "ko",
  "siteNo": "1",
  "dispYn": "Y",
  "goodsNo": 100000001,
  "schKwdNm": "검색어1,검색어2",
  "stdCtgNo": "text",
  "brandNo": "text",
  "lgcGoodsNo": "text",
  "itmNo": "001",
  "stkQty": 0,
  "saleStatCd": "10",
  "entrNo": "text"
}

{
  "goodsNo": "text",
  "stkMgrYn": "text",
  "itmNo": "text",
  "itmNm": "text",
  "itmSaleStatCd": "text",
  "stkQty": "text",
  "supPcost": "text",
  "norPrc": "text",
  "salePrc": "text",
  "dispGoodsInfoList": [
    {
      "siteNo": 1,
      "siteNm": "플래티어닷컴",
      "dpmlNo": 10001,
      "dpmlNm": "통합몰",
      "dispCtgNo": 242,
      "dispCtgNm": "잡화>주얼리"
    }
  ],
  "tsalePrc": "text",
  "tsupPrc": "text"
}

상품별 단품정보 조회(장바구니전용)

post

기능설명

단품 기준의 상세정보를 조회하는 API입니다.

상세설명

장바구니페이지에서 단품별 상세정보를 조회하기 위해 호출합니다.
리스트로 받은 단품번호 기준으로 단품의 상세정보를 조회합니다.
쿠키에 저장된 언어코드, 사이트번호, 몰번호를 사용하여 조회합니다.

검증내용

0000 : API 조회가 성공적으로 동작한 경우입니다.
500 : request 값이 없거나, request의 단품번호가 없는 경우 발생하는 에러입니다.

수정번호

Release v1.02_231023

마일리지적립가능여부(milgRsrvPsbYn) 변수추가
선물하기가능여부(gvgfPsbYn) 변수추가

Release v1.03_231106

판매가에 단품추가판매가, 공급가에 단품추가공급가로 수정

Release v1.05_231204

정기배송상품여부(rglrDeliGoodsYn) 변수추가

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Header parameters

AuthorizationanyOptional

Access Token

Bodyobject · ProductOrderDetailRequest[]

장바구니 상품상세 조회관련 조건 DTO

langCdstringOptional

언어코드(CM009)

Default: koExample: ko

siteNostringOptional

사이트번호

Default: 1

mallNostringOptional

몰번호

Default: 100001

dispYnstring · enumOptional

전시여부

Default: YPossible values:

goodsNostringOptional

상품번호

Example: 10001921

itmNostring[]Optional

단품번호

Example: ["001","002"]

stkQtyinteger · int64Optional

단품수량

Default: 1Example: 1

previewDatestring · dateOptional

미리보기날짜

Example: 2023-08-28

Responses

200

단품상세 조회 성공

*/*

상품+단품 검색결과 DTO

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

교환가능여부

supPcostinteger · int32Optional

공급원가

norPrcinteger · int32Optional

정상가

preSalePrcinteger · int32Optional

종전판매가

salePrcinteger · int32Optional

판매가

mrgnRateinteger · int64Optional

마진율

payMeanInfostringOptional

결제수단

itmNostringOptional

단품번호

itmNmstringOptional

단품명

stkQtyinteger · int32Optional

단품수량

itmSaleStatCdstringOptional

판매상태코드(PR005)

prestNmstringOptional

증정품명

rsvStrtDtmstring · date-timeOptional

예약시작일시

rsvEndDtmstring · date-timeOptional

예약종료일시

fwdidcPrarDystringOptional

출고지시예정일자

deliProcTypCdstringOptional

배송처리유형코드(PR008)

gvgfPsbYnstringOptional

선물하기가능여부

milgRsrvPsbYnstringOptional

마일리지적립가능여부

rglrDeliGoodsYnstringOptional

정기배송상품여부

sngGoodsYnstringOptional

단일상품여부

frgnDirPurGoodsYnstringOptional

해외직구상품여부

entrGoodsNostringOptional

협력사상품번호

ordCnclPsbYnstringOptional

주문취소가능여부

wthdYnstringOptional

회수여부

ecpnAplyTermGbCdstringOptional

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

ecpnIssuDdStdUseDdsinteger · int32Optional

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

ecpnUsePsbStrDtstring · dateOptional

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

ecpnUsePsbEndDtstring · dateOptional

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

entrItmNostringOptional

협력사단품번호

ecpnLinkGbCdstringOptional

e-쿠폰연동구분코드(VD015)

ecpnUseYnstringOptional

e-쿠폰사용여부

tsalePrcinteger · int32Optional

tsupPrcinteger · int32Optional

900

단품상세 조회 실패

*/*

post/v1/detail/goods

POST /api/goods/v1/detail/goods HTTP/1.1
Host: api-goods.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 140

[
  {
    "langCd": "ko",
    "siteNo": "1",
    "mallNo": "100001",
    "dispYn": "Y",
    "goodsNo": 10001921,
    "itmNo": [
      "001",
      "002"
    ],
    "stkQty": 1,
    "previewDate": "2023-08-28"
  }
]

{
  "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-01-01T00:00:00.000Z",
  "saleEndDtm": "2026-01-01T00:00:00.000Z",
  "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-01-01T00:00:00.000Z",
  "rsvEndDtm": "2026-01-01T00:00:00.000Z",
  "fwdidcPrarDy": "text",
  "deliProcTypCd": "text",
  "gvgfPsbYn": "text",
  "milgRsrvPsbYn": "text",
  "rglrDeliGoodsYn": "text",
  "sngGoodsYn": "text",
  "frgnDirPurGoodsYn": "text",
  "entrGoodsNo": "text",
  "ordCnclPsbYn": "text",
  "wthdYn": "text",
  "ecpnAplyTermGbCd": "text",
  "ecpnIssuDdStdUseDds": 1,
  "ecpnUsePsbStrDt": "2026-01-01",
  "ecpnUsePsbEndDt": "2026-01-01",
  "entrItmNo": "text",
  "ecpnLinkGbCd": "text",
  "ecpnUseYn": "text",
  "tsalePrc": 1,
  "tsupPrc": 1
}

상품별 결제가능수단 조회

post

기능설명

상품별 결제수단을 조회합니다.

상세설명

다건의 상품별 각각의 결제수단을 조회합니다.
쿠키에 저장된 언어코드를 사용하여 조회합니다.
결제수단의 사용여부가 'Y'인 결제수단만 조회합니다.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Header parameters

AuthorizationanyOptional

Access Token

Bodystring[]

string[]Optional

Responses

200

상품별 결제수단 조회 성공

*/*

상품+단품 검색결과 DTO

goodsNostringOptional

상품번호

langCdstringOptional

언어코드(CM009)

900

상품별 결제수단 조회 실패

*/*

post/v1/detail/goodsPayMeanList

POST /api/goods/v1/detail/goodsPayMeanList HTTP/1.1
Host: api-goods.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 8

[
  "text"
]

{
  "goodsNo": "text",
  "langCd": "text",
  "prGoodsBase": {
    "goodsNo": 100000001,
    "lgcGoodsNo": 100000001,
    "entrNo": 1000001,
    "stdCtgNo": 1,
    "goodsCompCd": 10,
    "goodsTypCd": 10,
    "saleMethCd": 10,
    "brandNo": 1,
    "safeCertiTgtYn": "Y",
    "buyrAgeLmtCd": 0,
    "dispYn": "Y",
    "saleStatCd": 10,
    "saleStatChgCausCd": 41,
    "goodsRegDtm": "2021-01-01 00:00:00",
    "saleStrDtm": "2021-01-01 00:00:00",
    "saleEndDtm": "2029-01-01 00:00:00",
    "buyTypCd": 10,
    "taxGbCd": 10,
    "stkMgrYn": "Y",
    "buyQtyLmtYn": "Y",
    "minLmtQty": 1,
    "maxLmtQty": 10,
    "safeStkNotiYn": "Y",
    "deliProcTypCd": 10,
    "deliProcTypCdNm": "센터배송",
    "deliGoodsGbCd": "01",
    "deliGoodsGbCdNm": "일반상품",
    "deliWayCd": "01",
    "deliWayCdNm": "택배배송",
    "deliPsbRgnCd": "01",
    "deliPsbRgnCdNm": "전국",
    "deliDday": 1,
    "deliPolcNo": 1,
    "bpckPsbYn": "Y",
    "rtnPsbYn": "Y",
    "exchPsbYn": "Y",
    "hsCd": 123456,
    "rglrDeliGoodsYn": "Y",
    "frgnDirPurGoodsYn": "N",
    "szGdeUseYn": "Y",
    "szGdeRegMethodCd": 10,
    "szGdeCd": 10,
    "szGdeConts": "text",
    "prcCompaExpYn": "Y",
    "pkgGoodsPrioRnkCd": 10,
    "regInfPathCd": "01",
    "aprvReqDt": 20201231,
    "aprvDt": 20201231,
    "retnCausCd": 10,
    "retnCaus": "가격오류",
    "retnDt": "2026-01-01",
    "prestNm": "증정품목",
    "langCd": "ko",
    "goodsNm": "상품명",
    "modlNm": "모델명",
    "homeNm": "원산지명",
    "mfcoNm": "제조사명",
    "incomNm": "수입자명",
    "manufYm": 202301,
    "salemnNm": "판매자명",
    "schKwdNm": "검색키워드명",
    "adveWrd": "홍보문구",
    "aplyStrDtm": "2026-01-01T00:00:00.000Z",
    "aplyEndDtm": "2026-01-01T00:00:00.000Z",
    "saleMethCdNm": "판매방식코드명",
    "entrNm": "협력사명",
    "fwdidcPrarDy": 20210101,
    "rsvStrtDtm": "2024-01-01 00:00:00",
    "rsvEndDtm": "2024-01-31 23:59:59",
    "dispCtgNo": 462,
    "dispCtgNm": "여성_드레스",
    "norPrc": 1,
    "supPcost": 1,
    "orgSalePrc": 1,
    "orgTaxPrc": 1,
    "maxBenefitAmt": 1,
    "salePrc": 1,
    "saleTaxPrc": 1,
    "mrgnRate": "text",
    "goodsPrceTypCd": "text",
    "saleRate": 1,
    "gvgfPsbYn": "text",
    "milgRsrvPsbYn": "text",
    "entrGoodsNo": "text",
    "ordCnclPsbYn": "text",
    "wthdYn": "text",
    "ecpnAplyTermGbCd": "text",
    "ecpnIssuDdStdUseDds": 1,
    "ecpnUsePsbStrDt": "2026-01-01",
    "ecpnUsePsbEndDt": "2026-01-01",
    "timedealYn": "text",
    "histEndDtm": "2026-01-01"
  },
  "prBrandMst": {
    "brandNo": 1,
    "useYn": "Y",
    "brandImgPathNm": "text",
    "brandImgFileNm": "text",
    "langCd": "ko",
    "brandNm": "브랜드명",
    "brandDescCmt": "브랜드설명내용",
    "schKwdNm": "검색키워드명"
  },
  "prGoodsContInfo": [
    {
      "goodsNo": 100000001,
      "contTypCd": "01",
      "contSn": 1,
      "imgGbCd": 10,
      "dispSeq": 1,
      "contFilePathNm": 1,
      "contFileNm": 1,
      "trnfTextCont": 1,
      "useYn": "Y",
      "goodsDtlDesc": "상품상세설명"
    }
  ],
  "prGoodsPrceHist": [
    {
      "goodsNo": 100000001,
      "histStrDtm": "2021-01-01 00:00:00",
      "histEndDtm": "2025-01-01 00:00:00",
      "goodsPrceTypCd": "text",
      "supPcost": 10000,
      "norPrc": 20000,
      "salePrc": 15000,
      "mrgnRate": "20%",
      "prcChgCausCd": 10
    }
  ],
  "prItmBase": [
    {
      "goodsNo": 100000001,
      "itmNo": "001",
      "addSalePrc": 10000,
      "addMrgnRate": "20%",
      "limtQty": 100,
      "stkQty": 100,
      "itmSaleStatCd": 10,
      "dispSeq": 1,
      "safeStkQty": 10,
      "repItmYn": "Y",
      "saleStatChgCausCd": 41,
      "soutCausCd": 11,
      "lgcItmNo": 100000001,
      "optnCatNo1": 1,
      "optnNo1": 1,
      "optnCatNo2": 2,
      "optnNo2": 2,
      "optnCatNo3": 3,
      "optnNo3": 3,
      "optnCatNo4": 4,
      "optnNo4": 4,
      "optnCatNo5": "text",
      "optnNo5": "text",
      "langCd": "ko",
      "optnCatNm1": "색상",
      "optnNm1": "빨강",
      "optnCatNm2": "사이즈",
      "optnNm2": "XL",
      "optnCatNm3": "색상",
      "optnNm3": "파랑",
      "optnCatNm4": "사이즈",
      "optnNm4": "L",
      "optnCatNm5": "색상",
      "optnNm5": "노랑",
      "stkMgrYn": "Y"
    }
  ],
  "prGoodsPayMeanInfo": [
    {
      "goodsNo": 100000001,
      "payWayCd": 11,
      "payWayCdNm": "신용카드",
      "useYn": "Y",
      "langCd": "ko",
      "cdNm": "text",
      "cdDesc": "text"
    }
  ],
  "prGoodsItemInfo": [
    {
      "goodsNo": 100000001,
      "goodsNotiLisartCd": "text",
      "goodsNotiItemCd": "text",
      "langCd": "ko",
      "notiItemCmt": "text",
      "sortSeq": "text",
      "notiItemNm": "text",
      "goodsNotiLisartNm": "text"
    }
  ],
  "prGoodsSafeCertiHist": [
    {
      "goodsNo": 100000001,
      "safeCertiGbCd": "01",
      "safeCertiNm": "text",
      "safeCertiNo": "01",
      "aplyStrDt": "2021-01-01",
      "aplyEndDt": "2029-01-01",
      "safeCertiOrnNm": "안전인증기관명"
    }
  ],
  "prRelGoodsInfo": [
    {
      "baseGoodsNo": 100000001,
      "tgtGoodsNo": 100000002,
      "tgtGoodsNm": "대상상품명예시",
      "buyrAgeLmtCd": 0,
      "repYn": "Y",
      "sortSeq": 1
    }
  ],
  "prAssocGoodsInfo": [
    {
      "goodsNo": 1000476,
      "saleStatCd": 10,
      "asctGbCd": "text",
      "asctGoodsNo": 1000626,
      "sortSeq": 1,
      "goodsNm": "상품명",
      "brandNm": "Dior",
      "contFilePathNm": "text",
      "trnfTextCont": "text",
      "salePrc": 1500,
      "aplyPrc": 1300,
      "norPrc": 1800,
      "saleRate": 15,
      "buyrAgeLmtCd": 19,
      "iconJson": "text"
    }
  ],
  "etDeliPolcBase": {
    "deliPolcNo": 10000001,
    "entrNo": 1000001,
    "dlexTypCd": 10,
    "stdAmt": 2000,
    "dlexAmt": 2000,
    "wthdRtnAmt": 3000,
    "exchDlex": 3000,
    "useYn": "Y"
  },
  "etAddDlexInfo": [
    {
      "deliPolcNo": 10000001,
      "deliRegnGrpNo": 10,
      "deliRegnGrpNm": 10,
      "addDlexAmt": 2000
    }
  ],
  "etEntrBase": {
    "entrNo": 1000001,
    "entrNm": "협력사1",
    "entrGbCd": 10,
    "latt": 37.123456,
    "lngt": 127.123456,
    "trdTypCd": 10,
    "trdStatCd": 20,
    "lgcEntrNo": 1000001,
    "rpstmnNm": "홍길동",
    "bmanNo": "123-45-67890",
    "corpnNo": "123-45-67890",
    "btyp": "제조",
    "bkind": "식품",
    "contStrtDy": "2021-01-01",
    "contEndDy": "2029-12-31",
    "aempNm": "홍길동",
    "aempTelRgnNo": "02",
    "aempTelTxnoNo": 1234,
    "aempTelEndNo": 5678,
    "aempCellSctNo": "010",
    "aempCellTxnoNo": 1234,
    "aempCellEndNo": 5678,
    "faxRgnNo": "02",
    "faxTxnoNo": 1234,
    "faxEndNo": 5678,
    "bmanKindCd": 10,
    "zipNoSeq": 1,
    "zipNo": 123,
    "zipAddr": "서울시 강남구",
    "dtlAddr": "테헤란로 123",
    "rmkCont": "비고내용",
    "mrgnRateGbCd": 10,
    "mrgnRate1": 10,
    "mrgnRate2": 20
  },
  "promoList": [
    {
      "promoNo": "text",
      "promoNm": "text",
      "promoTypCd": "text",
      "dcAmt": 1
    }
  ],
  "revSummaryDto": {
    "goodsNo": "text",
    "goodsNm": "text",
    "totScr": 1,
    "avgScr": 1,
    "revTotCnt": 1,
    "totalRevCnt": "text",
    "photoVideoRevCnt": "text",
    "normalRevCnt": "text"
  },
  "productDetailIconInfo": [
    {
      "iconUrl": "text"
    }
  ],
  "prGoodsAttInfo": [
    {
      "langCd": "text",
      "goodsNo": "text",
      "attCd": "text",
      "attVal": "text",
      "stdCtgNo": "text",
      "attNm": "text"
    }
  ]
}

상품별 최대혜택가 조회 (프로모션 제공)

get

기능설명

상품의 최대혜택가를 조회하는 API입니다.

상세설명

request에 단품번호가 없는 경우는 상품의 단품번호가 가장 빠른 단품을 기준으로 프로모션 최대혜택가를 적용하여 조회합니다.
request에 단품번호가 있는 경우는 상품의 해당 단품번호를 기준으로 프로모션 최대혜택가를 적용하여 조회합니다.
최대혜택가에 해당하는 프로모션리스트를 조회합니다.
쿠키에 저장된 사이트번호, 몰번호를 사용하여 조회합니다.
request에 채널번호가 있는 경우 해당 채널번호를 사용하여 조회하고, 외의 경우는 쿠키에 저장된 채널번호를 사용하여 조회합니다.
로그인을 한 경우 로그인 사용자 정보가 프로모션 최대혜택가 계산 조건에 적용됩니다.

검증내용

500 : 프로모션 최대혜택가 결과값이 오류인 경우 발생하는 에러입니다.
5001 : 미리보기의 경우 request에 미리보기날짜가 'yyyyMMdd'형식에 맞지 않는 경우 발생하는 에러입니다.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

goodsNostringRequired

상품번호

Query parameters

Header parameters

AuthorizationanyOptional

Access Token

Responses

200

상품별 최대혜택가 조회 성공

*/*

상품별 최대혜택가 DTO

goodsNostringOptional

상품번호

itmNostringOptional

단품번호

norPrcinteger · int32Optional

정상가

salePrcinteger · int32Optional

할인 적용 판매가

orgSalePrcinteger · int32Optional

기존 판매가

maxBenefitAmtinteger · int64Optional

최대혜택가

saleRateinteger · int32Optional

종전판매가 대비 혜택가 할인율

900

상품별 최대혜택가 조회 실패

*/*

get/v1/detail/maxDc/{goodsNo}

GET /api/goods/v1/detail/maxDc/{goodsNo}?promotionGoodsRequest=[object+Object] HTTP/1.1
Host: api-goods.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "goodsNo": "text",
  "itmNo": "text",
  "norPrc": 1,
  "salePrc": 1,
  "orgSalePrc": 1,
  "maxBenefitAmt": 1,
  "saleRate": 1,
  "promoList": [
    {
      "promoNo": "text",
      "promoNm": "text",
      "promoTypCd": "text",
      "dcAmt": 1
    }
  ]
}

단품별 즉시할인가 조회

get

기능설명

단품별 즉시할인가를 조회하는 API입니다.

상세설명

쿠키에 저장된 사이트번호, 몰번호를 사용하여 조회합니다.
단품에 즉시할인가가 적용된 가격정보를 조회합니다.

검증내용

500 : 프로모션 즉시할인가 결과값이 오류인 경우 발생하는 에러입니다.
1001 : 상품번호, 단품번호가 없는 경우 발생하는 에러입니다.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

goodsNostringRequired

상품번호

itmNostringRequired

단품번호

Header parameters

AuthorizationanyOptional

Access Token

Responses

200

단품별 즉시할인가 조회 성공

*/*

상품별 최대혜택가 DTO

goodsNostringOptional

상품번호

itmNostringOptional

단품번호

norPrcinteger · int32Optional

정상가

salePrcinteger · int32Optional

할인 적용 판매가

orgSalePrcinteger · int32Optional

기존 판매가

maxBenefitAmtinteger · int64Optional

최대혜택가

saleRateinteger · int32Optional

종전판매가 대비 혜택가 할인율

900

단품별 즉시할인가 조회 실패

*/*

get/v1/detail/immediateDc/{goodsNo}/{itmNo}

GET /api/goods/v1/detail/immediateDc/{goodsNo}/{itmNo} HTTP/1.1
Host: api-goods.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "goodsNo": "text",
  "itmNo": "text",
  "norPrc": 1,
  "salePrc": 1,
  "orgSalePrc": 1,
  "maxBenefitAmt": 1,
  "saleRate": 1,
  "promoList": [
    {
      "promoNo": "text",
      "promoNm": "text",
      "promoTypCd": "text",
      "dcAmt": 1
    }
  ]
}

옵션정보 조회 (옵션팝업)

get

기능설명

상품의 옵션정보를 조회하는 API입니다.

상세설명

상품에 대한 옵션목록을 조회하기 위한 API입니다.
묶음상품을 조회하는 경우 해당 묶음상품의 대표 상품의 옵션목록을 조회합니다.
상품의 전시여부가 Y이고, 단품의 판매상태가 판매중/품절인 단품이 속한 옵션들을 조회합니다.
단품목록이 없는 옵션은 조회에서 제외합니다.
리프옵션에 해당하는 단품의 기본정보를 포함합니다.
쿠키에 저장된 사이트번호, 몰번호를 사용하여 조회합니다.
미리보기의 경우 request의 미리보기 언어코드를 사용하여 조회하고, 외의 경우는 쿠키에 저장된 언어코드를 사용하여 조회합니다.

검증내용

1001 : request에 상품번호가 없는 경우 발생하는 에러입니다.
5001 : 미리보기의 경우 request에 미리보기날짜가 'yyyyMMdd'형식에 맞지 않는 경우 발생하는 에러입니다.
5003 : 판매종료 / 존재하지 않는 상품 / 상품의 필수 데이터가 입력되지 않는 상품을 조회하는 경우 발생하는 에러입니다.

수정번호

Release v1.03_231106:

이미지경로명(imgPathNm), 이미지파일명(imgFileNm), RGB값(rgbVal) 변수추가

Release v2.00_240401:

단품 추가 가격(addSalePrc) 추가

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

Header parameters

AuthorizationanyOptional

Access Token

Responses

200

옵션정보 조회 성공

*/*

상품별 단품 옵션정보 및 상품 기본정보 검색결과 DTO

itmOptnNoArrstring[]Optional

단품 옵션값 Array

900

옵션정보 조회 실패

*/*

get/v1/detail/goodsOptionInfo

GET /api/goods/v1/detail/goodsOptionInfo?request=[object+Object] HTTP/1.1
Host: api-goods.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "optionInfo": {
    "optnCatNo": "text",
    "optnNo": "text",
    "optnCatNm": "text",
    "optnNm": "text",
    "optnCatSortSeq": 1,
    "optnSortSeq": 1,
    "itmNo": "text",
    "limtQty": 1,
    "stkQty": 1,
    "itmSaleStatCd": "text",
    "safeStkQty": 1,
    "addSalePrc": 1,
    "imgPathNm": "text",
    "imgFileNm": "text",
    "rgbVal": "text",
    "goodsNo": "text",
    "leafOption": 1,
    "goodsCompCd": "text",
    "productOption1InfoList": [
      {
        "optnCatNo": "text",
        "optnNo": "text",
        "optnCatNm": "text",
        "optnNm": "text",
        "optnCatSortSeq": 1,
        "optnSortSeq": 1,
        "itmNo": "text",
        "limtQty": 1,
        "stkQty": 1,
        "itmSaleStatCd": "text",
        "safeStkQty": 1,
        "addSalePrc": 1,
        "imgPathNm": "text",
        "imgFileNm": "text",
        "rgbVal": "text",
        "productOption2InfoList": [
          {
            "optnCatNo": "text",
            "optnNo": "text",
            "optnCatNm": "text",
            "optnNm": "text",
            "optnCatSortSeq": 1,
            "optnSortSeq": 1,
            "itmNo": "text",
            "limtQty": 1,
            "stkQty": 1,
            "itmSaleStatCd": "text",
            "safeStkQty": 1,
            "addSalePrc": 1,
            "imgPathNm": "text",
            "imgFileNm": "text",
            "rgbVal": "text",
            "productOption3InfoList": [
              {
                "optnCatNo": "text",
                "optnNo": "text",
                "optnCatNm": "text",
                "optnNm": "text",
                "optnCatSortSeq": 1,
                "optnSortSeq": 1,
                "itmNo": "text",
                "limtQty": 1,
                "stkQty": 1,
                "itmSaleStatCd": "text",
                "safeStkQty": 1,
                "addSalePrc": 1,
                "imgPathNm": "text",
                "imgFileNm": "text",
                "rgbVal": "text",
                "productOption4InfoList": [
                  {
                    "optnCatNo": "text",
                    "optnNo": "text",
                    "optnCatNm": "text",
                    "optnNm": "text",
                    "optnCatSortSeq": 1,
                    "optnSortSeq": 1,
                    "itmNo": "text",
                    "limtQty": 1,
                    "stkQty": 1,
                    "itmSaleStatCd": "text",
                    "safeStkQty": 1,
                    "addSalePrc": 1,
                    "imgPathNm": "text",
                    "imgFileNm": "text",
                    "rgbVal": "text",
                    "productOption5InfoList": [
                      {
                        "optnCatNo": "text",
                        "optnNo": "text",
                        "optnCatNm": "text",
                        "optnNm": "text",
                        "optnCatSortSeq": 1,
                        "optnSortSeq": 1,
                        "itmNo": "text",
                        "limtQty": 1,
                        "stkQty": 1,
                        "itmSaleStatCd": "text",
                        "safeStkQty": 1,
                        "addSalePrc": 1,
                        "imgPathNm": "text",
                        "imgFileNm": "text",
                        "rgbVal": "text"
                      }
                    ]
                  }
                ]
              }
            ]
          }
        ]
      }
    ],
    "previewDate": "2026-01-01"
  },
  "prGoodsBase": {
    "goodsNo": 100000001,
    "lgcGoodsNo": 100000001,
    "entrNo": 1000001,
    "stdCtgNo": 1,
    "goodsCompCd": 10,
    "goodsTypCd": 10,
    "saleMethCd": 10,
    "brandNo": 1,
    "safeCertiTgtYn": "Y",
    "buyrAgeLmtCd": 0,
    "dispYn": "Y",
    "saleStatCd": 10,
    "saleStatChgCausCd": 41,
    "goodsRegDtm": "2021-01-01 00:00:00",
    "saleStrDtm": "2021-01-01 00:00:00",
    "saleEndDtm": "2029-01-01 00:00:00",
    "buyTypCd": 10,
    "taxGbCd": 10,
    "stkMgrYn": "Y",
    "buyQtyLmtYn": "Y",
    "minLmtQty": 1,
    "maxLmtQty": 10,
    "safeStkNotiYn": "Y",
    "deliProcTypCd": 10,
    "deliProcTypCdNm": "센터배송",
    "deliGoodsGbCd": "01",
    "deliGoodsGbCdNm": "일반상품",
    "deliWayCd": "01",
    "deliWayCdNm": "택배배송",
    "deliPsbRgnCd": "01",
    "deliPsbRgnCdNm": "전국",
    "deliDday": 1,
    "deliPolcNo": 1,
    "bpckPsbYn": "Y",
    "rtnPsbYn": "Y",
    "exchPsbYn": "Y",
    "hsCd": 123456,
    "rglrDeliGoodsYn": "Y",
    "frgnDirPurGoodsYn": "N",
    "szGdeUseYn": "Y",
    "szGdeRegMethodCd": 10,
    "szGdeCd": 10,
    "szGdeConts": "text",
    "prcCompaExpYn": "Y",
    "pkgGoodsPrioRnkCd": 10,
    "regInfPathCd": "01",
    "aprvReqDt": 20201231,
    "aprvDt": 20201231,
    "retnCausCd": 10,
    "retnCaus": "가격오류",
    "retnDt": "2026-01-01",
    "prestNm": "증정품목",
    "langCd": "ko",
    "goodsNm": "상품명",
    "modlNm": "모델명",
    "homeNm": "원산지명",
    "mfcoNm": "제조사명",
    "incomNm": "수입자명",
    "manufYm": 202301,
    "salemnNm": "판매자명",
    "schKwdNm": "검색키워드명",
    "adveWrd": "홍보문구",
    "aplyStrDtm": "2026-01-01T00:00:00.000Z",
    "aplyEndDtm": "2026-01-01T00:00:00.000Z",
    "saleMethCdNm": "판매방식코드명",
    "entrNm": "협력사명",
    "fwdidcPrarDy": 20210101,
    "rsvStrtDtm": "2024-01-01 00:00:00",
    "rsvEndDtm": "2024-01-31 23:59:59",
    "dispCtgNo": 462,
    "dispCtgNm": "여성_드레스",
    "norPrc": 1,
    "supPcost": 1,
    "orgSalePrc": 1,
    "orgTaxPrc": 1,
    "maxBenefitAmt": 1,
    "salePrc": 1,
    "saleTaxPrc": 1,
    "mrgnRate": "text",
    "goodsPrceTypCd": "text",
    "saleRate": 1,
    "gvgfPsbYn": "text",
    "milgRsrvPsbYn": "text",
    "entrGoodsNo": "text",
    "ordCnclPsbYn": "text",
    "wthdYn": "text",
    "ecpnAplyTermGbCd": "text",
    "ecpnIssuDdStdUseDds": 1,
    "ecpnUsePsbStrDt": "2026-01-01",
    "ecpnUsePsbEndDt": "2026-01-01",
    "timedealYn": "text",
    "histEndDtm": "2026-01-01"
  },
  "itmOptnNoArr": [
    "text"
  ]
}

상품 상세정보 조회

get

기능설명

상품의 상세정보를 조회하는 API입니다.

상세설명

상품의 상세페이지에서 상품정보를 상세 조회하기 위한 API입니다.
전시여부가 Y이고, 판매상태가 판매중/품절이고, 판매기간에 해당하는 상품을 조회합니다.
상품의 기본/단품/브랜드/이미지/가격/결제수단/연관상품/묶음상품/배송비정책/프로모션/증정품/리뷰별점통계 정보를 조회합니다.
쿠키에 저장된 언어코드, 사이트번호, 몰번호를 사용하여 조회합니다.

검증내용

0000 : API 조회가 성공적으로 동작한 경우입니다.
1001 : request에 상품번호가 없는 경우 발생하는 에러입니다.
5001 : 미리보기의 경우 request에 미리보기날짜가 'yyyyMMdd'형식에 맞지 않는 경우 발생하는 에러입니다.
5003 : 판매종료 / 존재하지 않는 상품 / 상품의 필수 데이터가 입력되지 않는 상품을 조회하는 경우 발생하는 에러입니다.
7010 : 구매 연령제한 만19세 이상 상품이지만, 로그인이 안된 경우 발생하는 에러입니다.
7060 : 구매 연령제한 만19세 이상 상품이고, 로그인한 사용자가 성인인증이 이루어 지지 않은 경우 발생하는 에러입니다.

수정번호

Release v1.02_231023: 마일리지적립가능여부(milgRsrvPsbYn) 변수추가, 선물하기가능여부(gvgfPsbYn) 변수추가

Release v1.03_231106: 사이즈가이드 관련 변수(szGdeUseYn, szGdeRegMethodCd, szGdeCd, szGdeConts) 추가, 아이콘(뱃지) 설정

Release v1.04_231120: 정기배송상품여부(rglrDeliGoodsYn) 추가, 묶음상품의 구매제한연령이 19금이 아닐 경우, 19금 상품을 목록에서 제외

Release v1.05_231204: 표준카테고리 관리속성 - 상품카테고리속성(prGoodsAttInfo) 추가

Release v2.00_240401:

예약상품 예약 시작일/종료일 추가
연관상품정보 내 가격정보, 판매상태코드 추가

Release v2.00_240627: 추가배송비정보(etAddDlexInfo) - 지역별 추가배송비 가격정보 추가

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

Header parameters

AuthorizationanyOptional

Access Token

Responses

200

상품 상세정보 조회 성공

*/*

상품+단품 검색결과 DTO

goodsNostringOptional

상품번호

langCdstringOptional

언어코드(CM009)

900

상품 상세정보 조회 실패

*/*

get/v1/detail/goodsDetail

GET /api/goods/v1/detail/goodsDetail?request=[object+Object] HTTP/1.1
Host: api-goods.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "goodsNo": "text",
  "langCd": "text",
  "prGoodsBase": {
    "goodsNo": 100000001,
    "lgcGoodsNo": 100000001,
    "entrNo": 1000001,
    "stdCtgNo": 1,
    "goodsCompCd": 10,
    "goodsTypCd": 10,
    "saleMethCd": 10,
    "brandNo": 1,
    "safeCertiTgtYn": "Y",
    "buyrAgeLmtCd": 0,
    "dispYn": "Y",
    "saleStatCd": 10,
    "saleStatChgCausCd": 41,
    "goodsRegDtm": "2021-01-01 00:00:00",
    "saleStrDtm": "2021-01-01 00:00:00",
    "saleEndDtm": "2029-01-01 00:00:00",
    "buyTypCd": 10,
    "taxGbCd": 10,
    "stkMgrYn": "Y",
    "buyQtyLmtYn": "Y",
    "minLmtQty": 1,
    "maxLmtQty": 10,
    "safeStkNotiYn": "Y",
    "deliProcTypCd": 10,
    "deliProcTypCdNm": "센터배송",
    "deliGoodsGbCd": "01",
    "deliGoodsGbCdNm": "일반상품",
    "deliWayCd": "01",
    "deliWayCdNm": "택배배송",
    "deliPsbRgnCd": "01",
    "deliPsbRgnCdNm": "전국",
    "deliDday": 1,
    "deliPolcNo": 1,
    "bpckPsbYn": "Y",
    "rtnPsbYn": "Y",
    "exchPsbYn": "Y",
    "hsCd": 123456,
    "rglrDeliGoodsYn": "Y",
    "frgnDirPurGoodsYn": "N",
    "szGdeUseYn": "Y",
    "szGdeRegMethodCd": 10,
    "szGdeCd": 10,
    "szGdeConts": "text",
    "prcCompaExpYn": "Y",
    "pkgGoodsPrioRnkCd": 10,
    "regInfPathCd": "01",
    "aprvReqDt": 20201231,
    "aprvDt": 20201231,
    "retnCausCd": 10,
    "retnCaus": "가격오류",
    "retnDt": "2026-01-01",
    "prestNm": "증정품목",
    "langCd": "ko",
    "goodsNm": "상품명",
    "modlNm": "모델명",
    "homeNm": "원산지명",
    "mfcoNm": "제조사명",
    "incomNm": "수입자명",
    "manufYm": 202301,
    "salemnNm": "판매자명",
    "schKwdNm": "검색키워드명",
    "adveWrd": "홍보문구",
    "aplyStrDtm": "2026-01-01T00:00:00.000Z",
    "aplyEndDtm": "2026-01-01T00:00:00.000Z",
    "saleMethCdNm": "판매방식코드명",
    "entrNm": "협력사명",
    "fwdidcPrarDy": 20210101,
    "rsvStrtDtm": "2024-01-01 00:00:00",
    "rsvEndDtm": "2024-01-31 23:59:59",
    "dispCtgNo": 462,
    "dispCtgNm": "여성_드레스",
    "norPrc": 1,
    "supPcost": 1,
    "orgSalePrc": 1,
    "orgTaxPrc": 1,
    "maxBenefitAmt": 1,
    "salePrc": 1,
    "saleTaxPrc": 1,
    "mrgnRate": "text",
    "goodsPrceTypCd": "text",
    "saleRate": 1,
    "gvgfPsbYn": "text",
    "milgRsrvPsbYn": "text",
    "entrGoodsNo": "text",
    "ordCnclPsbYn": "text",
    "wthdYn": "text",
    "ecpnAplyTermGbCd": "text",
    "ecpnIssuDdStdUseDds": 1,
    "ecpnUsePsbStrDt": "2026-01-01",
    "ecpnUsePsbEndDt": "2026-01-01",
    "timedealYn": "text",
    "histEndDtm": "2026-01-01"
  },
  "prBrandMst": {
    "brandNo": 1,
    "useYn": "Y",
    "brandImgPathNm": "text",
    "brandImgFileNm": "text",
    "langCd": "ko",
    "brandNm": "브랜드명",
    "brandDescCmt": "브랜드설명내용",
    "schKwdNm": "검색키워드명"
  },
  "prGoodsContInfo": [
    {
      "goodsNo": 100000001,
      "contTypCd": "01",
      "contSn": 1,
      "imgGbCd": 10,
      "dispSeq": 1,
      "contFilePathNm": 1,
      "contFileNm": 1,
      "trnfTextCont": 1,
      "useYn": "Y",
      "goodsDtlDesc": "상품상세설명"
    }
  ],
  "prGoodsPrceHist": [
    {
      "goodsNo": 100000001,
      "histStrDtm": "2021-01-01 00:00:00",
      "histEndDtm": "2025-01-01 00:00:00",
      "goodsPrceTypCd": "text",
      "supPcost": 10000,
      "norPrc": 20000,
      "salePrc": 15000,
      "mrgnRate": "20%",
      "prcChgCausCd": 10
    }
  ],
  "prItmBase": [
    {
      "goodsNo": 100000001,
      "itmNo": "001",
      "addSalePrc": 10000,
      "addMrgnRate": "20%",
      "limtQty": 100,
      "stkQty": 100,
      "itmSaleStatCd": 10,
      "dispSeq": 1,
      "safeStkQty": 10,
      "repItmYn": "Y",
      "saleStatChgCausCd": 41,
      "soutCausCd": 11,
      "lgcItmNo": 100000001,
      "optnCatNo1": 1,
      "optnNo1": 1,
      "optnCatNo2": 2,
      "optnNo2": 2,
      "optnCatNo3": 3,
      "optnNo3": 3,
      "optnCatNo4": 4,
      "optnNo4": 4,
      "optnCatNo5": "text",
      "optnNo5": "text",
      "langCd": "ko",
      "optnCatNm1": "색상",
      "optnNm1": "빨강",
      "optnCatNm2": "사이즈",
      "optnNm2": "XL",
      "optnCatNm3": "색상",
      "optnNm3": "파랑",
      "optnCatNm4": "사이즈",
      "optnNm4": "L",
      "optnCatNm5": "색상",
      "optnNm5": "노랑",
      "stkMgrYn": "Y"
    }
  ],
  "prGoodsPayMeanInfo": [
    {
      "goodsNo": 100000001,
      "payWayCd": 11,
      "payWayCdNm": "신용카드",
      "useYn": "Y",
      "langCd": "ko",
      "cdNm": "text",
      "cdDesc": "text"
    }
  ],
  "prGoodsItemInfo": [
    {
      "goodsNo": 100000001,
      "goodsNotiLisartCd": "text",
      "goodsNotiItemCd": "text",
      "langCd": "ko",
      "notiItemCmt": "text",
      "sortSeq": "text",
      "notiItemNm": "text",
      "goodsNotiLisartNm": "text"
    }
  ],
  "prGoodsSafeCertiHist": [
    {
      "goodsNo": 100000001,
      "safeCertiGbCd": "01",
      "safeCertiNm": "text",
      "safeCertiNo": "01",
      "aplyStrDt": "2021-01-01",
      "aplyEndDt": "2029-01-01",
      "safeCertiOrnNm": "안전인증기관명"
    }
  ],
  "prRelGoodsInfo": [
    {
      "baseGoodsNo": 100000001,
      "tgtGoodsNo": 100000002,
      "tgtGoodsNm": "대상상품명예시",
      "buyrAgeLmtCd": 0,
      "repYn": "Y",
      "sortSeq": 1
    }
  ],
  "prAssocGoodsInfo": [
    {
      "goodsNo": 1000476,
      "saleStatCd": 10,
      "asctGbCd": "text",
      "asctGoodsNo": 1000626,
      "sortSeq": 1,
      "goodsNm": "상품명",
      "brandNm": "Dior",
      "contFilePathNm": "text",
      "trnfTextCont": "text",
      "salePrc": 1500,
      "aplyPrc": 1300,
      "norPrc": 1800,
      "saleRate": 15,
      "buyrAgeLmtCd": 19,
      "iconJson": "text"
    }
  ],
  "etDeliPolcBase": {
    "deliPolcNo": 10000001,
    "entrNo": 1000001,
    "dlexTypCd": 10,
    "stdAmt": 2000,
    "dlexAmt": 2000,
    "wthdRtnAmt": 3000,
    "exchDlex": 3000,
    "useYn": "Y"
  },
  "etAddDlexInfo": [
    {
      "deliPolcNo": 10000001,
      "deliRegnGrpNo": 10,
      "deliRegnGrpNm": 10,
      "addDlexAmt": 2000
    }
  ],
  "etEntrBase": {
    "entrNo": 1000001,
    "entrNm": "협력사1",
    "entrGbCd": 10,
    "latt": 37.123456,
    "lngt": 127.123456,
    "trdTypCd": 10,
    "trdStatCd": 20,
    "lgcEntrNo": 1000001,
    "rpstmnNm": "홍길동",
    "bmanNo": "123-45-67890",
    "corpnNo": "123-45-67890",
    "btyp": "제조",
    "bkind": "식품",
    "contStrtDy": "2021-01-01",
    "contEndDy": "2029-12-31",
    "aempNm": "홍길동",
    "aempTelRgnNo": "02",
    "aempTelTxnoNo": 1234,
    "aempTelEndNo": 5678,
    "aempCellSctNo": "010",
    "aempCellTxnoNo": 1234,
    "aempCellEndNo": 5678,
    "faxRgnNo": "02",
    "faxTxnoNo": 1234,
    "faxEndNo": 5678,
    "bmanKindCd": 10,
    "zipNoSeq": 1,
    "zipNo": 123,
    "zipAddr": "서울시 강남구",
    "dtlAddr": "테헤란로 123",
    "rmkCont": "비고내용",
    "mrgnRateGbCd": 10,
    "mrgnRate1": 10,
    "mrgnRate2": 20
  },
  "promoList": [
    {
      "promoNo": "text",
      "promoNm": "text",
      "promoTypCd": "text",
      "dcAmt": 1
    }
  ],
  "revSummaryDto": {
    "goodsNo": "text",
    "goodsNm": "text",
    "totScr": 1,
    "avgScr": 1,
    "revTotCnt": 1,
    "totalRevCnt": "text",
    "photoVideoRevCnt": "text",
    "normalRevCnt": "text"
  },
  "productDetailIconInfo": [
    {
      "iconUrl": "text"
    }
  ],
  "prGoodsAttInfo": [
    {
      "langCd": "text",
      "goodsNo": "text",
      "attCd": "text",
      "attVal": "text",
      "stdCtgNo": "text",
      "attNm": "text"
    }
  ]
}

이전상품 Q&A 관리

다음상품공급협력사

마지막 업데이트 7개월 전