移除商品

从指定的订单中移除商品。如果某订单下的商品全被移除,则订单状态显示为已作废。

注:该功能只适用于卖家配送的订单。

相关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