移除商品

從指定的訂單中移除商品。如果某訂單下的商品全被移除，則訂單狀態顯示為已作廢。

註：該功能只適用於賣家配送的訂單。

參數

名稱	是否必填？	描述
sellerid	是	您在新蛋商城的商家編號
ordernumber	是	訂單編號

請求文件主體

屬性	是否必填？	格式	描述
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

<OperationType>KillItemRequest</OperationType>

<Order>

<Item>

</Item>

<Item>

</Item>

</ItemList>

</Order>

</KillItem>

</RequestBody>

</NeweggAPIRequest>

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>

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"

}

]

}

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" } ] } } } } }

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”?>

<OperationType>KillItemResponse</OperationType>

<Item>

</Item>

</ItemList>

</Result>

</Orders>

</ResponseBody>

</NeweggAPIResponse>

<?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>

<?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"

}

{ "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" }

{
    "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"?>

<Error>

<Message>This order has already been voided</Message>

</Error>

</Errors>

<?xml version="1.0" encoding="utf-8"?> <Errors> <Error> <Code>SO008</Code> <Message>This order has already been voided</Message> </Error> </Errors>

<?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"

}

]

[ { "Code": "SO008", "Message": " This order has already been voided" } ]

[
    {
        "Code": "SO008",
        "Message": " This order has already been voided"
    }
]

更新日期：10/15/2018

HTTP方式	是否需要認證	請求格式	回覆格式	頻率限制
PUT	需要	XML,Json	XML,Json	1000 請求/小時

移除商品

相關URL

參數

相關請求資訊

請求文件主體

回覆文件主體

請求失敗錯誤資訊