상품

굿웨어몰 상품 연동을 위한 다양한 API를 제공하고 있습니다.

POST/v1/product/category/list

1. 카테고리 조회

굿웨어몰의 카테고리 목록을 조회합니다.

옵션 파라미터

Name
leafCtgryYn
Children
최하위(Leaf) 카테고리 여부
Type
string
Name
representYn
Children
대표 전시 카테고리 여부
Type
string

응답 모델

프로퍼티명	설명	타입	상위객체
data	카테고리 목록 Array	Array	N/A
dspCtgryNo	전시 카테고리 번호	String	data
level	카테고리 레벨	Number	data
upperDspCtgryNo	상위 전시 카테고리 번호	String	data
dspCtgryNm	전시 카테고리명	String	data
dspCtgryPath	전시 카테고리 경로	String	data
leafCtgryYn	최하위 카테고리 여부	String	data
representYn	대표 전시 카테고리 여부	String	data

Request

POST

/v1/product/category/list

curl -X POST "https://store-api.goodwearmall.com/v1/product/category/list" \
    -H "Authorization: ${API_AUTH_INFO}" \
    -H "Content-Type: application/json" \
    -d '{"leafCtgryYn":"Y"}'

Response

{
    "data": [
        {
            "dspCtgryNo": "SSMA01A01A01",
            "level": 4,
            "upperDspCtgryNo": "SSMA01A01",
            "dspCtgryNm": "반소매",
            "dspCtgryPath": "여성>티셔츠>반소매",
            "leafCtgryYn": "Y",
            "representYn": "N"
        },
        {
            "dspCtgryNo": "SSMA01A01A02",
            "level": 4,
            "upperDspCtgryNo": "SSMA01A02",
            "dspCtgryNm": "긴소매",
            "dspCtgryPath": "여성>티셔츠>긴소매",
            "leafCtgryYn": "Y",
            "representYn": "Y"
        },
        ...
    ]
}

POST/v1/product/brand/list

2. 브랜드 조회

등록된 브랜드의 목록을 조회할 수 있습니다.

옵션 파라미터

Name
brndId
Children
브랜드 ID
Type
string
Name
useYn
Children
사용 여부
Type
string
Name
pageNo
Children
조회 페이지
Type
int
Name
limitCnt
Children
페이지당 표시 개수
Type
int

응답 모델

프로퍼티명	설명	타입	상위객체
data	브랜드 목록 Array	Array	N/A
brndId	브랜드 ID	String	data
upperBrndId	상위 브랜드 ID	String	data
brndNm	브랜드명	String	data
naBrndNm	브랜드 경로	String	data
brndLevel	브랜드 레벨	Number	data
stdSizeUseYn	표준 사이즈 사용 여부	String	data
ovseaSlrBrndYn	해외 판매자 브랜드 여부	String	data
useYn	브랜드 사용 여부	String	data
brndGrpYn	브랜드 그룹 사용 여부	String	data
brndKorFlterNm	브랜드 한국어 필터명	String	data
pageNo	현재 페이지	Number	N/A
pageSize	페이지당 표시 개수	Number	N/A
totalCount	전체 개수	Number	N/A
totalPage	전체 페이지 수	Number	N/A

Request

POST

/v1/product/brand/list

curl -X POST "https://store-api.goodwearmall.com/v1/product/brand/list" \
    -H "Authorization: ${API_AUTH_INFO}" \
    -H "Content-Type: application/json" \
    -d '{"brndId":"testBrand", "useYn":"Y"}'

Response

{
    "data": [
        {
            "brndId": "TEST",
            "upperBrndId": "TEST",
            "brndNm": "TEST",
            "naBrndNm": "FOO BRAND > TEST BRANDS > TEST BRAND",
            "brndLevel": 3,
            "stdSizeUseYn": "Y",
            "ovseaSlrBrndYn": "N",
            "useYn": "Y",
            "brndGrpYn": "N",
            "brndKorFlterNm": "테스트"
        }
    ],
    "pageNo": 1,
    "pageSize": 50,
    "totalCount": 1,
    "totalPage": 1
}

POST/v1/product/list

3. 상품 목록 조회

상품 목록을 조회할 수 있습니다.

옵션 파라미터

Name
godNos
Children
굿웨어몰 상품 번호
Type
array of string
Name
brndId
Children
브랜드 ID
Type
string
Name
pageNo
Children
조회 페이지
Type
int
Name
limitCnt
Children
페이지당 표시 개수
Type
int

응답 모델

프로퍼티명	설명	타입	상위객체
data	상품 목록 Array	Array	N/A
godAprvSectCd	상품 승인 구분 코드	String	data
godAprvSectNm	상품 승인 구분명	String	data
godNo	굿웨어몰 상품 번호	String	data
itmNo	굿웨어몰 단품 번호	String	data
itmNm	단품명	String	data
skuNo	SKU	String	data
godNm	상품명	String	data
brndNm	브랜드명	String	data
cvrPrc	정상가	Number	data
godSaleSectCd	상품 판매 구분 코드	String	data
godSaleSectNm	상품 판매 구분 코드명	String	data
godCnsgnComFeeRt	입점 업체 수수료율	String	data
godResveCnsgnComFeeRt	예약 입점 업체 수수료율	String	data
dspYn	전시 여부	String	data
dspYnNm	전시 여부명	String	data
optNm1	옵션1명	String	data
optValNm1	옵션1값명	String	data
optNm2	옵션2명	String	data
optValNm2	옵션2값명	String	data
optNm3	옵션3명	String	data
optValNm3	옵션3값명	String	data
itmStatCd	단품 상태 코드	String	data
itmStatNm	단품 상태 코드명	String	data
mnfctTpCd	제작 유형 코드	String	data
mnfctTpNm	제작 유형 코드명	String	data
godTpCd	상품 유형 코드	String	data
godTpNm	상품 유형 코드명	String	data
itmUseYn	단품 사용 여부	String	data
optAmtYn	옵션가 등록 여부	String	data
optAmt	옵션가	Number	data
saleTpCd	판매 유형 코드	String	data
saleTpNm	판매 유형 코드명	String	data
resveOrdDlivyPrearngeDate	예약 배송일	String	data
stdCtgryNmPath	표준 카테고리 뎁스	String	data
saleBegDateRep	판매 시작일	String	data
saleEndDateRep	판매 종료일	String	data
brndId	브랜드ID	String	data
imgExistYn	이미지 존재 여부	String	data
imgUrl	이미지 URL	String	data
totUsefulInvQty	총 가용 재고 수량	Number	data
currSalePrc	할인가	Number	data
saleDetailBegDate	예약 판매 시작 일시	String	data
saleDetailEndDate	예약 판매 종료 일시	String	data
saleBegDate	판매 시작일	String	data
saleEndDate	판매 종료일	String	data
comGodNo	업체 상품 번호	String	data
pageNo	현재 페이지	Number	N/A
pageSize	페이지당 표시 개수	Number	N/A
totalCount	전체 개수	Number	N/A
totalPage	전체 페이지 수	Number	N/A

Request

POST

/v1/product/list

curl -X POST "https://store-api.goodwearmall.com/v1/product/list" \
    -H "Authorization: ${API_AUTH_INFO}" \
    -H "Content-Type: application/json" \
    -d '{"godNos":["1P000000000000"], "brndId":"TEST"}'

Response

{
    "data": [
        {
            "godAprvSectCd": "APRV_REJ",
            "godAprvSectNm": "승인거부",
            "godNo": "1P000000000000",
            "itmNo": "IT123456789000000",
            "itmNm": "TEST",
            "skuNo": "IT123456789000000",
            "godNm": "TEST",
            "brndNm": "TEST",
            "cvrPrc": 0,
            "godSaleSectCd": "SALE_END",
            "godSaleSectNm": "판매 종료",
            "godCnsgnComFeeRt": 24,
            "godResveCnsgnComFeeRt": 24,
            "dspYn": "N",
            "dspYnNm": "미전시",
            "optNm1": "사이즈",
            "optValNm1": "L",
            "optNm2": "색상",
            "optValNm2": "BK",
            "optNm3": null,
            "optValNm3": null,
            "itmStatCd": "SALE_END",
            "itmStatNm": "판매 종료",
            "mnfctTpCd": "RDMD_GOD",
			"mnfctTpNm": "기성상품",
            "godTpCd": "GNRL_GOD",
			"godTpNm": "일반상품",
            "itmUseYn": "Y",
            "optAmtYn": "YES",
            "optAmt": 0,
			"saleTpCd": "GNRL_SALE",
            "saleTpNm": "일반판매",
            "resveOrdDlivyPrearngeDate": "",
            "stdCtgryNmPath": "신성통상>카테고리1>카테고리2",
            "saleBegDateRep": "",
            "saleEndDateRep": "",
            "brndId": "TEST",
            "imgExistYn": "없음",
            "imgUrl": null,
            "totUsefulInvQty": 999,
            "currSalePrc": 0,
            "saleDetailBegDate": "",
            "saleDetailEndDate": "",
            "saleBegDate": "",
            "saleEndDate": "",
            "comGodNo": "TEST"
        },
        ...
    ],
    "pageNo": 1,
    "pageSize": 50,
    "totalCount": 6,
    "totalPage": 1
}

POST/v1/product/detail

4. 상품 상세 조회

상품 상세 정보를 조회할 수 있습니다.

필수 파라미터

Name
godNo
Children
굿웨어몰 상품 번호
Type
string

응답 모델

프로퍼티명	설명	타입	상위 객체
data	상품 상세정보	Object	N/A
godNo	굿웨어몰 상품 번호	String	data
comOrdNo	업체 상품 번호	String	data
godNm	상품명	String	data
godDetailCont	상품 상세	String	data
brndId	브랜드 ID	String	data
brndNm	브랜드명	String	data
stdCtgryNo	표준 카테고리 코드	String	data
stdCtgryNm	표준 카테고리명	String	data
cvrPrc	정상가	Number	data
salePrc	판매가	Number	data
godSaleSectCd	판매 상태 코드	String	data
godSaleSectNm	판매 상태 코드명	String	data
godAprvSectCd	승인 상태 코드	String	data
godAprvSectNm	승인 상태 코드명	String	data
dspYn	전시 여부	String	data
saleBegDate	판매 시작 일자	String	data
saleEndDate	판매 종료 일자	String	data
resveBegDt	예약 시작 일자	String	data
resveEndDt	예약 종료 일자	String	data
resveSalePrc	기간가	Number	data
minOrdQty	최소 구매 가능 수량	Number	data
maxOrdQty	최대 구매 가능 수량	Number	data
godDlivyDay	배송 소요일	String	data
dmstcDlvCstPlcSn	배송 정책 코드	Number	data
dlvPlcNm	배송 정책명	String	data
dmstcDlvCstExmStdrAmt	배송비 면제 기준 금액	Number	data
dmstcDlvCst	배송비	Number	data
otskrAditDlvCstLevyYn	도서 산간 추가 배송비 부과 여부	String	data
otskrDlvCst	도서 산간 배송비	Number	data
buyerImptExchgDlvCst	구매자 귀책 교환 배송비	Number	data
buyerImptRtgodDlvCst	구매자 귀책 반품 배송비	Number	data
imageList	이미지 리스트	Array	data
imgTpCd	이미지 타입	String	imageList
imgTpNm	이미지 타입명	String	imageList
imgUrl	이미지 url	String	imageList
imgDscr	이미지 설명	String	imageList
dspCategoryList	전시 카테고리 리스트	Array	data
ctgrySectCd	카테고리 구분 코드	String	dspCategoryList
ctgrySectNm	카테고리 구분 코드명	String	dspCategoryList
dspCtgryNo	전시 카테고리 코드	String	dspCategoryList
dspCtgryNm	전시 카테고리명	String	dspCategoryList
ntfcInfoList	상품 정보 고시 리스트	Array	data
ntfcCd	정보고시코드	String	ntfcInfoList
ntfcNm	정보고시명	String	ntfcInfoList
ntfcVal	정보고시값	String	ntfcInfoList
essntlYn	필수 여부	String	ntfcInfoList
optionList	옵션 리스트	Array	data
itmNo	굿웨어몰 단품 번호	String	optionList
comItmNo	업체 단품번호	String	optionList
itmStatCd	단품 상태	String	optionList
itmStatNm	단품 상태명	String	optionList
optNm1	옵션1명	String	optionList
optVal1	옵션1값	String	optionList
optNm2	옵션2명	String	optionList
optVal2	옵션2값	String	optionList
stock	재고	Number	optionList
optPrc	옵션가	Number	optionList

Request

POST

/v1/product/detail

curl -X POST "https://store-api.goodwearmall.com/v1/product/detail" \
    -H "Authorization: ${API_AUTH_INFO}" \
    -H "Content-Type: application/json" \
    -d '{"godNo":"1P000000000000"}'

Response

{
    "data": {
        "godNo": "1P000000000000",
        "comOrdNo": "",
        "godNm": "TEST",
        "godDetailCont": "TEST",
        "brndId": "TEST",
        "brndNm": "TEST",
        "stdCtgryNo": "A01A02A03A04",
        "stdCtgryNm": "신성통상>카테고리1>카테고리2>카테고리3>카테고리4",
        "cvrPrc": 9999.00,
        "salePrc": 9999.00,
		"godSaleSectCd": "SALE_END",
		"godSaleSectNm": "판매 종료",
		"godAprvSectCd": "APRV_REJ",
		"godAprvSectNm": "승인거부",
        "dspYn": "Y",
        "saleBegDate": "20250101",
        "saleEndDate": "20991231",
        "resveBegDt": "2025-01-01T00:00:00.000+00:00",
        "resveEndDt": "2099-12-31T23:59:59.000+00:00",
        "resveSalePrc": 9999.00,
        "minOrdQty": 1,
        "maxOrdQty": 9999,
        "godDlivyDay": "3",
        "dmstcDlvCstPlcSn": 000,
        "dlvPlcNm": "TEST",
        "dmstcDlvCstExmStdrAmt": 1.00,
        "dmstcDlvCst": 2500.00,
        "otskrAditDlvCstLevyYn": "N",
        "otskrDlvCst": 0.00,
        "buyerImptExchgDlvCst": 9999.00,
        "buyerImptRtgodDlvCst": 9999.00,
        "imageList": [
            {
				"imgTpCd": "THNAIL",
				"imgTpNm": "섬네일",
                "imgUrl": "/goods/1P0000/1P000000000000_1.jpg",
                "imgDscr": "썸네일 이미지 컷"
            }
        ],
        "dspCategoryList": [
            {
				"ctgrySectCd": "GNRL_CTGRY",
				"ctgrySectNm": "일반 카테고리",
                "dspCtgryNo": "SSMA01A02A03",
                "dspCtgryNm": "카테고리1>카테고리2>카테고리3"
            },
            ...
        ],
        "ntfcList": [
            {
				"ntfcCd": "NTFC_PRDNM",
				"ntfcNm": "품명 및 모델명",
                "ntfcVal": "상품상세 참조",
                "essntlYn": "Y"
            },
            ...
        ],
        "optionList": [        
            {
                "itmNo": "1P000000000000",
                "comItmNo": null,
				"itmStatCd": "SALE_END",
				"itmStatNm": "판매 종료",
                "optNm1": "사이즈",
                "optVal1": "L",
                "optNm2": "색상",
                "optVal2": "BK",
                "stock": 999,
                "optPrc": 0.00
            },
            ...
        ]
    }
}

POST/v1/product/register

5. 상품 등록

굿웨어몰에 상품을 등록합니다.

필수 파라미터

Name
comGodNo
Children
업체 상품 번호
Type
string
Name
brndId
Children
브랜드 ID
Type
string

Name: dspCtgryNos
Children: 전시 카테고리 코드 Array
Type: array of object
Description

Name
dspCtgryNo
Children
전시 카테고리 코드
Type
string
Description
Name
representYn
Children
대표 전시 카테고리 여부
Type
string
Description

Name
godNm
Children
상품명
Type
string
Name
cvrPrc
Children
정상가
Type
int
Enum
tdfSect
Children
과면세 구분
Type
enum
Enum
kcCrtfcTgtCd
Children
KC안전인증 대상 여부
Type
enum
Name
saleBegDate
Children
판매 시작일
Type
string
Name
saleEndDate
Children
판매 종료일
Type
string
Name
minOrdQty
Children
최소 구매 가능 수량
Type
int
Name
maxOrdQty
Children
최대 구매 가능 수량
Type
int
Name
buyAgeLmitCd
Children
미성년자 구매 가능 여부
Type
string
Name
godDlivyWaitDay
Children
배송 소요일
Type
int
Name
otskrDlvPsbYn
Children
도서산간 배송 가능 여부
Type
string
Name
sumPkgPsbYn
Children
합포장 가능 여부
Type
string

Name: opt
Children: 옵션
Type: object
Description

Enum
type
Children
옵션 구성
Type
enum
Description

Name: opt1
Children: 옵션1 Array
Type: array of object
Description

Name
nm
Children
옵션1명
Type
string
Description
Name
values
Children
옵션1값
Type
array of string
Description

Name: opt2
Children: 옵션2 Array
Type: array of object
Description

Name
nm
Children
옵션2명
Type
string
Description
Name
values
Children
옵션2값
Type
array of string
Description

Name: items
Children: 옵션 정보 Array
Type: array of object
Description

Name
opt1
Children
옵션1
Type
string
Description
Name
opt2
Children
옵션2
Type
array of string
Description

Name
mnfcturNationNm
Children
상품정보제공고시 제조국(원산지)
Type
string
Name
mnfcturYm
Children
상품정보제공고시 제조연월
Type
string
Name
matrNm
Children
상품정보제공고시 소재
Type
string
Name
makerNm
Children
상품정보제공고시 제조자
Type
string

옵션 파라미터

Name
comModelNm
Children
상품 모델명
Type
string
Name
godWt
Children
무게
Type
string
Enum
sesonCd
Children
시즌 구분
Type
enum
Enum
kcCrtfcExmCd
Children
KC안전인증 면제 사유
Type
enum
Enum
kcCrtfcSectCd
Children
KC안전인증 종류
Type
enum
Name
kcCrtfcNo
Children
KC안전인증번호
Type
string
Name
kcCrtfcDate
Children
KC안전인증일자
Type
string
Name
godDetailDscr
Children
상품 상세 설명
Type
string
Name
dmstcDlvCstPlcSn
Children
배송정책
Type
int

응답 모델

프로퍼티명	설명	타입	상위객체
message	결과 메세지	String	N/A
godNo	굿웨어몰 상품 번호	String	N/A
comGodNo	입점사 상품 번호	String	N/A
itmInfos	단품 정보 리스트	Array	N/A
comItmNo	입점사 단품 번호	String	itmInfos
itmNo	굿웨어몰 단품 번호	String	itmInfos
itmNm	단품명	String	itmInfos

Request

POST

/v1/product/register

curl -X POST "https://store-api.goodwearmall.com/v1/product/register" \
    -H "Authorization: ${API_AUTH_INFO}" \
    -H "Content-Type: application/json" \
    -d '{"comGodNo":"업체상품번호","brndId":"브랜드ID","dspCtgryNos":[{"dspCtgryNo":"전시카테고리","representYn":"Y"}],"godNm":"상품명","cvrPrc":00000,"comModelNm":"","godWt":"","tdfSect":"TAXAT","sesonCd":"","kcCrtfcTgtCd":"","kcCrtfcExmCd":"","kcCrtfcSectCd":"","kcCrtfcNo":"","kcCrtfcDate":"","saleBegDate":"판매시작일","saleEndDate":"판매종료일","minOrdQty":0,"maxOrdQty":0000,"buyAgeLmitCd":"N","godDlivyWaitDay":0,"otskrDlvPsbYn":"Y","sumPkgPsbYn":"Y","opt":{"type":"옵션구성","opt1":{"nm":"옵션1명","values":["옵션1값"]},"opt2":{"nm":"옵션2명","values":["옵션2값"]},"items":[{"opt1":"옵션1값","opt2":["옵션2값"]}]},"modelInfoDscr":"","godDetailDscr":"상품상세","mnfcturNationNm":"제조국","mnfcturYm":"제조년월","matrNm":"소재","makerNm":"제조자"}'

Response

{
    "message": "상품 등록이 완료 되었습니다.",
    "godNo": "1P000000000000",
    "comGodNo": "업체 상품 번호",
    "itmInfos": [
        {
            "comItmNo": null,
            "itmNo": "IT000000000000000",
            "itmNm": "옵션1명/옵션2명"
        }
    ]
}

POST/v1/product/modify

6. 상품 수정

등록된 상품 정보를 수정합니다.

필수 파라미터

Name
godNo
Children
굿웨어몰 상품 번호
Type
string

옵션 파라미터

Name
comGodNo
Children
업체 상품 번호
Type
string
Name
brndId
Children
브랜드
Type
string

Name: dspCtgryNos
Children: 전시 카테고리 코드 Array
Type: array of object
Description

Name
dspCtgryNo
Children
전시 카테고리 코드
Type
string
Description
Name
representYn
Children
대표 전시 카테고리 여부
Type
string
Description

Name
godNm
Children
상품명
Type
string
Name
cvrPrc
Children
정상가
Type
int
Name
comModelNm
Children
상품모델명
Type
string
Name
godWt
Children
무게
Type
string
Enum
tdfSect
Children
과면세 구분
Type
enum
Enum
sesonCd
Children
시즌 구분
Type
enum
Enum
kcCrtfcTgtCd
Children
KC안전인증 대상 여부
Type
enum
Enum
kcCrtfcExmCd
Children
KC안전인증 면제 사유
Type
enum
Enum
kcCrtfcSectCd
Children
KC안전 인증 종류
Type
enum
Name
kcCrtfcNo
Children
KC안전인증번호
Type
string
Name
kcCrtfcDate
Children
KC안전인증일자
Type
string
Name
saleBegDate
Children
판매시작일
Type
string
Name
saleEndDate
Children
판매종료일
Type
string
Name
minOrdQty
Children
최소 구매 가능 수량
Type
int
Name
maxOrdQty
Children
최대 구매 가능 수량
Type
int
Name
buyAgeLmitCd
Children
미성년자 구매 가능 여부
Type
string
Name
godDlivyWaitDay
Children
배송 소요일
Type
int
Name
otskrDlvPsbYn
Children
도서산간 배송 가능 여부
Type
string
Name
sumPkgPsbYn
Children
합포장 가능 여부
Type
string
Name
dspYn
Children
전시 여부
Type
string
Name
dmstcDlvCstPlcSn
Children
배송정책
Type
int

Name: opt
Children: 옵션
Type: object
Description

Enum
type
Children
옵션 구성
Type
enum
Description

Name: opt1
Children: 옵션1 Array
Type: array of object
Description

Name
nm
Children
옵션1명
Type
string
Description
Name
values
Children
옵션1값
Type
array of string
Description

Name: opt2
Children: 옵션2 Array
Type: array of object
Description

Name
nm
Children
옵션2명
Type
string
Description
Name
values
Children
옵션2값
Type
array of string
Description

Name: items
Children: 옵션 정보 Array
Type: array of object
Description

Name
opt1
Children
옵션1
Type
string
Description
Name
opt2
Children
옵션2
Type
array of string
Description

Name: modItems
Children: 옵션 상세 Array
Type: array of object
Description

Name
itmNo
Children
굿웨어몰 단품 번호
Type
string
Description
Name
comItmNo
Children
업체 단품 번호
Type
string
Description
Name
amt
Children
옵션가
Type
string
Description
Enum
status
Children
판매 상태
Type
enum
Description

Name: addItems
Children: 추가 대상 옵션 정보 Array
Type: array of object
Description

Name
opt1
Children
옵션1
Type
string
Description
Name
opt2
Children
옵션2
Type
array of string
Description

Name
godDetailDscr
Children
상품 상세 설명
Type
string
Name
mnfcturNationNm
Children
상품정보제공고시 제조국(원산지)
Type
string
Name
mnfcturYm
Children
상품정보제공고시 제조연월
Type
string
Name
matrNm
Children
상품정보제공고시 소재
Type
string
Name
makerNm
Children
상품정보제공고시 제조자
Type
string

응답 모델

프로퍼티명	설명	타입	상위객체
message	결과 메세지	String	N/A
godNo	굿웨어몰 상품 번호	String	N/A
comGodNo	입점사 상품 번호	String	N/A
itmInfos	옵션 정보 리스트	Array	N/A
comItmNo	입점사 옵션 번호	String	itmInfos
itmNo	굿웨어몰 옵션 번호	String	itmInfos
itmNm	굿웨어몰 옵션명	String	itmInfos

Request

POST

/v1/product/modify

curl -X POST "https://store-api.goodwearmall.com/v1/product/modify" \
    -H "Authorization: ${API_AUTH_INFO}" \
    -H "Content-Type": "application/json" \
    -d '{"godNo":"굿웨어몰 상품 번호"}'

Response

{
    "message": "상품 수정이 완료 되었습니다.",
    "godNo": "1P000000000000",
    "comGodNo": "굿웨어몰 상품 번호",
    "itmInfos": null
}

POST/v1/product/inventory

7. 재고 연동

등록된 상품의 재고를 연동합니다. 재고 연동 시 상품 승인 상태는 변경되지 않습니다. 호출당 최대 100개 단품만 연동 가능합니다.

필수 파라미터

Name: invInfos
Children: 상품 재고 정보 Array
Type: array of object
Description

Name
itmNo
Children
굿웨어몰 단품 번호
Type
string
Description
Name
totUsefulInvQty
Children
재고 수량
Type
string
Description

응답 모델

프로퍼티명	설명	타입	상위객체
code	응답 코드	Number	N/A
message	응답 메시지	String	N/A
success/failed	재고 업데이트 성공/실패	Object	N/A
itmNo	굿웨어몰 단품 번호	String	success/failed
totUsefulInvQty	재고 수량	Number	success/failed

Request

POST

/v1/product/inventory

curl -X POST "https://store-api.goodwearmall.com/v1/product/inventory" \
    -H "Authorization: ${API_AUTH_INFO}" \
    -H "Content-Type: application/json" \
    -d '{
        "invInfo": [
            {
                "itmNo": "AA1234567890",
                "totUsefulInvQty": 999
            },
            {
                "itmNo": "BB1234567890",
                "totUsefulInvQty": 999
            },
            {
                "itmNo": "CC1234567890",
                "totUsefulInvQty": 999
            }
        ]
    }'

Response

{
    "code": 0,
    "message": "재고가 갱신되었습니다.",
    "success": [
        {
            "itmNo": "AA1234567890",
            "totUsefulInvQty": 999
        },
        {
            "itmNo": "BB1234567890",
            "totUsefulInvQty": 999
        },
        {
            "itmNo": "CC1234567890",
            "totUsefulInvQty": 999
        }
    ],
    "failed": []
}

POST/v1/product/status

8. 상태 연동

등록된 상품의 상태를 변경합니다.

필수 파라미터

Name: statusList
Children: 상품 상태 Array
Type: array of object
Description

Name
godNo
Children
굿웨어몰 상품 번호
Type
string
Description
Enum
godSaleSectCd
Children
판매 상태
Type
enum
Description

응답 모델

프로퍼티명	설명	타입	상위객체
success	상품 상태 연동 성공	object	N/A
RES	상위 브랜드 ID	String	success
fail	상품 상태 연동 실패	object	N/A

Request

POST

/v1/product/status

curl -X POST "https://store-api.goodwearmall.com/v1/product/status" \
    -H "Authorization: ${API_AUTH_INFO}"
    -H "Content-Type": "application/json" \
    -d '{"statusList":[{"godNo":"1P000000000000", "godSaleSectCd":"SALE_PROGRS"}]}'

Response

{
    "success": {
        "RES": "n건 중 n건 상태 변경 되었습니다."
    },
    "fail": null
}

POST/v1/product/qna/list

9. 상품 QnA 조회

상품 QnA 목록을 조회할 수 있습니다.

필수 파라미터

Name
fromDate
Children
문의 조회 일시 (시작) (YYYYMMDD)
Type
string
Name
toDate
Children
문의 조회 일시 (종료) (YYYYMMDD)
Type
string

옵션 파라미터

Enum
inqTpCd
Children
문의 유형
Type
enum
Name
pageNo
Children
조회 페이지
Type
int
Name
limitCnt
Children
페이지당 표시 개수
Type
int

응답 모델

프로퍼티명	설명	타입	상위 객체
data	상품 문의 Array	Array	N/A
godInqSn	상품 문의 일련번호	Number	data
inqTpCd	문의 유형 코드	String	data
inqTpNm	문의 유형 코드명	String	data
brndNm	브랜드명	String	data
regDt	등록일시	String	data
godNo	굿웨어몰 상품 번호	String	data
godNm	상품명	String	data
inqSj	문의 제목	String	data
inqCont	문의 내용	String	data
inqCstmrNm	문의 고객명	String	data
cstmrEmail	고객 메일	String	data
inqDt	문의 일시	String	data
ansStatCd	답변 상태	String	data
ansStatNm	답변 상태명	String	data
ansDt	답변 일시	String	data
ansdelay	답변 소요시간	String	data
cnsltChrgerNm	상담사	String	data
cnsltStatCd	상담 상태 코드	String	data
secretsntncYn	비밀글 여부	String	data
cnsltStatNm	상담 상태명	String	data
cnsltPrcsComptDt	상담 처리 완료 일시	String	data
updatehistory	변경 이력	String	data
dvcNm	디바이스명	String	data
langNm	언어명	String	data
partmalSectCd	제휴몰 상품 카테고리 코드	String	data
partmalSectNm	제퓨몰 상품 카테고리 명	String	data
delayYn	지연 여부	String	data
comId	업체 ID	String	data
mallNm	매장명	String	data
ansEvlCd	답변 평가 코드	String	data
ansEvlNm	답변 평가 코드명	String	data
ansEvlCont	답변 평가 내용	String	data
ansEvlAdminAns	답변 평가 관리자 답변 내용	String	data
ansdelayworktm	답변 소요 시간	String	data
comGodNo	입점 상품 번호	String	data
comGodNoForPo	굿웨어몰 상품 번호	String	data
ansCont	답변 내용	String	data
pageNo	현재 페이지	Number	N/A
pageSize	페이지당 표시 개수	Number	N/A
totalCount	전체 개수	Number	N/A
totalPage	전체 페이지 수	Number	N/A

Request

POST

/v1/product/qna/list

curl -X POST "https://store-api.goodwearmall.com/v1/product/qna/list" \
    -H "Authorization: ${API_AUTH_INFO}" \
    -H "Content-Type: application/json" \
    -d '{"fromDate": "YYYYMMDD","toDate": "YYYYMMDD","inqTpCd": ["inqTpCd"]}'

Response

{
    "data": [
        {
            "godInqSn": 123,
            "inqTpCd": "CSO_GOD_INQ",
            "inqTpNm": "상품문의",
            "brndNm": "TEST",
            "regDt": "YYYY-MM-DDTHH:MI:SS.000+00:00",
            "godNo": "1P000000000000",
            "godNm": "TEST",
            "inqSj": null,
            "inqCont": "TEST",
            "inqCstmrNm": "홍길동",
            "cstmrEmail": "test@test.com",
            "inqDt": "YYYY-MM-DD HH:MI",
            "ansStatCd": "ANS_COMPT",
            "ansStatNm": "답변완료",
            "ansDt": "YYYY-MM-DD HH:MI",
            "ansdelay": "n시n분",
            "cnsltChrgerNm": "홍길동",
            "cnsltStatCd": "PROC_COMPT",
            "cnsltStatNm": "처리 완료 ",
            "secretsntncYn": "N",
            "cnsltPrcsComptDt": "YYYY-MM-DD HH:MI",
            "updatehistory": "YYYY-MM-DD HH:MI",
            "dvcNm": "모바일 앱 통합",
            "langNm": "한국어 ",
            "partmalSectCd": "CNSGN",
            "partmalSectNm": "입점업체",
            "delayYn": "N",
            "comId": "TEST",
            "mallNm": "신성통상",
            "ansEvlCd": null,
            "ansEvlNm": null,
            "ansEvlCont": null,
            "ansEvlAdminAns": "N",
            "ansdelayworktm": 0,
            "elapsetime": "",
            "comGodNo": "TEST",
            "comGodNoForPo": "TEST",
            "ansCont": "답변 내용"
        },
        ...
    ],
    "pageNo": 1,
    "pageSize": 50,
    "totalCount": 2,
    "totalPage": 1
}

POST/v1/product/image

10. 상품 이미지 등록

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

필수 파라미터

Name: params
Children: 상품 이미지 파라미터
Type: object
Description

Name
godNo
Children
굿웨어몰 상품 번호
Type
string
Description

Name: imageInfoList
Children: 상품 이미지 Array
Type: array of object
Description

Name
imgTurn
Children
이미지 순번
Type
int
Description
Enum
flag
Children
타입
Type
enum
Description
Name
imageNm
Children
이미지명
Type
string
Description

Name
imageList
Children
이미지 파일
Type
array<MultipartFile>

응답 모델

프로퍼티명	설명	타입	상위객체
code	응답 코드	Number	N/A
message	응답 메시지	String	N/A

Request

POST

/v1/product/image

curl -X POST https://store-api.goodwearmall.com/v1/product/image \
    -H "Authorization: ${API_AUTH_INFO}" \
    -H "Content-Type: multipart/form-data; boundary=${BOUNDARY}" \
    -F "params={\"godNo\":\"${GOD_NO}\", \"imageInfoList\":[{\"imgTurn\":\"${IMG_TURN}\", \"flag\":\"${CrudType}\"}]}" \
    -F "imageList=@${IMAGE};type=${IMAGE_TYPE};filename=${IMAGE_NAME}"

Response

{
    "code": 0,
    "message": "SUCCESS"
}

POST/v1/product/option/list

11. 상품 옵션 조회

등록된 상품 옵션 정보를 조회합니다.

필수 파라미터

Name
godNo
Children
굿웨어몰 상품 번호
Type
string

응답 모델

프로퍼티명	설명	타입	상위객체
data	상품 옵션 목록 Array	Array	N/A
itmNo	굿웨어몰 단품 번호	String	data
comItmNo	업체 단품 번호	String	data
itmStatCd	단품 판매 상태 코드	String	data
itmStatNm	단품 판매 상태 코드명	String	data
optNm1	옵션1명	String	data
optVal1	옵션1값	String	data
optNm2	옵션2명	String	data
optVal2	옵션2값	String	data
stock	재고	Number	data
optPrc	옵션가	Number	data

Request

POST

/v1/product/option/list

curl -X POST "https://store-api.goodwearmall.com/v1/product/option/list" \
    -H "Authorization: ${API_AUTH_INFO}" \
    -H "Content-Type: application/json" \
    -d '{"godNo":"굿웨어몰 상품 번호"}'

Response

{
    "data": [
        {
            "itmNo": "IT012345678900001",
            "comItmNo": null,
            "itmStatCd": "SALE_END",
            "itmStatNm": "판매 종료",
            "optNm1": "사이즈",
            "optVal1": "S",
            "optNm2": "색상",
            "optVal2": "블랙",
            "stock": 999,
            "optPrc": 0.00
        },
        {
            "itmNo": "IT012345678900002",
            "comItmNo": null,
            "itmStatCd": "SALE_END",
            "itmStatNm": "판매 종료",
            "optNm1": "사이즈",
            "optVal1": "M",
            "optNm2": "색상",
            "optVal2": "블랙",
            "stock": 999,
            "optPrc": 0.00
        },
        {
            "itmNo": "IT012345678900003",
            "comItmNo": null,
            "itmStatCd": "SALE_END",
            "itmStatNm": "판매 종료",
            "optNm1": "사이즈",
            "optVal1": "L",
            "optNm2": "색상",
            "optVal2": "블랙",
            "stock": 999,
            "optPrc": 1000.00
        }
    ]
}

POST/v1/product/deliveryPolicy/list

12. 배송정책 조회

등록된 배송정책 정보를 조회합니다.

응답 모델

프로퍼티명	설명	타입	상위객체
data	배송정책 목록 Array	Array	N/A
dmstcDlvCstPlcSn	배송정책 코드	Number	data
dlvPlcNm	배송정책 명	String	data
dlvCstLevySectCd	기본 정책 코드	String	data
dlvCstLevySectNm	기본 정책 명	String	data
dlvComCd	출고택배사 코드	String	data
dlvComNm	출고택배사 명	String	data
retrnComCd	회수택배사 코드	String	data
retrnComNm	회수택배사 명	String	data
autoRtrvlDrctPsbYn	자동 회수지시 가능 여부	String	data
dmstcDlvCstExmStdrAmt	기본 배송비 면제 기준 금액	Number	data
dmstcDlvCst	기본 배송비	Number	data
otskrAditDlvCstLevyYn	도서산간 추가 배송비 부과 여부	String	data
otskrDlvCst	도서산간 추가 배송비	Number	data
slrImptRtgodDlvCst	판매자 귀책 반품 배송비	Number	data
slrImptExchgDlvCst	판매자 귀책 교환 배송비	Number	data
buyerImptRtgodDlvCst	구매자 귀책 반품 배송비	Number	data
buyerImptExchgDlvCst	구매자 귀책 교환 배송비	Number	data
dlvspPostNo	발송주소 우편번호	String	data
dlvspBaseAddr	발송주소	String	data
dlvspDetailAddr	발송주소 상세	String	data
retrnPostNo	반품주소 우편번호	String	data
retrnBaseAddr	반품주소	String	data
retrnDetailAddr	반품주소 상세	String	data
baseDlvCstPlcYn	기본 배송정책 여부	String	data

Request

POST

/v1/product/deliveryPolicy/list

curl -X POST "https://store-api.goodwearmall.com/v1/product/deliveryPolicy/list" \
    -H "Authorization: ${API_AUTH_INFO}" \
    -H "Content-Type: application/json" \
    -d '{}'

Response

{
    "data": [
        {
            "dmstcDlvCstPlcSn": 1,
            "dlvPlcNm": "기본배송",
            "dlvCstLevySectCd": "COND_FREE",
            "dlvCstLevySectNm": "조건부무료",
            "dlvComCd": "TEST",
            "dlvComNm": "테스트",
            "retrnComCd": "TEST",
            "retrnComNm": "테스트",
            "autoRtrvlDrctPsbYn": "Y",
            "dmstcDlvCstExmStdrAmt": 39900.00,
            "dmstcDlvCst": 3000.00,
            "otskrAditDlvCstLevyYn": "Y",
            "otskrDlvCst": 3000.00,
            "slrImptRtgodDlvCst": 0.00,
            "slrImptExchgDlvCst": 0.00,
            "buyerImptRtgodDlvCst": 3000.00,
            "buyerImptExchgDlvCst": 6000.00,
            "dlvspPostNo": "17604",
            "dlvspBaseAddr": "경기도 안성시 미양면 양변길 42-4",
            "dlvspDetailAddr": "신성통상(주)",
            "retrnPostNo": "17604",
            "retrnBaseAddr": "경기도 안성시 미양면 양변길 42-4",
            "retrnDetailAddr": "온라인물류센터 지하 1층 반품팀",
            "baseDlvCstPlcYn": "Y"
        },
        {
            "dmstcDlvCstPlcSn": 2,
            "dlvPlcNm": "무료배송",
            "dlvCstLevySectCd": "FREE",
            "dlvCstLevySectNm": "무료",
            "dlvComCd": "TEST",
            "dlvComNm": "테스트",
            "retrnComCd": "TEST",
            "retrnComNm": "테스트",
            "autoRtrvlDrctPsbYn": "Y",
            "dmstcDlvCstExmStdrAmt": 1.00,
            "dmstcDlvCst": 0.00,
            "otskrAditDlvCstLevyYn": "N",
            "otskrDlvCst": 0.00,
            "slrImptRtgodDlvCst": 0.00,
            "slrImptExchgDlvCst": 0.00,
            "buyerImptRtgodDlvCst": 0.00,
            "buyerImptExchgDlvCst": 0.00,
            "dlvspPostNo": "05364",
            "dlvspBaseAddr": "서울특별시 강동구 풍성로63길 84 (둔촌동)",
            "dlvspDetailAddr": "신성통상",
            "retrnPostNo": "05364",
            "retrnBaseAddr": "서울특별시 강동구 풍성로63길 84 (둔촌동)",
            "retrnDetailAddr": "신성통상",
            "baseDlvCstPlcYn": "N"
        }
    ]
}