移除商品
从指定的订单中移除商品。如果某订单下的商品全被移除,则订单状态显示为已作废。
注:该功能只适用于卖家配送的订单。
相关URL
Newegg.com: https://api.newegg.com/marketplace/ordermgmt/killitem/orders/{ordernumber}?sellerid={sellerid}
Neweggbusiness.com: https://api.newegg.com/marketplace/b2b/ordermgmt/killitem/orders/{ordernumber}?sellerid={sellerid}
Newegg.ca: https://api.newegg.com/marketplace/can/ordermgmt/killitem/orders/{ordernumber}?sellerid={sellerid}
注:请确保您的请求URL全都是小写(除Seller ID)并且不能包含任何空格或者换行符。
参数
| 名称 | 是否必填? | 描述 |
| sellerid | 是 | 您在新蛋商城的商家编号 |
| ordernumber | 是 | 订单编号 |
相关请求信息
| HTTP方式 | 是否需要认证 | 请求格式 | 回复格式 | 频率限制 |
| PUT | 需要 | XML,Json | XML,Json | 1000 请求/小时 |
请求文件主体
| 属性 | 是否必填? | 格式 | 描述 |
| IssueUser | 否 | String | 您注册成为新蛋卖家账户的邮箱地址 |
| OperationType | 是 | String | 固定值:KillItemRequest |
| SellerPartNumber | 是 | String | 商家自定义的商品编号 注:新蛋配送订单,商品不能被移除。 |
| Memo | 否 | String | 附加信息,移除商品的原因。 |
Schema: RemoveItemRequest.xsd
示例:XML,Request
PUT https://api.newegg.com/marketplace/ordermgmt/killitem/orders/{ordernumber}?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest>
<OperationType>KillItemRequest</OperationType>
<RequestBody>
<KillItem>
<Order>
<ItemList>
<Item>
<SellerPartNumber>AWHZ3434</SellerPartNumber>
</Item>
<Item>
<SellerPartNumber>AWHZ3435</SellerPartNumber>
</Item>
</ItemList>
</Order>
</KillItem>
</RequestBody>
</NeweggAPIRequest>
示例:Json,Request
PUT https://api.newegg.com/marketplace/ordermgmt/killitem/orders/{ordernumber}?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"OperationType": "KillItemRequest",
"RequestBody": {
"KillItem": {
"Order": {
"ItemList": {
"Item": [
{
"SellerPartNumber": "AWHZ3434"
},
{
"SellerPartNumber": "AWHZ3435"
}
]
}
}
}
}
}
回复文件主体
| 属性 | 格式 | 描述 |
| IsSuccess | String | 用于确定从订单中移除商品的操作是否成功。
返回:True或者False |
| OperationType | String | 固定值: KillItemResponse |
| SellerID | String | 商家编号 |
| ResponseDate | String | 请求时间(太平洋标准时间) |
| OrderNumber | Integer | 订单编号 |
| ShipDate | String | 发货时间(太平洋标准时间) |
| SellerPartNumber | String | 商品的商家编号 |
| RequestDate | String | 请求时间(太平洋标准时间) |
| Memo | String | 如果操作失败,该字段将包含详细的错误描述 |
Schema: RemoveItemResponse.xsd
示例:XML,Response
<?xml version=”1.0” encoding=”utf-8”?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<OperationType>KillItemResponse</OperationType>
<SellerID>A006</SellerID>
<Memo />
<ResponseBody>
<RequestDate>2012-02-22 16:42:10</RequestDate>
<Orders>
<OrderNumber>88237462</OrderNumber>
<Result>
<ItemList>
<Item>
<SellerPartNumber>AWHZ3434</SellerPartNumber>
</Item>
</ItemList>
</Result>
</Orders>
</ResponseBody>
<ResponseDate>2012-02-22 16:42:10</ResponseDate>
</NeweggAPIResponse>
示例:Json,Response
{
"IsSuccess": true,
"Memo": null,
"OperationType": "KillItemResponse",
"SellerID": "A006",
"ResponseBody": {
"Orders": {
"OrderNumber": "88237462",
"Result": {
"ItemList": [
{
"SellerPartNumber": "AWHZ3434"
}
]
}
},
"RequestDate": "2012-02-22 16:42:10"
},
"ResponseDate": "2012-02-22 16:42:10"
}
请求失败错误信息
常规HTTP错误回复,请参考回复失败错误代码列表。
| 错误代码 | 描述 |
| SO002 | Order Number should be an integer (ranging from 1 to 2147483647)
订单编号应为整数(区间为 1 到 2147483647) |
| SO003 | No data found or this order does not belong to this seller
找不到数据或此订单不属于该商家 |
| SO004 | This is a replacement SO with a RMA number. It cannot be voided
此订单是带有 RMA 编号的换货订单,不能被作废 |
| SO005 | Cannot remove item because this is a Shipped by Newegg order. order is Shipped by Newegg
不能移除由新蛋 SBN 服务运送的订单中的商品。此订单由新蛋SBN服务运送 |
| SO006 | Only unshipped orders can be voided. The order status is currently {0}
只有未发货的订单才能被删除。当前订单状态为{0} |
| SO007 | Cannot get the order status info
不能获取订单状态信息 |
| SO008 | This order has already been voided
此订单已被作废 |
| SO009 | Order number cannot be null or empty
订单编号不能为空 |
| SO041 | CANNOT find SONumber: {0}
找不到匹配的运单编号:{0} |
| SO042 | Application exception occurred during calling EC Interface. SONumber: {0}, ItemNumber: {1}. Please Contact Newegg Marketplace.
调用计算机接口时出现应用异常。订单号:{0},商品编号:{1},请联系新蛋商城 |
| SO043 | Business exception occurred during calling EC Interface(3 invoice,4 void,1 shipped). SONumber: {0}, ItemNumber: {1}. Please Contact Newegg Marketplace.
调用计算机接口时出现交易异常(3 交易完成,4 交易关闭,1 已发货),订单号: {0},商品编号:{1}请联系新蛋商城 |
| SO045 | Failed to get customer information! The customer number is {0}.
获取顾客信息失败!顾客编号为{0} |
| SO046 | CANNOT find item in Newegg_SOTransaction, SONumber: {0}, ItemNumber: {1}
无法在新蛋_运单交易系统找到该商品,运单编号: {0},商品编号: {1} |
| SO047 | CANNOT get item detail information (sub category), ItemNumber: {0}
无法获取商品详细信息(子类目),商品编号:{0} |
| SO049 | The ‘{0}’ is required.
“{0}”必填 |
| SO050 | The SellerPartNumber ‘{0}’ is invalid.
无效的 SellerPartNumber ‘{0}’ |
| SO051 | This ‘{0}’ has already been canceled in Newegg System.
这个“{0}”已在新蛋系统中被取消 |
| SO052 | CANNOT find out item by ordernumber ='{0}’ and sellerid='{1}’.
无法通过 ordernumber ='{0}’ 和 sellerid='{1}’找到商品 |
| SO053 | Cannot get the ordernumber='{0}’ status.
无法获取订单编号为“{0}”的订单状态 |
| SO054 | The ordernumber= ‘{0}’ is Replacement SO. CANNOT be voided.
订单编号为’{0}’的订单为换货订单,无法作废 |
| SO055 | The seller part# = ‘{0}’ is repeated.
seller part# = ‘{0}’重复 |
| SO056 | Cannot remove item because this is a Shipped by Newegg order. order is Shipped by Newegg
无法移除该订单下的商品,因为该订单为新蛋配送。 |
示例:XML,Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
<Code>SO008</Code>
<Message>This order has already been voided</Message>
</Error>
</Errors>
示例:Json,Response
[
{
"Code": "SO008",
"Message": " This order has already been voided"
}
]
更新日期:10/15/2018