---
title: "상품 일괄 등록"
method: POST
path: "/V1/front/products"
---

# 상품 일괄 등록

`POST /V1/front/products`

## Request

- Base URL: `https://stage.api.sauceflex.com`
- URL: `https://stage.api.sauceflex.com/V1/front/products`
- Auth: none required

## Headers

- `X-Sauceflex-Authorize` string, required

## Request body

- object
  - `products` object[], required: 등록 상품 목록(최대 20개)
    - `externalProductId` string, required: 파트너사 상품 ID
    - `brandName` string, required: 브랜드명
    - `productName` string, required: 상품명(최대 200자)
    - `priceTypeCode` 'basic' | 'text' | 'hide': 상품가 표시 타입 코드 basic: 일반 </br> text: 텍스트 </br> hide: 표시 하지 않음</br>
    - `price` string, required: 상품 가격
    - `discountTypeCode` 'rate' | 'price' | 'none': 상품 할인 타입</br> rate: 할인율</br> none: 없음</br>
    - `discountRate` string: 할인률
    - `discountPrice` string: 할인금액
    - `sellingPrice` string: 판매가
    - `isSoldout` '0' | '1', required: 품절 여부(1: 품절, 0: 품절 아님) 해당필드를 넣지 않으면 fail이 날 수 있습니다.
    - `redirectUrl` string, required: 상품 이동 URL
    - `androidSchemeUrl` string: 안드로이드 스킴
    - `iosSchemeUrl` string: iOS 스킴
    - `productThumbnailUrlList` object[], required: 상품 썸네일 이미지 주소 목록
      - `isRepresentative` boolean, required: 대표 이미지로 선택되면 true</br> 꼭 1개 이상의 대표이미지를 true로 설정해주세요.
      - `thumbnailUrl` string, required: 이미지 Url
      - `productThumbnailType` 'image' | 'link': 이미지 등록 타입 API에서 등록할때에는 이미지 링크로만 등록하기때문에 link를 입력해야함. image: 이미지 직접 등록 link: 링크로 등록
    - `currencyId` 'KRW' | 'USD' | 'JPY' | 'VND' | 'IDR': 환율 코드 KRW: 대한민국 통화</br> USD: 미국 통화 </br> JPY: 일본 통화</br> VND: 베트남 통화</br> IDR:인도네시아 통화

## Response `200`

200

- object
  - `code` string: "SU0000" 일시 정상 응답
  - `timestamp` integer: 타임스탬프
  - `requestId` string: 요청 아이디
  - `message` string: 메세지
  - `response` object: 응답 객체
    - `successCount` integer: 성공 갯수
    - `failCount` integer: 실패 갯수
    - `success` object[]: 성공 객체
      - `externalProductId` string: 파트너사 상품 ID
      - `productId` string: 상품 아이디
      - `productName` string: 상품명
      - `regDt` string: 생성일
    - `fail` object[]: 실패 객체
      - `externalProductId` string: 파트너사 상품 ID
      - `messageCode` string: 실패 코드

## Other responses

- `400`: 400
- `401`: 401

---

[API](https://skmtc.dev/sauce/apis/saucelive.md) - [All operations](https://skmtc.dev/sauce/apis/saucelive/llms.txt) - [OpenAPI document](https://skmtc.dev/sauce/apis/saucelive/revisions/d9e8f0fce2cc?raw)