移除商品
从指定的订单中移除商品。如果某订单下的商品全被移除,则订单状态显示为已作废。
注:该功能只适用于卖家配送的订单。
相关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