사은품 등록

사은품 등록

post

기능설명

• 사은품 정보를 등록합니다.

---

상세설명

• 사은품 정보를 등록합니다.

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

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

requestGiftGoodsCUDRequestOptional

사은품 정보 Request

Body

application/json

사은품 등록/수정 Request

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/giftGoodsApi/registerGiftGoods

HTTPcURLJavaScriptPython

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

{
  "prGoodsBase": {
    "goodsNo": "text",
    "goodsNm": "text",
    "modlNm": "text",
    "homeNm": "text",
    "mfcoNm": "text",
    "incomNm": "text",
    "salemnNm": "text",
    "manufYm": "text",
    "schKwdNm": "text",
    "lgcGoodsNo": "text",
    "entrNo": "text",
    "stdCtgNo": "text",
    "goodsCompCd": "text",
    "goodsTypCd": "text",
    "saleMethCd": "text",
    "brandNo": "text",
    "safeCertiTgtYn": "text",
    "buyrAgeLmtCd": "text",
    "dispYn": "text",
    "saleStatCd": "text",
    "aprvReqDt": "text",
    "saleStatChgCausCd": "text",
    "soutCausCd": "text",
    "goodsRegDtm": "2026-02-27T18:16:04.615Z",
    "saleStrDtm": "2026-02-27T18:16:04.615Z",
    "saleEndDtm": "2026-02-27T18:16:04.615Z",
    "buyTypCd": "text",
    "taxGbCd": "text",
    "stkMgrYn": "text",
    "buyQtyLmtYn": "text",
    "minLmtQty": 1,
    "maxLmtQty": 1,
    "deliProcTypCd": "text",
    "deliGoodsGbCd": "text",
    "deliWayCd": "text",
    "deliDday": 1,
    "itmSoutNotiYn": "text",
    "deliPolcNo": "text",
    "deliPsbRgnCd": "text",
    "rtnPsbYn": "text",
    "exchPsbYn": "text",
    "prcCompaExpYn": "text",
    "pkgGoodsPrioRnkCd": "text",
    "bpckPsbYn": "text",
    "hsCd": "text",
    "safeStkNotiYn": "text",
    "rglrDeliGoodsYn": "text",
    "regInfPathCd": "text",
    "aprvDt": "text",
    "retnCausCd": "text",
    "retnCausCdNm": "text",
    "retnCaus": "text",
    "retnDt": "text",
    "schPsbYn": "text",
    "optnYn": "text",
    "optnCDYn": "text",
    "goodsNoArray": [
      "text"
    ],
    "szGdeUseYn": "text",
    "szGdeRegMethodCd": "text",
    "szGdeCd": "text",
    "szGdeConts": "text",
    "gftWthdYn": "text",
    "milgRsrvPsbYn": "text",
    "gvgfPsbYn": "text",
    "frgnDirPurGoodsYn": "text",
    "entrGoodsNo": "text",
    "ordCnclPsbYn": "text",
    "wthdYn": "text",
    "ecpnAplyTermGbCd": "text",
    "ecpnIssuDdStdUseDds": 1,
    "ecpnUsePsbStrDt": "2026-02-27",
    "ecpnUsePsbEndDt": "2026-02-27"
  },
  "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
  },
  "giftImageInfo": {
    "goodsNo": "text",
    "contTypCd": "text",
    "contSn": "text",
    "goodsDtlDesc": "text",
    "imgGbCd": "text",
    "dispSeq": 1,
    "contFilePathNm": "text",
    "contFileNm": "text",
    "trnfTextCont": "text",
    "useYn": "text",
    "packageSubImageRegistDefaultValue": 1
  }
}

{
  "timestamp": "2026-02-27T18:16:04.615Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}