亚马逊JSON刊登进度

## 一. 简介
该文档主要是介绍当前对接亚马逊SPAPI-Listing接口

## 二. 接口介绍
### /listings/2021-08-01/items/${sellerId}/${sku}
该**刊登**接口在亚马逊文档中是以RESTFUL形式呈现，就意味着GET, PUT, DELETE, PATCH需要传递不同的参数来实现对应的业务效果。 
**GET是获取刊登商品属性和状态
PUT是刊登单条商品(父商品和子商品算作2条),如果相同SKU会覆盖原有SKU
DELETE是删除刊登商品
PATCH是更新刊登商品部分字段**

### /definitions/2020-09-01/productTypes
该接口是辅助上述刊登接口,主要是获取当前marketplaceIds能支持那些产品分类,因刊登时需要传递产品分类

### /definitions/2020-09-01/productTypes/HOME
该接口是辅助上述刊登接口,主要是通过产品分类来获取刊登时必填字段及其描述，字段与字段之间必填或选填规则等

## 三. 接口调用示例
**PS: 所有示例都在amazon-spapi-service项目下完成,代码内部有加密规则, 具体可以结合代码看 http://git.mabangerp.com:2280/m-sched/mdc-amazon-spapi**

### 获取Token
```java
String token = MdcAESUtils.aesDecodeStr(
				"${Access_Token获取}",
                "B9zVorJ32GqNAZHw");
```

### Access_Token获取
```sql
select access_token from mabang_scheduling.mdc_sc_shop_platform_param where sc_shop_id=57139154011398198 limit 100;
```

### 调用亚马逊加密规则
```
<请求头>
1、<user-agent> 请求头必须包含user-agent，格式为 应用程序/其版本号，例如MyCompanyName/build1611。
2、<host> 为URL请求的域名，例如 sellingpartnerapi-na.amazon.com，不同站点大概是不一样的。
3、<x-amz-access-token> 为用户店铺的时效性令牌，目前取的DB_Shop表的cainiaoToken字段，该字段使用之前需要先解密。（老版本才会使用其他字段的令牌）
4、<x-amz-date> 为本次请求的时间，这个参数会参与到签名的计算中，所以每次的请求是具有时效性的，大约为5分钟。
5、<authorization> 这个字段为权限字段，它包含几部分组成：
签名算法：AWS4-HMAC-SHA256
凭据（Credential）：由appId/年月日/站点/请求的服务/特殊的终止字符串aws4_request
SignedHeaders：header中需要参与计算签名的参数
参数（Signature）：签名
以上每个参数之间会有逗号+分割（即, ）做分割，所以，一个合法的authorization如下格式：
AWS4-HMAC-SHA256 Credential=AKIAIHV6HIXXXXXXX/20201022/us-east-1/execute-api/aws4_request, SignedHeaders=host;user-agent;x-amz-access-token, Signature=5d672d79c15b13162d9279b0855cfba6789a8edb4c82c400e06b5924aEXAMPLE
签名说明：
https://docs.aws.amazon.com/general/latest/gr/sigv4-create-canonical-request.html
```

### SendPutApi
```java
public ResponseApi<JSONObject> sendPutApi(String site, String uri, String token, String methodName, String body, String queryString,
 String appkey, String appsecret) {
 InputStream inputStream = null;
 BufferedReader br = null;
 try {
 HttpClient client = new HttpClient();
 client.getParams().setSoTimeout(10 * 1000);
 client.getParams().setConnectionManagerTimeout(10 * 1000);
 PutMethod put = new PutMethod(uri);

Map<String, String> params = AmazonUtil.calculateAwsSignatureAndReturnHeaders(methodName, "PUT",
 AmazonAPiConstant.getHostBySite(site), body, queryString, AmazonAPiConstant.getRegion(site),
 token, appkey, appsecret);
 if (params != null && params.size() > 0) {
 for (String key : params.keySet()) {
 put.setRequestHeader(key, params.get(key));
 }
 }
 if (StringUtils.hasText(body)) {
 RequestEntity requestEntity = new StringRequestEntity(body, "application/json", "utf-8");
 put.setRequestEntity(requestEntity);
 }
 put.setRequestHeader("Connection", "close");

//            JSONObject requestHeader = getHeader(post.getRequestHeaders());
//            rt.setRequestHeader((requestHeader != null ? requestHeader.toJSONString() : null));
//            rt.setRequestUrl(uri);
//            rt.setRequestParam(body);

int httpCode = client.executeMethod(put);

JSONObject headerJsonObj = getHeader(put.getResponseHeaders());
//            rt.setHeaders((headerJsonObj != null ? headerJsonObj.toJSONString() : null));

if (httpCode == 204) {
// rt.setAck(204);
// rt.setMsg("返回http状态码是204");
 return new ResponseApi<JSONObject>(CommonEnum.FAILED.getCode(), httpCode,
 "返回http状态码是204", "",
 headerJsonObj);
 }
 inputStream = put.getResponseBodyAsStream();
 br = new BufferedReader(new InputStreamReader(inputStream));
 StringBuffer stringBuffer = new StringBuffer();
 String str = "";
 while ((str = br.readLine()) != null) {
 stringBuffer.append(str);
 }
 if (httpCode != 200) {
// rt.setAck(httpCode);
// rt.setMsg(stringBuffer.toString());
// rt.setData(stringBuffer.toString());
 return new ResponseApi<JSONObject>(CommonEnum.OTHER_EXCEPTION.getCode(), httpCode,
 stringBuffer.toString(), stringBuffer.toString(),
 headerJsonObj);
 }
 if (!StringUtils.hasText(stringBuffer.toString())) {
// rt.setAck(1000);
// rt.setMsg("返回值为空!");
 return new ResponseApi<JSONObject>(CommonEnum.FAILED.getCode(), httpCode,
 "返回值为空!", "返回值为空!",
 headerJsonObj);
 }
// rt.setAck(200);
// rt.setMsg("ok");
// rt.setData(stringBuffer.toString());
 return new ResponseApi<JSONObject>(CommonEnum.SUCCESS.getCode(), httpCode,
 CommonEnum.SUCCESS.getMsg(), stringBuffer.toString(),
 headerJsonObj);
 } catch (Exception e) {
// rt.setAck(1000);
// rt.setMsg("Exception:" + e.getMessage());
 return new ResponseApi<JSONObject>(CommonEnum.FAILED.getCode(), CommonEnum.FAILED.getCode(),
 "Exception:" + e.getMessage(), "Exception:" + e.getMessage(),
 null);
 } finally {
 if (inputStream != null) {
 try {
 inputStream.close();
 } catch (IOException e) {
 e.printStackTrace();
 }
 }
 if (br != null) {
 try {
 br.close();
 } catch (IOException e) {
 e.printStackTrace();
 }
 }
 }
 }
```

### 刊登单品
```java
private static void listing(String token) {
 String methodName = "/listings/2021-08-01/items/A1UH1MH0JRXDR5/WWW-OLII";
 String queryString = "marketplaceIds=ATVPDKIKX0DER";
 String requestUrl = "https://" + "sellingpartnerapi-na.amazon.com" + methodName + "?" + queryString;
 AmazonSpApiServiceImpl service = new AmazonSpApiServiceImpl();
 ResponseApi<JSONObject> rs = service.sendPutApi("US",
 requestUrl,
 token,
 methodName,
				// 直接参考这个单体Json
 "{\"productType\":\"HOME\",\"requirements\":\"LISTING\",\"attributes\":{\"brand\":[{\"value\":\"ROVOZAR\",\"language_tag\":\"en_US\",\"marketplace_id\":\"ATVPDKIKX0DER\"}],\"item_name\":[{\"value\":\"Sony Game X Plush Slippers\",\"language_tag\":\"en_US\",\"marketplace_id\":\"ATVPDKIKX0DER\"}],\"manufacturer\":[{\"value\":\"ROVOZAR\",\"language_tag\":\"en_US\",\"marketplace_id\":\"ATVPDKIKX0DER\"}],\"item_type_name\":[{\"marketplace_id\":\"ATVPDKIKX0DER\",\"language_tag\":\"en_US\",\"value\":\"Sony Game X Plush Slippers\"}],\"item_type_keyword\":[{\"marketplace_id\":\"ATVPDKIKX0DER\",\"language_tag\":\"en_US\",\"value\":\"Sony Game X Plush Slippers\"}],\"model_number\":[{\"marketplace_id\":\"ATVPDKIKX0DER\",\"language_tag\":\"en_US\",\"value\":\"RXZER23\"}],\"model_name\":[{\"marketplace_id\":\"ATVPDKIKX0DER\",\"language_tag\":\"en_US\",\"value\":\"Sony Game X Plush Slippers\"}],\"externally_assigned_product_identifier\":[{\"value\":\"706316864779\",\"marketplace_id\":\"ATVPDKIKX0DER\",\"type\":\"upc\"}],\"fulfillment_availability\":[{\"fulfillment_channel_code\":\"DEFAULT\",\"lead_time_to_ship_max_days\":2,\"quantity\":30,\"restock_date\":\"2022-06-13T00:00:00.000Z\"}],\"purchasable_offer\":[{\"marketplace_id\":\"ATVPDKIKX0DER\",\"currency\":\"USD\",\"discounted_price\":[{\"schedule\":[{\"value_with_tax\":\"20.96\",\"start_at\":\"2022-06-13T00:00:00.000Z\",\"end_at\":\"2022-06-15T00:00:00.000Z\"}]}],\"our_price\":[{\"schedule\":[{\"value_with_tax\":\"20.96\"}]}]}],\"list_price\":[{\"marketplace_id\":\"ATVPDKIKX0DER\",\"currency\":\"USD\",\"value\":\"20.96\"}],\"product_tax_code\":[{\"marketplace_id\":\"ATVPDKIKX0DER\",\"value\":\"A_NEWS_4QTLY\"}],\"gift_options\":[{\"marketplace_id\":\"ATVPDKIKX0DER\",\"can_be_messaged\":false,\"can_be_wrapped\":false}],\"max_order_quantity\":[{\"marketplace_id\":\"ATVPDKIKX0DER\",\"value\":\"30\"}],\"merchant_release_date\":[{\"value\":\"2022-06-13T00:00:00.000Z\",\"language_tag\":\"en_US\",\"marketplace_id\":\"ATVPDKIKX0DER\"}],\"condition_type\":[{\"value\":\"new_new\",\"language_tag\":\"en_US\",\"marketplace_id\":\"ATVPDKIKX0DER\"}],\"product_description\":[{\"value\":\"Welcome to My Store, Customer first, Providing high-quality products and excellent service is our essence, I hope you can choose your favorite items here, If you have any questions, we will try our best to help you, Simulator Game X Plush Slippers, Cute Pet&nbsp; Big Games Animal Cat Plush Slippers, Square Cat Animal Soft Plush Slippers,come and take it home.The Realistic Modeling Perfectly Restores,Come and Bring Home Such a Lovely! 100% Brand New Premium Quality Guarantee Name: Simulator Game X Plush Slippers Fabric: Crystal super soft material Filling: imported three-dimensional pp cotton Number of yards: 28cm (EU36-42 / US6-10 yards ) Weight: 270 G Packing: 1 piece Simulator Game X Plush Slippers Friendly Tips Quality service -- Providing a 100% satisfaction experience is our top priority for customers. If the product does not meet your expectations, please feel free to send us a message via \\\"Contact Seller\\\",If you have any questions about our products, please leave a message in \\\"Customer questions &amp; answers\\\", we will answer online 24 hours\",\"language_tag\":\"en_US\",\"marketplace_id\":\"ATVPDKIKX0DER\"}],\"bullet_point\":[{\"value\":\"bullet_point\",\"language_tag\":\"en_US\",\"marketplace_id\":\"ATVPDKIKX0DER\"}],\"generic_keyword\":[{\"value\":\"simulator game x plush slippers cute pet big games animal cat plush slippers square cat animal soft plush slippers\",\"language_tag\":\"en_US\",\"marketplace_id\":\"ATVPDKIKX0DER\"}],\"number_of_items\":[{\"marketplace_id\":\"ATVPDKIKX0DER\",\"language_tag\":\"en_US\",\"value\":\"1\"}],\"color\":[{\"marketplace_id\":\"ATVPDKIKX0DER\",\"language_tag\":\"en_US\",\"value\":\"Cranberry\"}],\"part_number\":[{\"value\":\"RXZER23\",\"marketplace_id\":\"ATVPDKIKX0DER\"}],\"country_of_origin\":[{\"value\":\"US\",\"language_tag\":\"en_US\",\"marketplace_id\":\"ATVPDKIKX0DER\"}],\"batteries_required\":[{\"value\":false,\"language_tag\":\"en_US\",\"marketplace_id\":\"ATVPDKIKX0DER\"}],\"supplier_declared_dg_hz_regulation\":[{\"value\":\"unknown\",\"language_tag\":\"en_US\",\"marketplace_id\":\"ATVPDKIKX0DER\"}],\"required_product_compliance_certificate\":[{\"marketplace_id\":\"ATVPDKIKX0DER\",\"language_tag\":\"en_US\",\"value\":\"Not Applicable\"}],\"supplier_declared_material_regulation\":[{\"value\":\"not_applicable\",\"language_tag\":\"en_US\",\"marketplace_id\":\"ATVPDKIKX0DER\"}],\"cpsia_cautionary_statement\":[{\"marketplace_id\":\"ATVPDKIKX0DER\",\"language_tag\":\"en_US\",\"value\":\"no_warning_applicable\"}],\"item_package_dimensions\":[{\"marketplace_id\":\"ATVPDKIKX0DER\",\"length\":{\"value\":\"10\",\"unit\":\"inches\"},\"width\":{\"value\":\"5\",\"unit\":\"inches\"},\"height\":{\"value\":\"2.7\",\"unit\":\"inches\"}}],\"item_package_weight\":[{\"marketplace_id\":\"ATVPDKIKX0DER\",\"unit\":\"pounds\",\"value\":\"10\"}],\"number_of_boxes\":[{\"marketplace_id\":\"ATVPDKIKX0DER\",\"language_tag\":\"en_US\",\"value\":\"1\"}]}}",
 queryString,
 "AKIARO4A3BNMX565PGEV",
 "ErxCUVC1j9I79ogTDbJJwp8kFpHxlvoglLlvnCLy");
 System.out.println("ack:" + rs.getAck());
 System.out.println("msg:" + rs.getMsg());
 System.out.println("data:" + rs.getData());
}
```

### 刊登变种
代码参考上述刊登单品,只是需要改动的点
**1. SKU父商品与变种商品需要修改,同时变种商品Body体内的父Sku也要修改。父与变种商品SKU均自定义
2. SKU父商品与变种商品都分别看作是一条记录,因此需要调用两次listing**

父商品:
```json
{
	"productType": "HOME",
	"requirements": "LISTING",
	"attributes": {
		"brand": [{
			"value": "Bowtus",
			"language_tag": "en_US",
			"marketplace_id": "ATVPDKIKX0DER"
		}],
		"item_name": [{
			"value": "OLAY-SKIN",
			"language_tag": "en_US",
			"marketplace_id": "ATVPDKIKX0DER"
		}],
		"item_type_name": [{
			"marketplace_id": "ATVPDKIKX0DER",
			"language_tag": "en_US",
			"value": "OLAY-SKIN"
		}],
		"item_type_keyword": [{
			"value": "OLAY-SKIN",
			"marketplace_id": "ATVPDKIKX0DER"
		}],
		"model_number": [{
			"marketplace_id": "ATVPDKIKX0DER",
			"language_tag": "en_US",
			"value": "OLAY-SKIN"
		}],
		"model_name": [{
			"marketplace_id": "ATVPDKIKX0DER",
			"language_tag": "en_US",
			"value": "OLAY-SKIN"
		}],
		"manufacturer": [{
			"value": "Bowtus",
			"language_tag": "en_US",
			"marketplace_id": "ATVPDKIKX0DER"
		}],
		"variation_theme": [{
			"name": "COLOR"
		}],
		"parentage_level": [{
			"value": "parent",
			"marketplace_id": "ATVPDKIKX0DER"
		}],
		"child_parent_sku_relationship": [{
			"child_relationship_type": "variation",
			"language_tag": "en_US",
			"marketplace_id": "ATVPDKIKX0DER"
		}],
		"fulfillment_availability": [{
			"fulfillment_channel_code": "DEFAULT"
		}],
		"product_description": [{
			"value": "product_description",
			"language_tag": "en_US",
			"marketplace_id": "ATVPDKIKX0DER"
		}],
		"bullet_point": [{
			"value": "bullet_point",
			"language_tag": "en_US",
			"marketplace_id": "ATVPDKIKX0DER"
		}],
		"generic_keyword": [{
			"value": "generic_keyword",
			"language_tag": "en_US",
			"marketplace_id": "ATVPDKIKX0DER"
		}],
		"number_of_items": [{
			"marketplace_id": "ATVPDKIKX0DER",
			"language_tag": "en_US",
			"value": "1"
		}],
		"part_number": [{
			"value": "LE-15151",
			"marketplace_id": "ATVPDKIKX0DER"
		}],
		"country_of_origin": [{
			"value": "US",
			"language_tag": "en_US",
			"marketplace_id": "ATVPDKIKX0DER"
		}],
		"batteries_required": [{
			"value": false,
			"language_tag": "en_US",
			"marketplace_id": "ATVPDKIKX0DER"
		}],
		"supplier_declared_dg_hz_regulation": [{
			"value": "unknown",
			"language_tag": "en_US",
			"marketplace_id": "ATVPDKIKX0DER"
		}],
		"required_product_compliance_certificate": [{
			"marketplace_id": "ATVPDKIKX0DER",
			"language_tag": "en_US",
			"value": "Not Applicable"
		}],
		"supplier_declared_material_regulation": [{
			"value": "not_applicable",
			"language_tag": "en_US",
			"marketplace_id": "ATVPDKIKX0DER"
		}],
		"cpsia_cautionary_statement": [{
			"marketplace_id": "ATVPDKIKX0DER",
			"language_tag": "en_US",
			"value": "no_warning_applicable"
		}],
		"number_of_boxes": [{
			"marketplace_id": "ATVPDKIKX0DER",
			"language_tag": "en_US",
			"value": "1"
		}]
	}
}
```

变种商品
```json
{
	"productType": "HOME",
	"requirements": "LISTING",
	"attributes": {
		"brand": [{
			"value": "Bowtus",
			"language_tag": "en_US",
			"marketplace_id": "ATVPDKIKX0DER"
		}],
		"item_name": [{
			"value": "OLAY-SKIN-RED",
			"language_tag": "en_US",
			"marketplace_id": "ATVPDKIKX0DER"
		}],
		"item_type_name": [{
			"marketplace_id": "ATVPDKIKX0DER",
			"language_tag": "en_US",
			"value": "OLAY-SKIN-RED"
		}],
		"item_type_keyword": [{
			"value": "OLAY-SKIN-RED",
			"marketplace_id": "ATVPDKIKX0DER"
		}],
		"model_number": [{
			"marketplace_id": "ATVPDKIKX0DER",
			"language_tag": "en_US",
			"value": "OLAY-SKIN-RED"
		}],
		"model_name": [{
			"marketplace_id": "ATVPDKIKX0DER",
			"language_tag": "en_US",
			"value": "OLAY-SKIN-RED"
		}],
		"manufacturer": [{
			"value": "Bowtus",
			"language_tag": "en_US",
			"marketplace_id": "ATVPDKIKX0DER"
		}],
		"variation_theme": [{
			"name": "COLOR"
		}],
		"parentage_level": [{
			"value": "child",
			"marketplace_id": "ATVPDKIKX0DER"
		}],
		"child_parent_sku_relationship": [{
			"child_relationship_type": "variation",
			"parent_sku": "WWW-PARENT-OLII",
			"marketplace_id": "ATVPDKIKX0DER"
		}],
		"color": [{
			"value": "RED",
			"language_tag": "en_US",
			"marketplace_id": "ATVPDKIKX0DER"
		}],
		"externally_assigned_product_identifier": [{
			"value": "744173565583",
			"marketplace_id": "ATVPDKIKX0DER",
			"type": "upc"
		}],
		"condition_type": [{
			"value": "new_new",
			"language_tag": "en_US",
			"marketplace_id": "ATVPDKIKX0DER"
		}],
		"fulfillment_availability": [{
			"fulfillment_channel_code": "DEFAULT",
			"lead_time_to_ship_max_days": 2,
			"quantity": 30,
			"restock_date": "2022-06-13T08:00:00.000Z"
		}],
		"purchasable_offer": [{
			"marketplace_id": "ATVPDKIKX0DER",
			"currency": "USD",
			"discounted_price": [{
				"schedule": [{
					"value_with_tax": "100000.96",
					"start_at": "2022-06-14T08:00:00.000Z",
					"end_at": "2022-06-16T08:00:00.000Z"
				}]
			}],
			"our_price": [{
				"schedule": [{
					"value_with_tax": "100000.96"
				}]
			}]
		}],
		"merchant_release_date": [{
			"value": "2022-06-14T08:00:00.000Z",
			"language_tag": "en_US",
			"marketplace_id": "ATVPDKIKX0DER"
		}],
		"list_price": [{
			"marketplace_id": "ATVPDKIKX0DER",
			"currency": "USD",
			"value": "100000.96"
		}],
		"product_tax_code": [{
			"marketplace_id": "ATVPDKIKX0DER",
			"value": "A_NEWS_4QTLY"
		}],
		"gift_options": [{
			"marketplace_id": "ATVPDKIKX0DER",
			"can_be_messaged": false,
			"can_be_wrapped": false
		}],
		"max_order_quantity": [{
			"marketplace_id": "ATVPDKIKX0DER",
			"value": "30"
		}],
		"product_description": [{
			"value": "product_description",
			"language_tag": "en_US",
			"marketplace_id": "ATVPDKIKX0DER"
		}],
		"bullet_point": [{
			"value": "bullet_point",
			"language_tag": "en_US",
			"marketplace_id": "ATVPDKIKX0DER"
		}],
		"generic_keyword": [{
			"value": "generic_keyword",
			"language_tag": "en_US",
			"marketplace_id": "ATVPDKIKX0DER"
		}],
		"number_of_items": [{
			"marketplace_id": "ATVPDKIKX0DER",
			"language_tag": "en_US",
			"value": "1"
		}],
		"part_number": [{
			"value": "LE-15151",
			"marketplace_id": "ATVPDKIKX0DER"
		}],
		"country_of_origin": [{
			"value": "US",
			"language_tag": "en_US",
			"marketplace_id": "ATVPDKIKX0DER"
		}],
		"batteries_required": [{
			"value": false,
			"language_tag": "en_US",
			"marketplace_id": "ATVPDKIKX0DER"
		}],
		"supplier_declared_dg_hz_regulation": [{
			"value": "unknown",
			"language_tag": "en_US",
			"marketplace_id": "ATVPDKIKX0DER"
		}],
		"required_product_compliance_certificate": [{
			"marketplace_id": "ATVPDKIKX0DER",
			"language_tag": "en_US",
			"value": "Not Applicable"
		}],
		"supplier_declared_material_regulation": [{
			"value": "not_applicable",
			"language_tag": "en_US",
			"marketplace_id": "ATVPDKIKX0DER"
		}],
		"cpsia_cautionary_statement": [{
			"marketplace_id": "ATVPDKIKX0DER",
			"language_tag": "en_US",
			"value": "no_warning_applicable"
		}],
		"number_of_boxes": [{
			"marketplace_id": "ATVPDKIKX0DER",
			"language_tag": "en_US",
			"value": "1"
		}]
	}
}
```

### 获取类型productTypes

```java
private static void listingProductType(String token) {
 String methodName = "/definitions/2020-09-01/productTypes";
 String queryString = "marketplaceIds=ATVPDKIKX0DER";
 String requestUrl = "https://" + "sellingpartnerapi-na.amazon.com" + methodName + "?" + queryString;
 AmazonSpApiServiceImpl service = new AmazonSpApiServiceImpl();
 ResponseApi<JSONObject> rs = service.sendGetApi("US",
 requestUrl,
 token,
 methodName,
 queryString,
 "AKIARO4A3BNMX565PGEV",
 "ErxCUVC1j9I79ogTDbJJwp8kFpHxlvoglLlvnCLy");
 System.out.println("ack:" + rs.getAck());
 System.out.println("msg:" + rs.getMsg());
 System.out.println("data:" + rs.getData());
 }
```

### 获取字段关系productDefinition

```java
private static void productDefinition(String token) {
 String methodName = "/definitions/2020-09-01/productTypes/HOME";
 String queryString = "marketplaceIds=ATVPDKIKX0DER";
 String requestUrl = "https://" + "sellingpartnerapi-na.amazon.com" + methodName + "?" + queryString;
 AmazonSpApiServiceImpl service = new AmazonSpApiServiceImpl();
 ResponseApi<JSONObject> rs = service.sendGetApi("US",
 requestUrl,
 token,
 methodName,
 queryString,
 "AKIARO4A3BNMX565PGEV",
 "ErxCUVC1j9I79ogTDbJJwp8kFpHxlvoglLlvnCLy");
 System.out.println("ack:" + rs.getAck());
 System.out.println("msg:" + rs.getMsg());
 System.out.println("data:" + rs.getData());
 }
```
**这个接口返回结果里会有schema Url。这个schema Url就描述了字段信息以及字段之间的规则。刊登body体就是通过这个Url去匹配属性字段**

## 四. 接口返回示例

### 刊登
```json
{
	"sku": "WWW-CHILD-OLII",
	"status": "ACCEPTED",
	"submissionId": "0b66de259fa8422dbdd8658cfa314fce",
	"issues": []
}
```

### 获取类型productTypes
```json
{
	"productTypes": [{
		"name": "3D_PRINTER",
		"marketplaceIds": ["ATVPDKIKX0DER"]
	}, {
		"name": "ABRASIVE_WHEELS",
		"marketplaceIds": ["ATVPDKIKX0DER"]
	}, {
		"name": "ACCESSORY",
		"marketplaceIds": ["ATVPDKIKX0DER"]
	}, {
		"name": "ACCESSORY_OR_PART_OR_SUPPLY",
		"marketplaceIds": ["ATVPDKIKX0DER"]
	}, {
		"name": "ADULT_COSTUME",
		"marketplaceIds": ["ATVPDKIKX0DER"]
	}, {
		"name": "AIR_MATTRESS",
		"marketplaceIds": ["ATVPDKIKX0DER"]
	}, {
		"name": "ANIMAL_CARRIER",
		"marketplaceIds": ["ATVPDKIKX0DER"]
	}, {
		"name": "ANIMAL_HARNESS",
		"marketplaceIds": ["ATVPDKIKX0DER"]
	}, {
		"name": "ANTENNA",
		"marketplaceIds": ["ATVPDKIKX0DER"]
	}, {
		"name": "APPAREL",
		"marketplaceIds": ["ATVPDKIKX0DER"]
	}, {
		"name": "APPAREL_BELT",
		"marketplaceIds": ["ATVPDKIKX0DER"]
	}, {
		"name": "APPAREL_GLOVES",
		"marketplaceIds": ["ATVPDKIKX0DER"]
	}, {
		"name": "APPAREL_HEAD_NECK_COVERING",
		"marketplaceIds": ["ATVPDKIKX0DER"]
	}, {
		"name": "APRON",
		"marketplaceIds": ["ATVPDKIKX0DER"]
	}, {
		"name": "ARM_SLEEVE",
		"marketplaceIds": ["ATVPDKIKX0DER"]
	}, {
		"name": "AROMA_DIFFUSER",
		"marketplaceIds": ["ATVPDKIKX0DER"]
	}, {
		"name": "ART",
		"marketplaceIds": ["ATVPDKIKX0DER"]
	}, {
		"name": "ARTIFICIAL_PLANT",
		"marketplaceIds": ["ATVPDKIKX0DER"]
	}, {
		"name": "ARTIFICIAL_TREE",
		"marketplaceIds": ["ATVPDKIKX0DER"]
	}, {
		"name": "ART_AND_CRAFT_SUPPLY",
		"marketplaceIds": ["ATVPDKIKX0DER"]
	}
	....
	]
}
```

### 获取类型字段定义
```json
{
	"metaSchema": {
		"link": {
			"resource": "https://selling-partner-definitions-prod-iad.s3.amazonaws.com/schema/amazon-product-type-definition-meta-schema-v1.json/R%252BtOle7%252FtlSwgT5dChfExA%253D%253D?X-Amz-Security-Token=IQoJb3JpZ2luX2VjEHoaCXVzLWVhc3QtMSJGMEQCIHOJiwVCJEV71R1jSOWIMyCkJjX%2F%2BMfXZeHitXUv7TcjAiAQ8N9ukSZEnbBL375tc0Zm7OXSnI0%2FUnIHBOFmgtbAkSrSBAiC%2F%2F%2F%2F%2F%2F%2F%2F%2F%2F8BEAIaDDUzNTc4OTgyMzgwOCIMncFHMYfuI%2Bnl22qyKqYEVUSlUuZAU0G9sYnfPk%2Bf800aEcJdUbbRNoVAd6kKQDGOmlYYI70qDEBRbhMMF2C%2B2yBsI51s9J2Z9lE5kKQhBffMgv%2BcV5Wloh%2F6ZUmnfTfOKk27MFyNqCuvAPCf%2BVlwiZH9l%2F04ktjTHQyaSe21gxKVLXoLa93Sh0LLK4ln07y%2FsdwEc81YmuLU0nrxk8kpcqYQyxaaW50dPVkU4VODepAIEb1G5Fci2QfHmyNCnv1XDCA07sfdbDYpNr3F2q18qCfpXB9F6K3U7oPPJ34vWH%2FDv6KawvW7kfbJBwSqVeO%2BMmwE7DqonEPudzff8BcDQJ9tZRF3t7TAYCHbzlN4oFECcQZo%2FfPkpO8Lf8sQRqttiSdaUgEzBsvQ6Kkc5oG2GQvI8RLRoic8QQBNkUnUBjnQoe7YiIXq5t%2BFoER%2BVg9sX9Rs64AFHk0oC6r5n9oJOSbARG9Xlll8Gk2mv5fPMEJxsyJOGJMinxFoyxKURbiFWCCNPnoOrAzQPy8rWw2xxNG6995ZO7P9QWBTfmGTGgMQ81eoTFBV9NGJP0djsx2CuKNEA3GQnV1mh8ORjiZv9H%2FGngRaoRde4KSHeRXDrTC%2FJFxYYGoNAH%2F9B%2F2Ea8yguJflPg9fGpFxjI%2FUjLwRQub9prWTfrINnhlVIFhxibeF%2FFeyx0VwTtpZwpCB5SftGP8URXTwXlxcr%2FoWfKxWxkOy4vnVn0BbotTIzx5XWPnlPM7QhzDVv5%2BVBjqoAUeyvTv%2FtW2q23JS9op7D59R6ytD%2BwlShxLhm88uREiTBxNusWaUOr3rB3Q9Uv9Ys799UsZquHCePxwgDYWVQ432kDDiSbqJAmGqnUmIHcDMUVG9uA2vk1OZ%2FMSC0EAMk7RAh9jUsu8cnWd%2BLPgi30%2Bm8GtNHEd1WGwRgmFrOYoWA4ZDReDFt29A3%2B5ovV2Q0b1JT3x5dEz65Gg5Xpe%2FYEwvyLU862hyvg%3D%3D&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20220614T030950Z&X-Amz-SignedHeaders=host&X-Amz-Expires=604800&X-Amz-Credential=ASIAXZP4P45AKQUFBUWI%2F20220614%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Signature=8b1abad5f90da72a97c0c5743c716a1f416655e90c0e31d5e3bb774a229f51f9",
			"verb": "GET"
		},
		"checksum": "R+tOle7/tlSwgT5dChfExA=="
	},
	"schema": {
		// 这个就是字段关系描述URL
		"link": {
			"resource": "https://selling-partner-definitions-prod-iad.s3.amazonaws.com/schema/HOME.json/8owFeYY1lU3w2m%252BEXhdp3g%253D%253D?X-Amz-Security-Token=IQoJb3JpZ2luX2VjEHoaCXVzLWVhc3QtMSJGMEQCIHOJiwVCJEV71R1jSOWIMyCkJjX%2F%2BMfXZeHitXUv7TcjAiAQ8N9ukSZEnbBL375tc0Zm7OXSnI0%2FUnIHBOFmgtbAkSrSBAiC%2F%2F%2F%2F%2F%2F%2F%2F%2F%2F8BEAIaDDUzNTc4OTgyMzgwOCIMncFHMYfuI%2Bnl22qyKqYEVUSlUuZAU0G9sYnfPk%2Bf800aEcJdUbbRNoVAd6kKQDGOmlYYI70qDEBRbhMMF2C%2B2yBsI51s9J2Z9lE5kKQhBffMgv%2BcV5Wloh%2F6ZUmnfTfOKk27MFyNqCuvAPCf%2BVlwiZH9l%2F04ktjTHQyaSe21gxKVLXoLa93Sh0LLK4ln07y%2FsdwEc81YmuLU0nrxk8kpcqYQyxaaW50dPVkU4VODepAIEb1G5Fci2QfHmyNCnv1XDCA07sfdbDYpNr3F2q18qCfpXB9F6K3U7oPPJ34vWH%2FDv6KawvW7kfbJBwSqVeO%2BMmwE7DqonEPudzff8BcDQJ9tZRF3t7TAYCHbzlN4oFECcQZo%2FfPkpO8Lf8sQRqttiSdaUgEzBsvQ6Kkc5oG2GQvI8RLRoic8QQBNkUnUBjnQoe7YiIXq5t%2BFoER%2BVg9sX9Rs64AFHk0oC6r5n9oJOSbARG9Xlll8Gk2mv5fPMEJxsyJOGJMinxFoyxKURbiFWCCNPnoOrAzQPy8rWw2xxNG6995ZO7P9QWBTfmGTGgMQ81eoTFBV9NGJP0djsx2CuKNEA3GQnV1mh8ORjiZv9H%2FGngRaoRde4KSHeRXDrTC%2FJFxYYGoNAH%2F9B%2F2Ea8yguJflPg9fGpFxjI%2FUjLwRQub9prWTfrINnhlVIFhxibeF%2FFeyx0VwTtpZwpCB5SftGP8URXTwXlxcr%2FoWfKxWxkOy4vnVn0BbotTIzx5XWPnlPM7QhzDVv5%2BVBjqoAUeyvTv%2FtW2q23JS9op7D59R6ytD%2BwlShxLhm88uREiTBxNusWaUOr3rB3Q9Uv9Ys799UsZquHCePxwgDYWVQ432kDDiSbqJAmGqnUmIHcDMUVG9uA2vk1OZ%2FMSC0EAMk7RAh9jUsu8cnWd%2BLPgi30%2Bm8GtNHEd1WGwRgmFrOYoWA4ZDReDFt29A3%2B5ovV2Q0b1JT3x5dEz65Gg5Xpe%2FYEwvyLU862hyvg%3D%3D&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20220614T030950Z&X-Amz-SignedHeaders=host&X-Amz-Expires=604800&X-Amz-Credential=ASIAXZP4P45AKQUFBUWI%2F20220614%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Signature=ba6331a4c54eb4717b69ba472600ed3f82c5c7c7a6bffd0ab77b2277a7661e8c",
			"verb": "GET"
		},
		"checksum": "8owFeYY1lU3w2m+EXhdp3g=="
	},
	"requirements": "LISTING",
	"requirementsEnforced": "ENFORCED",
	"propertyGroups": {
		"offer": {
			"title": "Offer",
			"description": "Product Offer",
			"propertyNames": ["skip_offer", "fulfillment_availability", "map_policy", "purchasable_offer", "condition_type", "condition_note", "list_price", "product_tax_code", "merchant_release_date", "merchant_shipping_group", "max_order_quantity", "gift_options", "main_offer_image_locator", "other_offer_image_locator_1", "other_offer_image_locator_2", "other_offer_image_locator_3", "other_offer_image_locator_4", "other_offer_image_locator_5"]
		},
		"images": {
			"title": "Images",
			"description": "Provide media content, such as product images",
			"propertyNames": ["main_product_image_locator", "other_product_image_locator_1", "other_product_image_locator_2", "other_product_image_locator_3", "other_product_image_locator_4", "other_product_image_locator_5", "other_product_image_locator_6", "other_product_image_locator_7", "other_product_image_locator_8", "swatch_product_image_locator"]
		},
		"shipping": {
			"title": "Shipping",
			"description": "Information to determine shipping and storage of your product (e.g., package dimensions, weight, volume)",
			"propertyNames": ["item_dimensions", "item_package_dimensions", "item_package_weight", "number_of_boxes"]
		},
		"variations": {
			"title": "Variations",
			"description": "Variations that product will use",
			"propertyNames": ["parentage_level", "child_parent_sku_relationship", "variation_theme"]
		},
		"safety_and_compliance": {
			"title": "Safety & Compliance",
			"description": "Information to indicate product compliance, hazardous materials, and legal and safety warnings (e.g., lithium batteries, choking hazards, Consumer Product Safety Information Act (CPSIA))",
			"propertyNames": ["country_of_origin", "warranty_description", "batteries_required", "batteries_included", "battery", "num_batteries", "number_of_lithium_metal_cells", "number_of_lithium_ion_cells", "lithium_battery", "supplier_declared_dg_hz_regulation", "hazmat", "safety_data_sheet_url", "item_weight", "required_product_compliance_certificate", "legal_compliance_certifications", "ghs", "country_as_labeled", "supplier_declared_material_regulation", "california_proposition_65", "cpsia_cautionary_statement", "pesticide_marking", "fcc_radio_frequency_emission_compliance", "regulatory_compliance_certification"]
		},
		"product_identity": {
			"title": "Product Identity",
			"description": "Information to uniquely identify your product (e.g., UPC, EAN, GTIN, Product Type, Brand)",
			"propertyNames": ["item_name", "brand", "externally_assigned_product_identifier", "merchant_suggested_asin", "supplier_declared_has_product_identifier_exemption", "item_type_keyword", "item_type_name", "model_number", "model_name", "manufacturer"]
		},
		"product_details": {
			"title": "Product Details",
			"description": "Information and characteristics to describe the product to support search, browse and detail page content (e.g., bullets, product features, model, style name)",
			"propertyNames": ["product_description", "bullet_point", "generic_keyword", "special_feature", "material", "number_of_items", "color", "size", "number_of_pieces", "occasion_type", "part_number", "item_shape", "sub_brand", "care_instructions", "bottle_count", "is_assembly_required", "number_of_shelves", "number_of_hooks", "wattage", "finish_type", "product_site_launch_date", "included_components", "unit_count", "maximum_weight_recommendation", "number_of_compartments"]
		}
	},
	"locale": "en_US",
	"marketplaceIds": ["ATVPDKIKX0DER"],
	"productType": "HOME",
	"productTypeVersion": {
		"version": "Uk1uCLxYHyc03TFCLH4tBySOJX2FT0CjshQdAVfFR",
		"latest": true,
		"releaseCandidate": false
	}
}
```

## 五. Q&A

### 一. 刊登了商品以后,如果状态是未完成有可能以下原因
	1) 那么进入编辑看是否发售时间或者其它时间有问题.
	2) 没有填写价格
	
### 二. 刊登商品Body里, 品牌与制造商要填写一致，否则刊登失败!!!
	以下是淘宝客服给的测试品牌 hanaiette，HAIHUANG，CHUANG，ROVOZAR，SWR，ruiyang，Togestar，Bowtus

### 三. 刊登商品填写属性字段都是根据亚马逊刊登后台页面属性一一对应
	对应的方式一般都是页面上Local lableName与属性关系Url页面中title对应确定fieldName
	
### 四. 相关资料
	网上用例: https://spapi.cyou/en/use-case/listings-items-api-use-case-guide_2021-08-01.html#step-1-submit-listings-item-get-request
	亚马逊Swagger: https://spapi.cyou/swagger/index.html?urls.primaryName=listings-items-api-model#/listings/putListingsItem

### 五. 提供以下UPC测试
706316864588,706316864595,706316864601,706316864618,706316864625,706316864632,706316864649,
706316864656,706316864663,706316864779,744173565569,744173565576,744173565583,744173565590,
744173565606,744173565613,744173565620,744173565637,744173565644,744173565651,744173565668,
744173565675,744173565682,744173565699,744173565705,744173565712,744173565729,744173565736,
744173565743,744173565750,744173565767,744173565774,744173565781,744173565798,744173565804,
744173565811,744173565828,744173565835,744173565842,744173565859,744173565866,744173565873,
744173565880,744173565897,744173565903,744173565910,744173565927,744173565934,744173565941,
744173565958,744173565965,744173565972,744173565989,744173565996,744173566009,744173566016,
744173566023,744173566030,744173566047,744173566054

## 六.尾声
这1，2周翻墙翻了很多外网文档都没有对于Listing API有很好的介绍文档,因此上述所有资料都是这段时间我和俊安测试出来,如果有其它纰漏可以直接给我或者俊安说。**严禁此文档对外泄露**