API 개발 메뉴얼

1. 더망고 상품데이터 전송은 환경설정에서 설정한 [자사몰연동 URL]으로 전송합니다.
전송방식은 POST, 데이터 형태는 JSON 방식으로 전송 및 출력합니다.

2. 전송되는 Parameter는 다음과 같습니다. (Bold 처리된 파라미터는 필수로 전송되는 값입니다.)

구분 이름 설명
Request AuthKey 서비스 인증키, 환경설정에서 확인할 수 있습니다.
ServiceURL 데이터 전송 URL, 환경설정에서 설정할 수 있습니다.
ItemNo 더망고 상품번호
SiteItemNo 자사몰 상품번호, 신규등록일 경우 해당 값은 전송되지 않습니다.
Mode 상품정보 등록, 수정, 삭제 타입 (REG : 상품등록, UPD : 상품수정, DEL : 상품삭제)
Item ItemName 현재상품명 (번역 또는 상품명 변경을 통해 변경된 상품명)
ItemNameOrigin 원문 상품명 (상품명이 변경된 경우에만 전송)
ItemBrand 브랜드
SKU 원문사이트 상품 고유번호
URL 상품 상세페이지 URL
Price 현지 상품가격 (숫자값만 전송)
PriceW 가격정책을 통해 변경된 원화가격 (숫자값만 전송)
ShippingPrice 현지배송비 (상품별 현지 배송비가 있는 사이트만 전송. 예) Amazon.com, eBay.com 등)
Stock 상품재고량 (상품별 재고량이 수집되는 사이트는 수집된 수량으로, 그외 사이트는 재고가 있으면 999, 없으면 0 으로 전송)
Currency 현지 통화 (USD, EUR, CNY, JPY, GBP, AUD)
BackOrdered 백오더 상품의 경우 입고예정일자 TEXT 전송
Condition 상품상태 (새상품:10, 중고상품:20, 리퍼상품:30, 전시상품:40, 삭제된 상품:99)
상품상태를 구별할 수 있는 원문사이트에 대에서만 적용, 기본값은 새상품
SiteCategory 원문사이트 카테고리
이름 설명
Name 원문사이트 카테고리 (카테고리 정보가 보여지는 사이트에 대해 전송)
- 카테고리 Depth 구분 :(콜론)
Code 원문사이트 카테고리 코드(카테고리 코드 정보가 보여지는 사이트에 대해 전송)
- 카테고리 코드 Depth 구분 :(콜론)
Image 상품대표이미지 (원문사이트 메인에 보여지는 이미지)
ImageSet 상품전체이미지 (원문사이트 메인에 보여지는 해당 상품에 대한 전체이미지)
- 첫번째 배열 하위에 배열 형태 형태로 전송
Description 상품설명 (번역 정책을 통해 변역된 상품설명, 배열 형태로 전송)
DescriptionOrigin 상품설명 원문 (상품설명이 변경된 경우에만 전송)
Specification 상품 스펙 (번역 정책을 통해 변역된 상품스펙, 배열 형태로 전송)
이름 설명
Title 상품 스펙 구분 (수집이 가능한 사이트만 전송, 대부분의 사이트는 제공하지 않음.)
Name 상품 스펙 명 (수집이 가능한 사이트만 전송)
Value 상품 스펙 값
SpecificationOrigin 상품 스펙 원문 (상품스펙이 변경된 경우에만 전송)
OptionTitle 옵션 타이틀명 (번역 또는 옵션명 변경을 통해 변경된 옵션명)
"OptionTitle":[
   "Color",
   "Size"
]
OptionList 옵션리스트 (번역 또는 옵션명 변경을 통해 변경된 옵션명, OptionTitle의 옵션명의 하위 배열로 전송)
"OptionList":{
   "Color":[
      "BLUE/WHITE"
   ],
   "Size":[
      "M 10 / W 11.5",
      "M 11 / W 12.5"
   ]
}
OptionInfo 조합된 옵션 정보 (옵션조합 순서는 OptionTitle, OptionList 와 동일하며, ||| 구분자를 이용하여 구분)
"OptionInfo":{
   "BLUE/WHITE|||M 10 / W 11.5":{
      "SKU":"6426878",
      "Stock":999,
      "Price":"160.00",
      "ShippingPrice":"0.00",
      "Currency":"USD",
      "Image":"https://c.static-nike.com/a/images/t_PDP_640_v1/c10c74e6-a823-4523-8eca-2bd5ec8f28d7/custom-kyrie-6-by-you.jpg",
      "ImageSet":[
          [
          "https://c.static-nike.com/a/images/t_PDP_640_v1/c10c74e6-a823-4523-8eca-2bd5ec8f28d7/custom-kyrie-6-by-you.jpg",
          "https://c.static-nike.com/a/images/t_PDP_640_v1/7255788c-4f8b-466e-aa5a-dd3703344048/custom-kyrie-6-by-you.jpg"
          ]
       ]
    }
}
이름 설명
SKU 옵션 고유번호
Stock 옵션 재고 (값 구성은 [Item] 과 동일함)
Price 옵션 가격 (값 구성은 [Item] 과 동일함)
PriceW 가격정책을 통해 변경된 옵션 원화가격 (값 구성은 [Item] 과 동일함)
Image 옵션 대표이미지 (값 구성은 [Item] 과 동일함)
ImageSet 옵션 전체이미지 (값 구성은 [Item] 과 동일함)
OptionTitleOrigin 옵션 타이틀명 원문 (옵션명이 변경된 경우에만 전송)
OptionListOrigin 옵션 옵션리스트 원문 (옵션명이 변경된 경우에만 전송)
OptionInfoOrigin 조합된 옵션 정보 원문 (옵션명이 변경된 경우에만 전송)

3. 처리결과는 다음과 같이 출력해주시면 됩니다. (Bold 처리된 파라미터는 필수로 출력해주셔야 하는 값입니다.)

{
   "Result":{
      "Code":"100",
      "ErrorMsg":"",
      "SiteItemNo":"3356135"
   }
}
		
이름 설명
Code 처리결과 코드 (100: 성공, 999:실패)
SiteItemNo 전송대상 자사몰의 상품번호
ErrorMsg 에러메세지 (처리결과코드 999 인 경우, 에러메세지를 출력하면, 메세지처리가 가능합니다.)

4. 전송되는 JSON 전문입니다.

{
   "Request":{
      "AuthKey":"vmPYVZY7bZsUDGYyFRLG7xkLtL0E4g",
      "ServiceURL":https://www.site.com/site.html",
      "ItemNo":"158419",
      "SiteItemNo":"12345678",
      "Mode":"UPD"
   },
   "Item":{
      "ItemName":"UGG Australia Kids K Raana Pull-On Boot",
      "ItemNameOrigin":"UGG Australia Kids K Raana Pull-On Boot",
      "ItemBrand":"UGG",
      "SKU":"B01MZ0USLT",
      "ModelName":"UGG BOOTS",
      "URL":"https://www.amazon.com/UGG-Kids-Raana-Rain-Black/dp/B01MZ0USLT/ref=sr_1_59?dchild=1&keywords=rain+boots&qid=1576299912&sr=8-59&psc=1",
      "Price":"54.95",
      "PriceW":122400,
      "ShippingPrice":"3.99",
      "Currency":"USD",
      "Stock":14,
      "BackOrdered":null,
      "Condition":"10",
      "SiteCategory":{
         "Name":"Clothing, Shoes & Jewelry:Boys:Shoes:Outdoor:Rain Boots",
         "Code":""
      },
      "Image":"https://images-na.ssl-images-amazon.com/images/I/818ydTs0NRL._SL600_.jpg",
      "ImageSet":[
         [
            "https://images-na.ssl-images-amazon.com/images/I/41SXfpu1C3L._SR600,600_.jpg",
            "https://images-na.ssl-images-amazon.com/images/I/31CyXNsDGrL._SR600,600_.jpg",
            "https://images-na.ssl-images-amazon.com/images/I/3115rRY88-L._SR600,600_.jpg",
            "https://images-na.ssl-images-amazon.com/images/I/41VB4-fgchL._SR600,600_.jpg",
            "https://images-na.ssl-images-amazon.com/images/I/41XJWo14CcL._SR600,600_.jpg",
            "https://images-na.ssl-images-amazon.com/images/I/41qCAzbiXkL._SR600,600_.jpg",
            "https://images-na.ssl-images-amazon.com/images/I/41veUKq2IeL._SR600,600_.jpg"
         ]
      ],
      "Description":[
         "UGG kids raana boot "
      ],
      "Specification":[
         {
            "Name":"Product Dimensions",
            "Value":"12 x 8 x 4.5 inches"
         },
         {
            "Name":"Shipping Weight",
            "Value":"1 pounds (View shipping rates and policies)"
         },
         {
            "Name":"ASIN",
            "Value":"B01N24MQW1"
         },
         {
            "Name":"Item model number",
            "Value":"1014340K"
         },
         {
            "Name":"Date first listed on Amazon",
            "Value":"January 16, 2013"
         }
      ],
      "OptionTitle":[
         "Option1",
         "Option2",
         "Option3"
      ],
      "OptionList":{
         "Option1":[
            "Big Kid (8-12 Years)"
         ],
         "Option2":[
            "5 Big Kid"
         ],
         "Option3":[
            "Black"
         ]
      },
      "OptionInfo":{
         "Big Kid (8-12 Years)|||5 Big Kid|||Black":{
            "SKU":"B01MZ0USLT",
            "Stock":14,
            "Price":"54.95",
            "PriceW":122400,
            "Currency":"USD",
            "Image":"https://images-na.ssl-images-amazon.com/images/I/818ydTs0NRL._SL600_.jpg",
	    "ImageSet":[
	       [
	       "https://images-na.ssl-images-amazon.com/images/I/41SXfpu1C3L._SR600,600_.jpg",
	       "https://images-na.ssl-images-amazon.com/images/I/31CyXNsDGrL._SR600,600_.jpg",
	       "https://images-na.ssl-images-amazon.com/images/I/3115rRY88-L._SR600,600_.jpg",
	       "https://images-na.ssl-images-amazon.com/images/I/41VB4-fgchL._SR600,600_.jpg",
	       "https://images-na.ssl-images-amazon.com/images/I/41XJWo14CcL._SR600,600_.jpg",
	       "https://images-na.ssl-images-amazon.com/images/I/41qCAzbiXkL._SR600,600_.jpg",
	       "https://images-na.ssl-images-amazon.com/images/I/41veUKq2IeL._SR600,600_.jpg"
	       ]
	    ],
         }
      },
      "OptionTitleOrigin":"",
      "OptionListOrigin":"",
      "OptionInfoOrigin":""
   }
}