Remove Item

Remove item from specified order. If all items removed from an order, order status becomes void.

Note: Only supports orders that is fulfilled by seller.

Resource 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}

Note: Please make sure your request URL is all in lower case (except for Seller ID) and cannot contain any blank spaces or line breaks.

Parameters

Resource Information

Request Body

Schema: RemoveItemRequest.xsd

Example: 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>

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

Response Body

Schema: RemoveItemResponse.xsd

Example: 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>

Example: 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"
}

Request Failure Errors

For common HTTP error responses, please refer to Failed Response Error Code List.

Example: XML, Response

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

Example: Json, Response

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

Last updated: October 15, 2018