상품 공통

이미지 저장

post

기능설명

  • 상품 이미지를 등록합니다.


상세설명

  • 상품 이미지를 S3에 등록합니다.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
filesstring · binaryRequired

이미지 파일 목록

imageInfoImageInfoRequestV2Optional

이미지 정보 Request

Body
imageInfoImageInfoRequestV2Optional

이미지 정보 Request

Responses
chevron-right
200

OK

*/*

상품컨텐츠정보

goodsNostringOptional

상품번호

contTypCdstringOptional

컨텐츠유형코드(PR017) 01:상세설명, 02:동영상, 03:상품이미지

contSnstringOptional

컨텐츠일련번호

goodsDtlDescstringOptional

상품상세설명

imgGbCdstringOptional

이미지구분코드(PR031) P10:기본이미지, P20:추가이미지, M10:동영상

dispSeqinteger · int32Optional

전시순서

contFilePathNmstringOptional

컨텐츠파일경로명

contFileNmstringOptional

컨텐츠파일명

trnfTextContstringOptional

대체텍스트내용

useYnstringOptional

사용여부

packageSubImageRegistDefaultValueinteger · int32Write-onlyOptional
post
/v2/goods/goodsCommonApi/uploadGoodsImage
200

OK

상품 다국어 정보 등록/수정

post

기능설명

  • 상품의 다국어 정보를 등록/수정합니다.


상세설명

  • 상품의 다국어 정보들 등록하거나 수정합니다.

  • 필수값을 모두 입력하지 않은 경우 오류 메시지를 보냅니다.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
requestGeneralGoodsCUDRequestV2Optional

상품 다국어 정보 Request

Body

일반상품 상세 Request

Responses
chevron-right
200

상품 다국어 정보 등록/수정 성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

post
/v2/goods/goodsCommonApi/registGoodsMultiLanguage

묶음상품 수정

post

기능설명

  • 묶음상품 정보를 수정합니다.


상세설명

  • 묶음상품 정보를 수정합니다.

  • 판매상태가 종료인 상품은 상품정보를 수정할 수 없습니다.

  • 필수값을 모두 입력하지 않은 경우 오류 메시지를 보냅니다.


수정번호

Release v1.04_231120

  • 묶음상품 구입자나이제한코드(buyrAgeLmtCd) 추가

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
requestPackageGoodsCUDRequestOptional

묶음상품정보 Request

Body

묶음상품 상세 Requset

Responses
chevron-right
200

묶음상품 수정 성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

post
/v2/goods/goodsCommonApi/modifyPackageGoods

상품정보 일괄수정

post

기능설명

  • 선택한 상품들의 전시카테고리, 홍보문구를 일괄 수정합니다.


상세설명

  • 선택한 상품들의 전시카테고리 또는 홍보문구를 일괄 수정합니다.

  • 홍보문구를 수정하는 경우 기존 홍보문구를 삭제하고 요청한 홍보문구로 변경합니다.


코드정리

  • target : 'dispCtg' : 전시카테고리, 'adveWrd' : 홍보문구

  • state : 'U' : 업데이트, 'D' : 삭제

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
requestGoodsMgmtInfoSaveApiRequestOptional
Body

상품관리 일관변경 Requsest

goodsNoListstring[]Optional

상품번호 목록

Responses
chevron-right
200

상품정보 일괄수정 성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

post
/v2/goods/goodsCommonApi/modifyGoodsInfo

사은품 수정

post

기능설명

  • 사은품 정보를 수정합니다.


상세설명

  • 사은품 정보를 수정합니다.

  • 판매상태가 종료인 사은품은 사은품정보를 수정할 수 없습니다.

  • 필수값을 모두 입력하지 않은 경우 오류 메시지를 보냅니다.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
requestGiftGoodsCUDRequestOptional

사은품정보 Request

Body

사은품 등록/수정 Request

Responses
chevron-right
200

사은품 수정 성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

post
/v2/goods/goodsCommonApi/modifyGiftGoods

일반상품 수정

post

기능설명

  • 일반상품 정보를 수정합니다.


상세설명

  • 일반상품 정보를 수정합니다.

  • 판매상태를 품절로 변경 시 상품과 상품 내 판매중인 모든 단품의 판매상태가 품절로 변경되며, 품절사유는 '관리자 품절' 사유로 저장됩니다.

  • 판매상태가 종료인 상품은 상품정보를 수정할 수 없습니다.

  • 예약판매 중인 상품의 판매상태가 품절인 경우 판매중으로 변경할 수 없습니다.

  • 필수값을 모두 입력하지 않은 경우 오류 메시지를 보냅니다.


수정번호

Release v1.02_231023

  • 선물하기가능여부(gvgfPsbYn) 변수추가

Release v1.03_231106

  • 사이즈 가이드 관련 컬럼(szGdeUseYn, szGdeRegMethodCd, szGdeCd, szGdeConts) 추가

  • 아이콘(뱃지) 설정 추가

Release v1.04_231120

  • 임시저장 시 validation 수정 및 대체값 추가

  • 임시저장 시 단품 옵션 추가/삭제 로직 추가

  • 아이콘(뱃지) 설정 기능 개선

  • 정기배송상품여부 컬럼(rglrDeliGoodsYn) 추가

Release v1.05_231204

  • 상품등록 및 상품상세팝업에 표준카테고리 관리속성 추가

Release v1.06_251020

  • 임시저장 or 승인대기 상품의 경우 이미 등록된 상품가격 마진율에 따라 단품정보 공급가 재계산

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
requestGeneralGoodsCUDRequestV2Optional

일반상품정보 Request

Body

일반상품 상세 Request

Responses
chevron-right
200

일반상품 수정 성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

post
/v2/goods/goodsCommonApi/modifyGeneralGoods

가격 변경 예약 등록/취소

post

기능설명

  • 가격 변경 예약을 등록 또는 취소합니다.


상세설명

  • 가격 변경 예약을 등록하거나 취소합니다.

  • 가격변경요청코드(rsvCudStat)에 따라 등록과 취소를 구분합니다.

  • 기존에 가격 변경 예약이 등록되어 있는 경우 기존 등록된 항목을 삭제하고 요청한 정보를 등록합니다.

  • 등록의 경우 필수값을 모두 입력해야합니다.

  • 공급원가, 정상가, 판매가, 마진율, 이력시작일시, 가격변경사유코드(PR033)


코드정리

  • 가격변경요청코드 : C:등록, D:취소

수정번호

Release v2.00_240827

  • 판매가/행사가 통합

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body

상품가격이력 Request

goodsNostringOptional

상품번호

histEndDtmstring · dateOptional

이력종료일시

histStrDtmstring · dateOptional

이력시작일시

supPcostnumberOptional

공급원가

norPrcnumberOptional

정상가

salePrcnumberOptional

판매가

mrgnRatenumberOptional

마진율

goodsPrceTypCdstringOptional

상품가격유형코드

prcChgCausCdstringOptional

가격변경사유코드(PR033)

rsvCudStatstringOptional

가격변경요청코드

timeDealYnstringOptional

타임딜여부

supPcostByMrgnnumberWrite-onlyOptional
Responses
chevron-right
200

가격 변경 예약 등록/취소 성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

post
/v1/goods/goodsCommontApi/modifyGeneralGoodsPriceReservation

아이콘 정보 조회

get

기능설명

  • 상품에 등록된 아이콘 정보를 조회합니다.


상세설명

  • 상품에 등록된 아이콘 정보를 조회합니다.


특이사항

  • NEW, BEST 아이콘은 수동 등록이 아니라 쿼리 조회시마다 노출 여부가 결정됩니다.


수정번호

Release v1.05_231204

  • 스프린트5 PO1 결함/개선 - 아이콘 이미지 쿼리 수정

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
Responses
chevron-right
200

상품 아이콘 정보 조회 성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

get
/v2/goods/goodsCommonApi/getPrGoodsIconInfoList

묶음상품 정보 조회

get

기능설명

  • 묶음상품 정보를 조회합니다.


상세설명

  • 묶음상품의 상품정보를 조회합니다.


수정번호

Release v1.05_231204

  • 전시 상품 조회 쿼리 inner join으로 변경

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
Responses
chevron-right
200

상품정보 조회 성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

get
/v2/goods/goodsCommonApi/getPackageGoodsInfo

단품 옵션목록 조회

get

기능설명

  • 단품 옵션목록을 조회합니다.


상세설명

  • 단품 옵션목록을 조회합니다.


수정번호

Release v1.03_231106

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

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
Responses
chevron-right
200

단품 옵션목록 조회 성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

get
/v2/goods/goodsCommonApi/getItemOptionList

단품 판매상태 목록 조회

get

기능설명

  • 단품 판매상태 목록을 조회합니다.


상세설명

  • 단품 판매상태 목록을 조회합니다.


수정번호

Release v1.03_231106

  • 단품 판매상태 목록 조회 API 추가

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
goodsNoStringRequired

상품번호

Responses
chevron-right
200

단품 판매상태 목록 조회 성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

get
/v2/goods/goodsCommonApi/getGoodsSaleStateList

상품고시항목 목록 조회

get

기능설명

  • 상품등록/수정/상세 페이지에서 필요한 상품고시항목 목록을 조회합니다.


상세설명

  • 상품고시항목코드에 따른 상품고시항목의 목록을 조회합니다.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
goodsNotiLisartCdStringOptional

상품고시품목코드

langCdStringOptional

언어코드

Responses
chevron-right
200

상품고시항목 조회 성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

get
/v2/goods/goodsCommonApi/getGoodsNotificationItemList

상품 다국어 정보 조회

get

기능설명

  • 상품의 다국어 정보를 조회합니다.


상세설명

  • 상품에 현재 등록된 모든 다국어 정보를 리스트로 조회합니다.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
goodsNoStringRequired

상품번호

Responses
chevron-right
200

상품 다국어 정보 조회 성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

get
/v2/goods/goodsCommonApi/getGoodsMultiLanguageInfo

상품 카테고리 속성 목록 조회

get

기능설명

  • 상품등록/수정/상세 페이지에서 필요한 상품 카테고리 속성 목록을 조회합니다.


상세설명

  • 표준카테고리에 매핑한 상품속성정보 목록을 조회합니다.


수정번호

Release v1.05_231204

  • 표준카테고리 관리속성 추가에 따른 신규 API 생성

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
Responses
chevron-right
200

상품 카테고리 속성 조회 성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

get
/v2/goods/goodsCommonApi/getGoodsCtgAttInfoList

상품 기본 정보 조회

get

기능설명

  • 상품 기본 정보를 조회합니다.


상세설명

  • 상품 기본 정보를 조회합니다.


수정번호

Release v1.04_231120: 묶음상품 구입자나이제한코드(buyrAgeLmtCd) 추가

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
goodsNostringRequired
langCdstringOptionalDefault: ko
Responses
chevron-right
200

상품정보 조회 성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

get
/v2/goods/goodsCommonApi/getGoodsBaseInfo

사은품 정보 조회

get

기능설명

  • 사은품 정보를 조회합니다.


상세설명

  • 사은품 정보를 조회합니다.


상세설명

  • 사은품의 상품정보를 조회합니다.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
goodsNostringRequired
langCdstringOptionalDefault: ko
Responses
chevron-right
200

상품정보 조회 성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

get
/v2/goods/goodsCommonApi/getGiftGoodsInfo

일반상품 정보 조회

get

기능설명

  • 일반상품 정보를 조회합니다.


상세설명

  • 일반상품의 상품정보를 조회합니다.


수정번호

Release v1.03_231106

  • 사이즈 가이드 관련 컬럼(szGdeUseYn, szGdeRegMethodCd, szGdeCd, szGdeConts) 추가

  • 아이콘(뱃지) 설정 추가

Release v1.04_231120

  • 판매상태 임시저장인 상품 조회 시 대체텍스트를 빈 값으로 반환하도록 수정

  • 정기배송상품여부 컬럼(rglrDeliGoodsYn) 추가 Release v1.05_231204

  • 전시 상품 조회 쿼리 inner join으로 변경

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
goodsNoStringRequired

상품번호

langCdStringOptional

언어코드

Responses
chevron-right
200

상품정보 조회 성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

get
/v2/goods/goodsCommonApi/getGeneralGoodsInfo

협력사 기본 정보 조회

get

기능설명

  • 상품등록/수정/상세 페이지에서 필요한 협력사 기본 정보를 조회합니다.


상세설명

  • 협력사 번호에 따른 협력사 기본 정보를 조회합니다.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
entrNoStringOptional

협력사번호

Responses
chevron-right
200

협력사 기본 정보 조회 성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

get
/v2/goods/goodsCommonApi/getEtEntrBase

표준카테고리별 전시카테고리 목록 조회

get

기능설명

  • 표준카테고리별 전시카테고리 목록을 조회합니다.


상세설명

  • 표준카테고리별 전시카테고리 목록을 조회합니다.


수정번호

Release v1.05_231204

  • 표준카테고리전시정보 목록 조회 쿼리 goodsNo가 없을 경우 삭제

  • 전시 카테고리 사용 여부 조건 추가

  • 표준 전시 카테고리 연결 삭제 여부 조건 추가

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
Responses
chevron-right
200

표준카테고리별 전시카테고리 목록 조회 성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

get
/v2/goods/goodsCommonApi/getDisplayCategoryListByStandardCategory

배송비/반품비 정책 목록 조회

get

기능설명

  • 상품등록/수정/상세 페이지에서 필요한 배송비/반품비 정책 목록을 조회합니다


상세설명

  • 협력사에 따른 배송비/반품비 정책 목록을 조회합니다.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
entrNoStringRequired

협력사번호

Responses
chevron-right
200

배송비/반품비 정책 목록 조회 성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

get
/v2/goods/goodsCommonApi/getDeliveryPolicyList

적용 중인 가격 조회

get

기능설명

  • 날짜 기준으로 적용 중인 가격를 조회합니다.


상세설명

  • 상품에 날짜기준으로 적용중인 행사가 정보를 조회합니다.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
goodsNoStringOptional

상품번호

Responses
chevron-right
200

적용 중인 가격 조회 성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

get
/v1/goods/goodsCommontApi/getGoodsPrePriceHistory

가격이력 정보 조회

get

기능설명

  • 가격이력 정보를 조회합니다.


상세설명

  • 일반상품의 가격이력을 조회합니다.


수정번호

Release v2.00_240808

  • 일반상품 정보 조회에서 분할 Release v1.06_250609

  • 타임딜 정보 조회 추가

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
goodsNoStringRequired

상품번호

langCdStringOptional

언어코드

Responses
chevron-right
200

상품정보 조회 성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

get
/v1/goods/goodsCommontApi/getGeneralGoodsPriceHist

Last updated