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