일반상품 등록

일반상품 등록

post

기능설명

  • 일반상품을 임시저장/승인요청 합니다.


상세설명

  • 일반상품 정보를 임시저장/승인요청 합니다.

  • 승인요청 시에는 필수값을 모두 입력하지 않으면 오류를 반환합니다.

  • 임시저장 시에는 필수값 중 아래 항목만 검증합니다.

    • 협력사 번호, 협력사명

    • 표준카테고리

    • 예약상품인 경우 예약주문 가능기간, 예약상품 출고지시일

    • 상품명

    • 검색키워드 사용인 경우 검색 키워드

    • 임시저장시 상품고시품목정보, 과/면세 구분, 정상가, 판매가 밸리데이션 제외


수정번호

Release v1.02_231023

  • 마일리지적립가능여부(milgRsrvPsbYn) 변수추가

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

Release v1.03_231106

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

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

Release v1.04_231120

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

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

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

Release v1.05_241125

  • 임시저장 시 validation 수정

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

일반상품정보 Request

Body

일반상품 등록 Request

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-쿠폰사용가능종료일자

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/generalGoodsApi/registTemporaryGeneralGoods

표준카테고리 마진율 사용여부 조회

get

기능설명

  • 시스템 설정상 표준카테고리 마진율 사용여부 조회


상세설명

  • application.yml에 세팅되어 있는 표준카테고리 마진율 사용여부 조회해서 반환

  • 상품 등록시 공급가 설정 및 BO내 UI 데이터(협력사, 카테고리) 설정 분기점 위해서 조회


Release v1.00_251020

  • 표준카테고리 마진율 적용여부 조회

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

카테고리 마진율 사용여부 조회 성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

get
/v2/goods/generalGoodsApi/getUseCateMrgnRate

일반상품 복사

get

일반상품을 복사하여 상품등록 화면에 노출한다.

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

상품번호

Responses
chevron-right
200

OK

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

get
/v2/goods/generalGoodsApi/copyGeneralGoods
200

OK

Last updated