> For the complete documentation index, see [llms.txt](https://help.genser.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.genser.ai/url/parameter.md).

# Copy of 요청 파라미터 설명

{% hint style="info" %}
**요청 데이터를 설명합니다. 자세한 API 요청 방식은**[ **상품 수집 API** ](/developers/product-collection/api.md)**를 참고해 주세요.**
{% endhint %}

## 공통 데이터 구조

### 다국어 텍스트 필드

상품명, 브랜드명, 카테고리명 등 텍스트 필드는 세 가지 형식을 지원합니다.

**형식 1. 단순 문자열**

```json
"name": "클래식 티셔츠"
```

**형식 2. 언어 지정 객체**

```json
"name": {
  "@value": "클래식 티셔츠",
  "@language": "ko"
}
```

**형식 3. 다국어 배열**

* 지원 언어 코드 (ISO 639-1): `ko`, `en`, `ja`

```json
"name": [
  { "@value": "클래식 티셔츠", "@language": "ko" },
  { "@value": "Classic T-Shirt", "@language": "en" },
  { "@value": "クラシックTシャツ", "@language": "ja" }
]
```

{% hint style="info" %}
언어 지정 객체(형식 2, 3)를 사용할 때 `@value`와 `@language`는 모두 필수입니다. `@language`를 생략하면 `400` 에러가 반환됩니다. 모든 언어를 반드시 제공할 필요는 없으며, 필요한 언어만 전달하면 됩니다.
{% endhint %}

### 데이터 입력 규칙

* **필수 필드와 null**: 필드 명세표에서 **필수(O)** 로 표기된 필드는 반드시 유효한 값을 포함해야 합니다. 필수 필드에 `null`을 전송하면 `400` 에러가 반환됩니다. 선택(X) 필드는 생략하거나 `null`로 전송할 수 있습니다.
* **문자열(string)**: 별도의 `maxLength` 제약 없이 적절한 길이로 전송하는 것을 권장합니다.
* **숫자(number)**: 별도의 소수점 정밀도 규약 없이 통화에 맞는 일반적인 자릿수를 사용합니다 (예: KRW는 정수, USD는 소수점 이하 2자리).
* **enum**: 허용되는 값이 지정된 필드는 Enum 값 레퍼런스 섹션에 정리되어 있습니다. 명시된 값 이외의 값을 전송하면 `400` 에러가 반환됩니다.
* **필드 간 의존관계**: 특정 필드의 값에 따라 다른 필드의 필수 여부가 변경되는 조건부 필수 규칙은 적용되지 않습니다. 필드 명세표의 필수 여부만 기준으로 데이터를 구성합니다.
* `@graph` 배열에 최소 1개, 최대 1,000개의 상품을 포함할 수 있습니다.
* API 명세서에 기재된 모든 필드는 null을 허용하지 않습니다.

***

## 필드 상세 명세

#### **이벤트 객체 (CollectorProductsEvent)**

<table><thead><tr><th width="153.7265625">필드</th><th width="128.16015625">타입</th><th width="74.109375">필수</th><th>설명</th></tr></thead><tbody><tr><td><code>@context</code></td><td>string</td><td>X</td><td>스키마 context. 고정값: <code>"https://schema.org"</code></td></tr><tr><td><code>specversion</code></td><td>string</td><td>X</td><td>스펙 버전. 고정값: <code>"1.0"</code></td></tr><tr><td><code>id</code></td><td>string</td><td>X</td><td>이벤트 고유 식별자. 등록: <code>"EVT-CREATE-PRODUCT"</code>, 수정: <code>"EVT-UPDATE-PRODUCT"</code></td></tr><tr><td><code>type</code></td><td>string</td><td>X</td><td>이벤트 유형. 등록: <code>"create_product"</code>, 수정: <code>"update_product"</code></td></tr><tr><td><code>agent</code></td><td>object</td><td>O</td><td>행위자 정보</td></tr><tr><td><code>@graph</code></td><td>array</td><td>O</td><td>상품 데이터 배열 (1~1,000건)</td></tr></tbody></table>

#### **agent 객체**

<table><thead><tr><th width="162.19921875">필드</th><th width="129.6640625">타입</th><th width="72.6875">필수</th><th>설명</th></tr></thead><tbody><tr><td><code>@type</code></td><td>string</td><td>X</td><td>유형. 고정값: <code>"Organization"</code></td></tr><tr><td><code>name</code></td><td>string</td><td>O</td><td>요청 기업명</td></tr></tbody></table>

#### **상품 객체 (@graph)**

`@graph` 배열의 각 항목은 하나의 상품을 나타냅니다.

<table><thead><tr><th>필드</th><th>타입</th><th width="72.5546875">필수</th><th>설명</th></tr></thead><tbody><tr><td><code>@type</code></td><td>string</td><td>X</td><td>유형. 고정값: <code>"Product"</code></td></tr><tr><td><code>sku</code></td><td>string</td><td>O</td><td>상품 코드 (고유 식별자)</td></tr><tr><td><code>name</code></td><td>string | object | array</td><td>O</td><td>상품명. 다국어 지원</td></tr><tr><td><code>description</code></td><td>object | array</td><td>O</td><td>상품 설명</td></tr><tr><td><code>brand</code></td><td>object</td><td>O</td><td>브랜드 정보</td></tr><tr><td><code>category</code></td><td>object | array</td><td>O</td><td>카테고리 정보</td></tr><tr><td><code>positiveNotes</code></td><td>string | object | array</td><td>X</td><td>핵심 장점 요약. 다국어 지원</td></tr><tr><td><code>url</code></td><td>string | object | array</td><td>O</td><td>상품 페이지 URL. 다국어 지원</td></tr><tr><td><code>mobileUrl</code></td><td>string | object | array</td><td>X</td><td>모바일 상품 페이지 URL. 다국어 지원</td></tr><tr><td><code>itemCondition</code></td><td>string</td><td>X</td><td>상품 상태. enum 참고</td></tr><tr><td><code>hasAdultConsideration</code></td><td>string</td><td>X</td><td>성인 대상 상품 구분. enum 참고</td></tr><tr><td><code>countryOfOrigin</code></td><td>object</td><td>X</td><td>제조 국가 정보</td></tr><tr><td><code>material</code></td><td>string | object | array</td><td>X</td><td>소재 정보. 다국어 지원</td></tr><tr><td><code>additionalProperty</code></td><td>array</td><td>X</td><td>추가 속성</td></tr><tr><td><code>offers</code></td><td>object | array</td><td>O</td><td>SKU별 가격/재고 정보</td></tr></tbody></table>

#### **countryOfOrigin 객체**

<table><thead><tr><th>필드</th><th>타입</th><th width="115.765625">필수</th><th>설명</th></tr></thead><tbody><tr><td><code>@type</code></td><td>string</td><td>X</td><td>유형. 고정값: <code>"Country"</code></td></tr><tr><td><code>address</code></td><td>string</td><td>O</td><td>제조 국가 코드 (ISO 3166-1 alpha-2, 예: <code>"KR"</code>, <code>"JP"</code>, <code>"US"</code>)</td></tr></tbody></table>

#### **브랜드 (brand)**

| 필드      | 타입                        | 필수 | 설명                 |
| ------- | ------------------------- | -- | ------------------ |
| `@type` | string                    | X  | 유형. 고정값: `"Brand"` |
| `@id`   | string                    | O  | 브랜드 식별자            |
| `name`  | string \| object \| array | O  | 브랜드 이름. 다국어 지원     |
| `logo`  | array\<string>            | X  | 브랜드 로고 URL 목록      |

#### **카테고리 (category)**

단일 객체 또는 배열로 전달합니다. 배열 사용 시 `position` 값으로 카테고리 계층 수준을 표현합니다.

<table><thead><tr><th>필드</th><th>타입</th><th width="157.14453125">필수</th><th>설명</th></tr></thead><tbody><tr><td><code>@type</code></td><td>string</td><td>X</td><td>유형. 고정값: <code>"CategoryCode"</code></td></tr><tr><td><code>codeValue</code></td><td>string</td><td>O</td><td>카테고리 코드</td></tr><tr><td><code>name</code></td><td>object | array</td><td>O</td><td>카테고리 이름. 다국어 지원</td></tr><tr><td><code>position</code></td><td>integer</td><td>O</td><td>카테고리 수준 (1 = 대분류, 2 = 중분류, ...)</td></tr></tbody></table>

#### **상품 설명 (description)**

<table><thead><tr><th>필드</th><th>타입</th><th width="96.671875">필수</th><th>설명</th></tr></thead><tbody><tr><td><code>@type</code></td><td>string</td><td>X</td><td>유형. 고정값: <code>"TextObject"</code></td></tr><tr><td><code>text</code></td><td>string</td><td>O</td><td>설명 텍스트</td></tr><tr><td><code>inLanguage</code></td><td>string</td><td>O</td><td>언어 코드 (ISO 639-1): <code>ko</code>, <code>en</code>, <code>ja</code></td></tr><tr><td><code>image</code></td><td>object | array</td><td>X</td><td>설명에 포함된 이미지 정보</td></tr><tr><td><code>additionalProperty</code></td><td>array</td><td>X</td><td>추가 속성</td></tr></tbody></table>

#### **description 내 이미지 객체**

| 필드           | 타입     | 필수 | 설명                       |
| ------------ | ------ | -- | ------------------------ |
| `@type`      | string | X  | 유형. 고정값: `"ImageObject"` |
| `contentUrl` | string | X  | 이미지 URL                  |
| `inLanguage` | string | X  | 언어 코드                    |

#### **가격/재고 정보 (offers)**

단일 객체 또는 배열로 전달합니다. 색상·사이즈 등 옵션별로 별도의 offer를 구성합니다.

<table><thead><tr><th>필드</th><th width="164.421875">타입</th><th width="78.58203125">필수</th><th>설명</th></tr></thead><tbody><tr><td><code>@type</code></td><td>string</td><td>X</td><td>유형. 고정값: <code>"Offer"</code></td></tr><tr><td><code>sku</code></td><td>string</td><td>O</td><td>옵션별 상품 코드</td></tr><tr><td><code>gtin</code></td><td>string</td><td>O</td><td>국제 표준 바코드</td></tr><tr><td><code>mpn</code></td><td>string</td><td>O</td><td>제조사 부품 번호</td></tr><tr><td><code>price</code></td><td>number</td><td>O</td><td>가격</td></tr><tr><td><code>priceCurrency</code></td><td>string</td><td>O</td><td>통화 코드 (ISO 4217, 예: <code>"KRW"</code>, <code>"JPY"</code>, <code>"USD"</code>)</td></tr><tr><td><code>priceSpecification</code></td><td>object | array</td><td>X</td><td>가격 유형 상세</td></tr><tr><td><code>color</code></td><td>string</td><td>O</td><td>색상</td></tr><tr><td><code>size</code></td><td>string</td><td>O</td><td>사이즈</td></tr><tr><td><code>availability</code></td><td>string</td><td>O</td><td>재고 상태. enum 참고</td></tr><tr><td><code>availabilityStarts</code></td><td>string</td><td>O</td><td>판매 시작 일시 (UTC ISO 8601)</td></tr><tr><td><code>availabilityEnds</code></td><td>string</td><td>O</td><td>판매 종료 일시 (UTC ISO 8601)</td></tr><tr><td><code>inventoryLevel</code></td><td>object</td><td>X</td><td>재고 수량 정보</td></tr><tr><td><code>shippingDetails</code></td><td>object</td><td>X</td><td>배송 정보</td></tr><tr><td><code>image</code></td><td>object | array</td><td>O</td><td>상품 이미지</td></tr><tr><td><code>additionalProperty</code></td><td>array</td><td>X</td><td>추가 속성</td></tr></tbody></table>

#### **inventoryLevel 객체**

<table><thead><tr><th>필드</th><th>타입</th><th width="111.06640625">필수</th><th>설명</th></tr></thead><tbody><tr><td><code>@type</code></td><td>string</td><td>X</td><td>유형. 고정값: <code>"QuantitativeValue"</code></td></tr><tr><td><code>value</code></td><td>number</td><td>O</td><td>재고 수량</td></tr></tbody></table>

#### **shippingDetails 객체**

| 필드       | 타입     | 필수 | 설명                                |
| -------- | ------ | -- | --------------------------------- |
| `@type`  | string | X  | 유형. 고정값: `"OfferShippingDetails"` |
| `weight` | object | O  | 배송 무게                             |

#### **shippingDetails.weight 객체**

| 필드         | 타입     | 필수 | 설명                             |
| ---------- | ------ | -- | ------------------------------ |
| `@type`    | string | X  | 유형. 고정값: `"QuantitativeValue"` |
| `value`    | number | O  | 무게 값                           |
| `unitCode` | string | O  | 단위 코드 (예: `"KGM"`, `"GRM"`)    |

#### **가격 유형 (priceSpecification)**

정가, 판매가, 권장소비자가격 등 다양한 가격 유형을 표현합니다.

<table><thead><tr><th>필드</th><th width="171.10546875">타입</th><th width="75.828125">필수</th><th>설명</th></tr></thead><tbody><tr><td><code>@type</code></td><td>string</td><td>X</td><td>유형. 고정값: <code>"UnitPriceSpecification"</code></td></tr><tr><td><code>priceType</code></td><td>string</td><td>O</td><td>가격 구분. enum 참고</td></tr><tr><td><code>price</code></td><td>number</td><td>O</td><td>가격</td></tr><tr><td><code>priceCurrency</code></td><td>string</td><td>O</td><td>통화 코드 (ISO 4217)</td></tr><tr><td><code>unitCode</code></td><td>string</td><td>O</td><td>단위 코드</td></tr></tbody></table>

#### **이미지 (image)**

| 필드                     | 타입      | 필수 | 설명                                                    |
| ---------------------- | ------- | -- | ----------------------------------------------------- |
| `@type`                | string  | X  | 유형. 고정값: `"ImageObject"`                              |
| `representativeOfPage` | boolean | X  | 대표 이미지 여부 (`true` = 대표 이미지)                           |
| `contentUrl`           | string  | O  | 이미지 URL                                               |
| `contentSize`          | string  | X  | 파일 크기                                                 |
| `width`                | object  | X  | 너비 (`{ "@type": "QuantitativeValue", "value": 800 }`) |
| `height`               | object  | X  | 높이 (`{ "@type": "QuantitativeValue", "value": 600 }`) |

#### **추가 속성 (additionalProperty)**

표준 필드로 표현할 수 없는 추가 정보를 담기 위한 확장 필드입니다.&#x20;

상품 객체(`@graph[]`), 상품 설명(`description`), 가격 정보(`offers`) 내에서 사용할 수 있습니다.

<table><thead><tr><th>필드</th><th width="152.64453125">타입</th><th width="66.84765625">필수</th><th>설명</th></tr></thead><tbody><tr><td><code>@type</code></td><td>string</td><td>X</td><td>유형. 고정값: <code>"PropertyValue"</code></td></tr><tr><td><code>propertyID</code></td><td>string</td><td>X</td><td>속성 아이디 (속성을 구분하는 키)</td></tr><tr><td><code>value</code></td><td>any</td><td>X</td><td>값 (string, number, boolean, array 등 모든 타입 가능)</td></tr></tbody></table>

{% hint style="warning" %}
상품 객체(`@graph[]`) 내로 값을 전달하기를 권장합니다.
{% endhint %}

**속성 레퍼런스**

아래는 `additionalProperty`에서 사용할 수 있는 권장 속성 목록입니다. 허용 값 예시를 참고하여 값을 맞춰서 보내주세요.

<table><thead><tr><th width="178.15234375">propertyID</th><th width="154.66796875">value 타입</th><th width="167.71875">설명</th><th>허용 값 / 예시</th></tr></thead><tbody><tr><td><code>gender</code></td><td>string</td><td>성별</td><td><code>"M"</code> (Men), <code>"W"</code> (Women), <code>"U"</code> (Unisex), <code>null</code> (미지정)</td></tr><tr><td><code>season</code></td><td>string[]</td><td>계절</td><td><code>"Spring"</code>, <code>"Summer"</code>, <code>"Fall"</code>, <code>"Winter"</code> 중 선택</td></tr><tr><td><code>temperature</code></td><td>string</td><td>보관 방법</td><td><code>"Refrigerate"</code> 등</td></tr><tr><td><code>platform_rate</code></td><td>number</td><td>플랫폼 수수료</td><td><code>0.15</code></td></tr><tr><td><code>unit</code></td><td>object</td><td>포장/무게 정보</td><td>하위 필드: <code>unit</code>, <code>unit_quantity</code>, <code>weight_unit</code>, <code>weight_quantity</code></td></tr><tr><td><code>seller</code></td><td>object</td><td>판매자 정보</td><td>하위 필드: <code>prefecture</code>, <code>seller_name</code></td></tr></tbody></table>

**`unit` 객체 구조**

| 하위 필드             | 타입     | 설명    | 예시                          |
| ----------------- | ------ | ----- | --------------------------- |
| `unit`            | string | 포장 단위 | `"box"`, `"pack"`, `"ea"` 등 |
| `unit_quantity`   | number | 포장 수량 | `500`                       |
| `weight_unit`     | string | 무게 단위 | `"g"`, `"ml"`               |
| `weight_quantity` | string | 무게 값  | `"500"`                     |

**`seller` 객체 구조**

<table><thead><tr><th>하위 필드</th><th width="145.53125">타입</th><th width="158.86328125">설명</th><th>예시</th></tr></thead><tbody><tr><td><code>prefecture</code></td><td>string</td><td>원산지/지역</td><td><code>"秋田県"</code>, <code>"제주도"</code> 등</td></tr><tr><td><code>seller_name</code></td><td>string</td><td>판매자명</td><td><code>"きのこ農園"</code>, <code>"유스파머"</code> 등</td></tr></tbody></table>

**사용 예시**

```json
"additionalProperty": [
  {
    "@type": "PropertyValue",
    "propertyID": "gender",
    "value": "M"
  },
  {
    "@type": "PropertyValue",
    "propertyID": "season",
    "value": ["Spring", "Summer"]
  },
  {
    "@type": "PropertyValue",
    "propertyID": "temperature",
    "value": "Refrigerate"
  },
  {
    "@type": "PropertyValue",
    "propertyID": "platform_rate",
    "value": 0.15
  },
  {
    "@type": "PropertyValue",
    "propertyID": "unit",
    "value": {
      "unit": "box",
      "unit_quantity": 500,
      "weight_unit": "g",
      "weight_quantity": "500"
    }
  },
  {
    "@type": "PropertyValue",
    "propertyID": "seller",
    "value": {
      "prefecture": "秋田県",
      "seller_name": "間木きのこ農園"
    }
  }
]

```

{% hint style="warning" %}
`unit` 속성의 `weight_unit`은 `g` 또는 `ml`로 통일하여 전송합니다. \
원본 데이터가 `kg`인 경우 `g`으로, `L`인 경우 `ml`로 변환해 주세요.
{% endhint %}

***

## **Enum 값 레퍼런스**

#### **itemCondition**

상품의 물리적 상태를 나타냅니다.

| 값                      | 설명      |
| ---------------------- | ------- |
| `NewCondition`         | 새 상품    |
| `RefurbishedCondition` | 리퍼비시 상품 |
| `UsedCondition`        | 중고 상품   |
| `DamagedCondition`     | 손상된 상품  |

#### hasAdultConsideration

성인 대상 상품 여부를 구분합니다.

| 값                                          | 설명       |
| ------------------------------------------ | -------- |
| `AlcoholConsideration`                     | 주류       |
| `DangerousGoodConsideration`               | 위험물      |
| `HealthcareConsideration`                  | 의약품/의료기기 |
| `NarcoticConsideration`                    | 마약류      |
| `ReducedRelevanceForChildrenConsideration` | 아동 부적합   |
| `SexualContentConsideration`               | 성인 콘텐츠   |
| `TobaccoNicotineConsideration`             | 담배/니코틴   |
| `UnclassifiedAdultConsideration`           | 기타 성인 고려 |
| `ViolenceConsideration`                    | 폭력성      |
| `WeaponConsideration`                      | 무기류      |

#### availability

SKU의 재고/판매 상태를 나타냅니다.

| 값                     | 설명            |
| --------------------- | ------------- |
| `BackOrder`           | 입고 예정 (주문 가능) |
| `Discontinued`        | 단종            |
| `InStock`             | 재고 있음         |
| `InStoreOnly`         | 매장 전용         |
| `LimitedAvailability` | 한정 수량         |
| `MadeToOrder`         | 주문 제작         |
| `OnlineOnly`          | 온라인 전용        |
| `OutOfStock`          | 품절            |
| `PreOrder`            | 예약 주문         |
| `PreSale`             | 사전 판매         |
| `Reserved`            | 예약 완료         |
| `SoldOut`             | 매진            |

#### priceType

가격의 성격을 구분합니다.

| 값                        | 설명                 |
| ------------------------ | ------------------ |
| `InvoicePrice`           | 청구 가격              |
| `ListPrice`              | 정가                 |
| `MSRP`                   | 제조사 권장 소비자가격       |
| `MinimumAdvertisedPrice` | 최소 광고 가격           |
| `RegularPrice`           | 일반 판매가             |
| `SRP`                    | 권장 소매가             |
| `SalePrice`              | 할인가                |
| `StrikethroughPrice`     | 취소선 가격 (원래 가격 표시용) |

***

## **참고: JSON 스키마 예시**

<details>

<summary>상품 등록</summary>

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "고객사 상품수집 - 상품 등록",
  "description": "고객사의 상품 데이터 수집",
  "type": "object",
  "properties": {
    "@context": {
      "type": "string",
      "description": "context",
      "enum": [
        "https://schema.org"
      ],
      "default": "https://schema.org"
    },
    "specversion": {
      "type": "string",
      "description": "스펙 버전",
      "enum": [
        "1.0"
      ],
      "default": "1.0"
    },
    "id": {
      "type": "string",
      "description": "이벤트 고유 식별자",
      "enum": [
        "EVT-CREATE-PRODUCT"
      ],
      "default": "EVT-CREATE-PRODUCT"
    },
    "type": {
      "type": "string",
      "description": "상품 수집 유형",
      "enum": [
        "create_product"
      ],
      "default": "create_product"
    },
    "agent": {
      "type": "object",
      "description": "조직 정보",
      "required": [
        "name"
      ],
      "properties": {
        "@type": {
          "type": "string",
          "description": "조직",
          "enum": [
            "Organization"
          ],
          "default": "Organization"
        },
        "name": {
          "type": "string",
          "description": "생성 요청한 기업"
        }
      }
    },
    "@graph": {
      "type": "array",
      "description": "상품 데이터",
      "minItems": 1,
      "maxItems": 1000,
      "items": {
        "type": "object",
        "properties": {
          "@type": {
            "type": "string",
            "description": "https://schema.org/Product",
            "enum": [
              "Product"
            ],
            "default": "Product"
          },
          "sku": {
            "type": "string",
            "description": "상품 코드"
          },
          "name": {
            "description": "상품명",
            "oneOf": [
              {
                "type": "array",
                "items": {
                  "$ref": "#/$defs/langName"
                }
              },
              {
                "$ref": "#/$defs/langName"
              },
              {
                "type": "string"
              }
            ]
          },
          "description": {
            "oneOf": [
              {
                "type": "array",
                "items": {
                  "$ref": "#/$defs/description"
                }
              },
              {
                "$ref": "#/$defs/description"
              }
            ]
          },
          "brand": {
            "type": "object",
            "description": "브랜드 정보",
            "properties": {
              "@type": {
                "type": "string",
                "description": "https://schema.org/Brand",
                "enum": [
                  "Brand"
                ],
                "default": "Brand"
              },
              "@id": {
                "type": "string",
                "description": "브랜드 아이디"
              },
              "name": {
                "oneOf": [
                  {
                    "type": "array",
                    "items": {
                      "$ref": "#/$defs/brandName"
                    }
                  },
                  {
                    "$ref": "#/$defs/brandName"
                  },
                  {
                    "type": "string",
                    "description": "브랜드 이름"
                  }
                ]
              },
              "logo": {
                "type": "array",
                "description": "브랜드 로고",
                "items": {
                  "type": "string",
                  "description": "브랜드 로고"
                }
              }
            },
            "required": [
              "@id",
              "name"
            ]
          },
          "category": {
            "description": "카테고리 정보",
            "oneOf": [
              {
                "type": "array",
                "description": "카테고리",
                "minItems": 1,
                "items": {
                  "$ref": "#/$defs/category"
                }
              },
              {
                "$ref": "#/$defs/category"
              }
            ]
          },
          "positiveNotes": {
            "oneOf": [
              {
                "type": "array",
                "items": {
                  "$ref": "#/$defs/positiveNote"
                }
              },
              {
                "$ref": "#/$defs/positiveNote"
              },
              {
                "type": "array",
                "description": "핵심 장점 요약",
                "items": {
                  "type": "string"
                }
              },
              {
                "type": "string",
                "description": "핵심 장점 요약"
              }
            ]
          },
          "url": {
            "oneOf": [
              {
                "type": "array",
                "items": {
                  "$ref": "#/$defs/url"
                }
              },
              {
                "$ref": "#/$defs/url"
              },
              {
                "type": "array",
                "description": "상품 페이지 URL",
                "items": {
                  "type": "string"
                }
              },
              {
                "type": "string",
                "description": "상품 페이지 URL"
              }
            ]
          },
          "mobileUrl": {
            "oneOf": [
              {
                "type": "array",
                "items": {
                  "$ref": "#/$defs/mobileUrl"
                }
              },
              {
                "$ref": "#/$defs/mobileUrl"
              },
              {
                "type": "array",
                "description": "모바일 상품 페이지 URL",
                "items": {
                  "type": "string"
                }
              },
              {
                "type": "string",
                "description": "모바일 상품 페이지 URL"
              }
            ]
          },
          "itemCondition": {
            "type": "string",
            "description": "상품 상태",
            "enum": [
              "NewCondition",
              "RefurbishedCondition",
              "UsedCondition",
              "DamagedCondition"
            ]
          },
          "hasAdultConsideration": {
            "type": "string",
            "description": "성인 대상 상품",
            "enum": [
              "AlcoholConsideration",
              "DangerousGoodConsideration",
              "HealthcareConsideration",
              "NarcoticConsideration",
              "ReducedRelevanceForChildrenConsideration",
              "SexualContentConsideration",
              "TobaccoNicotineConsideration",
              "UnclassifiedAdultConsideration",
              "ViolenceConsideration",
              "WeaponConsideration"
            ]
          },
          "countryOfOrigin": {
            "type": "object",
            "description": "제조 국가 정보",
            "properties": {
              "@type": {
                "type": "string",
                "description": "https://schema.org/Country",
                "enum": [
                  "Country"
                ],
                "default": "Country"
              },
              "address": {
                "type": "string",
                "description": "제조 국가 코드 (ISO 3166-1-alpha-2)"
              }
            },
            "required": [
              "address"
            ]
          },
          "material": {
            "oneOf": [
              {
                "type": "array",
                "minItems": 1,
                "items": {
                  "$ref": "#/$defs/material"
                }
              },
              {
                "$ref": "#/$defs/material"
              },
              {
                "type": "array",
                "description": "소재 정보",
                "items": {
                  "type": "string"
                }
              },
              {
                "type": "string",
                "description": "소재 정보"
              }
            ]
          },
          "additionalProperty": {
            "type": "array",
            "description": "부가 정보",
            "minItems": 1,
            "items": {
              "type": "object",
              "properties": {
                "@type": {
                  "type": "string",
                  "description": "https://schema.org/PropertyValue",
                  "enum": [
                    "PropertyValue"
                  ],
                  "default": "PropertyValue"
                },
                "propertyID": {
                  "type": "string",
                  "description": "속성 아이디"
                },
                "value": {
                  "description": "속성 값"
                }
              }
            }
          },
          "offers": {
            "oneOf": [
              {
                "$ref": "#/$defs/offers"
              },
              {
                "type": "array",
                "description": "",
                "minItems": 1,
                "items": {
                  "$ref": "#/$defs/offers"
                }
              }
            ]
          }
        },
        "required": [
          "sku",
          "name",
          "description",
          "brand",
          "category",
          "url",
          "offers"
        ]
      }
    }
  },
  "required": [
    "agent",
    "@graph"
  ],
  "$defs": {
    "langName": {
      "type": "object",
      "properties": {
        "@value": {
          "type": "string",
          "description": "상품명"
        },
        "@language": {
          "type": "string",
          "description": "ISO 639-1 언어코드",
          "enum": [
            "ko",
            "en",
            "ja"
          ],
          "pattern": "^[a-z]{2}$",
          "default": "ko"
        }
      },
      "required": [
        "@value",
        "@language"
      ]
    },
    "brandName": {
      "type": "object",
      "description": "브랜드 이름",
      "properties": {
        "@value": {
          "type": "string",
          "description": "브랜드 이름"
        },
        "@language": {
          "type": "string",
          "description": "ISO 639-1 언어코드",
          "enum": [
            "ko",
            "en",
            "ja"
          ],
          "pattern": "^[a-z]{2}$",
          "default": "ko"
        }
      },
      "required": [
        "@value",
        "@language"
      ]
    },
    "description": {
      "type": "object",
      "description": "상품 상세 설명 정보",
      "properties": {
        "@type": {
          "type": "string",
          "description": "https://schema.org/TextObject",
          "enum": [
            "TextObject"
          ],
          "default": "TextObject"
        },
        "text": {
          "type": "string",
          "description": "상품 상세 설명"
        },
        "inLanguage": {
          "type": "string",
          "description": "ISO 639-1 언어코드",
          "enum": [
            "ko",
            "en",
            "ja"
          ],
          "pattern": "^[a-z]{2}$",
          "default": "ko"
        },
        "image": {
          "description": "상품 상세 설명 (이미지)",
          "oneOf": [
            {
              "type": "array",
              "minItems": 1,
              "items": {
                "$ref": "#/$defs/descriptionImage"
              }
            },
            {
              "$ref": "#/$defs/descriptionImage"
            }
          ]
        },
        "additionalProperty": {
          "type": "array",
          "description": "상품 설명 부가 정보",
          "minItems": 1,
          "items": {
            "type": "object",
            "properties": {
              "@type": {
                "type": "string",
                "description": "https://schema.org/PropertyValue",
                "enum": [
                  "PropertyValue"
                ],
                "default": "PropertyValue"
              },
              "propertyID": {
                "type": "string",
                "description": "속성 아이디"
              },
              "value": {
                "description": "속성 값"
              }
            }
          }
        }
      },
      "required": [
        "text",
        "inLanguage"
      ]
    },
    "descriptionImage": {
      "type": "object",
      "description": "상품 상세 설명 (이미지)",
      "properties": {
        "@type": {
          "type": "string",
          "description": "https://schema.org/ImageObject",
          "enum": [
            "ImageObject"
          ],
          "default": "ImageObject"
        },
        "contentUrl": {
          "type": "string",
          "description": "이미지 파일 URL"
        },
        "inLanguage": {
          "type": "string",
          "description": "ISO 639-1 언어코드",
          "enum": [
            "ko",
            "en",
            "ja"
          ],
          "pattern": "^[a-z]{2}$",
          "default": "ko"
        }
      }
    },
    "category": {
      "type": "object",
      "properties": {
        "@type": {
          "type": "string",
          "description": "https://schema.org/CategoryCode",
          "enum": [
            "CategoryCode"
          ],
          "default": "CategoryCode"
        },
        "codeValue": {
          "type": "string",
          "description": "카테고리 코드"
        },
        "name": {
          "description": "카테고리 이름 정보",
          "oneOf": [
            {
              "type": "array",
              "minItems": 1,
              "items": {
                "$ref": "#/$defs/categoryName"
              }
            },
            {
              "$ref": "#/$defs/categoryName"
            }
          ]
        },
        "position": {
          "type": "integer",
          "description": "카테고리 수준 (대/중/소/세)"
        }
      },
      "required": [
        "codeValue",
        "name",
        "position"
      ]
    },
    "categoryName": {
      "type": "object",
      "properties": {
        "@value": {
          "type": "string",
          "description": "카테고리 이름"
        },
        "@language": {
          "type": "string",
          "description": "ISO 639-1 언어코드",
          "enum": [
            "ko",
            "en",
            "ja"
          ],
          "pattern": "^[a-z]{2}$",
          "default": "ko"
        }
      },
      "required": [
        "@value",
        "@language"
      ]
    },
    "positiveNote": {
      "type": "object",
      "description": "핵심 장점 요약 정보",
      "properties": {
        "@value": {
          "type": "string",
          "description": "핵심 장점 요약"
        },
        "@language": {
          "type": "string",
          "description": "ISO 639-1 언어코드",
          "enum": [
            "ko",
            "en",
            "ja"
          ],
          "pattern": "^[a-z]{2}$",
          "default": "ko"
        }
      },
      "required": [
        "@value",
        "@language"
      ]
    },
    "url": {
      "type": "object",
      "description": "상품 페이지 URL",
      "properties": {
        "@value": {
          "type": "string",
          "description": "상품 페이지 URL"
        },
        "@language": {
          "type": "string",
          "description": "ISO 639-1 언어코드",
          "enum": [
            "ko",
            "en",
            "ja"
          ],
          "pattern": "^[a-z]{2}$",
          "default": "ko"
        }
      },
      "required": [
        "@value",
        "@language"
      ]
    },
    "mobileUrl": {
      "type": "object",
      "description": "모바일 상품 페이지 URL",
      "properties": {
        "@value": {
          "type": "string",
          "description": "모바일 상품 페이지 URL"
        },
        "@language": {
          "type": "string",
          "description": "ISO 639-1 언어코드",
          "enum": [
            "ko",
            "en",
            "ja"
          ],
          "pattern": "^[a-z]{2}$",
          "default": "ko"
        }
      },
      "required": [
        "@value",
        "@language"
      ]
    },
    "image": {
      "type": "object",
      "description": "상품 이미지 정보",
      "properties": {
        "@type": {
          "type": "string",
          "description": "https://schema.org/ImageObject",
          "enum": [
            "ImageObject"
          ],
          "default": "ImageObject"
        },
        "representativeOfPage": {
          "type": "boolean",
          "description": "대표 이미지 여부",
          "default": false
        },
        "contentUrl": {
          "type": "string",
          "description": "이미지 파일 URL"
        },
        "contentSize": {
          "type": "string",
          "description": "이미지 파일 사이즈"
        },
        "width": {
          "type": "object",
          "description": "이미지 넓이",
          "properties": {
            "@type": {
              "type": "string",
              "description": "https://schema.org/QuantitativeValue",
              "enum": [
                "QuantitativeValue"
              ],
              "default": "QuantitativeValue"
            },
            "value": {
              "type": "number",
              "description": "이미지 높이"
            }
          }
        },
        "height": {
          "type": "object",
          "description": "이미지 파일의 높이",
          "properties": {
            "@type": {
              "type": "string",
              "description": "https://schema.org/QuantitativeValue",
              "enum": [
                "QuantitativeValue"
              ],
              "default": "QuantitativeValue"
            },
            "value": {
              "type": "number",
              "description": "이미지 파일의 높이 값"
            }
          }
        }
      },
      "required": [
        "contentUrl"
      ]
    },
    "material": {
      "type": "object",
      "description": "소재 정보",
      "properties": {
        "@value": {
          "type": "string",
          "description": "소재"
        },
        "@language": {
          "type": "string",
          "description": "ISO 639-1 언어코드",
          "enum": [
            "ko",
            "en",
            "ja"
          ],
          "pattern": "^[a-z]{2}$",
          "default": "ko"
        }
      },
      "required": [
        "@value",
        "@language"
      ]
    },
    "priceSpecification": {
      "type": "object",
      "description": "가격 유형",
      "properties": {
        "@type": {
          "type": "string",
          "description": "https://schema.org/UnitPriceSpecification",
          "enum": [
            "UnitPriceSpecification"
          ],
          "default": "UnitPriceSpecification"
        },
        "priceType": {
          "type": "string",
          "description": "가격 유형",
          "enum": [
            "InvoicePrice",
            "ListPrice",
            "MSRP",
            "MinimumAdvertisedPrice",
            "RegularPrice",
            "SRP",
            "SalePrice",
            "StrikethroughPrice"
          ]
        },
        "price": {
          "type": "number",
          "description": "유닛 가격"
        },
        "priceCurrency": {
          "type": "string",
          "description": "ISO 4217 통화코드 (예: KRW, USD, JPY)"
        },
        "unitCode": {
          "type": "string",
          "description": "단위"
        }
      },
      "required": [
        "priceType",
        "price",
        "priceCurrency",
        "unitCode"
      ]
    },
    "offers": {
      "type": "object",
      "description": "SKU 별 가격, 판매 가능여부 ",
      "properties": {
        "@type": {
          "type": "string",
          "description": "https://schema.org/Offer",
          "enum": [
            "Offer"
          ],
          "default": "Offer"
        },
        "sku": {
          "type": "string",
          "description": "판매용 SKU"
        },
        "gtin": {
          "type": "string",
          "description": "국제 표준 바코드 (GTIN / EAN / UPC / ISBN), GTIN-13 = EAN "
        },
        "mpn": {
          "type": "string",
          "description": "제조사 부품 번호 (Manufacturer Part Number)"
        },
        "price": {
          "type": "number",
          "description": "판매가격"
        },
        "priceCurrency": {
          "type": "string",
          "description": "ISO 4217 통화코드 (예: KRW, USD, JPY)",
          "pattern": "^[A-Z]{3}$"
        },
        "priceSpecification": {
          "oneOf": [
            {
              "type": "array",
              "minItems": 1,
              "items": {
                "$ref": "#/$defs/priceSpecification"
              }
            },
            {
              "$ref": "#/$defs/priceSpecification"
            }
          ]
        },
        "color": {
          "type": "string",
          "description": "색상"
        },
        "size": {
          "type": "string",
          "description": "사이즈"
        },
        "availability": {
          "type": "string",
          "description": "재고 상태",
          "enum": [
            "BackOrder",
            "Discontinued",
            "InStock",
            "InStoreOnly",
            "LimitedAvailability",
            "MadeToOrder",
            "OnlineOnly",
            "OutOfStock",
            "PreOrder",
            "PreSale",
            "Reserved",
            "SoldOut"
          ]
        },
        "availabilityStarts": {
          "type": "string",
          "description": "ISO 8601 UTC 생성시간 (2025-11-28T10:00:00Z)",
          "pattern": "Z$"
        },
        "availabilityEnds": {
          "type": "string",
          "description": "ISO 8601 UTC 생성시간 (2025-11-28T10:00:00Z)",
          "pattern": "Z$"
        },
        "inventoryLevel": {
          "type": "object",
          "description": "재고 현황 정보",
          "properties": {
            "@type": {
              "type": "string",
              "description": "https://schema.org/QuantitativeValue",
              "enum": [
                "QuantitativeValue"
              ],
              "default": "QuantitativeValue"
            },
            "value": {
              "type": "number",
              "description": "재고 현황"
            }
          },
          "required": [
            "value"
          ]
        },
        "shippingDetails": {
          "type": "object",
          "description": "배송 정보",
          "properties": {
            "@type": {
              "type": "string",
              "description": "https://schema.org/OfferShippingDetails",
              "enum": [
                "OfferShippingDetails"
              ],
              "default": "OfferShippingDetails"
            },
            "weight": {
              "type": "object",
              "description": "배송 무게",
              "properties": {
                "@type": {
                  "type": "string",
                  "description": "https://schema.org/OfferShippingDetails",
                  "enum": [
                    "QuantitativeValue"
                  ],
                  "default": "QuantitativeValue"
                },
                "value": {
                  "type": "number",
                  "description": "배송 무게"
                },
                "unitCode": {
                  "type": "string",
                  "description": "배송 무게 표시 단위"
                }
              },
              "required": [
                "value",
                "unitCode"
              ]
            }
          },
          "required": [
            "weight"
          ]
        },
        "image": {
          "oneOf": [
            {
              "type": "array",
              "minItems": 1,
              "items": {
                "$ref": "#/$defs/image"
              }
            },
            {
              "$ref": "#/$defs/image"
            }
          ]
        },
        "additionalProperty": {
          "type": "array",
          "description": "부가 정보",
          "minItems": 1,
          "items": {
            "type": "object",
            "properties": {
              "@type": {
                "type": "string",
                "description": "https://schema.org/PropertyValue",
                "enum": [
                  "PropertyValue"
                ],
                "default": "PropertyValue"
              },
              "propertyID": {
                "type": "string",
                "description": "속성 아이디"
              },
              "value": {
                "description": "속성 값"
              }
            }
          }
        }
      },
      "required": [
        "sku",
        "gtin",
        "mpn",
        "price",
        "priceCurrency",
        "color",
        "size",
        "availability",
        "availabilityStarts",
        "availabilityEnds",
        "image"
      ]
    }
  }
}
```

</details>

<details>

<summary>상품 수정</summary>

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "고객사 상품수집 - 상품 등록",
  "description": "고객사의 상품 데이터 수집",
  "type": "object",
  "properties": {
    "@context": {
      "type": "string",
      "description": "context",
      "enum": [
        "https://schema.org"
      ],
      "default": "https://schema.org"
    },
    "specversion": {
      "type": "string",
      "description": "스펙 버전",
      "enum": [
        "1.0"
      ],
      "default": "1.0"
    },
    "id": {
      "type": "string",
      "description": "이벤트 고유 식별자",
      "enum": [
        "EVT-UPDATE-PRODUCT"
      ],
      "default": "EVT-UPDATE-PRODUCT"
    },
    "type": {
      "type": "string",
      "description": "상품 수집 유형",
      "enum": [
        "update_product"
      ],
      "default": "update_product"
    },
    "agent": {
      "type": "object",
      "description": "조직 정보",
      "required": [
        "name"
      ],
      "properties": {
        "@type": {
          "type": "string",
          "description": "조직",
          "enum": [
            "Organization"
          ],
          "default": "Organization"
        },
        "name": {
          "type": "string",
          "description": "생성 요청한 기업"
        }
      }
    },
    "@graph": {
      "type": "array",
      "description": "상품 데이터",
      "minItems": 1,
      "maxItems": 1000,
      "items": {
        "type": "object",
        "properties": {
          "@type": {
            "type": "string",
            "description": "https://schema.org/Product",
            "enum": [
              "Product"
            ],
            "default": "Product"
          },
          "sku": {
            "type": "string",
            "description": "상품 코드"
          },
          "name": {
            "description": "상품명",
            "oneOf": [
              {
                "type": "array",
                "items": {
                  "$ref": "#/$defs/langName"
                }
              },
              {
                "$ref": "#/$defs/langName"
              },
              {
                "type": "string"
              }
            ]
          },
          "description": {
            "oneOf": [
              {
                "type": "array",
                "items": {
                  "$ref": "#/$defs/description"
                }
              },
              {
                "$ref": "#/$defs/description"
              }
            ]
          },
          "brand": {
            "type": "object",
            "description": "브랜드 정보",
            "properties": {
              "@type": {
                "type": "string",
                "description": "https://schema.org/Brand",
                "enum": [
                  "Brand"
                ],
                "default": "Brand"
              },
              "@id": {
                "type": "string",
                "description": "브랜드 아이디"
              },
              "name": {
                "oneOf": [
                  {
                    "type": "array",
                    "items": {
                      "$ref": "#/$defs/brandName"
                    }
                  },
                  {
                    "$ref": "#/$defs/brandName"
                  },
                  {
                    "type": "string",
                    "description": "브랜드 이름"
                  }
                ]
              },
              "logo": {
                "type": "array",
                "description": "브랜드 로고",
                "items": {
                  "type": "string",
                  "description": "브랜드 로고"
                }
              }
            },
            "required": [
              "@id",
              "name"
            ]
          },
          "category": {
            "description": "카테고리 정보",
            "oneOf": [
              {
                "type": "array",
                "description": "카테고리",
                "minItems": 1,
                "items": {
                  "$ref": "#/$defs/category"
                }
              },
              {
                "$ref": "#/$defs/category"
              }
            ]
          },
          "positiveNotes": {
            "oneOf": [
              {
                "type": "array",
                "items": {
                  "$ref": "#/$defs/positiveNote"
                }
              },
              {
                "$ref": "#/$defs/positiveNote"
              },
              {
                "type": "array",
                "description": "핵심 장점 요약",
                "items": {
                  "type": "string"
                }
              },
              {
                "type": "string",
                "description": "핵심 장점 요약"
              }
            ]
          },
          "url": {
            "oneOf": [
              {
                "type": "array",
                "items": {
                  "$ref": "#/$defs/url"
                }
              },
              {
                "$ref": "#/$defs/url"
              },
              {
                "type": "array",
                "description": "상품 페이지 URL",
                "items": {
                  "type": "string"
                }
              },
              {
                "type": "string",
                "description": "상품 페이지 URL"
              }
            ]
          },
          "mobileUrl": {
            "oneOf": [
              {
                "type": "array",
                "items": {
                  "$ref": "#/$defs/mobileUrl"
                }
              },
              {
                "$ref": "#/$defs/mobileUrl"
              },
              {
                "type": "array",
                "description": "모바일 상품 페이지 URL",
                "items": {
                  "type": "string"
                }
              },
              {
                "type": "string",
                "description": "모바일 상품 페이지 URL"
              }
            ]
          },
          "itemCondition": {
            "type": "string",
            "description": "상품 상태",
            "enum": [
              "NewCondition",
              "RefurbishedCondition",
              "UsedCondition",
              "DamagedCondition"
            ]
          },
          "hasAdultConsideration": {
            "type": "string",
            "description": "성인 대상 상품",
            "enum": [
              "AlcoholConsideration",
              "DangerousGoodConsideration",
              "HealthcareConsideration",
              "NarcoticConsideration",
              "ReducedRelevanceForChildrenConsideration",
              "SexualContentConsideration",
              "TobaccoNicotineConsideration",
              "UnclassifiedAdultConsideration",
              "ViolenceConsideration",
              "WeaponConsideration"
            ]
          },
          "countryOfOrigin": {
            "type": "object",
            "description": "제조 국가 정보",
            "properties": {
              "@type": {
                "type": "string",
                "description": "https://schema.org/Country",
                "enum": [
                  "Country"
                ],
                "default": "Country"
              },
              "address": {
                "type": "string",
                "description": "제조 국가 코드 (ISO 3166-1-alpha-2)"
              }
            },
            "required": [
              "address"
            ]
          },
          "material": {
            "oneOf": [
              {
                "type": "array",
                "minItems": 1,
                "items": {
                  "$ref": "#/$defs/material"
                }
              },
              {
                "$ref": "#/$defs/material"
              },
              {
                "type": "array",
                "description": "소재 정보",
                "items": {
                  "type": "string"
                }
              },
              {
                "type": "string",
                "description": "소재 정보"
              }
            ]
          },
          "additionalProperty": {
            "type": "array",
            "description": "부가 정보",
            "minItems": 1,
            "items": {
              "type": "object",
              "properties": {
                "@type": {
                  "type": "string",
                  "description": "https://schema.org/PropertyValue",
                  "enum": [
                    "PropertyValue"
                  ],
                  "default": "PropertyValue"
                },
                "propertyID": {
                  "type": "string",
                  "description": "속성 아이디"
                },
                "value": {
                  "description": "속성 값"
                }
              }
            }
          },
          "offers": {
            "oneOf": [
              {
                "$ref": "#/$defs/offers"
              },
              {
                "type": "array",
                "description": "",
                "minItems": 1,
                "items": {
                  "$ref": "#/$defs/offers"
                }
              }
            ]
          }
        },
        "required": [
          "sku",
          "name",
          "description",
          "brand",
          "category",
          "url",
          "offers"
        ]
      }
    }
  },
  "required": [
    "agent",
    "@graph"
  ],
  "$defs": {
    "langName": {
      "type": "object",
      "properties": {
        "@value": {
          "type": "string",
          "description": "상품명"
        },
        "@language": {
          "type": "string",
          "description": "ISO 639-1 언어코드",
          "enum": [
            "ko",
            "en",
            "ja"
          ],
          "pattern": "^[a-z]{2}$",
          "default": "ko"
        }
      },
      "required": [
        "@value",
        "@language"
      ]
    },
    "brandName": {
      "type": "object",
      "description": "브랜드 이름",
      "properties": {
        "@value": {
          "type": "string",
          "description": "브랜드 이름"
        },
        "@language": {
          "type": "string",
          "description": "ISO 639-1 언어코드",
          "enum": [
            "ko",
            "en",
            "ja"
          ],
          "pattern": "^[a-z]{2}$",
          "default": "ko"
        }
      },
      "required": [
        "@value",
        "@language"
      ]
    },
    "description": {
      "type": "object",
      "description": "상품 상세 설명 정보",
      "properties": {
        "@type": {
          "type": "string",
          "description": "https://schema.org/TextObject",
          "enum": [
            "TextObject"
          ],
          "default": "TextObject"
        },
        "text": {
          "type": "string",
          "description": "상품 상세 설명"
        },
        "inLanguage": {
          "type": "string",
          "description": "ISO 639-1 언어코드",
          "enum": [
            "ko",
            "en",
            "ja"
          ],
          "pattern": "^[a-z]{2}$",
          "default": "ko"
        },
        "image": {
          "description": "상품 상세 설명 (이미지)",
          "oneOf": [
            {
              "type": "array",
              "minItems": 1,
              "items": {
                "$ref": "#/$defs/descriptionImage"
              }
            },
            {
              "$ref": "#/$defs/descriptionImage"
            }
          ]
        },
        "additionalProperty": {
          "type": "array",
          "description": "상품 설명 부가 정보",
          "minItems": 1,
          "items": {
            "type": "object",
            "properties": {
              "@type": {
                "type": "string",
                "description": "https://schema.org/PropertyValue",
                "enum": [
                  "PropertyValue"
                ],
                "default": "PropertyValue"
              },
              "propertyID": {
                "type": "string",
                "description": "속성 아이디"
              },
              "value": {
                "description": "속성 값"
              }
            }
          }
        }
      },
      "required": [
        "text",
        "inLanguage"
      ]
    },
    "descriptionImage": {
      "type": "object",
      "description": "상품 상세 설명 (이미지)",
      "properties": {
        "@type": {
          "type": "string",
          "description": "https://schema.org/ImageObject",
          "enum": [
            "ImageObject"
          ],
          "default": "ImageObject"
        },
        "contentUrl": {
          "type": "string",
          "description": "이미지 파일 URL"
        },
        "inLanguage": {
          "type": "string",
          "description": "ISO 639-1 언어코드",
          "enum": [
            "ko",
            "en",
            "ja"
          ],
          "pattern": "^[a-z]{2}$",
          "default": "ko"
        }
      }
    },
    "category": {
      "type": "object",
      "properties": {
        "@type": {
          "type": "string",
          "description": "https://schema.org/CategoryCode",
          "enum": [
            "CategoryCode"
          ],
          "default": "CategoryCode"
        },
        "codeValue": {
          "type": "string",
          "description": "카테고리 코드"
        },
        "name": {
          "description": "카테고리 이름 정보",
          "oneOf": [
            {
              "type": "array",
              "minItems": 1,
              "items": {
                "$ref": "#/$defs/categoryName"
              }
            },
            {
              "$ref": "#/$defs/categoryName"
            }
          ]
        },
        "position": {
          "type": "integer",
          "description": "카테고리 수준 (대/중/소/세)"
        }
      },
      "required": [
        "codeValue",
        "name",
        "position"
      ]
    },
    "categoryName": {
      "type": "object",
      "properties": {
        "@value": {
          "type": "string",
          "description": "카테고리 이름"
        },
        "@language": {
          "type": "string",
          "description": "ISO 639-1 언어코드",
          "enum": [
            "ko",
            "en",
            "ja"
          ],
          "pattern": "^[a-z]{2}$",
          "default": "ko"
        }
      },
      "required": [
        "@value",
        "@language"
      ]
    },
    "positiveNote": {
      "type": "object",
      "description": "핵심 장점 요약 정보",
      "properties": {
        "@value": {
          "type": "string",
          "description": "핵심 장점 요약"
        },
        "@language": {
          "type": "string",
          "description": "ISO 639-1 언어코드",
          "enum": [
            "ko",
            "en",
            "ja"
          ],
          "pattern": "^[a-z]{2}$",
          "default": "ko"
        }
      },
      "required": [
        "@value",
        "@language"
      ]
    },
    "url": {
      "type": "object",
      "description": "상품 페이지 URL",
      "properties": {
        "@value": {
          "type": "string",
          "description": "상품 페이지 URL"
        },
        "@language": {
          "type": "string",
          "description": "ISO 639-1 언어코드",
          "enum": [
            "ko",
            "en",
            "ja"
          ],
          "pattern": "^[a-z]{2}$",
          "default": "ko"
        }
      },
      "required": [
        "@value",
        "@language"
      ]
    },
    "mobileUrl": {
      "type": "object",
      "description": "모바일 상품 페이지 URL",
      "properties": {
        "@value": {
          "type": "string",
          "description": "모바일 상품 페이지 URL"
        },
        "@language": {
          "type": "string",
          "description": "ISO 639-1 언어코드",
          "enum": [
            "ko",
            "en",
            "ja"
          ],
          "pattern": "^[a-z]{2}$",
          "default": "ko"
        }
      },
      "required": [
        "@value",
        "@language"
      ]
    },
    "image": {
      "type": "object",
      "description": "상품 이미지 정보",
      "properties": {
        "@type": {
          "type": "string",
          "description": "https://schema.org/ImageObject",
          "enum": [
            "ImageObject"
          ],
          "default": "ImageObject"
        },
        "representativeOfPage": {
          "type": "boolean",
          "description": "대표 이미지 여부",
          "default": false
        },
        "contentUrl": {
          "type": "string",
          "description": "이미지 파일 URL"
        },
        "contentSize": {
          "type": "string",
          "description": "이미지 파일 사이즈"
        },
        "width": {
          "type": "object",
          "description": "이미지 넓이",
          "properties": {
            "@type": {
              "type": "string",
              "description": "https://schema.org/QuantitativeValue",
              "enum": [
                "QuantitativeValue"
              ],
              "default": "QuantitativeValue"
            },
            "value": {
              "type": "number",
              "description": "이미지 높이"
            }
          }
        },
        "height": {
          "type": "object",
          "description": "이미지 파일의 높이",
          "properties": {
            "@type": {
              "type": "string",
              "description": "https://schema.org/QuantitativeValue",
              "enum": [
                "QuantitativeValue"
              ],
              "default": "QuantitativeValue"
            },
            "value": {
              "type": "number",
              "description": "이미지 파일의 높이 값"
            }
          }
        }
      },
      "required": [
        "contentUrl"
      ]
    },
    "material": {
      "type": "object",
      "description": "소재 정보",
      "properties": {
        "@value": {
          "type": "string",
          "description": "소재"
        },
        "@language": {
          "type": "string",
          "description": "ISO 639-1 언어코드",
          "enum": [
            "ko",
            "en",
            "ja"
          ],
          "pattern": "^[a-z]{2}$",
          "default": "ko"
        }
      },
      "required": [
        "@value",
        "@language"
      ]
    },
    "priceSpecification": {
      "type": "object",
      "description": "가격 유형",
      "properties": {
        "@type": {
          "type": "string",
          "description": "https://schema.org/UnitPriceSpecification",
          "enum": [
            "UnitPriceSpecification"
          ],
          "default": "UnitPriceSpecification"
        },
        "priceType": {
          "type": "string",
          "description": "가격 유형",
          "enum": [
            "InvoicePrice",
            "ListPrice",
            "MSRP",
            "MinimumAdvertisedPrice",
            "RegularPrice",
            "SRP",
            "SalePrice",
            "StrikethroughPrice"
          ]
        },
        "price": {
          "type": "number",
          "description": "유닛 가격"
        },
        "priceCurrency": {
          "type": "string",
          "description": "ISO 4217 통화코드 (예: KRW, USD, JPY)"
        },
        "unitCode": {
          "type": "string",
          "description": "단위"
        }
      },
      "required": [
        "priceType",
        "price",
        "priceCurrency",
        "unitCode"
      ]
    },
    "offers": {
      "type": "object",
      "description": "SKU 별 가격, 판매 가능여부 ",
      "properties": {
        "@type": {
          "type": "string",
          "description": "https://schema.org/Offer",
          "enum": [
            "Offer"
          ],
          "default": "Offer"
        },
        "sku": {
          "type": "string",
          "description": "판매용 SKU"
        },
        "gtin": {
          "type": "string",
          "description": "국제 표준 바코드 (GTIN / EAN / UPC / ISBN), GTIN-13 = EAN "
        },
        "mpn": {
          "type": "string",
          "description": "제조사 부품 번호 (Manufacturer Part Number)"
        },
        "price": {
          "type": "number",
          "description": "판매가격"
        },
        "priceCurrency": {
          "type": "string",
          "description": "ISO 4217 통화코드 (예: KRW, USD, JPY)",
          "pattern": "^[A-Z]{3}$"
        },
        "priceSpecification": {
          "oneOf": [
            {
              "type": "array",
              "minItems": 1,
              "items": {
                "$ref": "#/$defs/priceSpecification"
              }
            },
            {
              "$ref": "#/$defs/priceSpecification"
            }
          ]
        },
        "color": {
          "type": "string",
          "description": "색상"
        },
        "size": {
          "type": "string",
          "description": "사이즈"
        },
        "availability": {
          "type": "string",
          "description": "재고 상태",
          "enum": [
            "BackOrder",
            "Discontinued",
            "InStock",
            "InStoreOnly",
            "LimitedAvailability",
            "MadeToOrder",
            "OnlineOnly",
            "OutOfStock",
            "PreOrder",
            "PreSale",
            "Reserved",
            "SoldOut"
          ]
        },
        "availabilityStarts": {
          "type": "string",
          "description": "ISO 8601 UTC 생성시간 (2025-11-28T10:00:00Z)",
          "pattern": "Z$"
        },
        "availabilityEnds": {
          "type": "string",
          "description": "ISO 8601 UTC 생성시간 (2025-11-28T10:00:00Z)",
          "pattern": "Z$"
        },
        "inventoryLevel": {
          "type": "object",
          "description": "재고 현황 정보",
          "properties": {
            "@type": {
              "type": "string",
              "description": "https://schema.org/QuantitativeValue",
              "enum": [
                "QuantitativeValue"
              ],
              "default": "QuantitativeValue"
            },
            "value": {
              "type": "number",
              "description": "재고 현황"
            }
          },
          "required": [
            "value"
          ]
        },
        "shippingDetails": {
          "type": "object",
          "description": "배송 정보",
          "properties": {
            "@type": {
              "type": "string",
              "description": "https://schema.org/OfferShippingDetails",
              "enum": [
                "OfferShippingDetails"
              ],
              "default": "OfferShippingDetails"
            },
            "weight": {
              "type": "object",
              "description": "배송 무게",
              "properties": {
                "@type": {
                  "type": "string",
                  "description": "https://schema.org/OfferShippingDetails",
                  "enum": [
                    "QuantitativeValue"
                  ],
                  "default": "QuantitativeValue"
                },
                "value": {
                  "type": "number",
                  "description": "배송 무게"
                },
                "unitCode": {
                  "type": "string",
                  "description": "배송 무게 표시 단위"
                }
              },
              "required": [
                "value",
                "unitCode"
              ]
            }
          },
          "required": [
            "weight"
          ]
        },
        "image": {
          "oneOf": [
            {
              "type": "array",
              "minItems": 1,
              "items": {
                "$ref": "#/$defs/image"
              }
            },
            {
              "$ref": "#/$defs/image"
            }
          ]
        },
        "additionalProperty": {
          "type": "array",
          "description": "부가 정보",
          "minItems": 1,
          "items": {
            "type": "object",
            "properties": {
              "@type": {
                "type": "string",
                "description": "https://schema.org/PropertyValue",
                "enum": [
                  "PropertyValue"
                ],
                "default": "PropertyValue"
              },
              "propertyID": {
                "type": "string",
                "description": "속성 아이디"
              },
              "value": {
                "description": "속성 값"
              }
            }
          }
        }
      },
      "required": [
        "sku",
        "gtin",
        "mpn",
        "price",
        "priceCurrency",
        "color",
        "size",
        "availability",
        "availabilityStarts",
        "availabilityEnds",
        "image"
      ]
    }
  }
}
```

</details>

<details>

<summary>상품 삭제</summary>

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "고객사 상품수집 - 상품 삭제",
  "description": "고객사의 상품 데이터 삭제 요청 수집",
  "type": "object",
  "properties": {
    "@context": {
      "type": "string",
      "description": "context",
      "enum": [
        "https://schema.org"
      ],
      "default": "https://schema.org"
    },
    "specversion": {
      "type": "string",
      "description": "스펙 버전",
      "enum": [
        "1.0"
      ],
      "default": "1.0"
    },
    "id": {
      "type": "string",
      "description": "이벤트 고유 식별자",
      "enum": [
        "EVT-DELETE-PRODUCT"
      ],
      "default": "EVT-DELETE-PRODUCT"
    },
    "type": {
      "type": "string",
      "description": "상품 수집 유형",
      "enum": [
        "delete_product"
      ],
      "default": "delete_product"
    },
    "agent": {
      "type": "object",
      "description": "조직 정보",
      "required": [
        "name"
      ],
      "properties": {
        "@type": {
          "type": "string",
          "description": "조직",
          "enum": [
            "Organization"
          ],
          "default": "Organization"
        },
        "name": {
          "type": "string",
          "description": "생성 요청한 기업"
        }
      }
    },
    "@graph": {
      "type": "array",
      "description": "상품 데이터",
      "minItems": 1,
      "maxItems": 1000,
      "items": {
        "type": "object",
        "properties": {
          "@type": {
            "type": "string",
            "description": "https://schema.org/Product",
            "enum": [
              "Product"
            ],
            "default": "Product"
          },
          "sku": {
            "type": "string",
            "description": "상품 코드"
          }
        },
        "required": [
          "sku"
        ]
      }
    }
  },
  "required": [
    "@graph"
  ]
}

```

</details>