본문 바로가기
서비스 API/당일배송

상품별 지점정보 관리 API

Description
등록/수정 : [PUT] https://sa2.esmplus.com/item/v1/goods/{goodsNo}/exshop/branch-options
조회 : [GET] https://sa2.esmplus.com/item/v1/goods/{goodsNo}/exshop/branch-options 
삭제 : [DELETE] https://sa2.esmplus.com/item/v1/goods/{goodsNo}/exshop/branch-options/{branchId}
상품별 지점 및 지점별 판매여부/추가가격을 설정합니다.
가격은 상품등록 시 등록한 판매가에서 +/- 할 금액만 연동합니다.
연동된 금액은 실제 판매가에서 지점추가금 +/- 노출 및 계산되어 상품페이지에 반영됩니다.
지점의 판매여부를 false로 설정할 경우, 해당 지점의 고객은 본 상품이 노출되지 않거나 품절로 노출됩니다.

Request Description

항목 항목명 필수여부 Type Description
goodsNo 마스터 상품번호 Y path  
branchId 지점코드 Y int  
onSale 판매여부 Y boolean 지점별 판매 가능 여부
addPrice 추가금액 Y int 대표가(판매가) 기준 (-) 80% ~ (+) 110% 설정 가능
service > types [ ]서비스형태   string 지점 관리시 설정한 서비스 형태는 등록 불가
reserve :
당일배송(예약), dawn : 새벽배송
stock 재고   int  
promotionCode1 행사코드1   int  
promotionCode2 행사코드2   int  
promotionCode3 행사코드3   int  
promotionCode4 행사코드4   int  
JSON
[
  {
    "branchId": 0,
    "service": {
      "types": [
        "string"
      ]
    },
    "onSale": true,
    "addPrice": 0,
    "stock": 0,
    "promotionCode1": 0,
    "promotionCode2": 0,
    "promotionCode3": 0,
    "promotionCode4": 0
  }
]

 

Response Description

항목 항목명 Type Description
branchId 지점코드 int 조회 시 내려가는 정보
goodsNo 마스터 상품번호 int 조회 시 내려가는 정보
service > Types [ ]지점서비스형태 string 조회 시 내려가는 정보
onSale 판매여부 boolean 조회 시 내려가는 정보
addPrice 추가금액 int 조회 시 내려가는 정보
stock 재고 int 조회 시 내려가는 정보
promotionCode1 행사코드1 int 조회 시 내려가는 정보
promotionCode2 행사코드2 int 조회 시 내려가는 정보
promotionCode3 행사코드3 int 조회 시 내려가는 정보
promotionCode4 행사코드4 int 조회 시 내려가는 정보
resultCode 결과코드 int 실패 시 내려가는 정보
message 메시지 string 실패 시 내려가는 정보

 JSON_Success

{
    "goodsNo": 0
}

JSON_Fail

{
  "resultCode": 0,
  "message": "string"
}

Sample Code_Success

{
    "goodsNo": 1543155764
}

Sample Code_Fail

{
  "resultCode":1000,
  "message":"에러메시지"
}

Error Code

결과코드 메시지 원인
1000 해당 지점은 존재하지 않습니다. 없는 지점번호로 조회 시 발생
1000 지점에 등록되지 않은 서비스 형태입니다. 서비스 형태를 확인해 주세요. 상품별 지점관리에 등록하려는 서비스타입이 branchId에 기 등록된 service>types에 포함되지 않는 경우
3000 당일배송 상품의 지점추가금액은 대표가 기준 -80%~+110% 등록 가능 합니다.(상품 번호: {model.GoodsNo}, 브랜치 번호: {model.BranchId}) master 가격 기준으로 추가금액의 등록 가능 범위를 벗어난 경우