Get Volume Discount Request Result

Resource URL

Newegg.com: https://api.newegg.com/marketplace/contentmgmt/item/volumediscount?sellerid={sellerid}
Neweggbusiness.com: https://api.newegg.com/marketplace/b2b/contentmgmt/item/volumediscount?sellerid={sellerid}
Newegg.ca: https://api.newegg.com/marketplace/can/contentmgmt/item/volumediscount?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

Name Required? Description
Seller ID Yes Your seller ID on Newegg Marketplace

Resource Information

HTTP Method Authentication? Request Formats Response Formats Rate Limited?
PUT Required XML, Json XML, Json 100 request per hour

Request Body

Attribute Required? Format Description
OperationType Yes String Fixed value: GetVolumeDiscountRequest
SellerPartNumber No, if NeweggItemNumber is provided. Integer Seller Part#
NeweggItemNumber No, if SellerPartNumber is provided. Integer NE Item#

Schema: GetVolumeDiscountRequest.xsd

Example: XML, Request

PUT https://api.newegg.com/marketplace/contentmgmt/item/volumediscount?sellerid={SellerID}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml

<NeweggAPIRequest >
    <OperationType>GetVolumeDiscountRequest</OperationType>
    <RequestBody>
        <NeweggItemNumber>9SIA0010287920</NeweggItemNumber>
    </RequestBody>
</NeweggAPIRequest>

Example: Json, Request

POST https://api.newegg.com/marketplace/contentmgmt/item/volumediscount?sellerid={SellerID}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json

{
    "OperationType": "GetVolumeDiscountRequest",
    "RequestBody": {
        "NeweggItemNumber": "9SIA0010287920"
    }
}

Response Body

Attribute Format Description
IsSuccess String Identify the operation of Volume Discount request is successful
Fixed value: True
SellerID String Your seller ID
OperationType String Fixed value: GetVolumeDiscountResponse
SellerPartNumber String Seller Part#
NeweggItemNumber String NE Item#
Priority Integer The tier for the volume discount.
Quantity Integer The quantity for the tier’s volume discount.
SellingPrice Decimal The unit price for the tier’s volume discount.
EnableFreeShipping Integer The shipping method for the tier’s volume discount.

Schema: GetVolumeDiscountResponse.xsd

Example: XML, Response

<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
    <IsSuccess>true</IsSuccess>
    <OperationType>GetVolumeDiscountResponse</OperationType>
    <SellerID>a001</SellerID>
    <ResponseBody>
        <ItemVolumeDiscountInfo>
            <SellerPartNumber>B0147001</SellerPartNumber>
            <NeweggItemNumber>9SIA0010287920</NeweggItemNumber>
            <DiscountSetting>
                <Tier>
                    <Priority>1</Priority>
                    <Quantity>12</Quantity>
                    <SellingPrice>110</SellingPrice>
                    <EnableFreeShipping>0</EnableFreeShipping>
                </Tier>
                <Tier>
                    <Priority>2</Priority>
                    <Quantity>20</Quantity>
                    <SellingPrice>105</SellingPrice>
                    <EnableFreeShipping>0</EnableFreeShipping>
                </Tier>
            </DiscountSetting>
        </ItemVolumeDiscountInfo>
    </ResponseBody>
</NeweggAPIResponse>

Example: Json, Response

{
    "IsSuccess": "true",
    "OperationType": "GetVolumeDiscountResponse",
    "SellerID": "a001",
    "ResponseBody": {
        "ItemVolumeDiscountInfo": {
            "SellerPartNumber": "B0147001",
            "NeweggItemNumber": "9SIA0010287920",
            "DiscountSetting": {
                "Tier": {
                    "Priority": "2",
                    "Quantity": "20",
                    "SellingPrice": "105",
                    "EnableFreeShipping": "0"
                }
            }
        }
    }
}

Request Failure Errors

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

Error Code Description
CT001 Invalid ItemNumber
CT002 Invalid SellerPartNumber
CT059 Item number or seller part# is required.
CT060 Not found. The requested item does not have volume discount yet.

Example: XML, Response

<?xml version="1.0" encoding="utf-8"?>
<Errors>
    <Error>
        <Code>CT001</Code>
        <Message>Invalid ItemNumber</Message>
    </Error>
</Errors>

Example: Json, Response

[
    {
        "Code": "CT001",
        "Message": "Invalid ItemNumber"
    }
]

Last updated: October 15, 2018