移除商品

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

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

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