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

# 상품 일괄 등록

`POST /V1/front/products`

상품 일괄 등록하는 API입니다.

## 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/authorize-v2.md) · [All operations](https://skmtc.dev/sauce/apis/authorize-v2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sauce/authorize-v2/revisions/17497c96804d/schema)