상품 APIs – Open APIs

상품 생성

쿠팡에서 판매할 상품을 등록하는 API 입니다. 상품을 생성할 때는 쿠팡 규격에 맞는 출고지/반품지, 카테고리, 고시정보, 옵션 정보 등이 필요합니다. 아래 상품등록 가이드를 다운받으시면, 보다 상세하게 확인하실 수 있습니다. [Download] 쿠팡 OPENAPI 상품등록가이드 Path POST /v2/providers/seller_api... 더보기

상품 승인 요청

임시저장 상태의 상품은 승인요청->승인완료 단계를 거처 상품 페이지에 노출됩니다. 주의: "인벤토리(XXXX)는 승인요청 상태가 아닙니다." 메시지는 "업체상품[XXXX]이 승인요청 가능한 상태가 아닙니다." 의 의미입니다. '임시저장' 상태에서만 '승인요청'이 가능합니다. 상품생성, 수정 API 에서 requested 파라메터를 true 로 입력할... 더보기

상품 조회

등록상품 ID(sellerProductId)로 등록된 상품의 정보를 조회합니다. 상품 가격/재고/판매상태 수정 시 필요한 옵션ID(vendorItemId)를 확인할 수 있습니다. 또한, 상품 정보를 조회하여 상품 수정 시 활용할 수 있는 전문을 얻을 수 있습니다. Path GET /v2/providers/seller_api/apis/api/v1/... 더보기

상품 조회 (승인불필요)

해당 상품의 배송 및 반품지 등의 관련 정보를 조회할 수 있습니다. 본 API의 응답 메시지를 활용하여, [상품 수정 API (승인불필요)]에서 빠르게 정보를 수정할 수 있습니다. Path GET /v2/providers/seller_api/apis/api/v1/marketplace/seller-products/{sellerProductId}... 더보기

상품 수정 (승인필요)

업체상품 정보를 수정한다.'상품 조회 API'를 이용하여 조회된 JSON 전문에서 원하는 값 만 수정 후, 전체 JSON 전문을 전송하여 수정이 가능합니다. 이 API를 사용하면 승인 후에 반영됩니다. 상품 생성 시 사용한 request body에, [sellerProductId]와 [sellerProductItemId]를 삽입하여 수정 가능- 옵션... 더보기

상품 수정 (승인불필요)

배송 및 반품지 관련 정보를 별도의 승인 절차 없이 빠르게 수정할 수 있습니다. 수정 가능한 속성은 Body Parameter를 참고해 주시기 바랍니다. '임시저장중', '승인대기중' 인 상품은 수정할 수 없습니다. Path PUT /v2/providers/seller_api/apis/api/v1/marketplace/seller-produ... 더보기

상품 삭제

등록된 상품을 삭제한다. 상품이 승인대기중 상태가 아니며, 상품에 포함된 옵션(아이템)이 모두 판매중지된 경우에 삭제가 가능합니다. Path DELETE /v2/providers/seller_api/apis/api/v1/marketplace/seller-products/{sellerProductId} Example Endpoint https://api... 더보기

상품 등록 현황 조회

판매자가 등록할 수 있는 상품수와 현재 등록되어 있는 상품수를 조회한다. 생성 가능한 최대 상품수(permittedCount)가 null일 경우 제한없이 상품등록이 가능합니다. Path GET /v2/providers/seller_api/apis/api/v1/marketplace/seller-products/inflow-status Example En... 더보기

상품 목록 페이징 조회

등록상품 목록을 페이징 조회한다. Path GET /v2/providers/seller_api/apis/api/v1/marketplace/seller-products Example Endpoint https://api-gateway.coupang.com/v2/providers/seller_api/apis/api/v1/marketplace/seller-... 더보기

상품 목록 구간 조회

등록된 상품 목록을 생성일시 기준으로 조회한다. 최대 조회 범위는 10분입니다. Path GET /v2/providers/seller_api/apis/api/v1/marketplace/seller-products/time-frame Example Endpoint https://api-gateway.coupang.com/v2/providers/selle... 더보기

상품 상태변경이력 조회

등록상품ID(sellerProductId)로 상품 상태변경이력을 조회한다. Path GET /v2/providers/seller_api/apis/api/v1/marketplace/seller-products/{sellerProductId}/histories Example Endpoint https://api-gateway.coupang.com/v2/p... 더보기

상품 요약 정보 조회

상품등록/수정 시 입력한 판매자 상품코드(externalVendorSku)로 상품 요약 정보를 조회할 수 있다. Path GET /v2/providers/seller_api/apis/api/v1/marketplace/seller-products/external-vendor-sku-codes/{externalVendorSkuCode} Example E... 더보기

상품 아이템별 수량/가격/상태 조회

상품 아이템별 재고수량, 판매가격, 판매상태를 조회한다. Path GET /v2/providers/seller_api/apis/api/v1/marketplace/vendor-items/{vendorItemId}/inventories Example Endpoint https://api-gateway.coupang.com/v2/providers/selle... 더보기

상품 아이템별 수량 변경

상품 아이템별 재고수량을 변경한다. 이 기능은 판매요청 신청 후 승인완료되어 옵션ID(vendorItemId)가 발급되면 사용할 수 있다. Path PUT /v2/providers/seller_api/apis/api/v1/marketplace/vendor-items/{vendorItemId}/quantities/{quantity} Example End... 더보기

상품 아이템별 가격 변경

상품 아이템별 판매가격을 변경한다.이 기능은 판매요청 신청 후 승인완료되어 옵션ID(vendorItemId)가 발급되면 사용할 수 있다. forceSalePriceUpdate=true 으로 가격변경 요청 시 변경 비율 제한없이 가격변경이 가능합니다. Path PUT /v2/providers/seller_api/apis/api/v1/marketplace... 더보기

상품 아이템별 판매 재개

상품 아이템별 판매상태를 판매중으로 변경한다. 이 기능은 판매요청 신청 후 승인완료되어 옵션ID(vendorItemId)가 발급되면 사용할 수 있다. Path PUT /v2/providers/seller_api/apis/api/v1/marketplace/vendor-items/{vendorItemId}/sales/resume Example Endpoi... 더보기

상품 아이템별 판매 중지

상품 아이템별 판매상태를 판매중지로 변경한다. 이 기능은 판매요청 신청 후 승인완료되어 옵션ID(vendorItemId)가 발급되면 사용할 수 있다. Path PUT /v2/providers/seller_api/apis/api/v1/marketplace/vendor-items/{vendorItemId}/sales/stop Example Endpoint... 더보기

상품 아이템별 할인율 기준가격 변경

상품 아이템별 할인율 기준가격을 변경한다. 이 기능은 판매요청 신청 후 승인완료되어 옵션ID(vendorItemId)가 발급되면 사용할 수 있다. Path PUT /v2/providers/seller_api/apis/api/v1/marketplace/vendor-items/{vendorItemId}/original-prices/{originalPric... 더보기

자동생성옵션 활성화 (옵션 상품 단위)

자동생성옵션을 개별 옵션상품마다 활성화할 수 있는 API 입니다. 판매자님이 등록한 상품에 대해 자동생성옵션을 활성화한다면, 조건에 맞는 옵션이 자동생성 됩니다. 필요 정보는 옵션 ID입니다. Path POST /v2/providers/seller_api/apis/api/v1/marketplace/vendor-items/{vendorItemId... 더보기

자동생성옵션 활성화 (전체 상품 단위)

자동생성옵션을 전체 상품에 대해 활성화할 수 있는 API 입니다. 자동생성옵션을 활성화한다면, 판매자님의 등록한 상품 중 조건에 맞는 옵션이 자동생성 됩니다. Path POST /v2/providers/seller_api/apis/api/v1/marketplace/seller/auto-generated/opt-in Example Endpoint h... 더보기

자동생성옵션 비활성화 (옵션 상품 단위)

자동생성옵션을 개별 옵션상품마다 비활성화할 수 있는 API 입니다. 판매자님이 기존 등록 상품에 대해 자동생성옵션을 비활성화 요청한다면, 더 이상 옵션이 자동 생성되지 않습니다. 이미 자동 생성된 옵션을 더 이상 판매하고 싶지 않다면 판매 중지를 설정하시면 됩니다. Path POST /v2/providers/seller_api/apis/api/v1... 더보기

자동생성옵션 비활성화 (전체 상품 단위)

자동생성옵션을 전체 상품에 대해 비활성화할 수 있는 API 입니다. 판매자님이 기존 등록 상품에 대해 자동생성옵션을 비활성화 요청한다면, 더 이상 옵션이 자동 생성되지 않습니다. 이미 자동 생성된 옵션을 더 이상 판매하고 싶지 않으시다면 판매 중지를 설정하시면 됩니다. Path POST /v2/providers/seller_api/apis/api/... 더보기

OPENAPI 관련 안내