상품 일괄 등록

상품일괄등록 엑셀 상품등록

post

기능설명

상품일괄등록에서 업로드한 엑셀 파일의 상품 데이터를 저장합니다.

상세설명

데이터 검증이 완료된 정상상품목록을 받아서 저장합니다.
저장 언어는 디폴트 언어코드인 ko 기준으로 저장합니다.
결제가능수단은 전체로 초기값 셋팅됩니다.
표준분류에 매핑된 전시카테고리 리스트가 초기값으로 저장됩니다.

수정번호

Release v1.05_231204 : 상품 엑셀 일괄등록 신규생성

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Bodyobject · ExcelUploadGoodsRequestV2[]

엑셀 상품 Request

successYnstringOptional

goodsDuplicationYnstringOptional

상품중복여부

errorMessagestringOptional

에러메시지

entrNmstringOptional

협력사명

stdCtgNmstringOptional

표준카테고리명

goodsNotiLisartNmstringOptional

고시품목명

goodsDuplicationstringOptional

상품중복확인

rowIndexinteger · int32Optional

엑셀행번호

goodsNostringOptional

상품번호

goodsCompCdstringOptional

상품구성코드

goodsTypCdstringOptional

상품유형코드

saleStatCdstringOptional

판매상태코드

regInfPathCdstringOptional

등록유입경로코드

deliGoodsGbCdstringOptional

배송상품구분코드

deliWayCdstringOptional

배송수단코드

deliPolcNostringOptional

배송정책번호

ordCnclPsbYnstringOptional

취소가능여부

wthdYnstringOptional

회수필요여부

goodsNmstringOptional

상품명

entrNostringOptional

협력사번호

stdCtgNostringOptional

표준카테고리번호

lgcGoodsNostringOptional

자체상품번호

saleMethCdstringOptional

판매방식코드

rsvStrDtmstringOptional

예약주문가능시작일시

rsvEndDtmstringOptional

예약주문가능종료일시

rsvEndSaleMethstringOptional

예약종료후판매방식

fwdidcPrarDystringOptional

예약상품출고지시일

modlNmstringOptional

모델명

brandNostringOptional

브랜드번호

mfcoNmstringOptional

제조사

homeNmstringOptional

원산지

salemnNmstringOptional

판매자

incomNmstringOptional

수입자

frgnDirPurGoodsYnstringOptional

직구상품 여부

saleStrDtmStrstringOptional

판매시작일시(Excel)

saleStrDtmstring · date-timeOptional

판매시작일시

saleEndDtmStrstringOptional

판매종료일시

saleEndDtmstring · date-timeOptional

판매종료일시

buyrAgeLmtCdstringOptional

구입자나이제한코드

dispYnstringOptional

전시여부

prcCompaExpYnstringOptional

가격비교노출여부

schPsbYnstringOptional

검색키워드 사용여부

schKwdNmstringOptional

검색키워드

milgRsrvPsbYnstringOptional

마일리지적립가능여부

gvgfPsbYnstringOptional

선물하기가능여부

szGdeUseYnstringOptional

사이즈가이드사용여부

szGdeRegMethodCdstringOptional

사이즈가이드등록방법코드

szGdeCdstringOptional

사이즈가이드코드

szGdeContsstringOptional

사이즈가이드내용

buyTypCdstringOptional

매입형태코드

taxGbCdstringOptional

과/면세구분

supPcostnumberOptional

공급원가

norPrcnumberOptional

정상가

salePrcnumberOptional

판매가

mrgnRatenumberOptional

마진율

deliProcTypCdstringOptional

배송처리유형코드

deliPsbRgnCdstringOptional

배송가능지역

deliDdayinteger · int32Optional

배송기일

hsCdstringOptional

HS코드

bpckPsbYnstringOptional

합배송가능여부

rtnPsbYnstringOptional

반품가능여부

exchPsbYnstringOptional

교환가능여부

rglrDeliGoodsYnstringOptional

정기배송상품여부

stkMgrYnstringOptional

재고관리여부

buyQtyLmtYnstringOptional

구매수량제한여부

minLmtQtyinteger · int32Optional

최소구매수량

maxLmtQtyinteger · int32Optional

최대구매수량

safeStkNotiYnstringOptional

안전재고알림여부

dtlDescstringOptional

상세설명

goodsNotiLisartCdstringOptional

고시품목코드

goodsNotiItemCd1stringOptional

고시항목1

notiItemCmt1stringOptional

고시항목내용1

goodsNotiItemCd2stringOptional

고시항목2

notiItemCmt2stringOptional

고시항목내용2

goodsNotiItemCd3stringOptional

고시항목3

notiItemCmt3stringOptional

고시항목내용3

goodsNotiItemCd4stringOptional

고시항목4

notiItemCmt4stringOptional

고시항목내용4

goodsNotiItemCd5stringOptional

고시항목5

notiItemCmt5stringOptional

고시항목내용5

goodsNotiItemCd6stringOptional

고시항목6

notiItemCmt6stringOptional

고시항목내용6

goodsNotiItemCd7stringOptional

고시항목7

notiItemCmt7stringOptional

고시항목내용7

goodsNotiItemCd8stringOptional

고시항목8

notiItemCmt8stringOptional

고시항목내용8

goodsNotiItemCd9stringOptional

고시항목9

notiItemCmt9stringOptional

고시항목내용9

goodsNotiItemCd10stringOptional

고시항목10

notiItemCmt10stringOptional

고시항목내용10

goodsNotiItemCd11stringOptional

고시항목11

notiItemCmt11stringOptional

고시항목내용11

goodsNotiItemCd12stringOptional

고시항목12

notiItemCmt12stringOptional

고시항목내용12

goodsNotiItemCd13stringOptional

고시항목13

notiItemCmt13stringOptional

고시항목내용13

goodsNotiItemCd14stringOptional

고시항목14

notiItemCmt14stringOptional

고시항목내용14

safeCertiTgtYnstringOptional

안전인증대상여부

safeCertiGbCd1stringOptional

안전인증구분코드1

safeCertiOrnNm1stringOptional

안전인증기관명1

safeCertiNo1stringOptional

안전인증번호1

aplyStrDt1stringOptional

안전인증적용시작일자1

aplyEndDt1stringOptional

안전인증적용종료일자1

safeCertiGbCd2stringOptional

안전인증구분코드2

safeCertiOrnNm2stringOptional

안전인증기관명2

safeCertiNo2stringOptional

안전인증번호2

aplyStrDt2stringOptional

안전인증적용시작일자2

aplyEndDt2stringOptional

안전인증적용종료일자2

safeCertiGbCd3stringOptional

안전인증구분코드3

safeCertiOrnNm3stringOptional

안전인증기관명3

safeCertiNo3stringOptional

안전인증번호3

aplyStrDt3stringOptional

안전인증적용시작일자3

aplyEndDt3stringOptional

안전인증적용종료일자3

safeCertiGbCd4stringOptional

안전인증구분코드4

safeCertiOrnNm4stringOptional

안전인증기관명4

safeCertiNo4stringOptional

안전인증번호4

aplyStrDt4stringOptional

안전인증적용시작일자4

aplyEndDt4stringOptional

안전인증적용종료일자4

safeCertiGbCd5stringOptional

안전인증구분코드5

safeCertiOrnNm5stringOptional

안전인증기관명5

safeCertiNo5stringOptional

안전인증번호5

aplyStrDt5stringOptional

안전인증적용시작일자5

aplyEndDt5stringOptional

안전인증적용종료일자5

optnYnstringOptional

옵션관리여부

Responses

200

상품일괄등록 엑셀 상품등록 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

상품일괄등록 엑셀 상품등록 실패

*/*

post/v2/goods/goodsBatchRegistApi/saveExcelGoodsList

POST /api/bo/v2/goods/goodsBatchRegistApi/saveExcelGoodsList HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 6745

[
  {
    "successYn": "text",
    "goodsDuplicationYn": "text",
    "errorMessage": "text",
    "entrNm": "text",
    "stdCtgNm": "text",
    "goodsNotiLisartNm": "text",
    "goodsDuplication": "text",
    "rowIndex": 1,
    "goodsNo": "text",
    "goodsCompCd": "text",
    "goodsTypCd": "text",
    "saleStatCd": "text",
    "regInfPathCd": "text",
    "deliGoodsGbCd": "text",
    "deliWayCd": "text",
    "deliPolcNo": "text",
    "ordCnclPsbYn": "text",
    "wthdYn": "text",
    "goodsNm": "text",
    "entrNo": "text",
    "stdCtgNo": "text",
    "lgcGoodsNo": "text",
    "saleMethCd": "text",
    "rsvStrDtm": "text",
    "rsvEndDtm": "text",
    "rsvEndSaleMeth": "text",
    "fwdidcPrarDy": "text",
    "modlNm": "text",
    "brandNo": "text",
    "mfcoNm": "text",
    "homeNm": "text",
    "salemnNm": "text",
    "incomNm": "text",
    "frgnDirPurGoodsYn": "text",
    "saleStrDtmStr": "text",
    "saleStrDtm": "2026-01-01T00:00:00.000Z",
    "saleEndDtmStr": "text",
    "saleEndDtm": "2026-01-01T00:00:00.000Z",
    "buyrAgeLmtCd": "text",
    "dispYn": "text",
    "prcCompaExpYn": "text",
    "schPsbYn": "text",
    "schKwdNm": "text",
    "milgRsrvPsbYn": "text",
    "gvgfPsbYn": "text",
    "szGdeUseYn": "text",
    "szGdeRegMethodCd": "text",
    "szGdeCd": "text",
    "szGdeConts": "text",
    "buyTypCd": "text",
    "taxGbCd": "text",
    "supPcost": 1,
    "norPrc": 1,
    "salePrc": 1,
    "mrgnRate": 1,
    "deliProcTypCd": "text",
    "deliPsbRgnCd": "text",
    "deliDday": 1,
    "hsCd": "text",
    "bpckPsbYn": "text",
    "rtnPsbYn": "text",
    "exchPsbYn": "text",
    "rglrDeliGoodsYn": "text",
    "stkMgrYn": "text",
    "buyQtyLmtYn": "text",
    "minLmtQty": 1,
    "maxLmtQty": 1,
    "safeStkNotiYn": "text",
    "dtlDesc": "text",
    "prGoodsContInfo": {
      "goodsNo": "text",
      "contTypCd": "text",
      "contSn": "text",
      "goodsDtlDesc": "text",
      "imgGbCd": "text",
      "dispSeq": 1,
      "contFilePathNm": "text",
      "contFileNm": "text",
      "trnfTextCont": "text",
      "useYn": "text",
      "packageSubImageRegistDefaultValue": 1
    },
    "goodsNotiLisartCd": "text",
    "goodsNotiItemCd1": "text",
    "notiItemCmt1": "text",
    "goodsNotiItemCd2": "text",
    "notiItemCmt2": "text",
    "goodsNotiItemCd3": "text",
    "notiItemCmt3": "text",
    "goodsNotiItemCd4": "text",
    "notiItemCmt4": "text",
    "goodsNotiItemCd5": "text",
    "notiItemCmt5": "text",
    "goodsNotiItemCd6": "text",
    "notiItemCmt6": "text",
    "goodsNotiItemCd7": "text",
    "notiItemCmt7": "text",
    "goodsNotiItemCd8": "text",
    "notiItemCmt8": "text",
    "goodsNotiItemCd9": "text",
    "notiItemCmt9": "text",
    "goodsNotiItemCd10": "text",
    "notiItemCmt10": "text",
    "goodsNotiItemCd11": "text",
    "notiItemCmt11": "text",
    "goodsNotiItemCd12": "text",
    "notiItemCmt12": "text",
    "goodsNotiItemCd13": "text",
    "notiItemCmt13": "text",
    "goodsNotiItemCd14": "text",
    "notiItemCmt14": "text",
    "safeCertiTgtYn": "text",
    "safeCertiGbCd1": "text",
    "safeCertiOrnNm1": "text",
    "safeCertiNo1": "text",
    "aplyStrDt1": "text",
    "aplyEndDt1": "text",
    "safeCertiGbCd2": "text",
    "safeCertiOrnNm2": "text",
    "safeCertiNo2": "text",
    "aplyStrDt2": "text",
    "aplyEndDt2": "text",
    "safeCertiGbCd3": "text",
    "safeCertiOrnNm3": "text",
    "safeCertiNo3": "text",
    "aplyStrDt3": "text",
    "aplyEndDt3": "text",
    "safeCertiGbCd4": "text",
    "safeCertiOrnNm4": "text",
    "safeCertiNo4": "text",
    "aplyStrDt4": "text",
    "aplyEndDt4": "text",
    "safeCertiGbCd5": "text",
    "safeCertiOrnNm5": "text",
    "safeCertiNo5": "text",
    "aplyStrDt5": "text",
    "aplyEndDt5": "text",
    "prAssocGoodsInfoList": {
      "all": [
        {
          "goodsNo": "text",
          "asctGoodsNo": "text",
          "asctGbCd": "text",
          "sortSeq": 1
        }
      ],
      "create": [
        {
          "goodsNo": "text",
          "asctGoodsNo": "text",
          "asctGbCd": "text",
          "sortSeq": 1
        }
      ],
      "update": [
        {
          "goodsNo": "text",
          "asctGoodsNo": "text",
          "asctGbCd": "text",
          "sortSeq": 1
        }
      ],
      "delete": [
        {
          "goodsNo": "text",
          "asctGoodsNo": "text",
          "asctGbCd": "text",
          "sortSeq": 1
        }
      ]
    },
    "prAdveWrdHistList": [
      {
        "goodsNo": "text",
        "aplyStrDtm": "2026-01-01T00:00:00.000Z",
        "aplyEndDtm": "2026-01-01T00:00:00.000Z",
        "adveWrd": "text",
        "useYn": "text"
      }
    ],
    "prGoodsIconInfoList": {
      "all": [
        {
          "siteNo": "text",
          "goodsNo": "text",
          "dispIconNo": "text",
          "siteNm": "text",
          "iconNm": "text",
          "dispMediaCdNm": "text",
          "iconTypCdNm": "text",
          "aplyStrDtm": "2026-01-01T00:00:00.000Z",
          "aplyEndDtm": "2026-01-01T00:00:00.000Z",
          "iconPathNm": "text",
          "delYn": "N"
        }
      ],
      "create": [
        {
          "siteNo": "text",
          "goodsNo": "text",
          "dispIconNo": "text",
          "siteNm": "text",
          "iconNm": "text",
          "dispMediaCdNm": "text",
          "iconTypCdNm": "text",
          "aplyStrDtm": "2026-01-01T00:00:00.000Z",
          "aplyEndDtm": "2026-01-01T00:00:00.000Z",
          "iconPathNm": "text",
          "delYn": "N"
        }
      ],
      "update": [
        {
          "siteNo": "text",
          "goodsNo": "text",
          "dispIconNo": "text",
          "siteNm": "text",
          "iconNm": "text",
          "dispMediaCdNm": "text",
          "iconTypCdNm": "text",
          "aplyStrDtm": "2026-01-01T00:00:00.000Z",
          "aplyEndDtm": "2026-01-01T00:00:00.000Z",
          "iconPathNm": "text",
          "delYn": "N"
        }
      ],
      "delete": [
        {
          "siteNo": "text",
          "goodsNo": "text",
          "dispIconNo": "text",
          "siteNm": "text",
          "iconNm": "text",
          "dispMediaCdNm": "text",
          "iconTypCdNm": "text",
          "aplyStrDtm": "2026-01-01T00:00:00.000Z",
          "aplyEndDtm": "2026-01-01T00:00:00.000Z",
          "iconPathNm": "text",
          "delYn": "N"
        }
      ]
    },
    "prGoodsAttInfoList": [
      {
        "langCd": "text",
        "goodsNo": "text",
        "attCd": "text",
        "attVal": "text",
        "stdCtgNo": "text"
      }
    ],
    "prRsvSaleHist": {
      "goodsNo": "text",
      "rsvStrtDtm": "2026-01-01T00:00:00.000Z",
      "rsvEndDtm": "2026-01-01T00:00:00.000Z",
      "rsvEndAfProcMethCd": "text",
      "rsvStopYn": "text",
      "rsvStopCausCd": "text",
      "rsvStopDtm": "2026-01-01T00:00:00.000Z",
      "fwdidcPrarDy": "text"
    },
    "prGoodsItemInfoList": [
      {
        "goodsNo": "text",
        "goodsNotiLisartCd": "text",
        "goodsNotiItemCd": "text",
        "notiItemCmt": "text"
      }
    ],
    "prGoodsSafeCertiHistList": [
      {
        "goodsNo": "text",
        "safeCertiGbCd": "text",
        "safeCertiNo": "text",
        "aplyStrDt": "text",
        "aplyEndDt": "text",
        "safeCertiOrnNm": "text"
      }
    ],
    "prGoodsPayMeanInfoList": [
      {
        "goodsNo": "text",
        "payWayCd": "text",
        "useYn": "text"
      }
    ],
    "prDispGoodsInfoList": {
      "all": [
        {
          "goodsNo": 10002042,
          "dispCtgNo": 242,
          "dispYn": "Y",
          "goodsList": [
            "text"
          ],
          "goodsArray": [
            "text"
          ],
          "itemList": [
            "text"
          ],
          "itemArray": [
            "text"
          ]
        }
      ],
      "create": [
        {
          "goodsNo": 10002042,
          "dispCtgNo": 242,
          "dispYn": "Y",
          "goodsList": [
            "text"
          ],
          "goodsArray": [
            "text"
          ],
          "itemList": [
            "text"
          ],
          "itemArray": [
            "text"
          ]
        }
      ],
      "update": [
        {
          "goodsNo": 10002042,
          "dispCtgNo": 242,
          "dispYn": "Y",
          "goodsList": [
            "text"
          ],
          "goodsArray": [
            "text"
          ],
          "itemList": [
            "text"
          ],
          "itemArray": [
            "text"
          ]
        }
      ],
      "delete": [
        {
          "goodsNo": 10002042,
          "dispCtgNo": 242,
          "dispYn": "Y",
          "goodsList": [
            "text"
          ],
          "goodsArray": [
            "text"
          ],
          "itemList": [
            "text"
          ],
          "itemArray": [
            "text"
          ]
        }
      ]
    },
    "prGoodsPrceHist": {
      "goodsNo": "text",
      "histStrDtm": "2026-01-01T00:00:00.000Z",
      "histEndDtm": "2026-01-01T00:00:00.000Z",
      "supPcost": 1,
      "norPrc": 1,
      "salePrc": 1,
      "eventPrc": 1,
      "mrgnRate": 1,
      "goodsPrceTypCd": "text",
      "prcChgCausCd": "text",
      "prcChgCausCdNm": "text",
      "timeDealYn": "text",
      "supPcostByMrgn": 1
    },
    "optnYn": "text",
    "prItmBase": {
      "goodsNo": "text",
      "itmNo": "text",
      "optnCatNm1": "text",
      "optnNm1": "text",
      "optnCatNm2": "text",
      "optnNm2": "text",
      "optnCatNm3": "text",
      "optnNm3": "text",
      "optnCatNm4": "text",
      "optnNm4": "text",
      "optnCatNm5": "text",
      "optnNm5": "text",
      "lgcItmNo": "text",
      "itmSaleStatCd": "text",
      "itmSaleStatCdNm": "text",
      "saleStatChgCausCd": "text",
      "repItmYn": "text",
      "dispSeq": 1,
      "addSupPcost": 1,
      "addSalePrc": 1,
      "soutCausCd": "text",
      "limtQty": 1,
      "stkQty": 1,
      "safeStkNotiYn": "text",
      "safeStkQty": 1,
      "optnCatNo1": "text",
      "optnNo1": "text",
      "optnCatNo2": "text",
      "optnNo2": "text",
      "optnCatNo3": "text",
      "optnNo3": "text",
      "optnCatNo4": "text",
      "optnNo4": "text",
      "optnCatNo5": "text",
      "optnNo5": "text",
      "giftRegistDefaultValue": "text",
      "addSupPcostByMargn": 1
    }
  }
]

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}