> ## Documentation Index
> Fetch the complete documentation index at: https://developers-partners.delivered.co.kr/llms.txt
> Use this file to discover all available pages before exploring further.

# 상품 정보 수정

> 
            상품 수정 API 입니다.
            path 파라미터 shopProductId로 식별되는 상품 1건을 수정합니다.
            PUT 시맨틱에 따라 요청 body의 값으로 상품 정보 전체를 교체합니다(부분 업데이트 아님).
        



## OpenAPI

````yaml /api-reference/global-link-api.json PUT /open-api/v1/global-link/products/{shopProductId}
openapi: 3.0.1
info:
  title: Global Link Open API
  description: '-'
  version: 1.0.0
servers:
  - url: https://gw-staging.delivered.co.kr/global-ship
    description: 테스트 환경
  - url: https://auth.delivered.co.kr/global-ship
    description: 운영 환경
security:
  - Authorization: []
tags:
  - name: 글로벌링크 상품
    description: 글로벌링크 상품
paths:
  /open-api/v1/global-link/products/{shopProductId}:
    put:
      tags:
        - Global Link Product
      summary: 글로벌링크 상품 단건 수정
      description: |2-

                    상품 수정 API 입니다.
                    path 파라미터 shopProductId로 식별되는 상품 1건을 수정합니다.
                    PUT 시맨틱에 따라 요청 body의 값으로 상품 정보 전체를 교체합니다(부분 업데이트 아님).
                
      operationId: updateProduct
      parameters:
        - name: shopProductId
          in: path
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GlobalLinkProductUpdateRequest'
        required: true
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/GlobalLinkProductUpdateResponse'
components:
  schemas:
    GlobalLinkProductUpdateRequest:
      required:
        - brandName
        - discountedProductPrice
        - domesticShippingPrice
        - freeDomesticShippingPriceCondition
        - mainImage
        - originProductUrl
        - productDetailImages
        - productImages
        - productName
        - productPrice
        - stockQuantity
      type: object
      properties:
        productName:
          type: string
          description: 상품명
          example: 베이직 코튼 반팔 티셔츠
        brandName:
          type: string
          description: 브랜드명
          example: Delivered Korea
        mainImage:
          type: string
          description: 대표 이미지 URL
          example: https://www.***.co.kr/main.jpg
        productImages:
          type: array
          description: 상품 이미지 URL 목록
          items:
            type: string
            description: 상품 이미지 URL 목록
        productDetailImages:
          type: array
          description: 상품 상세 이미지 URL 목록
          items:
            type: string
            description: 상품 상세 이미지 URL 목록
        productPrice:
          type: integer
          description: 상품가 (KRW)
          format: int64
          example: 19900
        discountedProductPrice:
          type: integer
          description: 할인 적용가 (KRW). 할인이 없으면 productPrice와 동일 값
          format: int64
          example: 14900
        domesticShippingPrice:
          type: integer
          description: 국내 배송비 (KRW)
          format: int64
          example: 3000
        freeDomesticShippingPriceCondition:
          type: integer
          description: 국내 무료배송 조건 금액 (KRW). 해당 금액 이상 구매 시 배송비 무료. 조건 없으면 0
          format: int64
          example: 30000
        stockQuantity:
          type: integer
          description: 재고 수량
          format: int32
          example: 250
        originProductUrl:
          type: string
          description: 원본 상품 URL (파트너사 상품 페이지)
          example: https://www.***.co.kr/***
        productOptionGroup:
          type: array
          description: 상품 옵션 그룹. 옵션이 없는 단일 상품이면 null
          items:
            $ref: '#/components/schemas/ProductOptionGroup'
    GlobalLinkProductUpdateResponse:
      required:
        - shopProductId
        - shopType
        - updatedAt
      type: object
      properties:
        shopType:
          type: string
          description: 파트너사 마켓 sub type
          example: SMART_STORE
        shopProductId:
          type: string
          description: 수정된 상품의 파트너사 상품 ID
          example: product-001
        updatedAt:
          type: string
          description: 수정 완료 시각 (다운스트림 응답에 없을 경우 본 게이트웨이 처리 시각으로 fallback)
          format: date-time
    ProductOptionGroup:
      required:
        - productOption
        - productOptionGroupName
        - productOptionGroupType
      type: object
      properties:
        productOptionGroupType:
          type: string
          description: '옵션 그룹 타입 (SIMPLE: 단일선택, COMBINATION: 조합형, TEXT: 텍스트 입력)'
          example: COMBINATION
          enum:
            - SIMPLE
            - COMBINATION
            - TEXT
        productOptionGroupName:
          type: array
          description: '옵션 그룹명 목록 (예: 색상, 사이즈)'
          items:
            $ref: '#/components/schemas/ProductOptionGroupName'
        productOption:
          type: array
          description: 옵션(SKU) 목록
          items:
            $ref: '#/components/schemas/ProductOption'
      description: 상품 옵션 그룹. 옵션이 없는 단일 상품이면 null
    ProductOptionGroupName:
      required:
        - productOptionGroupName
        - shopGroupOptionId
      type: object
      properties:
        shopGroupOptionId:
          type: integer
          description: 파트너사의 옵션 그룹 ID
          format: int64
          example: 1
        productOptionGroupName:
          type: string
          description: 옵션 그룹명
          example: 색상
      description: '옵션 그룹명 목록 (예: 색상, 사이즈)'
    ProductOption:
      required:
        - availablePurchaseQuantityMax
        - availablePurchaseQuantityMin
        - optionPrice
        - order
        - productOptionName
        - shopOptionId
        - stockQuantity
      type: object
      properties:
        productOptionName:
          type: array
          description: '옵션 그룹별 옵션값 목록 (예: 색상=블랙, 사이즈=M)'
          items:
            $ref: '#/components/schemas/ProductOptionName'
        optionPrice:
          type: integer
          description: 옵션 단가 (KRW)
          format: int64
          example: 19900
        stockQuantity:
          type: integer
          description: 옵션별 재고 수량
          format: int32
          example: 50
        order:
          type: integer
          description: 옵션 노출 순서 (0부터 시작)
          format: int32
          example: 0
        shopOptionId:
          type: string
          description: 파트너사의 옵션 ID
          example: opt-001
        availablePurchaseQuantityMin:
          type: integer
          description: 최소 구매 가능 수량
          format: int32
          example: 1
        availablePurchaseQuantityMax:
          type: integer
          description: 최대 구매 가능 수량
          format: int32
          example: 10
      description: 옵션(SKU) 목록
    ProductOptionName:
      required:
        - productOptionName
        - shopGroupOptionId
      type: object
      properties:
        shopGroupOptionId:
          type: integer
          description: 해당 값이 속한 옵션 그룹 ID (ProductOptionGroupName.shopGroupOptionId 참조)
          format: int64
          example: 1
        productOptionName:
          type: string
          description: '옵션값 (예: 블랙, M)'
          example: 블랙
      description: '옵션 그룹별 옵션값 목록 (예: 색상=블랙, 사이즈=M)'
  securitySchemes:
    Authorization:
      type: apiKey
      description: 발급받은 시크릿 키
      name: Authorization
      in: header

````