{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"딜리버드 파트너스 개발자 센터","colors":{"primary":"#FF9123","light":"#FF9123","dark":"#FF9123"},"logo":{"light":"https://mintcdn.com/deliveredkorea/nWJ7e83AaZRK5B9H/logo/light.svg?fit=max\u0026auto=format\u0026n=nWJ7e83AaZRK5B9H\u0026q=85\u0026s=8ca84e82637f7edb2b349181a5b3a2af","dark":"https://mintcdn.com/deliveredkorea/nWJ7e83AaZRK5B9H/logo/dark.svg?fit=max\u0026auto=format\u0026n=nWJ7e83AaZRK5B9H\u0026q=85\u0026s=5d4948a599b180ebd3a9f697205f2957"},"favicon":"https://mintcdn.com/deliveredkorea/nWJ7e83AaZRK5B9H/favicon_250327.svg?fit=max\u0026auto=format\u0026n=nWJ7e83AaZRK5B9H\u0026q=85\u0026s=c33eda690fbff744bd6da8aa83ba6896","navbar":{"links":[{"href":"https://developers-partners.delivered.co.kr/contact-form","label":"문의하기"}],"primary":{"type":"button","label":"파트너스 콘솔","href":"https://partners.delivered.co.kr/service/login"}},"integrations":{},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"deliveredkorea","hasAudioNarration":false,"actualSubdomain":"deliveredkorea","customDomains":["developers-partners.delivered.co.kr"],"gitSource":{"type":"github","owner":"delivered-dev","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6ab9fa18c6cd70013ee45f6a","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"default","tag":"API \u0026 SDK","count":21},{"language":"default","tag":"글로벌쉽","count":9},{"language":"default","tag":"가이드","count":7},{"language":"default","tag":"글로벌링크","count":7},{"language":"default","tag":"글로벌체크아웃","count":6},{"language":"default","tag":"배송 API","count":5},{"language":"default","tag":"상품 API","count":4},{"language":"default","tag":"주문 API","count":3},{"language":"default","tag":"OPEN API 이용 안내","count":3},{"language":"default","tag":"레퍼런스","count":2}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"reference/global-ship/api/create-products","slug":"/reference/global-ship/api/create-products","pageMetadata":{"title":"상품 등록","openapi":"api-reference/global-link-api.json POST /open-api/v1/global-link/products","description":"\n 상품 등록 API 입니다.\n 상품을 Bulk로 등록합니다. 1회 요청 시 최대 100건까지 처리합니다.\n\n 응답은 부분 성공 모델입니다.\n - successCount: 등록 성공한 상품 수\n - failureCount: 실패한 상품 수\n - failures[]: 실패한 상품별 상세 (shopProductId, errorCode, message)\n 실패가 있어도 HTTP 200으로 응답하므로, 클라이언트는 failures[]를 반드시 확인해야 합니다.\n ","href":"/reference/global-ship/api/create-products"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n li: \"li\",\n p: \"p\",\n ul: \"ul\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"상품 등록 API 입니다.\\n상품을 Bulk로 등록합니다. 1회 요청 시 최대 100건까지 처리합니다.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"응답은 부분 성공 모델입니다.\"\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsx(_components.li, {\n children: \"successCount: 등록 성공한 상품 수\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"failureCount: 실패한 상품 수\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"failures[]: 실패한 상품별 상세 (shopProductId, errorCode, message)\\n실패가 있어도 HTTP 200으로 응답하므로, 클라이언트는 failures[]를 반드시 확인해야 합니다.\"\n }), \"\\n\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"상품 등록","openapi":"api-reference/global-link-api.json POST /open-api/v1/global-link/products","description":"\n 상품 등록 API 입니다.\n 상품을 Bulk로 등록합니다. 1회 요청 시 최대 100건까지 처리합니다.\n\n 응답은 부분 성공 모델입니다.\n - successCount: 등록 성공한 상품 수\n - failureCount: 실패한 상품 수\n - failures[]: 실패한 상품별 상세 (shopProductId, errorCode, message)\n 실패가 있어도 HTTP 200으로 응답하므로, 클라이언트는 failures[]를 반드시 확인해야 합니다.\n ","href":"/reference/global-ship/api/create-products"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Global Link Product"],"summary":"글로벌링크 상품 등록","description":"\n 상품 등록 API 입니다.\n 상품을 Bulk로 등록합니다. 1회 요청 시 최대 100건까지 처리합니다.\n\n 응답은 부분 성공 모델입니다.\n - successCount: 등록 성공한 상품 수\n - failureCount: 실패한 상품 수\n - failures[]: 실패한 상품별 상세 (shopProductId, errorCode, message)\n 실패가 있어도 HTTP 200으로 응답하므로, 클라이언트는 failures[]를 반드시 확인해야 합니다.\n ","operationId":"registerProducts","requestBody":"fdd8545e-ac7e-47d6-9306-cb5e1dde1ba3","responses":{"200":"d682916e-519d-48b8-94d1-0663a62642b2"},"method":"post","type":"path","servers":["02f35447-197b-45ce-aa6d-a06b9151e667","d49bc65c-8032-49d9-9ad8-6b77aa95ce97"],"security":["7a34eb65-b1c6-45a0-82b8-92defdb37c4f"],"path":"/open-api/v1/global-link/products","baseUrlOptions":["https://gw-staging.delivered.co.kr/global-ship","https://auth.delivered.co.kr/global-ship"],"title":"글로벌링크 상품 등록","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"required":["products"],"type":"object","properties":{"products":{"type":"array","description":"등록할 상품 목록 (1회 요청당 최대 100건)","items":{"required":["brandName","discountedProductPrice","domesticShippingPrice","freeDomesticShippingPriceCondition","mainImage","originProductUrl","productDetailImages","productImages","productName","productPrice","shopProductId","stockQuantity"],"type":"object","properties":{"productName":{"type":"string","description":"상품명","example":"베이직 코튼 반팔 티셔츠","isRequired":true,"uniqueKey":"products.items.[INDEX].productName","typeLabel":"string"},"brandName":{"type":"string","description":"브랜드명","example":"Delivered Korea","isRequired":true,"uniqueKey":"products.items.[INDEX].brandName","typeLabel":"string"},"mainImage":{"type":"string","description":"대표 이미지 URL","example":"https://www.***.co.kr/main.jpg","isRequired":true,"uniqueKey":"products.items.[INDEX].mainImage","typeLabel":"string"},"productImages":{"type":"array","description":"상품 이미지 URL 목록","items":{"type":"string","description":"상품 이미지 URL 목록","uniqueKey":"products.items.[INDEX].productImages.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"products.items.[INDEX].productImages","typeLabel":"string[]"},"productDetailImages":{"type":"array","description":"상품 상세 이미지 URL 목록","items":{"type":"string","description":"상품 상세 이미지 URL 목록","uniqueKey":"products.items.[INDEX].productDetailImages.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"products.items.[INDEX].productDetailImages","typeLabel":"string[]"},"productPrice":{"type":"integer","description":"상품가 (KRW)","format":"int64","example":19900,"isRequired":true,"uniqueKey":"products.items.[INDEX].productPrice","typeLabel":"integer\u003cint64>"},"discountedProductPrice":{"type":"integer","description":"할인 적용가 (KRW). 할인이 없으면 productPrice와 동일 값","format":"int64","example":14900,"isRequired":true,"uniqueKey":"products.items.[INDEX].discountedProductPrice","typeLabel":"integer\u003cint64>"},"domesticShippingPrice":{"type":"integer","description":"국내 배송비 (KRW)","format":"int64","example":3000,"isRequired":true,"uniqueKey":"products.items.[INDEX].domesticShippingPrice","typeLabel":"integer\u003cint64>"},"freeDomesticShippingPriceCondition":{"type":"integer","description":"국내 무료배송 조건 금액 (KRW). 해당 금액 이상 구매 시 배송비 무료. 조건 없으면 0","format":"int64","example":30000,"isRequired":true,"uniqueKey":"products.items.[INDEX].freeDomesticShippingPriceCondition","typeLabel":"integer\u003cint64>"},"stockQuantity":{"type":"integer","description":"재고 수량","format":"int32","example":250,"isRequired":true,"uniqueKey":"products.items.[INDEX].stockQuantity","typeLabel":"integer\u003cint32>"},"originProductUrl":{"type":"string","description":"원본 상품 URL (파트너사 상품 페이지)","example":"https://www.***.co.kr/***","isRequired":true,"uniqueKey":"products.items.[INDEX].originProductUrl","typeLabel":"string"},"shopProductId":{"type":"string","description":"파트너사 상품 ID (shop 내 unique)","example":"product-001","isRequired":true,"uniqueKey":"products.items.[INDEX].shopProductId","typeLabel":"string"},"description":{"type":"array","description":"상품 설명 항목 목록 (label/value 페어). 파트너사가 제공하지 않으면 생략 가능","items":{"required":["label","value"],"type":"object","properties":{"label":{"type":"string","description":"설명 항목 라벨","example":"소재","isRequired":true,"uniqueKey":"products.items.[INDEX].description.items.[INDEX].label","typeLabel":"string"},"value":{"type":"string","description":"설명 항목 값","example":"100% 순면","isRequired":true,"uniqueKey":"products.items.[INDEX].description.items.[INDEX].value","typeLabel":"string"}},"description":"상품 설명 항목 목록 (label/value 페어). 파트너사가 제공하지 않으면 생략 가능","uniqueKey":"products.items.[INDEX].description.items.[INDEX]","typeLabel":"object"},"uniqueKey":"products.items.[INDEX].description","typeLabel":"object[]"},"productOptionGroup":{"type":"array","description":"상품 옵션 그룹. 옵션이 없는 단일 상품이면 null","items":{"required":["productOption","productOptionGroupName","productOptionGroupType"],"type":"object","properties":{"productOptionGroupType":{"type":"string","description":"옵션 그룹 타입 (SIMPLE: 단일선택, COMBINATION: 조합형, TEXT: 텍스트 입력)","example":"COMBINATION","enum":["SIMPLE","COMBINATION","TEXT"],"isRequired":true,"uniqueKey":"products.items.[INDEX].productOptionGroup.items.[INDEX].productOptionGroupType","typeLabel":"enum\u003cstring>"},"productOptionGroupName":{"type":"array","description":"옵션 그룹명 목록 (예: 색상, 사이즈)","items":{"required":["productOptionGroupName","shopGroupOptionId"],"type":"object","properties":{"shopGroupOptionId":{"type":"integer","description":"파트너사의 옵션 그룹 ID","format":"int64","example":1,"isRequired":true,"uniqueKey":"products.items.[INDEX].productOptionGroup.items.[INDEX].productOptionGroupName.items.[INDEX].shopGroupOptionId","typeLabel":"integer\u003cint64>"},"productOptionGroupName":{"type":"string","description":"옵션 그룹명","example":"색상","isRequired":true,"uniqueKey":"products.items.[INDEX].productOptionGroup.items.[INDEX].productOptionGroupName.items.[INDEX].productOptionGroupName","typeLabel":"string"}},"description":"옵션 그룹명 목록 (예: 색상, 사이즈)","uniqueKey":"products.items.[INDEX].productOptionGroup.items.[INDEX].productOptionGroupName.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"products.items.[INDEX].productOptionGroup.items.[INDEX].productOptionGroupName","typeLabel":"object[]"},"productOption":{"type":"array","description":"옵션(SKU) 목록","items":{"required":["availablePurchaseQuantityMax","availablePurchaseQuantityMin","optionPrice","order","productOptionName","shopOptionId","stockQuantity"],"type":"object","properties":{"productOptionName":{"type":"array","description":"옵션 그룹별 옵션값 목록 (예: 색상=블랙, 사이즈=M)","items":{"required":["productOptionName","shopGroupOptionId"],"type":"object","properties":{"shopGroupOptionId":{"type":"integer","description":"해당 값이 속한 옵션 그룹 ID (ProductOptionGroupName.shopGroupOptionId 참조)","format":"int64","example":1,"isRequired":true,"uniqueKey":"products.items.[INDEX].productOptionGroup.items.[INDEX].productOption.items.[INDEX].productOptionName.items.[INDEX].shopGroupOptionId","typeLabel":"integer\u003cint64>"},"productOptionName":{"type":"string","description":"옵션값 (예: 블랙, M)","example":"블랙","isRequired":true,"uniqueKey":"products.items.[INDEX].productOptionGroup.items.[INDEX].productOption.items.[INDEX].productOptionName.items.[INDEX].productOptionName","typeLabel":"string"}},"description":"옵션 그룹별 옵션값 목록 (예: 색상=블랙, 사이즈=M)","uniqueKey":"products.items.[INDEX].productOptionGroup.items.[INDEX].productOption.items.[INDEX].productOptionName.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"products.items.[INDEX].productOptionGroup.items.[INDEX].productOption.items.[INDEX].productOptionName","typeLabel":"object[]"},"optionPrice":{"type":"integer","description":"옵션 단가 (KRW)","format":"int64","example":19900,"isRequired":true,"uniqueKey":"products.items.[INDEX].productOptionGroup.items.[INDEX].productOption.items.[INDEX].optionPrice","typeLabel":"integer\u003cint64>"},"stockQuantity":{"type":"integer","description":"옵션별 재고 수량","format":"int32","example":50,"isRequired":true,"uniqueKey":"products.items.[INDEX].productOptionGroup.items.[INDEX].productOption.items.[INDEX].stockQuantity","typeLabel":"integer\u003cint32>"},"order":{"type":"integer","description":"옵션 노출 순서 (0부터 시작)","format":"int32","example":0,"isRequired":true,"uniqueKey":"products.items.[INDEX].productOptionGroup.items.[INDEX].productOption.items.[INDEX].order","typeLabel":"integer\u003cint32>"},"shopOptionId":{"type":"string","description":"파트너사의 옵션 ID","example":"opt-001","isRequired":true,"uniqueKey":"products.items.[INDEX].productOptionGroup.items.[INDEX].productOption.items.[INDEX].shopOptionId","typeLabel":"string"},"availablePurchaseQuantityMin":{"type":"integer","description":"최소 구매 가능 수량","format":"int32","example":1,"isRequired":true,"uniqueKey":"products.items.[INDEX].productOptionGroup.items.[INDEX].productOption.items.[INDEX].availablePurchaseQuantityMin","typeLabel":"integer\u003cint32>"},"availablePurchaseQuantityMax":{"type":"integer","description":"최대 구매 가능 수량","format":"int32","example":10,"isRequired":true,"uniqueKey":"products.items.[INDEX].productOptionGroup.items.[INDEX].productOption.items.[INDEX].availablePurchaseQuantityMax","typeLabel":"integer\u003cint32>"}},"description":"옵션(SKU) 목록","uniqueKey":"products.items.[INDEX].productOptionGroup.items.[INDEX].productOption.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"products.items.[INDEX].productOptionGroup.items.[INDEX].productOption","typeLabel":"object[]"}},"description":"상품 옵션 그룹. 옵션이 없는 단일 상품이면 null","uniqueKey":"products.items.[INDEX].productOptionGroup.items.[INDEX]","typeLabel":"object"},"uniqueKey":"products.items.[INDEX].productOptionGroup","typeLabel":"object[]"}},"description":"등록할 상품 목록 (1회 요청당 최대 100건)","uniqueKey":"products.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"products","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"products":[{"productName":"베이직 코튼 반팔 티셔츠","brandName":"Delivered Korea","mainImage":"https://www.***.co.kr/main.jpg","productImages":["\u003cstring>"],"productDetailImages":["\u003cstring>"],"productPrice":19900,"discountedProductPrice":14900,"domesticShippingPrice":3000,"freeDomesticShippingPriceCondition":30000,"stockQuantity":250,"originProductUrl":"https://www.***.co.kr/***","shopProductId":"product-001","description":[{"label":"소재","value":"100% 순면"}],"productOptionGroup":[{"productOptionGroupType":"COMBINATION","productOptionGroupName":[{"shopGroupOptionId":1,"productOptionGroupName":"색상"}],"productOption":[{"productOptionName":[{"shopGroupOptionId":1,"productOptionName":"블랙"}],"optionPrice":19900,"stockQuantity":50,"order":0,"shopOptionId":"opt-001","availablePurchaseQuantityMin":1,"availablePurchaseQuantityMax":10}]}]}]}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"d682916e-519d-48b8-94d1-0663a62642b2":{"description":"OK","content":{"*/*":{"schema":{"required":["failureCount","failures","successCount"],"type":"object","properties":{"successCount":{"type":"integer","description":"등록 성공한 상품 수","format":"int32","example":98,"isRequired":true,"uniqueKey":"successCount","typeLabel":"integer\u003cint32>"},"failureCount":{"type":"integer","description":"등록 실패한 상품 수","format":"int32","example":2,"isRequired":true,"uniqueKey":"failureCount","typeLabel":"integer\u003cint32>"},"failures":{"type":"array","description":"실패한 상품 상세 목록. failureCount가 0이면 빈 배열","items":{"required":["errorCode","message","shopProductId"],"type":"object","properties":{"shopProductId":{"type":"string","description":"실패한 상품의 판매처 상품 ID","example":"product-001","isRequired":true,"uniqueKey":"failures.items.[INDEX].shopProductId","typeLabel":"string"},"errorCode":{"type":"string","description":"실패 사유 코드","example":"INVALID_PRICE","isRequired":true,"uniqueKey":"failures.items.[INDEX].errorCode","typeLabel":"string"},"message":{"type":"string","description":"실패 사유 메시지","example":"할인가가 원가보다 큽니다","isRequired":true,"uniqueKey":"failures.items.[INDEX].message","typeLabel":"string"}},"description":"실패한 상품 상세 목록. failureCount가 0이면 빈 배열","uniqueKey":"failures.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"failures","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"successCount":98,"failureCount":2,"failures":[{"shopProductId":"product-001","errorCode":"INVALID_PRICE","message":"할인가가 원가보다 큽니다"}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"7a34eb65-b1c6-45a0-82b8-92defdb37c4f":{"Authorization":{"type":"apiKey","description":"발급받은 시크릿 키","name":"Authorization","in":"header","scopes":[]}}},"servers":{"02f35447-197b-45ce-aa6d-a06b9151e667":{"url":"https://gw-staging.delivered.co.kr/global-ship","description":"테스트 환경"},"d49bc65c-8032-49d9-9ad8-6b77aa95ce97":{"url":"https://auth.delivered.co.kr/global-ship","description":"운영 환경"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","description":"발급받은 시크릿 키","name":"Authorization","in":"header","scopes":[]},"schema":{"title":"Authorization","type":"string","description":"발급받은 시크릿 키","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"Authorization","name":"Authorization"}],"title":"Authorization"}]},"originalFileLocation":"api-reference/global-link-api.json"},"subdomain":"deliveredkorea","siteName":"딜리버드 파트너스 개발자 센터","title":"상품 등록 - 딜리버드 파트너스 개발자 센터","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-05-14T00:46:38.031Z","originalFileLocation":"reference/global-ship/api/create-products.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"상품 등록 API 입니다. 상품을 Bulk로 등록합니다. 1회 요청 시 최대 100건까지 처리합니다. 응답은 부분 성공 모델입니다. - successCount: 등록 성공한 상품 수 - failureCount: 실패한 상품 수 - failures[]: 실패한 상품별 상세 (shopProductId, errorCode, message) 실패가 있어도 HTTP 200으로 응답하므로, 클라이언트는 failures[]를 반드시 확인해야 합니다.\">\u003cmeta data-mint-head name=\"application-name\" content=\"딜리버드 파트너스 개발자 센터\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/deliveredkorea/T0pW9gCUVcpB_AaO/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/deliveredkorea/T0pW9gCUVcpB_AaO/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/deliveredkorea/T0pW9gCUVcpB_AaO/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/deliveredkorea/T0pW9gCUVcpB_AaO/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/deliveredkorea/T0pW9gCUVcpB_AaO/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/deliveredkorea/T0pW9gCUVcpB_AaO/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/deliveredkorea/T0pW9gCUVcpB_AaO/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/deliveredkorea/T0pW9gCUVcpB_AaO/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/deliveredkorea/T0pW9gCUVcpB_AaO/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"상품 등록 - 딜리버드 파트너스 개발자 센터\">\u003cmeta data-mint-head property=\"og:description\" content=\"상품 등록 API 입니다. 상품을 Bulk로 등록합니다. 1회 요청 시 최대 100건까지 처리합니다. 응답은 부분 성공 모델입니다. - successCount: 등록 성공한 상품 수 - failureCount: 실패한 상품 수 - failures[]: 실패한 상품별 상세 (shopProductId, errorCode, message) 실패가 있어도 HTTP 200으로 응답하므로, 클라이언트는 failures[]를 반드시 확인해야 합니다.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"딜리버드 파트너스 개발자 센터\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers-partners.delivered.co.kr/reference/global-ship/api/create-products\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://deliveredkorea.mintlify.site/_mintlify/api/og/v2?division=%EC%83%81%ED%92%88+API\u0026amp;title=%EC%83%81%ED%92%88+%EB%93%B1%EB%A1%9D\u0026amp;description=%0A++++++++++++%EC%83%81%ED%92%88+%EB%93%B1%EB%A1%9D+API+%EC%9E%85%EB%8B%88%EB%8B%A4.%0A++++++++++++%EC%83%81%ED%92%88%EC%9D%84+Bulk%EB%A1%9C+%EB%93%B1%EB%A1%9D%ED%95%A9%EB%8B%88%EB%8B%A4.+1%ED%9A%8C+%EC%9A%94%EC%B2%AD+%EC%8B%9C+%EC%B5%9C%EB%8C%80+100%EA%B1%B4%EA%B9%8C%EC%A7%80+%EC%B2%98%EB%A6%AC%ED%95%A9%EB%8B%88%EB%8B%A4.%0A%0A++++++++++++%EC%9D%91%EB%8B%B5%EC%9D%80+%EB%B6%80%EB%B6%84+%EC%84%B1%EA%B3%B5+%EB%AA%A8%EB%8D%B8%EC%9E%85%EB%8B%88%EB%8B%A4.%0A++++++++++++-+successCount%3A+%EB%93%B1%EB%A1%9D+%EC%84%B1%EA%B3%B5%ED%95%9C+%EC%83%81%ED%92%88+%EC%88%98%0A++++++++\u0026amp;theme=f8d5c843083039d09393bd32\u0026amp;signature=796d4dd89757005bcbcf8d191a1343b1d9846573290b404392d8bcb932fe1904\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"상품 등록 - 딜리버드 파트너스 개발자 센터\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"상품 등록 API 입니다. 상품을 Bulk로 등록합니다. 1회 요청 시 최대 100건까지 처리합니다. 응답은 부분 성공 모델입니다. - successCount: 등록 성공한 상품 수 - failureCount: 실패한 상품 수 - failures[]: 실패한 상품별 상세 (shopProductId, errorCode, message) 실패가 있어도 HTTP 200으로 응답하므로, 클라이언트는 failures[]를 반드시 확인해야 합니다.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://deliveredkorea.mintlify.site/_mintlify/api/og/v2?division=%EC%83%81%ED%92%88+API\u0026amp;title=%EC%83%81%ED%92%88+%EB%93%B1%EB%A1%9D\u0026amp;description=%0A++++++++++++%EC%83%81%ED%92%88+%EB%93%B1%EB%A1%9D+API+%EC%9E%85%EB%8B%88%EB%8B%A4.%0A++++++++++++%EC%83%81%ED%92%88%EC%9D%84+Bulk%EB%A1%9C+%EB%93%B1%EB%A1%9D%ED%95%A9%EB%8B%88%EB%8B%A4.+1%ED%9A%8C+%EC%9A%94%EC%B2%AD+%EC%8B%9C+%EC%B5%9C%EB%8C%80+100%EA%B1%B4%EA%B9%8C%EC%A7%80+%EC%B2%98%EB%A6%AC%ED%95%A9%EB%8B%88%EB%8B%A4.%0A%0A++++++++++++%EC%9D%91%EB%8B%B5%EC%9D%80+%EB%B6%80%EB%B6%84+%EC%84%B1%EA%B3%B5+%EB%AA%A8%EB%8D%B8%EC%9E%85%EB%8B%88%EB%8B%A4.%0A++++++++++++-+successCount%3A+%EB%93%B1%EB%A1%9D+%EC%84%B1%EA%B3%B5%ED%95%9C+%EC%83%81%ED%92%88+%EC%88%98%0A++++++++\u0026amp;theme=f8d5c843083039d09393bd32\u0026amp;signature=796d4dd89757005bcbcf8d191a1343b1d9846573290b404392d8bcb932fe1904\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/deliveredkorea/T0pW9gCUVcpB_AaO/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"딜리버드 파트너스 개발자 센터\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#FF9123\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers-partners.delivered.co.kr/reference/global-ship/api/create-products\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/reference/global-ship/api/create-products.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developers-partners.delivered.co.kr/#organization\",\"name\":\"딜리버드 파트너스 개발자 센터\",\"url\":\"https://developers-partners.delivered.co.kr\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/deliveredkorea/nWJ7e83AaZRK5B9H/logo/light.svg?fit=max\u0026auto=format\u0026n=nWJ7e83AaZRK5B9H\u0026q=85\u0026s=8ca84e82637f7edb2b349181a5b3a2af\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developers-partners.delivered.co.kr#website\",\"name\":\"딜리버드 파트너스 개발자 센터\",\"url\":\"https://developers-partners.delivered.co.kr\",\"publisher\":{\"@id\":\"https://developers-partners.delivered.co.kr/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers-partners.delivered.co.kr/reference/global-ship/api/create-products#webpage\",\"url\":\"https://developers-partners.delivered.co.kr/reference/global-ship/api/create-products\",\"name\":\"상품 등록\",\"description\":\"상품 등록 API 입니다. 상품을 Bulk로 등록합니다. 1회 요청 시 최대 100건까지 처리합니다. 응답은 부분 성공 모델입니다. - successCount: 등록 성공한 상품 수 - failureCount: 실패한 상품 수 - failures[]: 실패한 상품별 상세 (shopProductId, errorCode, message) 실패가 있어도 HTTP 200으로 응답하므로, 클라이언트는 failures[]를 반드시 확인해야 합니다.\",\"dateModified\":\"2026-05-14T00:46:38.031Z\",\"isPartOf\":{\"@id\":\"https://developers-partners.delivered.co.kr#website\"},\"breadcrumb\":{\"@id\":\"https://developers-partners.delivered.co.kr/reference/global-ship/api/create-products#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers-partners.delivered.co.kr/reference/global-ship/api/create-products#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"딜리버드 파트너스 개발자 센터\",\"item\":\"https://developers-partners.delivered.co.kr\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"상품 등록\",\"item\":\"https://developers-partners.delivered.co.kr/reference/global-ship/api/create-products\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developers-partners.delivered.co.kr/reference/global-ship/api/create-products#apireference\",\"headline\":\"상품 등록\",\"name\":\"상품 등록\",\"description\":\"상품 등록 API 입니다. 상품을 Bulk로 등록합니다. 1회 요청 시 최대 100건까지 처리합니다. 응답은 부분 성공 모델입니다. - successCount: 등록 성공한 상품 수 - failureCount: 실패한 상품 수 - failures[]: 실패한 상품별 상세 (shopProductId, errorCode, message) 실패가 있어도 HTTP 200으로 응답하므로, 클라이언트는 failures[]를 반드시 확인해야 합니다.\",\"url\":\"https://developers-partners.delivered.co.kr/reference/global-ship/api/create-products\",\"mainEntityOfPage\":{\"@id\":\"https://developers-partners.delivered.co.kr/reference/global-ship/api/create-products#webpage\"},\"dateModified\":\"2026-05-14T00:46:38.031Z\",\"publisher\":{\"@id\":\"https://developers-partners.delivered.co.kr/#organization\"},\"isPartOf\":{\"@id\":\"https://developers-partners.delivered.co.kr#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"딜리버드 파트너스 개발자 센터\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"딜리버드 파트너스 개발자 센터\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/reference/global-ship/api/create-products.md","siteName":"딜리버드 파트너스 개발자 센터","nav":{"global":null,"tabs":[{"tab":"가이드","pages":[{"title":"가이드","href":"/guide/global-checkout/introduction"}]},{"tab":"API \u0026 SDK","groups":[{"group":"업데이트 내역","pages":[{"title":"글로벌체크아웃 패치 노트","href":"/reference/changelog/go-update"},{"title":"글로벌링크 패치 노트","href":"/reference/changelog/gl-update"}]},{"group":"OPEN API 이용 안내","pages":[{"title":"API 키","href":"/reference/using-api/api-keys"},{"title":"환경","href":"/reference/using-api/environment"},{"title":"요청 및 응답","href":"/reference/using-api/req-res"}]},{"group":"글로벌체크아웃","pages":[{"title":"SDK 연동하기","href":"/reference/global-checkout/connecting"},{"group":"환율 API","pages":[{"title":"환율 정보 조회","openapi":"api-reference/global-checkout-api.json GET /open-api/v1/currencies/latest","href":"/reference/global-checkout/api/latest"}]},{"group":"주문 API","pages":[{"title":"주문 정보 조회","openapi":"api-reference/global-checkout-api.json GET /open-api/v1/orders","href":"/reference/global-checkout/api/orders"}]}]},{"group":"글로벌쉽","pages":[{"group":"주문 API","pages":[{"title":"주문 유효성 검사","openapi":"api-reference/global-ship-api.json POST /open-api/v1/orders/validators","href":"/reference/global-ship/api/validate-orders"},{"title":"주문 등록","openapi":"api-reference/global-ship-api.json POST /open-api/v1/orders","href":"/reference/global-ship/api/create-orders"}]},{"group":"주문 API (LOTOS)","pages":[{"title":"주문 유효성 검사","openapi":"api-reference/global-ship-api.json POST /open-api/v1/orders/lotos/validators","href":"/reference/global-ship/api/validate-lotos-orders"},{"title":"주문 등록","openapi":"api-reference/global-ship-api.json POST /open-api/v1/orders/lotos","href":"/reference/global-ship/api/create-lotos-orders"}]},{"group":"배송 API","pages":[{"title":"배송 API 시작하기","href":"/reference/global-ship/shipping-guide"},{"title":"배송 신청","openapi":"api-reference/global-ship-api.json POST /open-api/v1/shipments","href":"/reference/global-ship/api/create-shipments"},{"title":"라벨 발행 (다건)","openapi":"api-reference/global-ship-api.json POST /open-api/v1/shipments/labels","href":"/reference/global-ship/api/create-shipment-labels"},{"title":"라벨 발행 (단건)","openapi":"api-reference/global-ship-api.json GET /open-api/v1/shipments/{masterNumber}/label","href":"/reference/global-ship/api/get-shipment-label"},{"title":"배송 정보 조회","openapi":"api-reference/global-ship-api.json GET /open-api/v1/shipments/{masterNumber}/tracking","description":"DK 입고 송장번호로 배송 상태와 트래킹 정보를 조회합니다. 배송 상태(`shipmentStatus`)는 9종이며 DK 트래킹 페이지가 보여주는 값과 같습니다. 상태값 표는 [배송 API 시작하기](/reference/global-ship/shipping-guide)에 있습니다.\n\n운송사(`carrier`)는 송장 발행 전에도 반환됩니다. 트래킹 이벤트(`trackingEvents`)는 **라스트 마일 송장이 아직 발행되지 않았거나 트래킹 조회에 실패하면 빈 배열(`[]`)** 이 되며, 필드 자체가 생략되지는 않습니다. 트래킹 조회에 실패해도 응답은 200이고 배송 상태는 정상 반환됩니다.\n\n\u003cWarning>웹훅을 제공하지 않습니다. 폴링 방식으로 주기 호출하는 것을 전제로 합니다.\u003c/Warning>자세한 호출 순서와 식별자 흐름은 [배송 API 시작하기](/reference/global-ship/shipping-guide)를 참고하세요. 인증은 [API 키](/reference/using-api/api-keys) · [환경](/reference/using-api/environment) 문서를 따릅니다.","href":"/reference/global-ship/api/get-shipment-tracking"}]}]},{"group":"글로벌링크","pages":[{"group":"상품 API","pages":[{"title":"상품 등록","openapi":"api-reference/global-link-api.json POST /open-api/v1/global-link/products","href":"/reference/global-ship/api/create-products"},{"title":"상품 정보 수정","openapi":"api-reference/global-link-api.json PUT /open-api/v1/global-link/products/{shopProductId}","description":"\n 상품 수정 API 입니다.\n path 파라미터 shopProductId로 식별되는 상품 1건을 수정합니다.\n PUT 시맨틱에 따라 요청 body의 값으로 상품 정보 전체를 교체합니다(부분 업데이트 아님).\n ","href":"/reference/global-ship/api/update-product"},{"title":"상품 재고 수정","openapi":"api-reference/global-link-api.json POST /open-api/v1/global-link/products/stock-updates","href":"/reference/global-ship/api/update-stock"},{"title":"상품 정보 삭제","openapi":"api-reference/global-link-api.json DELETE /open-api/v1/global-link/products/{shopProductId}","href":"/reference/global-ship/api/delete-product"}]}]}]}]},"basePath":"","title":"상품 등록 - 딜리버드 파트너스 개발자 센터","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CybtLBIt.js","utils-BMLj2fvV.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-B6In562Y.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dr8Mfhp9.js","snippetPresets-2rmQvMVl.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-WMqJYdZj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CJ-MlPHu.js","shallow-dY3TMRCk.js","getApiPlaygroundDisplay-v-1B2bKm.js","CodeSnippet-BDhiTB7U.js","CodeSnippets-D9hnzQcS.js","Page-C4GwDT3_.js","getPastedJson-Th2V45jI.js","icon-BQXch1W9.js","MethodPill-BCqUneP3.js","DuplicateIcon-Q_-bhurZ.js","createIcon-DUjLHRqp.js","DynamicMarkdown-B-f2cqXQ.js","SectionHeading-Da5NsV4v.js","axios-vUo_bRtp.js","Markdown-D13FWkIM.js","clsx-D3Isdib3.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-C-XZBk9h.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink--qIqmmVG.js"]}